FP: Command Line Arguments for Server Administrator

Last reviewed: January 12, 1998
Article ID: Q164584
The information in this article applies to:
  • Microsoft FrontPage 98 for Windows
  • Microsoft FrontPage 97 for Windows with Bonus Pack

SUMMARY

FrontPage Server Administrator is available in two forms: The first form is Fpsrvwin.exe, which is a Windows application. The second form is Fpsrvadm.exe, which is a command line only version of the server administrator. To view the command line options for Fpsrvadm.exe, point to Programs on the Windows Start menu, and then click MS-DOS prompt. At the MS-DOS prompt, go to the \Program Files\Microsoft FrontPage\Bin folder, and then type the following:

   Fpsrvadm -h

This article describes the command-line arguments available to both forms of the FrontPage Server Administrator.

MORE INFORMATION

Fpsrvadm.exe

Fpsrvadm.exe is an MS-DOS and UNIX application, which supports the following command-line arguments:

Usage: fpsrvadm [-help]

                [-operation <install | upgrade | uninstall | check |
                  security |enable | disable | recalc | putfile |
                  recalcfile>]
                [-port <nnnn>]
                [-web <web name>]
                [-root <frontpage root directory>]
                [-type <ncsa | ncsa-manual-restart
                        | apache | apache-manual-restart
                        | cern | cern-manual-restart
                        | netscape | netscape-manual-restart>]
                [-servconf <server config file>]
                [-multihost <hostname>]
                [-username <username>]
                [-password <password>]
                [-ipaddress <IP address>]
                [-destination <destination Url>]
                [-filename <file name>]

FrontPage 98 for Windows supports these additional command-line arguments:

                [-xUser <UNIX username>]
                [-xGroup <UNIX group>]
                [-noChownContent Yes]   

You can shorten the command-line arguments by using the first letter of each command, with the exception of Password, which uses "-pw", xUser, which uses "-xu", and xGroup, which uses "-xg" (without the quotation marks).

Examples of command line arguments for Fpsrvadm.exe

   fpsrvadm -o install -r "c:\Program Files\Microsoft FrontPage"
            -t frontpage  -u user -pw password
            -s "c:\FrontPage Webs\server\conf\httpd.cnf" -m ""
   fpsrvadm -o install -p 80 -w webname (sub web)
   fpsrvadm -o upgrade -p 80
   fpsrvadm -o uninstall -p 80
   fpsrvadm -o check -p 80
   fpsrvadm -o check -p all
   fpsrvadm -o disable -p 80
   fpsrvadm -o security -p 80 -w webname -u username -pw password
            -i ipaddress
   fpsrvadm -o recalc -p 80 -w webname
   fpsrvadm -o putfile -p 80 -w webname -d url -f filename
   fpsrvadm -o recalcfile -p 80 -w webname -d url

If Fpsrvadm needs additional information you will be prompted to enter this information at the MS-DOS prompt.

NOTE: The following server types are not documented in the Fpsrvadm Help file. The FrontPage Server Administrator retrieves these server types from dlls installed on the server system when you install the FrontPage Server Extensions:

   Microsoft Internet Information Server      msiis
   Microsoft Personal Web Server              msiis
   Microsoft Peer Web Services                msiis
   O'Reilly & Associates WebSite              website
   Netscape Commerce                          netscape-commerce
   Netscape Communications                    netscape-communications
   Netscape FastTrack                         netscape-fasttrack
   Netscape Enterprise                        netscape-enterprise
   FrontPage Personal Web Server              frontpage

Of the supported Web servers on Windows NT or Windows 95 operating systems, the only servers that require configuration files are

Netscape and the FrontPage Personal Web Server. When you install extensions with Fpsrvadm or Fpsrvwin to other servers on these operating systems, you may omit the configuration file option.

Paths that contain spaces must be enclosed within quotation marks (""). For example, assuming FrontPage is installed in the c:\Microsoft FrontPage folder, the following command will fail:

   fpsrvadm -r c:\microsoft frontpage

but this command will not fail:

   fpsrvadm -r "c:\microsoft frontpage"

The destination and filename arguments are only used with the putfile and recalcfile options. These arguments are used when you place content into a FrontPage Web without using FrontPage Explorer. The filename argument accepts the name of the file you want to place into the Web. The destination file accepts the destination URL or the Web for which you want to recalculate links.

The recalcfile option recalculates the Web links going to or from a given file. You can use this as a substitute for recalculating an entire Web if only one or a few files have changed. The putfile option places a file into a FrontPage Web using Fpsrvadm.

The ipaddress argument limits access to the web server based on the IP address. This feature of FrontPage Server Administrator is not available on Microsoft Internet Information Servers (IIS).

Fpsrvwin.exe

There is a problem in the FrontPage 97 version of Fpsrvadm.exe on IIS and WebSite servers that support Secure Sockets Layer (SSL). Using Fpsrvadm will not install extensions to Port 443, so the server will not be able to accept FrontPage authoring over the secure port. To work around this problem, use the command-line arguments for Fpsrvwin.

Fpsrvwin.exe takes only a subset of the arguments available to Fpsrvadm.exe. The reason is that Fpsrvwin functionality was intended to support the setup program. Microsoft recommends using Fpsrvadm for batch mode server administrator operation. Future versions of Fpsrvwin may not support command-line arguments.

Fpsrvwin command-line functionality only supports install, upgrade, and uninstall because these are the operations necessary from FrontPage setup. The command line options for Fpsrvwin.exe are:

   -o	-operation <install | upgrade | uninstall>
   -p	-port <nnnn>
   -m	-multihost <hostname>
   -ma	-multihost-all
   -w	-webname <web name>
   -t	-type <frontpage | microsoft | website | netscape |
           netscape-enterprise ...>
   -s	-servconf

If Fpsrvwin needs additional information not provided by its command line options it will prompt you for the information.


Additional query words: fp97
Keywords : fpext
Version : 97
Platform : WINDOWS


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: January 12, 1998
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.