A 4: EtherShare utility programs
The following utility programs are provided with EtherShare.
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
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).
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
number of accumulated log files before logrotate
starts the "rotation"
octal expression for the file access rights,
i.e. "owner" and "group" have the right to
, whereas "others" are just
allowed to read
group to which the file is allocated
log file name
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".
prefrestore [-p PreferencesFile] ASCIIPreferenceExport
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.
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.
prefdump [-o AsciiPreferenceExport] [PreferencesFile]
is the binary preference database file
which exports the preferences. If omitted, the default file "$ESDIR/conf/Preferences" will be taken.
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".
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.
is a pathname of a file to print a preference value to or read a preference value from. If omitted stdout
will be used.
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!
is the value the preference will be set to.
is one of the following and may only be used when setting a preference:
a signed (32 bit) integer value
an unsigned (32 bit) integer value
a signed (64 bit) integer value
an unsigned (64 bit) integer value
a list of unsigned integers separated by comma
a list of strings separated by comma
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
A list of recognized keys can be found in the file "$ESDIR/etc/OpenImagePreferences".
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
· only if installed on the same server