HELIOS EtherShare 2.6 User manual


A 4: EtherShare utility programs
The following utility programs are provided with EtherShare.
HELIOS
LanTest
HELIOS LanTest is a tool for testing and measuring the performance of AppleShare services. It offers detailed AppleTalk network evaluations for file and record locking as well as for many typical file system operations. LanTest results can be used for finding bottlenecks, for troubleshooting, or just for maintenance purposes.
Fig. A-25: HELIOS LanTest dialog window

The LanTest tool resides on the "EtherShare Applications" volume in the folder "Unsupported". After double-clicking on the program icon the LanTest dialog window (see figure A-25) opens.
From the File menu choose Select Test Volume... and confirm with the Select "<Volume name>" button. Before you start examining the performance you should state the type of your network:
From the Edit menu choose Edit Other Settings... and - in the upcoming dialog window - select the net type you are connected to (see figure A-26). Depending on the network specified in this window, LanTest determines the test load, i.e. the size of test files that are processed at a time.
Fig. A-26: Other settings dialog window

This is sensible since FDDI or Fast Ethernet (100 Mbit/s) networks have a higher data throughput than the standard Ethernet (10 Mbit/s). The new Gigabit Ethernet is very fast and reaches a data throughput up to 1 Gbit/s (1000 Mbit/s).
logrotate
Log files such as printer or server log files are being modified with each new login on the respective server. To maintain a certain order, they can be allocated a particular file name extension, e.g. by an ascending numbering. For example, the printer log file which records the entries of today may be named printer.acct, the one with yesterday's entries printer.acct.0 and so on.
It may be reasonable to determine a cycle after which the oldest log file is discarded, e.g. after one week. The EtherShare utility program logrotate coordinates the "rotation" of the log files with the following parameters:
logrotate [-n numlogs] [-m mode] [-o owner]
[-g group] logfile

The next line shows a practical example:
logrotate -n 6 -m 664 -o John -g helios printer.acct
6 number of accumulated log files before
logrotate starts the "rotation"
664 octal expression for the file access rights,
i.e. "owner" and "group" have the right to
read
and write, whereas "others" are just
allowed to read the file
John owner of the file
helios group to which the file is allocated
printer.acct log file name
Preferences
The programs "prefrestore", "prefdump", and "prefvalue" can be used to create and update the EtherShare, PC Share1, EtherShare OPI 2.1*, PDF Handshake*, and Print Preview* preferences file "$ESDIR/conf/Preferences".
Usage:
prefrestore [-p PreferencesFile] ASCIIPreferenceExport
PreferencesFile is the binary preference database file which imports the preferences from ASCIIPreferenceExport. Any old preferences are deleted then.
If omitted, the default file "$ESDIR/conf/Preferences" will be taken.
ASCIIPreferenceExport is a text file, normaly exported from the preference file using prefdump, which builds the new preference file.
Dumping preferences into a readable form can be done using prefdump.
Usage:
prefdump [-o AsciiPreferenceExport] [PreferencesFile]
PreferencesFile is the binary preference database file
which exports the preferences. If omitted, the default file "$ESDIR/conf/Preferences" will be taken.
If ASCIIPreferenceExport is specified the preference database will be exported to that file. If omitted, the preference database will be printed to "stdout".
Setting and retrieving single entries of the preference database can be done using the program "prefvalue" found in "$ESDIR/etc".
Usage:
prefvalue -k Keys [-d] [-t type] [-p PreferenceFile] [-f valuefile||value]
PreferenceFile is the binary preference database file to use. If omitted, the default file "$ESDIR/conf/Preferences" will be taken.
Valuefile is a pathname of a file to print a preference value to or read a preference value from. If omitted stdout respective stdin will be used.
Keys is a single string conatining the key strings for the preference delimited by "/" characters. To set an OPI preference system wide, the first key element is OPI. To set a preference for a specific program, the first key element is the name of the program (for example "opisrv"). To set a preference for all printers, the first key element is "If". To set a preference for a specific printer, the first key element is the UNIX name of the printer. Please keep in mind that key names are case sensitive!
Value is the value the preference will be set to.
Type is one of the following and may only be used when setting a preference:
Type
Value is
bool
TRUE or FALSE
int
a signed (32 bit) integer value
uint
an unsigned (32 bit) integer value
int64
a signed (64 bit) integer value
uint64
an unsigned (64 bit) integer value
double
a floating point number
ulist
a list of unsigned integers separated by comma
str
a string
strlist
a list of strings separated by comma
data
The value cannot be taken from the command line and therefore requires a valuefile specified

To get the current value of a preference only specify a key.
To set a preference value, specify a key, type and value together.
To delete a preference, specify a key and the -d option.
A list of recognized keys can be found in the file "$ESDIR/etc/OpenImagePreferences".
A few examples:
To add a color alias for 'Process Black' to 'Black' for system wide use, specify:
prefvalue -k 'Opi/ColorAliases' -t strlist "Process Black=Black"
To set the layout creator to "UNIX" for the "opisrv" program only, specify:
prefvalue -k 'opisrv/LayoutCreator' -t str 'UNIX'
To set the "nice increment" value for all printer interfaces to 10, specify:
prefvalue -k 'If/NiceIncr' -t uint 10
To set the "Resolve All" option for the printer "lw" only, specify:
prefvalue -k 'lw/ResolveAll' -t bool true
1
only if installed on the same server


© 2002 HELIOS Software GmbH