If you are installing the Prospero server, a user and group ID must be established under which the directory server will run. The directory associated with the user ID should be a location in which additional information about virtual files and directories can be stored. New files which are to exist only within the Prospero file system will also be stored under this directory. It is suggested that you chose the user name pfs for this pseudo-user, but other names may be used as well.
Once the user ID has been set up, install the binaries. The directory in which they must be installed is selected at compile time. As originally distributed, it is /usr/pfs/bin. The program pstart should be installed setuid and setgid the pseudo-user just described.
To start the server run pstart. pstart takes an optional host name. If specified, the host name must be the primary name for the host on which the server is running. In most cases, the server is able to determine the name on its own and there is no need to specify it as an argument.
pstart will connect to the directory associated with the pseudo-user, it will check to make sure that the user id is set appropriately, and it will exec the directory server with the appropriate arguments.
Although it is not recommended, the directory server can also be started manually. You must first be logged in as (or be su'ed to) the user under whose ID you want the server to run. You can then execute dirsrv passing as arguments the required directory names.
dirsrv [-p#portnum] [-m] root shadow data aftpdir afsdir hostname
The -p# option allows one to specify an alternate port to run the server on. This alternate server can be reached with the hostname ``your-hostname(portnum)''. For instance, at ISI, we run a publicly accessible GOPHER-GW server at ZEPHYR.ISI.EDU(1570). Common reasons for running additional servers on alternate ports are for testing reasons, to take some of the load off of your primary server, or to run a server dedicated to publishing a special database.
The -m (manual) option prevents the directory server from dissociating itself from the terminal. It is only useful for debugging. root is the logical root of the system. Only files below this point (and those under aftpdir and afsdir) will be accessible through the Prospero file system. shadow is the name of the directory that is to contain additional information about files and directories. It should typically be the shadow subdirectory of the pseudo-user described above. data is the local directory under in which new virtual directories and their contents will be stored.
aftpdir is the name of the directory hierarchy to which anonymous FTP has access and afsdir is the name of the directory through which files from the Andrew File System may be accessed. If these access methods are not supported by your system, these arguments should be the null string.
Users can use the Prospero file system even if the server is not running, but they will be unable to access files or directories stored locally. If pstart is installed setuid and setgid to the Prospero user and group IDs, then the directory server can be started by any user. You may also want to start the directory server from the system's /etc/rc file.
As things stand, users can access files and directories created on the local system, but they can not create new virtual systems stored locally. If you want to allow virtual systems to be stored locally, then you must have the site administrator add a reference to the new system from the pfs_storage virtual directory.