Appendix D Server Extensions for Microsoft FrontPage

This appendix describes using server extensions on your Netscape Enterprise Server that provide support for Microsoft's FrontPage. These extensions provide the internal server-side support you need if you are using FrontPage webs.

• Overview
• Downloading the Extensions
• Installing FrontPage Server Extensions
• Further Information

• When a user moves a page between folders in a FrontPage web, the extensions automatically update all links to that page from every other page in the web.
• You can specify which users have permission to administer, author or browse a FrontPage web.
• When Front Page web users participate in a discussion group, the extensions take advantage of the available WebBots to maintain an index of links to discussion articles, tables of contents, and search forms.

• As private domain names, such as www.mycompany.com. These are usually implemented as virtual servers on the same physical server machine using multi-hosting. Private domain name customers each get their own root web and have the option of creating sub-webs.
• As a common or shared domain but with private virtual servers, as in www.mycompany.myprovider.com, where myprovider.com is a shared domain and www.mycompany is a private virtual server. Private virtual server customers on a shared domain each get their own root web and have the option of creating sub-webs.
• As a URL on an Internet service provider's server machine, as in www.myprovider.com/mycompany. URL customers get a single sub-web.

• FrontPage 97 Server Extensions (version 2.0):

• [NT] You can download an executable file.
• [Unix] You can download from Ready-to-Run Software's web site and install script and a set of server extensions. Download two tar files for your platform (for Solaris, they are vt20.solaris.tar.z and wpp.solaris.tar.z, which is part of the WPP Kit Software).
• [Unix] You can download from Microsoft's web site an install script and a set of server extensions. Download two tar files for your platform (for Solaris, they are vt20.solaris.tar.z and wpp.solaris.tar.z, which is part of the WPP Kit Software.)
• FrontPage 98 Server Extensions (version 3.0):

• [NT] You can download an executable file.
• [Unix] You can download from Ready-to-Run Software's web site an install script and a set of server extensions. Download the fp_install.sh file and the tar file for your platform (for Solaris, it is fp30.solaris.tar.z)
• [Unix] You can download from Microsoft's web site an install script and a set of server extensions.Download the fp_install.sh file and the tar file for your platform (for Solaris, it is fp30.solaris.tar.z).

1. From the Enterprise Server, choose System Preferences.
2. Click the Dynamic Configuration Files link.
3. Click the "Base Directory from URL" radio button.
4. Enter .nsconfig in the File Name field.
5. Click the Subdirectories radio button in the Search section.
6. Click OK.
7. Click Save and Apply.

• Do not remove any of the internal files needed by FrontPage such as the .nsconfig file. Doing so disables access control for content upload.
• You cannot set a web to be restricted to valid end-users only. If you set this, you receive a message that says "This server does not support restricting end user access."
• [Unix only] The Netscape server /config directory needs to be readable by the process ID that the Netscape server runs at in steady-state A default install of the Netscape server makes this directory only readable by root, so you need to reconfigure this access permission.
• [Unix only] The document root directory for the Netscape server must be writeable by the steady-state server process ID so that FrontPage webs can be created via the NSAPI.

• Windows NT systems
• Unix systems - FrontPage97 extensions
• Unix systems - FrontPage98 extensions

1. Run the server extensions setup program for your language and processor type.

For example, for English FrontPage98 extensions, it is the fp98ext_x86_enu.exe file. The server extensions are copied to the folder C:\Program Files\MicrosoftFrontPage\Version 2.0 or \Version 3.0. During this process, your web server is stopped to make sure that files are not locked by the running web server. As soon as the copy is complete, the web server is started and remains running for the remainder of the installation process. The stub server extensions are installed on each root web and sub-web. On a single-hosted server the FrontPage Server Extensions are automatically installed on the single content root of the server.

On a multi-hosted machine, the Multi-hosted Server dialog box is displayed.

2. Select the virtual servers on which the FrontPage Server Extensions should be installed and click OK.
3. Enter the name of a new FrontPage administrator account and a password.
4. You can add other administrator accounts after installing the server extensions using the Permissions command in the FrontPage Explorer.

• The FrontPage Server Extension .dll and .exe files are copied to the \binsubdirectory and to the default \windows\system directory.
• The ISAPI (.dll) or CGI (.exe) files used by FrontPage to implement the Server Extensions functionality in the user's webs are copied to the \isapiand \_vti_bin directories, respectively. They are also copied into the document root of each virtual server on which you are installing the FrontPage extensions.
• The FrontPage Server Administrator (fpsrvwin.exe) and a command line version (fpsrvadm.exe) are copied to the \bin directory. The FrontPage Server Administrator is a tool for installing, updating, verifying, or removing the FrontPage Server Extensions.

• The FrontPage Server Extensions .dll and .exe files copied to the \binsubdirectory and to the default \windows\system directory.
• The three ISAPI (.dll) or CGI (.exe) files used by FrontPage to implement the Server Extensions functionality in the user's webs are copied to the \isapi and the \_vti_bin directories, respectively. They are also copied into the document root of each virtual server on which the FrontPage extensions are installed.
• The FrontPage Server Administrator (fpsrvwin.exe) and a command line version (fpsrvadm.exe) are copied to the \bin directory. The FrontPage Server Administrator is a tool for installing, updating, verifying, or removing the FrontPage Server Extensions.
• The Server Extensions Resource Kit.
• HTML Administration forms, a set of HTML forms for remotely administering the FrontPage Server Extensions via web browsers. Also a command line utility (fpremadm.exe) for remote administration of the FrontPage Server Extensions is installed in the \bin directory.

• Modifies the magnus.conf file
• Modifies the server's configuration file (obj.conf) to add ObjectType directives, marking three of the \_vti_ directories as containing executables.
• Adds the following seven subdirectories are created under your server's document root:

