Managing the Filesystem

The LightWave Client file system is the repository for all LightWave Client configuration data: it contains API definitions, Server Certificates, configured users and groups, and HTTP logs. The file system consists of four audited Enscribe files: FC00, FC00A, FC01 and FC02. A file system cannot be shared by more than one LightWave Client Console process. Refer to LWCCOM for more information about managing the file system. 

Copying or Moving the File System

You can copy the LightWave Client filesystem by copying all of the FC0* 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 the files are not open.

> fup listopens $DATA.MYFS.FC0*

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

> pak myfspak, $DATA.MYFS.FC0*, audited, listall
> 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.

> volume $DATA.MYNEWFS
> fup
- dup $DATA.MYFS.FC0*, *, saveall
- alter FC00, altfile (0, FC00A), audit
- alter FC00A, audit
- alter FC01, audit
- alter FC02, audit
- exit

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

Important

The filesystem contains server certificates (if installed) which contain information specific to the host name used to access LightWave Client Console. If copying the filesystem to another NonStop system, you may need to obtain and install a new server certificate for the new 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 FC00 & FC01 files over time by a housekeeping process within LightWave Client Console. You can use LWCCOM to cause the FC00 & FC01 data records to be immediately deleted by running the following command from the TACL prompt:

> run lwccom control filesystem <filesystem-subvol>, clean

After cleaning the filesystem there may still be a large amount of unused disk space allocated to the FC01 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:

> 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 the LightWave Client Console is running. Note that you may need to run this command multiple times before all of the free space is reclaimed.