Administrator’s Guide

ManualsBrandsClaris FileMaker ManualsApplicationsFileMaker Pro 5 Unlimited

Table Of Contents

Chapter 1 Welcome to the FileMaker Pro Web Server Connector
Chapter 2 About the Web Server Connector
Chapter 3 Installing the FileMaker Pro Web Server Connector on Microsoft IIS and PWS
Chapter 4 Installing the FileMaker Pro Web Server Connector on Netscape Enterprise Server
Chapter 5 Installing the FileMaker Pro Web Server Connector with AppleShare IP and WebSTAR
Chapter 6 Installing the FileMaker Pro Web Server Connector on Apache (Mac OS X Server)
Chapter 7 Using the Web Server Connector as host
Chapter 8 Accessing hosted databases
- Connecting to databases served by CustomWebPublishing
- Connecting to databases served by InstantWebPublishing

FileMaker

Pro 5

Unlimited

FileMaker, Inc.

5201 Patrick Henry Drive

Santa Clara, California 95054

www.filemaker.com

and the file folder logo is a trademark of FileMaker, Inc. Java, 100% Pure Java, and all Java-based trademarks and logos are

trademarks or registered trademarks of Sun Microsystems, Inc., in the U.S. and other countries. All other trademarks are the property

of their respective owners. Mention of third party companies and products is for informational purposes only and does not constitute

an endorsement. FileMaker assumes no responsibility with regard to the selection, performance, or use of these products. All

understandings, agreements or warranties, if any, take place directly between the vendor and prospective users.

FileMaker Web Server Connector

Administrator’s Guide

For Windows and Mac

Summary of content (42 pages)

