Command line operations of fpinst.sh


Modes of operation

Default:    --install

--help [ topic ]
Get help documentation.

--install
Install FrontPage support on a site.
If support is already installed an upgrade will occur

Requires:

--vs <Virtual Server>
--admin <web administrator name>
--password <web administrator password>
--subserver <site name>
If Subservers are enabled
--user <user name> --group <group name>
If this cannot be derived from the owner of the document root
--path <path>
If the custom Subserver-hash option is in use
--chroot <jail directory>
If this virtual serrver restricts FrontPage to a chroot jail

--upgrade
Upgrade installed FrontPage on a site
Admin user and password are preserved

Requires:

--vs <Virtual Server>
--subserver <site name>
If Subservers enabled
--path <path>
If the custom Subserver-hash option is in use
--user <user name> --group <group name>
If this cannot be derived from the owner of the document root
--chroot <jail directory>
If this virtual serrver restricts FrontPage to a chroot jail

--uninstall
Disable a previous installation
Specifically this removes /usr/local/frontpage/zeus/<servername>
This leaves a working site, with the non-Zeus configuration intact, which cannot be published to.

Requires:

--vs <Virtual Server>
--subserver <site name>
If Subservers enabled
--chroot <jail directory>
If this virtual serrver restricts FrontPage to a chroot jail

--check
Check that a FrontPage installation is working
- uses fpsrvadm -o check

Requires:

--vs <Virtual Server>
--subserver <site name>
If Subservers enabled
--chroot <jail directory>
If this virtual serrver restricts FrontPage to a chroot jail

Arguments

--vs -V <Virtual Server>
Virtual Server (for example, test)
--subserver --site -S <site name>
Subserver site name (for example, mysite.isp.com).
Remember the Subserver must already have been created.
--admin -A <web administrator name>
Admin user name of FrontPage web
--password --passwd -P <web administrator password>
Password for administrator of the FrontPage web
--user -U <Unix user>
User name of the owner of the document root
Taken from the current ownership of the document root if unspecified unless that directory is owned by root in which case an error is given
--group -G <Unix group>
Group name of the owner of the document root
Taken from the current ownership of the document root if unspecified unless that directory is owned by root in which case an error is given
--path <path>
Only used if a custom Subserver hash is being used.
Specifies the relative path to the Subserver's document root from the Virtual Server document root.
--realm <authentication realm>
Set the realm of the access control in the global .htaccess file (changes the message displayed in the password popup).
--chroot <directory>
This option should be used if a Virtual Server runs FrontPage in a chroot'ed enviroment. This option specifies which directory is chroot'ed to, so that paths can be adjusted accordingly, and will chroot fpsrvadm.exe before it is run. This ensures that FrontPage and its associated tools see the chroot'ed enviroment in which an instance of /usr/local/frontpage can be found.
This does not set up the chroot'ed enviroment itself. See the documentation on chroot'ing FrontPage for details on who to do this.
--nofollow
If the document root of a Virtual Server is a symbolic link then by default the target of this link is put in the FrontPage configuration file and not the location of the link. This is due to a restriction in the FrontPage extensions. With version 4.0 of the extensions this can be changed so that symbolic links to directories outside the FrontPage web can be followed if the line FollowSymLinks:1 is added to
/usr/local/frontpage/version4.0/frontpage.cnf
The drawback of this is that it is not restricted to the document root link and allows other readable files to be linked into the FrontPage web. If you decide to use this then --nofollow will surpress the link dereferencing behavior.
--nofix
Disables automatic fixing of, for example, disabled required modules or missing links.
--nonroot
Normally, fpinst.sh must be run as root to create files as other users. If all the required modifications can be made as the current user then specify the --nonroot option to confirm that non-root operation is intended and to supress warnings. Particularly the script needs to be able to create files in the target document root, in /usr/local/frontpage and in /usr/local/frontpage/zeus/.
--noninteractive
Force non-interactive operation
This script will attempt detect when it is being run manually. If it is not run from an interactive shell prompting for additional information will be surpressed. If insufficient information is provided it will exit with a non-zero value and output an error message. This behavior can be forced by using the --noninteractive option described above.

Back