Managing the Filesystem

The LightWave Server filesystem is the repository for all LightWave Server configuration data: it contains API ans Service definitions, Access Control Policies, Server Certificates, configured users and groups, and HTTP and diagnostic logs. The filesystem consists of four audited Enscribe files: FS00, FS00A, FS01 and FS02. A filesystem cannot be shared by more than one LightWave Server SERVER process. Refer to SUTILITY for more information about managing the filesystem.

Copying or Moving the Filesystem

You copy the LightWave Server filesystem by copying all of the FS0* files in the filesystem subvolume to a new subvolume. The preferred way to do this is by using the PAK and UNPAK utilities (or similarly BACKUP and RESTORE) since they automatically update alternate key file references. A move is a copy to a new location, followed by a delete of the original.

Important

Before attempting to copy or move the filesystem, make sure its files are not open.

TEXT

tacl> fup listopens $DATA.MYFS.FS0*

Copy the FS files in subvolume $DATA.MYFS to $DATA.MYNEWFS.

TEXT

tacl> pak myfspak, $DATA.MYFS.FS0*, audited, listall
tacl> unpak myfspak, $*.*.*, audited, listall, myid, map names ($DATA.MYFS.* to $DATA.MYNEWFS.*)

Alternatively, you can use FUP DUP to copy the files, but you must manually update the alternate key file references.

CODE

tacl> volume $DATA.MYNEWFS
tacl> fup
- dup $DATA.MYFS.FS0*, *, saveall
- alter FS00, altfile (0, FS00A), audit
- alter FS00A, audit
- alter FS01, audit
- alter FS02, audit
- exit

Specify the new location of the filesystem using the --filesystem command line argument when starting the SERVER process. Once you have verified that you have successfully copied the filesystem to its new location, you may delete the original if desired.

If you are copying to another NonStop system, note that the filesystem contains one or more server certificates (if installed) which contain information specific to the host name used to access LightWave Server. You may need to obtain a new server certificate for your additional system.

Reducing Filesystem Disk Space Usage

When files are deleted from the filesystem the files are only marked for deletion. The file data records are physically deleted from the FS00 & FS01 files over time by a housekeeping process within LightWave Server. You can use SUTILITY to cause the FS00 & FS01 data records to be immediately deleted by running the following command from the TACL prompt:

CODE

tacl> run sutility --filesystem <filesystem-subvol> --clean

After cleaning the filesystem there may still be a large amount of unused disk space allocated to the FS01 file and the Console may report that the filesystem is full or nearly full. This is due to the way that data records are organized in the file. While there may be many free blocks available, they are interspersed with in-use blocks and cannot be released by Enscribe. You can reclaim this disk space using the FUP RELOAD command by running the following command from the TACL prompt:

CODE

tacl> fup reload <filesystem-subvol>.fs01

This creates a nowait process ORSERV which reorganizes the file data records and releases the unused space. This process can be run while LightWave Server is running. Note that you may need to run this command multiple times before all of the free space is reclaimed.