Relocating FacetTerm Install Directory

Having these directories in a fixed place allows us to simplify the installation process as well as updates and support.

However it is sometimes impossible for FacetTerm to be under the /usr directory because of file system space considerations. Therefore, we have made it possible to locate FacetTerm in another place.

IMPORTANT: Systems on which the directories are relocated need to be administered by someone who will keep the system consistent during updates and will indicate to our support personnel that their system has relocated FacetTerm.

NOTE THAT THIS IS CURRENTLY ONLY SUPPORTED FOR PTY SYSTEMS VERSION 3.0.9 AND ABOVE.

To relocate the FacetTerm directories, you must incorporate the following instruction into the normal FacetTerm installation instructions:

1. Create a directory and load the files from the FacetTerm installation media there. Instead of loading the files when the current working directory is / , create a directory on the file system that you have chosen and read in the tape or diskettes there. For example, to put FacetTerm on the file system mounted on /u6 in the directory fthere:
   cd /u6
   mkdir fthere
   cd fthere
   pwd
   ... cpio ... (as shown in installation instructions)

   This will result in the following directories:

   /u6/fthere/usr/facetterm
   /u6/fthere/usr/facet

   Create the file /etc/.fct_config specifying the location of the FacetTerm directories. You must tell the FacetTerm programs, scripts, and utilities where you have relocated the FacetTerm directories by building the configuration file:

   /etc/.fct_config

   The file should look like this with each line starting in column 1:

   FACETTERMPATH=/u6/fthere/usr/facetterm

   FACETTERMHOME=/u6/fthere/usr/facetterm

   FACETPATH=/u6/fthere/usr/facet

   FACETHOME=/u6/fthere/usr/facet

   Create the file NOLINKUSRBIN to prevent the linking of the FacetTerm programs into /usr/bin, if desired. As part of a normal installation, the programs in /usr/facetterm/bin are linked to the directory /usr/bin. If the programs are not to be linked to /usr/bin, tell FacetTerm not to do this by creating the file NOLINKUSRBIN in the directory that is now /usr/facetterm. For the example above, the following command would work:

   touch /u6/fthere/usr/facetterm/NOLINKUSRBIN

   Run the FacetTerm installation script in the relocated usr/facetterm directory. Then the normal installation procedure can be followed, substituting /u6/fthere/usr/facetterm wherever /usr/facetterm is specified. Instead of:

   cd /usr/facetterm

   ./inst.facetterm

   do instead:

   cd /u6/fthere/usr/facetterm

   ./inst.facetterm

   Modify the PATH environment variable for all FacetTerm users to include the relocated usr/facetterm/bin directory. If the programs are not linked to /usr/bin, the relocated usr/facetterm/bin directory should be placed in the PATH of the FacetTerm users so they can run FacetTerm and the other utilities described in the FacetTerm manual:

   PATH=$PATH:/u6/fthere/usr/facetterm/bin; export PATH

   or

   . /etc/.fct_config

   PATH=$PATH:${FACETTERMPATH-/usr/facetterm}/bin; export PATH