\_private
\_vti_bin (contains shtml.exe)
\_vti_bin\_vti_adm (contains admin.exe)
\_vti_bin\_vti_aut (contains author.exe)
\_vti_cnf
\_vti_log
\_vti_pvt
\_vti_txt
\images

• Creates .nsconfig files in the \_vti_bin, \_vti_adm,\_vti_aut directories and the document root directory.

• Execute the fpsrvwin.exe file (located in the \bin directory of your FrontPage directory) to set the server port, test the extensions, install the extensions to other virtual servers, and update extensions.
• Select the server and web you want to work with:

• A remote machine must have the FrontPage97 or FrontPage98 program installed (Macintosh or Windows only). Once the FrontPage program is started, the user is prompted for the name of a server to edit or open.
• If the user wants to edit a web on a different machine, click on "MoreWebs", on the line to select a web server or disk location type in the servername:portnumber of the web to edit then click OK.
• Select the web you wish to edit from the list of webs on the host machine.
• You need to provision each additional web. You can do this from the client side, with the FrontPage client provided the client has the right authorization (the administrator username and password) for the root web. You can also provision user webs from the server side by using the program fpsrvadm.exe to set the password for an individual web. You need to make sure that the new FrontPage web does not inherit the administrator username and password from the root web.
• Locate the fpadmin.htm file, typically in the \admin\cgidirectory of your FrontPage program directory. You can use this to configure your FrontPage web.
• Users can edit the local web that is displayed when FrontPage is started, but they must have a valid user ID and password to modify it.

1. Log on to your Enterprise Server user account so you can install the FrontPage Server Extensions from the tar file:

cd /usr/local

2. Untar the downloaded file.

This creates a /usr/local/FrontPage/version2.0 directory and installs several other new directories under the document root directory. For example, for the FrontPage 97 extensions on a Solaris platform, you untar the vt20.solaris.tar.z file:

tar xvf /usr/tmp/vt20.solaris.tar

3. Change directories to /usr/local/frontpage/version2.0.

cd frontpage/version2.0

4. Create a directory named /extensions and move the _vti_bin directory into it.

mv _vti_bin extensions

5. Install the WPP kit to /usr/local/frontpage/version2.0.

For Solaris, use this code:

tar xvf /usr/tmp/wpp.solaris.tar

6. Rename the directory /executables (/usr/local/frontpage/version2.0/executables) to /_vti_bin:

mv executables _vti_bin

7. Move the file fpsrvadm.suid.exe to the /bin directory:

mv fpsrvadm.suid.exe bin

8. Make sure your Enterprise Server's configuration file (magnus.conf) location matches that of the FrontPage server extensions install script:

/usr/ns-home/https-443/config

9. Run the fp_install.sh shell program and follow the on-screen instructions, which ask for the information described in the following table.

When you are prompted for the name of the server configuration file, enter the pathname of your server's magnus.conf file.

• Modifies magnus.conf
• Creates a configuration file named /usr/local/frontpage/<hostname:port.cnf
• Modifies the server's configuration file (obj.conf) to add ObjectType directives, marking three of the /_vti_ directories as containing executables.
• Adds seven subdirectories under the server's document root:

/_vti_bin (contains shtml.exe)
/_vti_bin/_vti_adm (contains admin.exe)
/_vti_bin/_vti_aut (contains author.exe)
/_vti_cnf
/_vti_pvt
/_private
/_vti_log
/_vti_txt
/images

• Creates .nsconfig files in the /_vti_bin, /_vti_adm, /_vti_aut and the document root directories.

1. Execute the fpsrvwin.exe file to set the server port, test the extensions, install the extensions to other virtual servers, and update extensions.
2. A remote machine must have the FrontPage '98 program installed, (Macintosh or Windows only).

Once the FrontPage program is started, the user is prompted for the name of a server to edit or open.

3. If the user wants to edit a web on a different machine, click on "MoreWebs" on the line to select a web server or disk location type in the servername:portnumber of the web to edit. Choose OK.
4. Select the proper web from the list of webs on the host machine to edit.

1. Log on to your Enterprise Server user account so you can install the FrontPage Server Extensions from the tar file.

cd /usr/local

2. Untar the downloaded file.

This creates a /usr/local/FrontPage/version3.0 directory and installs several other new directories under the document root directory. For example, for the FrontPage98 extensions on a Solaris platform, you untar the fp30.solaris.tar.z file.

tar xvf /usr/tmp/fp30.solaris.tar

3. Change directories to /usr/local/frontpage/version3.0:

cd frontpage/version3.0

4. Run the fp_install.sh shell program and follow the on-screen instructions, which ask for parameter information.

When you are prompted for the name of the server configuration file, enter the pathname of your server's magnus.conf file.

• Modifies magnus.conf
• Creates a configuration file named /usr/local/frontpage/<hostname:port.cnf
• Modifies the server's configuration file (obj.conf)to add ObjectType directives, marking three of the /_vti_ directories as containing executables.
• Adds seven subdirectories under the server's document root:

/_vti_bin (contains shtml.exe)
/_vti_bin/_vti_adm (contains admin.exe)
/_vti_bin/_vti_aut (contains author.exe)
/_vti_cnf
/_vti_pvt
/_private
/_vti_log
/_vti_txt
/images

• MicrosoftFP97 WPP page
• MicrosoftFP97 Unix Install Instructions
• Microsoft's Web Hosting Primer
• Microsoft's Technical Support for FP97
• Ready-to-Run FP97 Server Extensions Support
• Ready-to-Run FP97 Server Extensions for Netscape

• Microsoft FP98 WPP main page
• Ready-to-Run FP98 Server Extensions support page