PAGE 1
For Windows and Mac ® FileMaker Pro 5 Unlimited FileMaker Web Server Connector Administrator’s Guide ©1994-1995, 1997, 1999 FileMaker, Inc. All Rights Reserved. FileMaker, Inc. 5201 Patrick Henry Drive Santa Clara, California 95054 www.filemaker.com ©1999 FileMaker, Inc. All rights reserved. FileMaker is a trademark of FileMaker, Inc., registered in the U.S. and other countries, and the file folder logo is a trademark of FileMaker, Inc.
PAGE 2
This page intentionally left blank.
PAGE 3
Contents Chapter 1 Welcome to the FileMaker Pro Web Server Connector Registration and customer support Before you begin Minimum hardware and software requirements for the FileMaker Pro Web Server Connector Web publishing requirements Where to place database and HTML files Terms used in this guide 5 5 5 6 6 6 Installing with Microsoft Internet Information Server and Microsoft Personal Web Server Uninstalling the FileMaker Pro Web Server Connector Removing the ISAPI filter entry Where files are stored on yo
PAGE 4
iv FileMaker Web Server Connector Administrator’s Guide Running on a remote machine FMWSC_Apache.
PAGE 5
Chapter 1 Welcome to the FileMaker Pro Web Server Connector Welcome to the FileMaker® Pro Web Server Connector software package. FileMaker Pro Web Server Connector is designed to help you share information easily and effectively by serving FileMaker Pro databases through six popular web servers: Microsoft Personal Web Server and Internet Information Server, Netscape Enterprise Server, AppleShare IP Server, WebSTAR, and Apache on Mac OS X Server.
PAGE 6
FileMaker Web Server Connector Administrator’s Guide Terms used in this guide Mac OS X Server: 1 1 Mac OS X Server 1.02 The following terms are used in this guide: Apache 1.3.6 Operating system Supported server(s) Windows NT Server Microsoft Internet Information Server (IIS) Netscape Enterprise Server (NES) Windows NT Workstation, Windows 98, Windows 95 Microsoft Personal Web Server (PWS) Mac OS 8.6 AppleShareIP 6.2 WebSTAR 4.0 Mac OS X Server 1.02 Apache 1.3.
PAGE 7
Welcome to the FileMaker Pro Web Server Connector Term Definition Servlet A Java-based web server extension that is an alternative to traditional, platform-specific CGIs. Servlet engine The component of the servlet that arbitrates the interaction of the web server and external applications. Web Companion A FileMaker Pro plug-in that dynamically delivers data from FileMaker Pro 5 files via HTTP to a web browser. Web server The machine running the HTTP server software that hosts your web site.
PAGE 8
This page intentionally left blank.
PAGE 9
Chapter 2 About the Web Server Connector The FileMaker Pro Web Server Connector resides on your web server. It relays FileMaker requests for XML, CDML, and other dynamic content to one or more computers running FileMaker Pro 5 Unlimited. The FileMaker Web Server Connector is a servlet, a standard Javabased mechanism for extending the functionality of a web server. With the FileMaker Pro application and its Web Companion plug-in, you can publish your databases on the World Wide Web or an intranet.
PAGE 10
FileMaker Web Server Connector Administrator’s Guide Configuration 2: FileMaker Pro 5 Unlimited, the Web Server Connector, and web server software on a single machine Web Browser Web Browser Web Browser Web Browser Configuration 3: FileMaker Pro 5 Unlimited on one machine, the Web Server Connector on another machine Web Browser Web Browser Web Browser Web Browser Web Server Web Server Web Server Connector Web Server Connector FileMaker Pro 5 Unlimited Clients.fp5 Sales.
PAGE 11
About the Web Server Connector Configuration 4: RAIC with multiple copies of the same databases Web Browser Web Browser Web Browser Web Browser 11 However, this redundancy makes it difficult to input and modify data. Because the Web Server Connector releases a database after a request has been processed, that database becomes available immediately as a node of the RAIC. This means that it is possible to encounter a different node of the RAIC with each request or transaction.
PAGE 12
FileMaker Web Server Connector Administrator’s Guide In this configuration, individual databases are spread over several hosts. Because the databases are not duplicated, your clients can both read and write to them. This arrangement offers good throughput, because multiple hosts ease the load that would otherwise be given to a single host, and can provide a means for some load balancing if the most active databases are put on separate machines.
PAGE 13
About the Web Server Connector This configuration is similar to the previous RAIC structure. However, instead of using FileMaker Server 5 as a backend host, you use a dedicated copy of FileMaker Pro 5 to host the databases, and share them from the Web Companions of FileMaker Pro Unlimited running on the guest machines. Because this backend machine will be hosting databases using peer-to-peer networking, you can use a copy of either FileMaker Pro 5 or FileMaker Pro Unlimited.
PAGE 14
This page intentionally left blank.
PAGE 15
Chapter 3 Installing the FileMaker Pro Web Server Connector on Microsoft IIS and PWS This chapter explains how to install the FileMaker Pro Web Server Connector with Microsoft Personal Web Server (Windows 95, Windows 98, Windows NT Workstation 4.0) and Microsoft Internet Information Server (Windows NT Server 4.0). The FileMaker Pro Web Server Connector uses the same installer for Personal Web Server and Internet Information Server.
PAGE 16
FileMaker Web Server Connector Administrator’s Guide 4. In the Software License Agreement screen, click Yes if you accept the terms of the license agreement. 5. In the Read Me screen, review the contents for any late-breaking information about the Web Server Connector, then click Next. 6. In the Choose Destination Location installation dialog box, click Next to install the Web Server Connector.
PAGE 17
Installing the FileMaker Pro Web Server Connector on Microsoft IIS and PWS Where to go from here 5. Select fmwsc_isapi and click Remove. 6. Click OK, then click OK again. 7. Restart the web server software to reload your remaining filters. After you install the FileMaker Pro Web Server Connector, see chapter 7, “Using the Web Server Connector as host,” for instructions to configure the Web Server Connector for use..
PAGE 18
FileMaker Web Server Connector Administrator’s Guide Folder location Microsoft IIS and PWS c:\program files\filemaker\filemaker wsc 5 - IIS\jre\bin\lib File or folder Description Rmiregistry.exe Java runtime environment file Sysresource.dll Java runtime environment file Winawt.dll Java runtime environment file Zip.dll Java runtime environment file awt.properties Java runtime environment library file Content-types.properties Java runtime environment library file Font.
PAGE 19
Installing the FileMaker Pro Web Server Connector on Microsoft IIS and PWS Folder location Microsoft IIS and PWS c:\program files\filemaker\filemaker wsc 5 - IIS\jre\bin\security c:\program files\filemaker\filemaker wsc 5 - IIS\lib c:\Inetpub\scripts\ File or folder Description Font.properties.uk Java runtime environment library file Font.properties.yu Java runtime environment library file Font.properties.zh Java runtime environment library file Font.properties.
PAGE 20
This page intentionally left blank.
PAGE 21
Chapter 4 Installing the FileMaker Pro Web Server Connector on Netscape Enterprise Server This chapter explains how to install the FileMaker Pro Web Server Connector with Netscape Enterprise Server (Windows 95, Windows 98, Windows NT Workstation 4.0, and Windows NT Server 4.0). 4. In the Software License Agreement screen, click Yes if you accept the terms of the license agreement. 5.
PAGE 22
FileMaker Web Server Connector Administrator’s Guide 8. Click Yes to update the Obj.conf file. Important The installer must make changes and entries to this file for the Web Server Connector to function properly. Only experienced NES administrators should modify this file manually. 9. Restart your server to launch the Web Server Connector. Important Do not use high ASCII characters in user names, because they may cause authentication failures. The Web Server Connector is now running.
PAGE 23
Installing the FileMaker Pro Web Server Connector on Netscape Enterprise Server 23 Where files are stored on your hard disk The following tables show the files and folders you install as part of the Web Server Connector installation. Folder location Netscape Enterprise Server File or folder Description c:\program files\filemaker\filemaker wsc 5 netscape enterprise\ EditObjConf.
PAGE 24
FileMaker Web Server Connector Administrator’s Guide Folder location Netscape Enterprise Server File or folder Description c:\program files\filemaker\filemaker wsc 5 netscape enterprise\https-[server name]\jre\bin Ibmjitc.dll Java runtime environment file Javai.dll Java runtime environment file Javakey.exe Java runtime environment file JdbcOdbc.dll Java runtime environment file Jpeg.dll Java runtime environment file Jre.exe Java runtime environment file Jrew.
PAGE 25
Installing the FileMaker Pro Web Server Connector on Netscape Enterprise Server Folder location Netscape Enterprise Server File or folder Description Font.properties.ja Java runtime environment library file Font.properties.ko Java runtime environment library file Font.properties.lt Java runtime environment library file Font.properties.lv Java runtime environment library file Font.properties.mk Java runtime environment library file Font.properties.
PAGE 26
This page intentionally left blank.
PAGE 27
Chapter 5 Installing the FileMaker Pro Web Server Connector with AppleShare IP and WebSTAR This chapter explains how to install the FileMaker Pro Web Server Connector with AppleShare IP 6.2 and WebSTAR 4.0 on Mac OS 8.6 and higher. Installing with AppleShare IP and WebSTAR Important Installing this program requires you to restart your server. Before you begin the installation process, save your work, exit other open programs, and turn off virus protection utilities.
PAGE 28
FileMaker Web Server Connector Administrator’s Guide Where files are stored on your hard disk The following tables show the files and folders you install as part of the Web Server Connector installation. Folder location AppleShare IP File or folder Description Macintosh HD:FileMaker WSC 5 License FM WSC license JSDK License Java license ReadMe FM Read Me FMWSC Configuration Page Link to configuration page FMWSCResources.jar Strings and HTML pages used by the WSC FMWSC.
PAGE 29
Chapter 6 Installing the FileMaker Pro Web Server Connector on Apache (Mac OS X Server) This chapter explains how to install the FileMaker Pro Web Server Connector on Apache (Mac OS X Server). Installing with Apache Important Before you begin the installation process, save your work and exit other open programs, and turn off virus protection utilities. Remember to turn on virus protection utilities again when the installation is complete. 1. Insert the Web Server Connector CD-ROM into the CD-ROM drive. 2.
PAGE 30
FileMaker Web Server Connector Administrator’s Guide Note The original apache.conf file is renamed apache.conf.prefmwsc.[temp ID number] as part of the installation process. Temp ID number is used to differentiate previous copies of apache.conf; no apache.conf files are overwritten as part of the installation. If you need to restore your original (or a subsequent) apache.conf file, delete the file named apache.conf, which is the most recent configuration file, and rename the apache.conf.prefmwsc.
PAGE 31
Installing the FileMaker Pro Web Server Connector on Apache (Mac OS X Server) 5. Edit FMWSC_Apache.sh by doing the following: Parameter 1 Change the -root parameter to point to the directory on the remote -allow Allowed IP addresses (default=127.0.0.1) machine used as the root document directory. Change the -mimetypes parameter to point to the mime.types file in the FMWSC directory.
PAGE 32
FileMaker Web Server Connector Administrator’s Guide Where files are stored on your hard disk The following tables show the files and folders you install as part of the Web Server Connector installation. Folder location Apache (Mac OS X Server) File or folder Description /fmwsc/bin/ FMWSC_Apache.sh Shell script /fmwsc/ Configure.txt Instructions for installation JSDKLicense.txt License FMWSC.jar Servlet FMWSCResources.
PAGE 33
Chapter 7 Using the Web Server Connector as host With the FileMaker Pro Web Server Connector, you can use your compatible web server software to share databases over the Web from a single host or from multiple hosts. This chapter explains how to: 1 configure FileMaker Pro 5 Unlimited for use with the Web Server Configuring the FileMaker Pro Web Companion 1. Launch the FileMaker Pro 5 Unlimited application. 2. Choose Edit menu > Preferences > Application. Connector 3.
PAGE 34
FileMaker Web Server Connector Administrator’s Guide If you see the words IP Guest Limit: 10, then FileMaker Pro 5 Unlimited is not installed, or was not installed with the correct installation code. Uninstall FileMaker Pro 5, and reinstall FileMaker Pro 5 Unlimited using the installation code included with the FileMaker Pro 5 Unlimited software. See the FileMaker Pro 5 Getting Started Guide for more information about installing and uninstalling FileMaker Pro.
PAGE 35
Using the Web Server Connector as host Configuring the Web Server Connector Administration Account You must configure an Administration Account the first time you use the Web Server Connector. 1. Open the Web Server Connector. Depending on your web server software, do one of the following: 1 For IIS and PWS: On the web server, choose Start menu > Programs > FileMaker WSC IIS > FileMaker WSC Admin.
PAGE 36
FileMaker Web Server Connector Administrator’s Guide Click to go to the Add Host page 5. In the Add Host page, for Host, enter the IP address or domain name of the machine hosting the database. 1 If the database is hosted by the same computer as your server software, enter the same IP address or domain name of your server. 1 If the database is hosted by a different computer, enter the IP address or domain name of that machine.
PAGE 37
Using the Web Server Connector as host 37 Adding a database to the Web Server Connector Configuring by database provides a useful interface for bringing databases into or out of a RAIC. When you configure by database, you see a list of all databases currently hosted by the Web Server Connector. This feature allows you to see at a glance the number of hosts shared by individual databases. Enable all appropriate checkboxes 1. If you are already logged on to the Web Server Connector, go to step 5. 2.
PAGE 38
FileMaker Web Server Connector Administrator’s Guide 6. In the Configure by Database page, click the Add Database button. 8. For Host Domain Name/IP Address, enter the IP address or domain name of the database’s host. Tip If the database is shared from the same computer as the web server software, enter localhost as the domain name. 9. For Port, enter the port number of the host. Important Make sure the port number matches that of the host, or the Web Server Connector cannot serve your database. 10.
PAGE 39
Using the Web Server Connector as host Removing a database from the Web Server Connector Web server Log file location 1. In the Web Server Connector, click Configure by Database. WebSTAR Macintosh HD:WebSTAR Server Suite 4.0:FileMaker WSC 5:fmwsc.properties Apache [install location]/lib/FMWSC.properties 2. Enable the Remove checkbox to the left of each database you want to remove. 39 3. Click the Remove Database(s) button.
PAGE 40
FileMaker Web Server Connector Administrator’s Guide To find information about FileMaker Pro 5 Unlimited Web Companion log files: 1. Launch FileMaker Pro 5 Unlimited. 2. Choose Help menu > Contents and Index. 3. Click the Index tab. 4. Type Web Companion. 5. Choose Tracking web activity in log files from the list of topics that appear beneath the Web Companion index entry.
PAGE 41
Chapter 8 Accessing hosted databases After the databases are hosted by FileMaker Pro 5 Unlimited, and the Web Server Connector is installed and configured, you are ready to access your FileMaker Pro databases over the Internet or intranet. This chapter explains how to point end users to databases hosted by the Web Server Connector. Connecting to databases served by Custom Web Publishing Point your web browser to the HTML page or index page for the database you want to access.
PAGE 42
This page intentionally left blank.