HELIOS Base User manual


5 HELIOS directory structure
The following directory listing shows all files created in the "HELIOSDIR" file system after installation (Fig. 27):
Fig. 27: HELIOS directory tree
helios
HELIOS product directory
readonly
bin
All available applications/tools
readonly
etc
Additional installation files
readonly
lib
Lib files shared for all applications
readonly
public
Mac & Win applications (UTF-8 volume)
readonly
sbin
Server background applications
readonly
var
All configuaration data
read/write

The "HELIOSDIR" directory contains besides its six subdirectories ("bin", "etc", "lib", "public", "sbin", and "var") a number of "Manifest.xxx" files which list the installed files for each installed HELIOS product. The files "Manifest.base" and "Manifest.data" are obligatory and exist always after the HELIOS base installation. Other "Manifest.xxx" files are created with each HELIOS product that is installed, e.g. "Manifest.es" appears after the installation of EtherShare, "Manifest.pcshare" after a PCShare installation, etc.
In the following, we shortly describe the content of the subdirectories in "HELIOSDIR" and provide more detailed information on the files in "bin", "sbin", "var/conf" and "var/spool".
5.1 HELIOSDIR/bin
The "HELIOSDIR/bin" directory contains all available applications and tools, e.g. user utility and test programs:
"chpasswd", " hupd", "infocmp", "lcheck", "license", "locktable", "lpc", "lpq", "lpr", "lprm", "lscom", "machid", "oiinfo", "prefdump", "prefrestore", "prefvalue", "psresolve", "slptool", "srvutil", "start-helios",
"stop-helios", "swho", "tic", "uniconv", and "uwhat".
5.2 HELIOSDIR/etc
The "HELIOSDIR/etc" directory contains additional installation files in the subdirectories "install", "uninstall", "licversions", "daily", "kernel", "modes", "pdfweb", "prefs", "runonce", "startstop", "termdefs", "terminfo", and "updates".
5.3 HELIOSDIR/etc/prefs
This directory contains the default preferences of each installed server which are loaded into the
"HELIOSDIR/var/conf/Preferences" file.
5.4 HELIOSDIR/lib
"HELIOSDIR/lib" with its subdirectory "OpenImage" contains library files and other resources which are shared by all applications.
5.5 HELIOSDIR/public
The "HELIOSDIR/public" directory contains Macintosh and Windows applications in the directories "ReadMe", "Documentation", "MacOS" and "Windows". The applications are available to remote Macintosh/Windows users via the "HELIOS Applications" volume (Apple "Chooser") and "helios_apps" directory (Windows "Network Neighborhood").
5.6 HELIOSDIR/sbin
The "HELIOSDIR/sbin" directory contains applications which are automatically started by the server: "uninstall", "balanceif", "cloneif", "heliosgroups", "demouser", "demovol", "homevol", "diskif", "getlocalfs", "helios.daily", "holdif", "ifstat", "logrotate", "lpd", "pcap", "psof", "setmode", "shmif", "slpsrv", "srvsrv", "tcpif", "timeif", "update-versions", "yp-update", "execdaemon", or "exechelper". Some of them, such as "slpsrv" or "srvsrv" run permanently in the background,

Important: The files in the "HELIOSDIR/sbin" directory should never be started manually.

5.7 HELIOSDIR/var
The "HELIOSDIR/var" directory contains all configuration data and is the only subdirectory in "HELIOSDIR/" that is "read-write".
The "adm" directory contains server and printer accounting files of today and the last six days.
"cmaps" contains character translation mapping tables, e.g.: iso7, iso8, epson, hp, etc.
The "ICC-Profiles" directory, which is available as a shared network volume, contains subdirectories for scanner, monitor and printer profiles as well as the index file "!profile.inx" which lists all profiles.
"OpenImage" usually contains no permanent data. OpenImage-specific processes store files temporarily in this directory and delete them when they have accomplished their tasks.
The "run" directory contains version and other utility files.
"tmp" usually contains no permanent data. Some products, such as PrintPreview, store files temporarily in this directory and delete them when they have accomplished their tasks.
5.8 HELIOSDIR/var/conf
The "conf" directory has the following content, on which we will have a more detailed look:
ipaccess
This file contains the access list with the IP addresses which are permitted to log on to, i.e. use, HELIOS services. The access list can be modified with EtherShare Admin (Menu Lists > IP Access), or with PCShare Admin (Setup > IP Access).
ipaccess.local
Per default (after installation), the "ipaccess" file provides no access restrictions. In order to set up access restrictions use EtherShare Admin or PCShare Admin as described above, or copy the content of the file "ipaccess.local" to "ipaccess".
ipaccess.lpd
To allow remote access to the LPD of a machine, independent of the entries in the main "ipacces" list, it is possible to create a "HELIOSDIR/var/conf/ipaccess.lpd" file which will only be used by the LPD daemon.
license
This file contains HELIOS software license(s) which can be seen, erased and added by use of the tools which are described in 4.3 "Licenses".
passwd
The UNIX file "passwd" contains a list of all HELIOS users on the system. An entry line in this file specifies for each user user name and password in encrypted form.
Preferences
HELIOS preferences are stored in this (binary) file. Preferences with default values, i.e. that have not been changed, do not appear in this file. The programs "prefdump", "prefrestore", and "prefvalue", which are explained in
6 "HELIOS utility programs", could be used to create and update this file. But we strongly recommend to change preference values with EtherShare or PCShare Admin.
printcap
Each printer queue requires an entry in "printcap" to describe in detail the way in which the associated physical printer is connected.
This a typical "printcap" entry for a PAP printer:
Laser1:\
:lp=var/spool/qmeta/ljet/device:\
:if=var/spool/qmeta/ljet/if:\
:sh:\
:mx#0:\
:sf:\
:du#0:\
:sd=var/spool/ljet:\
:af=var/adm/printer.acct:\
:lf=var/spool/ljet/ljet-log:
5.9 HELIOSDIR/var/spool/dicts
The "dicts" directory contains the corrected Apple dictionaries:
_AppleDict_md__68_0
_AppleDict_md__70_0

and the HELIOS dictionaries:
HeliosDict_2_1
HeliosPDFDict_1_1
HeliosPDFDict_1_0
HeliosSeparationDict_1_0

The dictionary for the "Linotype color separation" process is now incorporated in the printer interfaces and not contained in this directory anymore.
5.10 HELIOSDIR/var/spool/psfonts
The "psfonts" directory contains all PostScript (Type1 and Type3) fonts that are installed on the host via EtherShare Admin.
FontDirectory
This file lists all installed fonts on the server.
5.11 HELIOSDIR/var/spool/qmeta
This directory contains the metadata for all existing printer queues which have been created on the server. The default queues are "hold" and "error". The directory of each printer queue contains amongst others the "FONTS" and "PPD" files. The "FONTS" file contains a list of all PostScript fonts, the "PPD" file the selected PPD for the specified printer queue installed on the server.

© 2002 HELIOS Software GmbH