FileMaker Unlimited 5 Administrator's Guide

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. 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.
This page intentionally left blank.
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 your hard disk
Where to go from here
9
Chapter 4
Installing the FileMaker Pro Web Server Connector on
Netscape Enterprise Server
Chapter 2
About the Web Server Connector
Configurations
Configuration 1: FileMaker Pro 5 Unlimited on a
single machine
Configuration 2: FileMaker Pro 5 Unlimited, the
Web Server Connector, and web server software on a
single machine
Configuration 3: FileMaker Pro 5 Unlimited on one
machine, the Web Server Connector on another
machine
Configuration 4: RAIC with multiple copies of the
same databases
Configuration 5: RAIC with multiple, different databases
Configuration 6: RAIC using FileMaker Server 5 as a
backend host
Configuration 7: RAIC using FileMaker Pro as a
backend host
Security considerations
Where to go from here
Chapter 3
Installing the FileMaker Pro Web Server Connector on
Microsoft IIS and PWS
9
Installing with Netscape Enterprise Server
Uninstalling the FileMaker Pro Web Server Connector
Where to go from here
Where files are stored on your hard disk
15
16
16
17
17
21
22
22
23
10
10
11
11
12
12
13
13
Chapter 5
Installing the FileMaker Pro Web Server Connector with
AppleShare IP and WebSTAR
Installing with AppleShare IP and WebSTAR
Considerations after installation
Where to go from here
Where files are stored on your hard disk
27
27
27
28
Chapter 6
Installing the FileMaker Pro Web Server Connector on
Apache (Mac OS X Server)
Installing with Apache
Considerations when installing and configuring
Changing the port number
29
30
30
iv
FileMaker Web Server Connector Administrator’s Guide
Running on a remote machine
FMWSC_Apache.sh parameters
Changing the VM settings and Classpath
Where to go from here
Where files are stored on your hard disk
30
31
31
31
32
Chapter 7
Using the Web Server Connector as host
Configuring FileMaker Pro
Configuring the FileMaker Pro Web Companion
Configuring FileMaker Pro databases for web serving
Configuring the Web Server Connector Administration Account
Adding a host to the Web Server Connector
Removing a host from the Web Server Connector
Adding a database to the Web Server Connector
Removing a database from the Web Server Connector
Configuring the Web Server Connector Administration Account
Resetting the administrator account
Locating Web Server Connector and Web Companion log files
33
33
34
35
35
37
37
39
39
39
39
Chapter 8
Accessing hosted databases
Connecting to databases served by Custom Web Publishing
Connecting to databases served by Instant Web Publishing
41
41
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.
This FileMaker Web Server Connector Administrator’s Guide tells
you how to install and configure the Web Server Connector software
on each of the six supported web servers.
Note Documentation for the FileMaker Pro 5 Unlimited application
is available on the FileMaker Pro 5 Unlimited CD-ROM, included
with this package.
Registration and customer support
Please take the time to complete and mail the registration card for
your product, or register online at www.filemaker.com/register or by
choosing Help menu > FileMaker on the Web in FileMaker Pro.
For information about technical support and customer service, see:
www.filemaker.com (North American customers)
www.filemaker.com/intl (customers outside North America)
or choose Help menu > FileMaker on the Web from the FileMaker Pro
application. At the web site, you will find the FileMaker, Inc. Service
Directory, which details the service options available to North
American customers, as well as links to FileMaker, Inc. international
sites, answers to frequently asked questions, and access to extensive
software libraries used by technical support staff. If you do not have
access to the Web, please refer to the Technical Support and
Customer Service sheet included in the software box. North America
customers can also call 1-800-965-9090 to learn about the service
options available.
Before you begin
Minimum hardware and software requirements for the
FileMaker Pro Web Server Connector
To install and use FileMaker Pro Web Server Connector, you need the
Web Server Connector CD-ROM in the FileMaker Pro Unlimited
package and the following minimum equipment and software.
Windows:
1 a hard disk with at least 1 MB of free space
1 a CD-ROM drive
1 Windows 98, Windows 95, Windows NT 4.0 (with Service Pack 3
or later)
1
Java™ Runtime Environment (JRE) 1.1.8
Mac OS:
1
1
1
1
a hard disk with at least 1 MB of free space
a CD-ROM drive
Mac OS 8.6 or later
Mac OS Runtime Java (MRJ) 2.1.4
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.6
Term
Definition
Active database
A database configured through the Web Server
Connector and hosted by a FileMaker Web Companion.
CDML
Claris Dynamic Markup Language, a collection of
proprietary tags used to command FileMaker Pro
databases via a web browser.
Client
A guest accessing a FileMaker Pro database.
Configured database A database configured through the Web Server
Connector, but not yet hosted by a FileMaker Web
Companion.
Fail-over
An internal procedure to switch to the next available host
in a RAIC if the Web Server Connector loses contact
with a previously available host.
To publish a database on the Web using the FileMaker Pro Web
Companion, you need a host computer with continuous access to the
Internet or an intranet via TCP/IP.
Format file
An HTML page that contains CDML tags.
HTML
HyperText Markup Language, the text-based code that
is used for formatting web pages.
Important Access to the Internet requires an Internet service provider
(ISP). FileMaker Pro does not provide an Internet account for you.
Local host, localhost A machine hosting a database, when the database
physically resides on that machine.
Web publishing requirements
Node
A machine in a RAIC that hosts files via the
FileMaker Pro 5 Unlimited Web Companion.
Plug-in
Software that extends the capabilities of an application
in a specific way. FileMaker Pro Web Companion and
ODBC Data Access Companions are FileMaker Pro
plug-ins.
RAIC
Redundant Array of Inexpensive Computers. A RAIC
links two or more computers to a web server, and uses
redundancy to increase throughput and provide fault
tolerance.
Remote host
A machine hosting a database that physically resides on
another machine.
Where to place database and HTML files
Keep the following points in mind:
1 Place database files on the same machine as their FileMaker Pro 5
Unlimited or FileMaker Server 5 host, because this arrangement
provides the best performance. Databases do not need to be stored in
any particular location to function properly.
1
Dynamic web pages that reference FileMaker Pro must reside on
the same machine as their FileMaker Pro 5 Unlimited host, in the
Web folder located within the FileMaker Pro folder.
1 Static HTML and image files should reside on your web server, as
specified by your web server software.
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.
7
This page intentionally left blank.
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. This built-in functionality enables FileMaker Pro to
function as a web server, delivering data from FileMaker Pro 5 files
to a web browser. Data shared in this manner through the Web
Companion can be accessed from client machines that have
appropriate network access and browser software.
With the FileMaker Web Server Connector you can extend the
functionality of FileMaker Pro to:
1
Configurations
Many different configurations are possible with the Web Server
Connector. In some cases, you can combine elements of several
configurations to meet your needs.
When used in a RAIC, the performance of the Web Server Connector
has been optimized for use with up to five RAIC machines. You can
continue to see performance gains beyond this number, but the
benefits of adding machines will be less significant.
Configuration 1: FileMaker Pro 5 Unlimited on a
single machine
Web
Browser
Web
Browser
Web
Browser
Web
Browser
take advantage of other plug-ins and features of your web server,
including secure socket layer (SSL) protection and server-side includes
1
1
configure a RAIC to increase throughput and reliability
FileMaker Pro 5
Unlimited CPU
store static elements such as graphic images on the web server,
bypassing the FileMaker Pro Web Companion for pages that do not
contain Instant Web Publishing, XML, or CDML elements
In addition to these server-derived benefits, the FileMaker Web
Server Connector lets you:
1 organize and configure the sharing of databases
1 host by multiple, separate installations of FileMaker Pro 5 Unlimited
1 configure the sharing of databases by host or by database
1 detect when the Web Companion on one machine is not responding,
and redirect requests to the next available machine in a RAIC
Clients.fp5
Sales.fp5
Catalog.fp5
In this configuration, one or more databases are hosted on a single
machine. FileMaker Pro 5 Unlimited acts as a web server and
database host using its built-in Web Companion plug-in.
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.fp5
FileMaker Pro 5
Unlimited CPU
Catalog.fp5
Clients.fp5
In this configuration, FileMaker Pro 5 Unlimited and the Web Server
Connector are installed directly on the web server machine. This
configuration delivers the server-derived benefits of the Web Server
Connector, but it is not recommended for performance reasons.
Sales.fp5
Catalog.fp5
In this configuration, FileMaker Pro 5 Unlimited hosts databases on
one machine, and the Web Server Connector resides on another. This
is a preferred configuration, because you are able to take advantage
of the server-derived benefits of the Web Server Connector using
only two machines.
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. When the contents of a record are duplicated in other
databases, it is difficult to reconcile changes.
Important Using read-only databases in this type of RAIC is strongly
recommended.
Web Server
Configuration 5: RAIC with multiple, different databases
Web
Server
Connector
Web
Browser
FileMaker Pro 5
Unlimited CPU
FileMaker Pro 5
Unlimited CPU
Web
Browser
Web
Browser
Web
Browser
FileMaker Pro 5
Unlimited CPU
Web Server
Catalog.fp5
Catalog.fp5
Web
Server
Connector
Catalog.fp5
In this configuration, identical copies of the same database(s) are
hosted from multiple copies of FileMaker Pro 5 Unlimited. The Web
Server Connector channels the request to the next available database
in the RAIC, according to the internal list kept by the Web Server
Connector.
This is an excellent configuration for serving data such as a catalog.
The redundancy of sharing multiple copies of the same database
produces excellent throughput, speed, and fail-over protection: if a
host crashes or is brought off line, the Web Server Connector moves
to the next host on its internal list.
FileMaker Pro 5
Unlimited CPU
FileMaker Pro 5
Unlimited CPU
FileMaker Pro 5
Unlimited CPU
Sales.fp5
Catalog.fp5
Invoice.fp5
Orders.fp5
Clients.fp5
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.
Configuration 6: RAIC using FileMaker Server 5 as a
backend host
Web
Browser
Web
Browser
Web
Browser
Web
Browser
In this configuration, FileMaker Server 5 hosts all of the databases.
The nodes of the RAIC open the databases as guests of FileMaker
Server 5, sharing through the Web Companion in each copy of
FileMaker Pro Unlimited.
This arrangement offers excellent throughput, because the Web
Server Connector can provide load balancing and fail-over
protection. FileMaker Server 5 also off-loads functions such as
sorting and summary field calculations to guest machines, so these
tasks are handled rapidly. You can read and write to the databases in
this type of RAIC, because each database exists once on the server.
And, you can use the backup and restore features of FileMaker
Server 5, providing you with added data security.
Configuration 7: RAIC using FileMaker Pro as a
backend host
Web Server
Web
Server
Connector
FileMaker Pro 5
Unlimited CPU
FileMaker Pro 5
Unlimited CPU
Web
Browser
Web
Browser
FileMaker Pro 5
Unlimited CPU
Web
Browser
Web
Browser
Web Server
Web
Server
Connector
FileMaker
Server 5 CPU
FileMaker Pro 5
Unlimited CPU
Clients.fp5
Sales.fp5
FileMaker Pro 5
CPU
FileMaker Pro 5
Unlimited CPU
Catalog.fp5
Clients.fp5
Sales.fp5
Catalog.fp5
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. If
FileMaker Pro 5 Unlimited is used in place of FileMaker Pro 5, then
this machine can also be used as a RAIC machine for added
performance.
As in the previous RAIC configuration, this structure provides the
advantages of load balancing and fail-over protection. Because there
is a single instance of each database, you can read and write to these
files.
Security considerations
To ensure proper authentication, make sure all nodes of the RAIC
have consistent security. For example, you may experience
unexpected behavior if you enable security on one machine but not
on other machines in the RAIC, or if your FileMaker Pro 5
passwords are different across the nodes of the RAIC.
13
Where to go from here
To install the FileMaker Web Server Connector, go to the chapter
that is appropriate for your specific server installation.
For instructions on installing the
Web Server Connector on
See
Microsoft Internet Information Server
Microsoft Personal Web Server
Chapter 3, “Installing the FileMaker
Pro Web Server Connector on
Microsoft IIS and PWS”
Netscape Enterprise Server
Chapter 4, “Installing the FileMaker
Pro Web Server Connector on
Netscape Enterprise Server”
AppleShare IP
Chapter 5, “Installing the FileMaker
Pro Web Server Connector with
AppleShare IP and WebSTAR”
WebSTAR
Mac OS X Server
Chapter 6, “Installing the FileMaker
Pro Web Server Connector on Apache
(Mac OS X Server)”
This page intentionally left blank.
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.
Installing with Microsoft Internet Information
Server and Microsoft Personal Web Server
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. Remember to
turn on virus protection utilities again when the installation is
complete.
Note Internet Information Server or Personal Web Server must be
installed prior to the installation of the FileMaker Pro Web Server
Connector. For IIS or PWS installation instructions, refer to the
documentation included with your web server software.
Windows NT Server/IIS If you use the FileMaker Pro 5 Web Security
database to control user name and password access, you must establish
Windows NT accounts with these same user names and passwords. IIS
authenticates these before passing them on to FileMaker Pro.
Windows NT Workstation/PWS If you are installing the Web Server
Connector on Windows NT Workstation with PWS, you must disable
Basic Authentication prior to installing the Web Server Connector.
To disable Basic Authentication, Internet Connection Services for
RAS must be installed, as it is required to access the Internet Services
Manager. Installing Internet Connection Services for RAS is an
option in the Windows NT 4.0 Option Pack installer. If Internet
Connection Services for RAS was not installed as part of the Option
Pack 4.0 installation, you must uninstall the Option Pack and
reinstall it with this option enabled. Refer to the documentation
included with your server software for instructions on this procedure.
To install the Web Server Connector:
1. Insert the Web Server Connector CD-ROM into the CD-ROM
drive.
2. Click the arrow next to Install FileMakerWSC5-IIS to begin the
installation.
Click this
arrow
3. In the Welcome screen, click Next.
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.
Tip On Windows NT, a -401 (“Invalid User Name”) error can
indicate that a user name and password have not been registered with
the operating system. When using the FileMaker Web Server
Connector on Windows NT, use the same user name and password
for Windows NT and the FileMaker Pro databases you intend to host.
IIS instructs Windows NT to authenticate these before passing them
on to FileMaker Pro.
Important Do not change the default installation location.
The Web Server Connector is now running. See chapter 7, “Using
the Web Server Connector as host,” for configuration instructions.
Uninstalling the FileMaker Pro Web Server
Connector
1. Stop IIS/PWS services.
2. Open the Add/Remove Programs control panel.
Accept the
default location
The Web Server Connector files are installed.
Note The Web Server Connector stops installation if it detects
another, previously installed servlet engine on your web server. For
information about installing the Web Server Connector with other
servlet engines, see the ReadMe file in the Unsupported folder (Web
Server Connector CD-ROM\Unsupported\ReadMe).
7. Restart your server to launch the Web Server Connector.
3. In the Install/Uninstall tab, select FileMaker WSC 5-IIS from the list.
Note The Uninstall command removes all files that have been
installed, but does not remove files generated by the Web Server
Connector after it has been launched. Examples of files not removed
include .PROPERTIES files, .LOG files, and ISAPI filter entries,
which must all be removed manually.
4. Click Add/Remove.
It is recommended that you restart your server at this time.
Removing the ISAPI filter entry
Windows NT users If you are installing the Web Server Connector on
Windows NT, you must enable Basic (Clear Text) Password
Authentication before configuring the Web Server Connector. Refer
to the documentation included with your server software for
instructions on this procedure.
1. Launch the Internet Service Manager application (IIS) or
Important Do not use high ASCII characters in user names, as these
may cause authentication failures.
Edit.
Microsoft Management Console (PWS).
2. Right-click on your server icon and choose Properties from the
context menu.
3. From the Master Properties menu, select WWW Service, then click
4. Select the ISAPI Filters tab.
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..
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 Microsoft IIS and PWS
c:\program files\ filemaker\ filemaker wsc 5 - IIS
c:\program files\filemaker\filemaker wsc 5 - IIS\jre
c:\program files\filemaker\filemaker wsc 5 - IIS\jre\bin
File or folder
Description
FileMaker WSC Admin.url
URL link file
JSDK License.txt
Java Servlet Development Kit license
License.txt
FileMaker, Inc., license
ReadMe.txt
FileMaker, Inc., Read Me
Unist.isu
Uninstall file for each FMWSC server installation
Changes
Java runtime environment file
Copyright
Java runtime environment file
Fixes.lst
Java runtime environment file
License
Java runtime environment file
ReadMe
Java runtime environment file
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.exe
Java runtime environment file
Math.dll
Java runtime environment file
Mmedia.dll
Java runtime environment file
Msvcrt.dll
Java runtime environment file
Net.dll
Java runtime environment file
17
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.properties
Java runtime environment library file
Font.properties.ar
Java runtime environment library file
Font.properties.be
Java runtime environment library file
Font.properties.bg
Java runtime environment library file
Font.properties.cs
Java runtime environment library file
Font.properties.el
Java runtime environment library file
Font.properties.et
Java runtime environment library file
Font.properties.hr
Java runtime environment library file
Font.properties.hu
Java runtime environment library file
Font.properties.iw
Java runtime environment library file
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.pl
Java runtime environment library file
Font.properties.ro
Java runtime environment library file
Font.properties.ru
Java runtime environment library file
Font.properties.s2
Java runtime environment library file
Font.properties.sk
Java runtime environment library file
Font.properties.sl
Java runtime environment library file
Font.properties.th
Java runtime environment library file
Font.properties.tr
Java runtime environment library file
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.zh_TW
Java runtime environment library file
I18n.jar
Java runtime environment library file
Math.jar
Java runtime environment library file
Rt.jar
Java runtime environment library file
Java.security
Java runtime environment security file
19
FMWSC.jar
FileMaker Web Server Connector servlet
FMWSCResources.jar
Strings and supporting HTML pages for WSC servlet
Servlet.jar
Servlet API
FMWSC_NSAPI.dll
Plug-in API
This page intentionally left blank.
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. In the Read Me screen, view the contents for any late-breaking
information about the Web Server Connector, then click Next.
Installing with Netscape Enterprise Server
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. Remember to
turn on virus protection utilities again when the installation is
complete.
6. In the Choose Destination Location installation dialog box, click
Next.
Important It is recommended that you install the Web Server
Connector in the default installation location, because you may
experience inconsistent results if the Web Server Connector is
installed elsewhere.
1. Insert the Web Server Connector CD-ROM into the CD-ROM
drive.
2. Click the arrow next to Install FileMakerWSC5-NES to begin the
installation.
Accept the
default location
Click this
arrow
3. In the Welcome screen, click Next.
7. Click Next to install the Web Server Connector files.
Note The Web Server Connector stops installation if it detects
another, previously installed servlet engine on your web server. For
information about installing the Web Server Connector with other
servlet engines, see the ReadMe file in the Unsupported folder (Web
Server Connector CD-ROM\Unsupported\ReadMe).
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. See chapter 7, “Using
the Web Server Connector as host,” for configuration instructions.
Uninstalling the FileMaker Pro Web
Server Connector
1. Stop NES services.
2. Open the Add/Remove Programs control panel.
3. In the Install/Uninstall tab, select FileMaker WSC 5-NES from the list.
4. Click Add/Remove.
Where to go from here
See chapter 7, “Using the Web Server Connector as host,” for
instructions to configure the Web Server Connector for use.
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.class
Configure file for each server installation, as NES allows multiple
server installations on a single machine
FileMaker WSC Admin.url
URL link file
FMWSC_NSAPI.dll
Plug-in API
JSDK License.txt
Java Servlet Development Kit license
License.txt
FileMaker, Inc., license
ReadMe.txt
FileMaker, Inc., Read Me
Unist-https-[server name].isu
Uninstall file for each FMWSC server installation
VerifyObjConf.class
Configure file for each server installation, because NES allows
multiple server installations on a single machine
c:\program files\filemaker\filemaker wsc 5 netscape enterprise\https-[server name]
Verify.log
Server-specific component
VerifyObjConf.bat
Server-specific component
c:\program files\filemaker\filemaker wsc 5 netscape enterprise\https-[server name]\jre
Changes
Java runtime environment file
Copyright
Java runtime environment file
Fixes.lst
Java runtime environment file
License
Java runtime environment file
ReadMe
Java runtime environment file
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.exe
Java runtime environment file
Math.dll
Java runtime environment file
Mmedia.dll
Java runtime environment file
Msvcrt.dll
Java runtime environment file
Net.dll
Java runtime environment file
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.properties
Java runtime environment library file
Font.properties.ar
Java runtime environment library file
Font.properties.be
Java runtime environment library file
Font.properties.bg
Java runtime environment library file
Font.properties.cs
Java runtime environment library file
Font.properties.el
Java runtime environment library file
Font.properties.et
Java runtime environment library file
Font.properties.hr
Java runtime environment library file
Font.properties.hu
Java runtime environment library file
Font.properties.iw
Java runtime environment library file
c:\program files\filemaker\filemaker wsc 5 netscape enterprise\https-[server name]\jre\lib
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.pl
Java runtime environment library file
Font.properties.ro
Java runtime environment library file
Font.properties.ru
Java runtime environment library file
Font.properties.s2
Java runtime environment library file
Font.properties.sk
Java runtime environment library file
Font.properties.sl
Java runtime environment library file
Font.properties.th
Java runtime environment library file
Font.properties.tr
Java runtime environment library file
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.zh_TW
Java runtime environment library file
I18n.jar
Java runtime environment library file
Math.jar
Java runtime environment library file
Rt.jar
Java runtime environment library file
c:\program files\filemaker\filemaker wsc 5 Java.security
netscape enterprise\https-[server name]\jre\lsecurity
Java runtime environment security file
c:\program files\filemaker\filemaker wsc 5 netscape enterprise\https-[server name]\lib
FMWSC.jar
FileMaker Web Server Connector servlet
FMWSCResources.jar
Strings and supporting HTML pages for WSC servlet
Servlet.jar
Servlet API
25
This page intentionally left blank.
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. Remember to
turn on virus protection utilities again when the installation is
complete.
1. Shut down the AppleShare IP server or WebSTAR server if they
are active. For information about doing this, see the documentation
that came with your server.
2. Insert the Web Server Connector CD-ROM into the CD-ROM
drive on the web server machine.
Note The Web Server Connector stops installation if it detects
another, previously installed servlet engine on your web server. For
information about installing the Web Server Connector with other
servlet engines, see the ReadMe file in the Unsupported folder (Web
Server Connector CD-ROM\Unsupported\ReadMe).
8. When the installation is complete, click Quit.
9. Restart your server to launch the Web Server Connector.
The Web Server Connector is now running. See chapter 7, “Using
the Web Server Connector as host,” for configuration instructions.
Considerations after installation
AppleShare IP requires that you share the AppleShare IP Web folder.
It is important that you restrict access to the FMWSC.properties and
FMWSC.log files after installation. These files are stored in the Web
folder, and items with unrestricted access may be available through
a client’s web browser.
3. Double-click the FileMaker WSC 5 icon to begin the installation.
4. In the Software License Agreement screen, click Accept if you
agree to the terms of the license agreement.
5. In the Read Me screen, view the contents for any late-breaking
information about the Web Server Connector, then click Continue.
6. In the FileMaker Web Server Connector dialog box, choose Select
Folder from the Install Location pop-up menu.
7. Select the Web folder currently being used as the root directory for
AppleShare IP or WebSTAR.
Where to go from here
See chapter 7, “Using the Web Server Connector as host,” to begin
configuring the Web Server Connector for use.
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.jar
Servlet
Servlet.jar
Servlet API
Macintosh HD:FileMaker WSC 5:Plug-Ins
FMWSC
The Web Server Connector plug-in
Folder location WebSTAR
File or folder
Description
Macintosh HD:FileMaker WSC 5:lib
Macintosh HD:WebSTAR Server Suite 4.0:FileMaker License
WSC 5
JSDK License
Macintosh HD:WebSTAR Server Suite 4.0:lib
Macintosh HD:WebSTAR Server Suite 4.0:Plug-Ins
FM WSC 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.jar
Servlet
Servlet.jar
Servlet API
FMWSC
The Web Server Connector plug-in
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. Locate the file fmwsc.pkg.tar on the CD-ROM, and copy it to your
hard drive.
3. Double-click the file.
4. In the Archive Inspector dialog box, choose Unarchive.
5. Double-click the file fmwsc.pkg in the same directory as
fmwsc.pkg.tar.
6. In the FMWSC for Apache dialog box, click Install.
Important It is recommended that you install the Web Server
Connector in the default installation location.
7. Click Install to launch the Install Package script.
You see the message Installation completed if the installation
completes without error.
Important If you encounter an error during installation, click List in
the FMWSC for Apache dialog box to display the error. You must
resolve all errors before attempting installation again.
8. After installation is complete, click List to see a detailed report of
the names and locations of all installed files.
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.[temp ID number] file with the earliest date
and time stamp to apache.conf.
9. Launch FMWSC_Apache.sh, which is located in the directory
<fmwsc install dir>/bin.
Important Apache requires that you launch this script each time
before using the Web Server Connector. Once launched, the script
window must remain open for the Web Server Connector to function
properly. Proper functioning of this script does not necessarily
indicate that the FMWSC_Apache.so module (located in the Apache
Modules folder) is also functioning properly. If you experience
difficulties, you may need to use a means other than this script to
verify that the FMWSC_Apache.so module is running correctly.
10. Enter the following URL to access the Web Server Connector
Administration Account:
http://host server name/FMPro?config
where host server name is the host name of your server (for
example, www.filemaker.com).
11. To stop the Web Server Connector, press Ctrl+C in the terminal
window in which the Web Server Connector is running, or close the
window.
Considerations when installing
and configuring
Changing the port number
By default, the Web Server Connector is configured to only accept
requests on port 8888 from Apache. To change this port number:
1. Add the following line to the end of the apache.conf file:
FMWSC_Instances 127.0.0.1:<port number>
2. Restart the Apache web server.
3. Edit the FMWSC_Apache.sh file and add the following option to
the end of the java command:
-port <port number>
where <port number> is the port number you want to use.
4. Relaunch FMWSC_Apache.sh.
Running on a remote machine
By default, the FMWSC is installed on the same machine as the
Apache web server and only accepts requests from the local machine
(IP address 127.0.0.1). To run the Web Server Connector on a
remote machine:
1. Add the following line to the end of apache.conf:
FMWSC_Instances <ip address>
where <ip address> is the IP address of the machine on which the
Web Server Connector will run.
2. Restart the Apache Web Server.
3. Copy the FMWSC directory to the remote machine.
4. Copy the Apache mime.types file to the FMWSC directory on the
remote machine.
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 <ip1,ip2,etc.> 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.
1
Add the following parameter to the end of the Java command:
31
Description
The -allow parameter indicates the IP addresses which
can send requests to the FMWSC. You can specify an IP
address with an asterisk to indicate all values (for
example, 168.121.97.*).
-allow <ip address>
where <ip address> is the IP address of the machine on which the
Apache Web Server is running.
FMWSC_Apache.sh parameters
Changing the VM settings and Classpath
You can change the Java VM settings and Classpath. To do so,
modify the Java parameters that are passed to the Java command in
the FMWSC_Apache.sh file.
The FMWSC_Apache.sh file invokes the FMWSC_Apache Java
class, and passes parameters to it. The following table describes the
parameters this class accepts.
Where to go from here
Parameter
Description
-help
Displays a description of the parameters
After you install the FileMaker Pro Web Server Connector, see
chapter 7, “Using the Web Server Connector as host,” to begin
configuring the Web Server Connector for use.
-port <port number> Port number (default=8888)
The -port parameter indicates which port the Web
Server Connector listens on for incoming requests.
-backlog <length>
Incoming connection queue length (default=50)
The -backlog parameter indicates how many requests
are queued.
-root <directory>
Server's root document directory (mandatory)
The -root parameter indicates the root document
directory for the Apache web server.
-mimetypes <file>
Path to mime.types file (optional)
The -mimetypes parameter indicates the location of the
Apache server mime.types file.
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 install dir>/fmwsc/bin/
FMWSC_Apache.sh
Shell script
<fmwsc install dir>/fmwsc/
Configure.txt
Instructions for installation
JSDKLicense.txt
License
FMWSC.jar
Servlet
FMWSCResources.jar
Strings and HTML pages used by the Web Server Connector
FMWSC_Apache.jar
Apache file for servlet engine
Servlet.jar
Servlet API
/usr/local/fmwsc/src/
Mod_fmwsc.c
Raw code
/System/Library/Apache/Modules
Mod_fmwsc.so
Compiled shared object
/Local/Library/Receipts/
Fmwsc.pkg
FMWSC package file
<fmwsc install dir>/fmwsc/lib/
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. In the Application Preferences dialog box, click the Plug-Ins tab.
1
1
add, remove, and configure host computers
4. Enable the Web Companion checkbox.
add, remove, and configure shared databases
5. Click the Configure button to open the Web Companion
Configuration dialog box.
Configuring FileMaker Pro
Your shared databases must be properly configured for use with the
FileMaker Pro Web Companion.
Keep these points in mind:
1
For best performance and reliability, store FileMaker Pro
databases on the same computer as the FileMaker Pro application
that hosts them.
1
Each host machine must have a copy of FileMaker Pro 5
Unlimited.
1 The Web Server Connector can also share databases that are hosted
by FileMaker Server 5 and FileMaker Pro peer-to-peer networking,
if those databases are opened as guests by FileMaker Pro 5
Unlimited.
1
You must enable the Web Companion on each host machine.
The IP Guest Limit confirms that
FileMaker Pro 5 Unlimited is installed
6. Verify that you are using FileMaker Pro 5 Unlimited.
Look for the words IP Guest Limit: Unlimited in the lower-left corner of
the dialog box.
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.
Important If you are simultaneously sharing the database from the
same machine through another plug-in, such as LDAC or RDAC,
performance may be compromised.
Note During operation, the Web Server Connector verifies that it is
serving databases hosted from FileMaker Pro 5 Unlimited. Using the
Web Server Connector to serve databases from a version of
FileMaker Pro other than FileMaker Pro 5 Unlimited generates a
FileMaker Pro error.
7. For TCP/IP Port Number, port 80 is the default port for web servers.
If you enable the Web Companion on the same machine as the web
server, you must use a port number other than port 80. Consider
changing the TCP/IP port number to 591. FileMaker, Inc. has
registered port number 591 with the Internet Assigned Numbers
Authority (IANA) for use with FileMaker Pro Web Companion.
Note To optimize performance, run your web server from a
dedicated machine and use other machines as the RAIC nodes.
Configuring FileMaker Pro databases for
web serving
3. In the Companion Sharing area, enable the Web Companion
checkbox.
4. Click OK.
5. Verify that the databases you intend to share are correctly
configured by pointing your web browser to the IP address of each
database host machine.
Important If a database is not shared by a Web Companion, it cannot
be used by the Web Server Connector.
Once you have configured the FileMaker Pro Web Companion, you
are ready to open your databases on the host machine.
Important For troubleshooting purposes, verify that each potential
node of a RAIC setup is working properly before configuring a
RAIC structure with the Web Server Connector.
To share a database using the Web Companion:
Once your databases are open and being shared by the FileMaker Pro
Web Companion, you are ready to configure the Web Server
Connector.
1. Open each database you want to host in FileMaker Pro 5
Unlimited.
2. For each database, choose File menu > Sharing.
You can share databases via the Web Companion independent of
your FileMaker Network Sharing selection.
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.
Adding a host to the Web Server Connector
All administrative interaction with the Web Server Connector is
performed through a web browser.
1. Point your browser to the FileMaker WSC Admin page, as
described in the previous section.
2. If prompted, enter your user name and password.
3. In the first page of the Web Server Connector, click the Configure
by Host link.
1
For NES: On the web server, choose Start menu > Programs >
FileMaker WSC NES > FileMaker WSC Admin.
1
For AppleShare IP and WebSTAR: On the web server, launch the
file FMWSC Configuration Page, located in the FileMaker WSC
folder.
1
For Apache, or to configure the Web Server Connector remotely:
Point your browser to the IP address or domain name of your web
server using the address
http://your IP address or domain name/FMPro?config
Click to go to the
Configure by
Host page
Use the format 123.456.789.123 or www.yourdomainname.com for
your IP address or domain name.
Apache FMPro?config is case sensitive, and must be entered exactly
as it appears here.
Tip If the database is shared from the same computer as the web
server software, you may enter localhost as the domain name.
2. Enter a user name and password at the prompt.
Use the same user name and password as for administrator-level
access to your web server.
Note IIS users, enter a user name only.
35
4. In the Configure by Host page, click the Add Host button.
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.
Tip If the database is shared from the same computer as the web
server software, you may enter localhost as the domain name.
Enter the IP
address or
domain name
Enter the port
number
6. For Port, enter the port number used by the Web Companion on
the RAIC node machine, then click Next.
Important If your web server machine is functioning as a node of the
RAIC, this will likely be port 591 for this machine, as most web
servers use port 80 as their default port. For all RAIC nodes, make
sure the port number matches that of the RAIC node machine.
Otherwise, the Web Server Connector cannot serve your database.
7. Enable the Serve Database checkbox to the right of each database
you want to serve.
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. Prepare your databases for sharing via the FileMaker Pro Web
Companion, as described in “Configuring the FileMaker Pro Web
Companion” on page 33.
8. Click the Submit button to send your information to the Web
Server Connector.
You see the message Host Updated. This confirms that your changes
were made.
3. Open the Web Server Connector, as described on page 35.
4. Enter the administrator user name and password at the prompt.
5. From the first page of the Web Server Connector, or from the top
of any subsequent page, click the Configure by Database link.
9. Repeat steps 3 through 8 for each host.
Removing a host from the Web Server Connector
1. In the Web Server Connector, click Configure by Host.
2. Select the Remove checkbox to the left of each host you want to
remove.
3. Click the Remove Host(s) button.
Click to go to the
Configure by
Database 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. Click the Submit button to send your information to the Web
Server Connector.
You see the message Database Updated. This confirms that your
changes were made.
Click to go to
the Database
Detail page
11. Repeat steps 5 through 10 for each database you want to add.
Tip You can use the Configure by Database page to configure
databases for sharing through the Web Server Connector even if
those databases aren’t currently hosted.
7. In the Database Detail page, for Database Name, enter the name of
the database you want to serve.
To do this:
1. Launch FileMaker Pro 5 Unlimited on each machine you intend to
host from, and make sure that each Web Companion is properly
configured for sharing.
2. Enter the name of each database and its port number in the
Configure by Database page.
Enter the
database
name
Enter the IP address
or domain name
Enter the port number
The Web Server Connector will allow you to enter databases on the
Configure by Database page without verifying that the databases are
currently available over the network, as long as users don’t try to
access the databases via a browser before they are hosted.
3. Host the database.
This same technique is useful for switching the port numbers of
databases that are already being shared through the Web Server
Connector.
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.
Configuring the Web Server Connector
Administration Account
The Web Server Connector uses an Administration Account name
and password to control access and prevent unauthorized changes.
Because the Web Server Connector runs on top of your web server
software, the Administration Account user name and password must
correspond to those of an existing account on your web server. For
Windows NT Server, this account must also have Administratorlevel access to the directories your web pages are stored in.
Resetting the administrator account
If you forget or lose your Web Server Connector administrator
password, you can reset it by deleting the fmwsc.properties file and
restarting your web server. This file is recreated the next time the
Web Server Connector is launched.
The fmwsc.properties file is located as follows:
Locating Web Server Connector and Web
Companion log files
The Web Server Connector and the FileMaker Pro Web Companion
each generate log files which are useful for troubleshooting
purposes. The Web Server Connector log files can help you diagnose
problems with the Web Server Connector on your web server, and
the Web Companion log files can help you isolate problems on
individual database host machines.
There are two Web Server Connector log files, FMWSC.log and
FMWSCNative.log. These files list the date and time of each server
start and close event, as well as all errors reported by the servlet
engine and the relay servlet.
Log files are located on the supported web servers as follows:
Web server
Log file location
PWS
Root of the Web folder
IIS
c:\program files\filemaker\filemaker wsc 5 - IIS\
FMWSC.log
Web server
Log file location
PWS
Root of the Web folder
NES
IIS
c:\program files\filemaker\filemaker wsc 5 - IIS\lib\
fmwsc.properties
c:\program files\filemaker\filemaker wsc 5 - NES\
FMWSC.log
AppleShareIP
Macintosh HD:FileMaker WSC 5
NES
c:\program files\filemaker\filemaker wsc 5 - NES\
mwsc.properties
WebSTAR
Macintosh HD:WebSTAR Server Suite 4.0:FileMaker
WSC 5:log
AppleShareIP
Macintosh HD:FileMaker WSC 5:fmwsc.properties
Apache
[install location]/FMWSC.log
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.
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.
http://web server IP address or domain name/
mysolution.htm
Use the format 123.456.789.123/mysolution.htm or
www.yourdomainname.com/mysolution.htm for web server IP
address or domain name/mysolution.htm.
For more information about FileMaker Pro Custom Web Publishing,
see the Web ReadMe.htm file in the Web folder in the FileMaker
Pro 5 folder.
Connecting to databases served by
Instant Web Publishing
1. Point your web browser to the IP address or domain name of the
web server.
http://web server IP address or domain name/
Use the format 123.456.789.123 or www.yourdomainname.com for
web server IP address or domain name.
You see the FileMaker Pro default page and a list of links to the
currently shared databases.
For more information about FileMaker Instant Web Publishing, see
chapter 14 of the FileMaker Pro User’s Guide.
2. From the list, click the database you want to access.
This page intentionally left blank.