HELIOS Base G8 User manual (Version 5.0.0)  
 

6 HELIOS directory structure

The following directory listing shows all directories that are created in the “HELIOSDIR” directory during installation (Table 6.1):

Where Description Usage
bin All available applications/tools read-only
etc Additional installation files read-only
lib Lib files shared for all applications read-only
public Mac & Win applications (UTF-8 volume) read-only
sbin Server background applications and tools read-only
var All configuration data read/write

Table 6.1: HELIOS directory tree

The “HELIOSDIR” directory contains besides its six subdirectories a number of “Manifest.<product>” documents which list the installed files for each installed HELIOS product. The two files “Manifest.base” and “Manifest.data” are obligatory and exist always after the HELIOS base installation. Other “Manifest.<product>” files are created with each HELIOS product that is installed, e.g. “Manifest.es” exists after the installation of EtherShare.

In the following, we briefly describe the content of the subdirectories in “HELIOSDIR” and provide more detailed information on the files in “bin”, “sbin”, “var/conf” and “var/spool”.

6.1 HELIOSDIR/bin

The “HELIOSDIR/bin” directory contains all available applications and tools, e.g. user utility programs:

“authutil”, “dt”, “htar”, “hupd”, “infocmp”, “lcheck”, “license”, “locktable”, “lpc”, “lpq”, “lpr”, “lprm”, “lscom”, “machid”, “mail”, “oiinfo”, “prefdump”, “prefrestore”, “prefvalue”, “printerlog”, “pstext”, “psresolve”, “psyslog”, “serverlog”, “socket”, “srvmsg”, “srvutil”, “start-helios”, “stop-helios”, “swho”, “tic”, “uniconv”, and “uwhat”.

6.2 HELIOSDIR/etc

The “HELIOSDIR/etc” directory contains additional installation files in the subdirectories “daily”, “install”, “licversions”, “modes”, “prefs”, “runonce”, “startstop”, “termdefs”, “terminfo”, “uninstall”, and “updates”.

6.2.1 HELIOSDIR/etc/prefs

This directory contains the default preferences of each installed server which are loaded into the “HELIOSDIR/var/conf/Preferences” file.

6.3 HELIOSDIR/lib

“HELIOSDIR/lib” with its subdirectory “OpenImage” contains library files and other resources which are shared by all applications.

6.4 HELIOSDIR/public

The “HELIOSDIR/public” directory contains the directories “Documentation”, “MacOS”, “Windows”, and “Java”. The applications are available to remote Mac/Windows users via the “HELIOS Applications” volume.

6.5 HELIOSDIR/sbin

The “HELIOSDIR/sbin” directory contains applications that are automatically started by the server: “authsrv”, “balanceif”, “cloneif”, “demouser”, “demovol”, “desksrv”, “diskif”, “exechelper” (OS X only!), “getlocalfs”, “heladmsrv”, “helios.daily”, “heliosgroups”, “holdif”, “homevol”, “ifstat”, “logrotate”, “lpd”, “mdnsproxysrv”, “mdnssrv” (not on OS X!), “migrate”, “notifysrv”, “pcap”, “psof”, “rebuild”, “setmode”, “srvsrv”, “tcpif”, “timeif”, “uninstall”, “update-versions”, and “yp-update”. Some of them, such as “srvsrv”, run permanently in the background.

Important:

Usually, the services in the “HELIOSDIR/sbin” directory should never be started manually unless otherwise advised in the manual!

6.6 HELIOSDIR/var

The “HELIOSDIR/var” directory contains all configuration data and is the only subdirectory in “HELIOSDIR/” that allows “read/write” access.

“adm” contains server and printer accounting files of today and the last six days.

“cmaps” contains character translation mapping tables, e.g.: iso7, iso8, epson.

“conf”. See 6.6.1 “HELIOSDIR/​var/​conf”.

“ICC-Profiles”, 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.

“run” contains “Versions” and other utility files.

“settings” contains subdirectories which are meant as a server repository for PPDs, printer scripts, printer drivers, and Distiller settings. In order to make it available to all users on the network, this directory is published as a HELIOS volume. Additional subdirectories are created in “settings” if further HELIOS products are installed on the host, e.g. “WebShare”.

“tmp” usually contains no permanent data. Some products, such as ImageServer, store files temporarily in this directory and delete them when they have accomplished their tasks.

6.6.1 HELIOSDIR/​var/​conf

The “conf” directory has the following content, on which we will have a more detailed look:

passwd.key

Key file for RSA encryption. When being started, “authsrv” checks for this key file and uses it for password encoding.

indexsuffixmap

See “Index Server suffix map” chapter in the HELIOS Index Server manual.

ipaccess

This file contains the access list with the IP addresses which are permitted to log on to, i.e. use, HELIOS services. You can modify the access list with HELIOS Admin (Settings > IP Access). See 7.8.6 “IP Access”.

ipaccess.local

By default (after installation), the “ipaccess” file provides no access restrictions. In order to set up access restrictions use HELIOS Admin as described above or copy the content of the file “ipaccess.local” to “ipaccess”.

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 file “passwd” contains a list of all HELIOS users on the system. An entry line in this file specifies for each 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 8 “HELIOS utility programs”, can be used to create and update this file. But we strongly recommend to change preference settings with HELIOS 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 TCP 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:

6.6.2 HELIOSDIR/var/spool/dicts

The “dicts” directory contains the HELIOS PostScript dictionaries:

HeliosDict_2_1 
HeliosPDFDict_1_1 
HeliosPDFDict_1_0 
HeliosSeparationDict_1_0

6.6.3 HELIOSDIR/var/spool/psfonts

The “psfonts” directory contains all PostScript (Type1 and Type3) fonts that were installed on the host via HELIOS Admin.

FontDirectory

This file lists all installed fonts on the server.

6.6.4 HELIOSDIR/var/spool/qmeta

This directory contains the metadata for all existing printer queues that 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 printer fonts, the “PPD” file is the selected PPD for the specified printer queue installed on the server.


HELIOS Website © 2020 HELIOS Software GmbH  
HELIOS Manuals May 27, 2021