|
|
|
|
|
HELIOS Base User manual |
||||
Note: Usually, almost all preferences for program functions and behavior of the HELIOS products can be set via EtherShare Admin or PCShare Admin. That means that it is not required to modify preferences manually. Nevertheless, in the following the single preferences and their function are described.
The server preferences are stored in a binary file. In the following, the preferences are listed by name, type, and default value. The default value is used by the HELIOS services unless another value is specified.
Not all of the following preferences are set by default, meaning they are not listed in the "prefdump" output, so HELIOS Services will use the given default values. When a different value is set by means of "prefvalue", this will take precedence. To revert back to the default value delete the preference entry.
Exporting, setting/deleting and restoring preferences on the HELIOS host is done via the programs "prefdump", "prefvalue", and "prefrestore". For a detailed description of these programs see 6 "HELIOS utility programs", where you will also find examples.
Important: Make sure that preference keys MUST NOT start or end with a slash (“/”) character!
Specifies the AppleTalk (NVE) name of the File Server. This is the name with which it is known to the network. Several names in a row, separated by a comma, are optional.
Specifies the name of the AppleTalk zone(s) to which the file server should be allocated. The chosen zone must be one of the local zones that the server is connected to. You can test this with the "zones -l" command.
Specifies the number of "region locks" that the server allows simultaneously (if PCShare is installed on the same server it must be allocated the same settings).
The default for this parameter is 10 * sessions, where "sessions" is equal to the number of units (clients) for which you bought your license.
Do not set this preference to an unnecessarily high value because this would increase HELIOS Services' requirement for UNIX system resources.
Specifies the maximum number of workstations (clients) that are permitted to work on the file server simultaneously. This value should normally be the same as the total number of Macintosh workstations that are connected to the AppleShare server. The value you choose should be less than or equal to the number of sessions allowed by your software license. The maximum tolerable number of workstations depends on the type of Macintosh applications you mostly use (whether they are file-intensive or client-server applications), on the configuration of your server system, and on its expansion stage.
This preference specifies the maximum number of files that can be opened by the file server process simultaneously. The achievable maximum cannot exceed the maximum number of open files per process currently allowed by the host. To save system resources, do not set this value higher than necessary.
Specifies the user name which is automatically allocated to guest users. The name is invisible to guest users, it is solely used to assign an entry for guests in the user list. If this parameter is specified, the file server automatically supports guest access to available volumes. Otherwise, guest access to available volumes is not possible.
The default for guestid is "nobody". The specified guest user must exist on your host. The installation automatically creates the user "nobody" if it does not already exist.
"afpsrv" normally simulates Finder info (such as file type and creator) automatically for files without Macintosh resource. The type of file is determined by inspecting the file's contents. This allows about 20 different icons to be shown for non-Macintosh files.
In the case of files created by MS-DOS applications, the file type is typically indicated by adding a suffix to the file name, the so-called the file name "extension". For example, DOS executable programs have the extension ".COM" or ".EXE" and DOS batch files have the extension ".BAT". Under EtherShare, suitable icons can be displayed for such files by specifying them in the so-called extension mapping table. This is particularly useful in the case of applications such as FrameMaker for Macintosh which are able to directly read documents created by the MS-DOS version without prior conversion. The suffixes parameter allows you to specify the location and name of the extension mapping table.
Specifies the complete path name of the "chpasswd" program, which is used by "afpsrv" to change passwords in the AFP user list. This parameter only needs to be changed if, for administrative reasons, it is necessary to modify EtherShare's default directory system.
Specifies the maximum number of AppleTalk data packets that are passed from "afpsrv" to workstations through the network during a transaction. The number of packets may need to be limited if the buffer size in the workstations is too small. localwinsize can be varied to optimize the data transfer rate.
Specifies the maximum number of AppleTalk data packets that are passed from workstations to "afpsrv" through the network during a transaction. The number of packets may need to be limited if the buffer size in the UNIX server is too small. remotewinsize can be varied to optimize the data transfer rate.
Specifies the lowest number allowed for user IDs. All users defined in "HELIOSDIR/var/conf/passwd" which have a lower user number than that specified by minuid are not recognized as valid users of EtherShare. This parameter is provided as an additional security feature.
Specifies the highest number allowed for user IDs. All users defined in "HELIOSDIR/var/conf/passwd" which have a higher user number than that specified by maxuid are not recognized as valid users of EtherShare. This parameter is provided as an additional security feature.
"afpsrv" normally simulates Finder info (such as file type and creator) automatically for files without Macintosh resource. The type of file is determined by inspecting the file's contents. This allows about 20 different icons to be shown for non-Macintosh files. Specify binonly if this feature is not required, in which case all non-Macintosh files will be treated as type DATA/UNIX, which means that UNIX text files will then become invisible to most Macintosh text editors.
The AppleShare selection in the Chooser on the Macintosh accepts passwords of any length from 0 byte to max. 8 bytes. Short passwords may represent a security risk. A password of zero length is equivalent to no password. Specify minpwlen as a numeric value between 0 and 8. To improve security, a meaningful minimum value for this parameter is 5.
As a time-saving feature when logging on, the AppleShare selection in the Chooser on the Macintosh lets you save your File Server user name and/or user password on the Macintosh's local hard disk.
To improve security, set this flag to FALSE to disable the saving of user passwords in this way, in which case all users have to enter their password manually each time they log on to EtherShare.
The File Server caches Finder information in RAM memory to optimize performance. findercache specifies the number of Finder entries to cache, and thus the amount of RAM needed that should be allocated for this purpose. Higher values require more RAM but lead to a File Server speed improvement for some Finder operations.
Note: Each entry requires about 100 bytes of RAM. The cache is used by only one single "afpsrv" (i.e. client) at a time, since it cannot be shared.
This option will cause line end translation for all files of type "TEXT", without regard to creator.
Whenever you modify a Macintosh file, the changes you make do not necessarily affect both the data file and resource file, and in many cases only the data file is changed. "afpsrv" only checks the modification date of the data file when it needs to display date and time information in the Finder. Accordingly, "afpsrv" is designed to always update ("touch") the modification date of the data file, even if only the resource fork has been modified.
However, "afpsrv" does not normally update the modification date of the resource file if only the data fork has been modified. The modification date of the resource file is usually not important, even to incremental backup procedures, and updating it would waste system resources and slow down the File Server somewhat.
Nonetheless, situations may exist where differences between the modification date of the data and resource files can cause difficulties. Such situations are typically those involving automatic data migration to slower external storage.
Specify the filedatesync flag to cause "afpsrv" to always synchronize the modification date of the resource and data files, even if only the data fork has been modified.
This preference specifies the default mode for new directories. The default value given above (0700) specifies the access rights and means that the owner has "Read, Write and Execute" rights for the directory.
In the Mac OS file system only the owner of a folder or volume can permanently change the folder's layout, e.g. sorting order, icons placement and label settings. This feature has been added to allow workgroups, e.g. users who are all members of the same group, to change layout settings or labels according to the organization of their work.
"afpsrv" will return, by default, the number of offsprings (entries in a subdirectory) as 9999 while enumerating a directory. This option can be turned off by using this flag set to FALSE. Then, the AFP-call "GetFileDirParms" on a directory gives the real number of entries.
This feature is especially useful when folders containing many subfolders, which on their part may contain many files, are in use. The Macintosh Finder, or application program, will request information not only on files in the current folder, but in addition on files in subfolders, although this information is currently not used. Therefore, this option may accelerate the opening and displaying of folders with many subfolders.
There are few Macintosh applications which rely on the exact offspring count. For those, disabling of this parameter may be required.
The texttran flag has been added to "afpsrv" in order to turn off the newline translation for all types of text files. texttran set to FALSE will disable line end translation for all files of type "TEXT", without regard to creator.
Specifies the maximum size of AppleShare/IP data packets that are passed via TCP/IP from "afpsrv" to workstations through the network during a transaction.
Specifies the time interval in seconds how often "afpsrv" checks the amount of free space on the server.
Specifies the IP address the "afpsrv" program offers to the Macintosh clients for logging in via IP-protocol (if this value remains unspecified, i.e. empty, all IP addresses on all network interfaces are offered).
This preference is applied for handling more than one
IP address, and is given out in a string in which the addresses appear comma-separated.
Specifies the path of the file containing the access list with the IP addresses which are permitted to log on to "afpsrv".
This parameter lets "afpsrv" append a record to the system messages if, due to the IP access list, access to one or more users has been denied.
Specifies the time interval in seconds after which "afpsrv" sends a tickle packet to signal that the server is still running.
If specified, the file names of all files edited (written, read, saved, etc.) on EtherShare volumes are recorded and stored sequentially in an "xferlog" file. In general, folder operations (new, move, rename), file moves within a volume, file name changes, and file deletions are not logged. Nor are operations under UNIX or from PC clients. Use this option with care since it causes considerable load on the server. This information is stored in the "xferlog" file in the same format as that used by FTP server log files. Each server entry is composed of a single line, consisting of the fields described in the following table, with the fields separated by spaces. If the "xferlog" str points to the same log file (typically in "/usr/adm") as used by the FTP server daemon (ftpd(8)), and "ftpd" logging is enabled, then both FTP and "afpsrv" file operations can be recorded in the same log.
Note: Make sure an empty "xferlog" file exists at the specified location and set file permissions sufficiently so that "owner", "group", and "others" can write to that file.
Is the time in minutes after which the "afpsrv" program gives the user a warning before he is logged-out by the "afpsrv" idletime parameter.
If set to TRUE the host sends IP-datagrams first to contact other nodes, but the exact behavior depends on the configured queueing discipline. Some high priority levels may require an effective user ID of 0.
This preference defines the AppleTalk network settings for the specified hardware network interface. The "if" preference value consists of a list of settings, separated by colons (see7.2.1 "About the "if" and "nif" preferences").
Disables AppleTalk over the specified network interface (see 7.2.1 "About the "if" and "nif" preferences").
An entry of this type is required for each hardware interface (e.g. Ethernet). ifname is the name of the interface as known to the kernel. netno is the network number in the AppleTalk network. The network number must be specified as a range with a dash (e.g. 10-15); the interface will then automatically be configured by "atalkd" as a Phase II network with this number range.
snode is the starting node number at which "atalkd" starts to look for a free node for the EtherShare host on the AppleTalk network (dynamic node number allocation). By convention, servers in an AppleTalk network have node numbers higher or equal to 128 (EtherShare usually starts at 140). zonename is the name (or a list of names delimited by colon) of the AppleTalk zone for this interface.
The "le0" interface has been allocated the network number range 30-35. Compared to an outdated Phase I network, the maximum number of AppleTalk devices allowed on the network here increases from 254 to (35-30+1) * 254. You must not use the same network number range for more than one hardware interface (see example above).
Note: If you see a Programs/atalkd/nif preference entry instead of Programs/atalkd/if this indicates that the configuration has been edited by means of the "netconf" program, and that the interface stated here, has been set to inactive.
To configure the network interfaces use the "netconf" program which is described in the EtherShare manual (except for Mac OS X which uses its own network interface configuration program).
Specifies the SMB name of the File Server. This is the name with which it is known to the network. It corresponds to Windows Server Name in EtherShare Admin's Server Settings configuration window.
Specifies the user name which is automatically allocated to guest users. The name is invisible to the guest users themselves, it is solely used to assign an entry for guests in the user list. The default for guestid is "nobody". This specified guest user must exist on your host. The PCShare installation automatically creates the user "nobody", if it does not already exist.
Specifies the number of "region locks" that the server allows simultaneously (if EtherShare is installed on the same server it must be allocated the same settings).
The default for this parameter is 10*sessions, where "sessions" is equal to the number of units (clients) for which you bought your license.
Do not set this preference to an unnecessary high value because this increases PCShare's requirement for UNIX system resources.
This preference specifies the maximum number of files that can be opened by the file server simultaneously. The achievable maximum cannot exceed the maximum number of open files per process currently allowed by the host. It is normally set by "pcshare" for itself automatically. To save system resources, do not set this value higher than necessary.
The default is the maximum number of open files per process currently allowed by the host or 256, whichever is less.
In a Windows environment, this string specifies the name of the domain in which the host is located.
Specifies the maximum number of network volumes that can be opened by Macintosh users on the File Server simultaneously.
The default is 128 volumes. Each open volume is only counted once, even if it has been opened by more than one user. The absolute maximum value is 450, but the achievable maximum may be limited by the maximum number of open files for the "desksrv" process allowed by the host. This limit is normally set by "desksrv" for itself automatically. In case of problems, refer to "limit" and "ulimit" in your UNIX documentation for details about how to increase the limit manually for your host.
This preference is the AppleTalk type of the Mail Server. This is the type with which it is known to the network. type should normally be set to "MailServer".
This preference sets the AppleTalk (NVE) name of the Mail Server. This is the name with which it is known to the network. Several names in a row, separated by a comma, are optional.
Specifies the name of the AppleTalk zone to which the Mail Server should be allocated. The chosen zone must be one of the local zones that the host is connected to. You can test this with the "zones -l" program.
Specifies the directory path of which all incoming mail is spooled. Outgoing mail is not spooled, since it is passed directly to the UNIX mail system.
Gives the interval in seconds with which the mail directory is polled for new mail. Usually, you use the "biff" program for mail notification instead, since you get immediate notification this way, and because "biff" needs less system overhead.
The Mail Server only polls for mail at the time interval specified by mailinterval if "biff" has been disabled or is not available for some reason.
This preference is a string containing the official name (UNIX mail name) of your host. This is the name which users of other systems need to include in their mail address when they want to reach you. It is made up of a name (e.g. the host name "osiris") and the domain in which the host resides (e.g. "helios.de").
Specifies the name and path of a file containing a list of
e-mail addresses. The list can be accessed by and maintained from HELIOS Mail. You can use it to save time when you often mail to the same people.
Is the name and path of the UNIX program used to send mail. You should normally use the "sendmail" program for this purpose. In some cases, you may need to use
"/usr/bin/mail" instead. However, you may encounter problems with the mail program, such as lack of 8-bit transparency. You need 8-bit transparency if you want to send mail containing national accented characters such as "umlauts". A character conversion table in the Mail Server allows you to send mail containing "umlauts" to UNIX users, too.
This switch specifies whether or not to use the UNIX "biff" program for mail notification. "biff" is the preferred method, since it needs less system overhead than polling for mail. However, on some systems "biff" is already used by other programs such as "comsat", and may not be available for use by the Mail Server. In this case, the Mail Server automatically falls back to polling for mail.
If you want to release "biff" from "comsat" for use with
the Mail Server, bracket out the corresponding line in the UNIX configuration file "/etc/inetd.conf" by inserting a
"#" at the start of the line.
Then re-initialize "inetd" with the command "kill -1 xxx", where "xxx" is the process id of the "inetd" process.
Finally, restart the Mail Server with "srvutil". The usage is described in 9.1 "srvutil".
History: "Biff" was the name of a dog belonging to a Berkeley programmer who wrote part of the UNIX mail system. Biff used to bark each time the postman delivered a (conventional paper) letter to the door.
When you installed the HELIOS software, a new address book was automatically created as the empty UNIX text file "addressbook" in "HELIOSDIR/var/conf". You can add new addresses to the list with the New Address... function of HELIOS Mail. When you use the address book, normally you will also see all users of your UNIX host, including root, in addition to users you have included manually with the New Address... function. Specify FALSE to turn off this feature, in which case the address book will only show users who have been included manually.
If you check Save name in the HELIOS Mail login window, HELIOS Mail makes a note of your name, and the zone and name of the Mail Server you want to use. Next time you start HELIOS Mail, you only need to enter your password. Furthermore, if you log on first to the EtherShare File Server on the same host, you will not have to enter your name and password for either the Mail Server or the "Mail Notification Feature" anymore. This is convenient, but presents a security risk if you leave your Macintosh unattended with volumes mounted - even if you have quit HELIOS Mail, others can start it again and have access to your mailbox without needing to type in any password. Specify FALSE to force HELIOS Mail to ask for a password each time it is started. This is similar to deactivate the Save name box in the HELIOS Mail login window, but applies to all HELIOS Mail users on that host. In this case do not forget to always deselect Save password in the same window.
Specifies the maximum number of data packets that are passed from "mailsrv" to workstations through the network during a transaction. The number of packets may need to be limited if the buffer size in the workstations is too small. This flag can be varied to optimize the data transfer rate.
Specifies the maximum number of data packets that are passed from workstations to "mailsrv" through the network during a transaction. The number of packets may need to be limited if the buffer size in the UNIX host is too small. This flag can be varied to optimize the data transfer rate.
Specifies the path of the UNIX vacation program. It is required if you want to make use of HELIOS Mail's vacation message option. For details about the vacation program and the ".vacation.msg" file, see the respective UNIX man pages.
Specifies the name of the AppleTalk zone(s) to which the PAP-Server should be allocated. Thus it determines the zone in which the Print Server can be seen in the Chooser. The chosen zone must be one of the local zones that the server is connected to. We strongly recommend to test this using the UNIX program "zones -l".
Address of the master TCP port. All active TCP printers (printers with active tcpname and TCPPublish flag) can be reached via this port.
This preference specifies the AppleTalk type of the Terminal Server. This is the type with which it is known to the network. type should normally be set to "UNIXTerminal". The same type must be set in the "Connection Settings" window of the HELIOS Terminal program.
name specifies the AppleTalk (NVE) name of the Terminal Server. This is the name with which it is known to the network. Several names in a row, separated by a comma, are optional.
Specifies the name of the AppleTalk zone(s) to which the Terminal Server should be allocated. This parameter determines the zone in which the Terminal Server can be seen in the Chooser of the HELIOS Terminal program. The chosen zone must be one of the local zones that the host is connected to. You can test this with the "zones -l" program.
This preference specifies a string which is output to each Macintosh terminal whenever a connection is made and before the login itself is started. For example, you can use this parameter to output a company trademark.
Specifies the name of the terminal emulation. This name
is written by "termsrv" to the UNIX environment variable "TERM" on starting a new connection. In the standard UNIX configuration, the VT100 emulation (i.e. a definition of terminal control codes) is defined in each of the files "termcap" and "terminfo". If you change term to specify another emulation, you must ensure that the new emulation definition has been added to both files. Whereas many programs refer to the "termcap" file, an entry is also required in "terminfo", since, under Solaris 2, some programs refer to "terminfo" (like the editor program vi) instead of "termcap". Note that the standard UNIX VT100 emulation is a subset of the VT320 emulation provided in HELIOS Terminal.
Specifies the maximum number of data packets that are passed from "termsrv" to workstations through the network during a transaction. The number of packets may need to be limited if the buffer size in the workstations is too small. The value of localwinsize can be varied to optimize the data transfer rate.
Specifies the maximum number of data packets that are passed from workstations to "termsrv" through the network during a transaction. The number of packets may need to be limited if the buffer size in the UNIX host is too small. The value of remotewinsize can be varied to optimize the data transfer rate.
This preference sets the AppleTalk (NVE) name of the Admin Server. This is the name with which it is known to the network. Several names in a row, separated by a comma, are optional.
Specifies the name of the AppleTalk zone(s) to which the Admin Server should be allocated. The chosen zone must be one of the local zones that the host is connected to. You can test this with the "zones -l" program.
Specifies the maximum number of workstations (clients) that are permitted to work on the Admin Server simultaneously. This value can be the same as the total number of workstations that are connected to the AppleTalk network, but is usually smaller than that.
Specifies the name and path of the file in which the user, optional AFP user and group data for the NIS ("Yellow Pages") system are stored.
This flag - if set to TRUE - is specified to protect (lock) all configuration data. Then, merely maintaining spool queues is possible.
Specifies the path of the host directory which contains the server font list "FontDirectory". The fonts themselves are contained in the file's subdirectories, arranged alphabetically.
EtherShare Admin allows users with sufficient permissions to configure the EtherShare system from any Macintosh workstation on the network in a convenient and secure way. For example, it can be used to set up users, groups, volumes, and printers, and re-schedule print jobs. Normally, only the system administrator is allowed to make any changes. Non-privileged users can inspect the configuration and the print job queue, but cannot change anything except delete their own print jobs.
Members of the special "system administrators" group can also use EtherShare Admin to make any changes they like, including printer configuration, and sending AFP messages with Lists/Active Users/Message/Message To All... to all AppleShare users logged-on to the EtherShare server. However, these group members are not allowed to modify any information on users with an ID less than 100 (Note that the system administrator has a user ID of 0!). The sysadmgroup parameter specifies the name of the special "system administrators" group.
Members of the special "queue administrators" group can use EtherShare Admin to manipulate print jobs and queue configurations from a Macintosh workstation. Thus, they have even more privileges than members of the "printer administrators" group that is described above. Queue administrators are allowed to:
Members of the special "printer administrators" group
can use EtherShare Admin to manipulate print jobs from
a Macintosh workstation, i.e. they are allowed to:
As a time-saving feature when logging on, the AppleShare selection in the Macintosh Chooser lets you save your File Server user name and/or user password on the Macintosh's local hard disk.
To improve security, specify the flag to disable the saving of user passwords in this way, in which case all users have to enter their password manually each time they log on to EtherShare Admin.
Specifies the path of the file containing the access list with the IP addresses which are permitted to log on to "admsrv".
This parameter lets "admsrv" append a record to the system messages if, due to the IP access list, access to one or more users has been denied.
Sets the Macintosh AFP volume name. The setting reflects that of the AFP Name: field in EtherShare Admin's Volumes: configuration window.
Sets the PCShare SMB volume name. The setting reflects that of the SMB Name: field in EtherShare Admin's Volumes: configuration window.
Specifies the volume password (currently only supported on Mac). The setting reflects that of the Password: field in EtherShare Admin's Volumes: configuration window.
Only set this flag to TRUE for removable media attached to the host which are normally changed while the host is running (e.g. MO drives). Do not apply this setting for local volumes. The setting reflects that of the checkbox Exchangeable in EtherShare Admin's Volumes: configuration window.
This flag must be set to TRUE when the underlying physical media is write protected (e.g. CD-ROM). Then, there is
- for all users - only read access to the specific volume. The setting reflects that of the checkbox Read Only in EtherShare Admin's Volumes: configuration window.
This option specifies how the server handles cross-platform record locking between clients and UNIX applications.
This option specifies how the server handles cross-platform file locking between clients and UNIX applications.
With this flag set to TRUE, the particular volume is published for Macintosh clients. The setting reflects that of the checkbox Macintosh visible in EtherShare Admin's Volumes: configuration window.
With this flag set to TRUE, guest access is allowed on the particular volume. The setting reflects that of the checkbox Guest Access in EtherShare Admin's Volumes: configuration window.
This flag makes the host use the Unicode character set encoding on the specific volume. This provides a correct cross-platform file name display (particularly if the names contain special characters, such as "umlauts" between Macintosh clients, PC clients, and UNIX servers. The setting reflects that of the checkbox Unicode/UTF-8 in EtherShare Admin's Volumes: configuration window.
This option has been added to the HELIOS server products in order to show files which start with a dot (".") as "hidden". The setting reflects that of the checkbox Hide "dot files" in EtherShare Admin's Volumes: configuration window.
This flag specifies how the file server reacts to a file close command from a PCShare client. close disables the file descriptor caching, so files are closed immediately as soon as the file close command is received. The setting reflects that of the checkbox Close Option in EtherShare Admin's Volumes: configuration window.
Specifies a list of groups which are allowed access to this particular volume. The setting reflects the entries in the Groups: field in EtherShare Admin's Volumes: configuration window.
Specifies the file name of the IP access list that makes the particular volume visible for clients which have one of the IP numbers on the IP access list.
If the UTF8 flag is set the charset flag is used to translate and encode file names to the "MacRoman" or "SJIS" character set. The setting reflects that of the AFP Charset: pop-up menu in EtherShare Admin's Volumes: configuration window.
If the UTF8 flag is set the charset flag is used to translate and encode file names to the "PC850" or "SJIS" character set. The setting reflects that of the SMB Charset: pop-up menu in EtherShare Admin's Volumes: configuration window.
This flag specifies how the file server reacts to a directory close command from the PCShare client. closedirs disables the directory descriptor caching, so directories are closed immediately as soon as the directory close command is received.
This flag specifies whether or not the server allows record locking between multiple PCShare clients.
This flag specifies how the server reacts if a PCShare client opens a file for reading or writing without indicating how (and whether) the file can be simultaneously opened by other programs. Normally, if a file is opened for reading, other users can only open the file for reading ("deny other write"). Furthermore, if a file is opened for reading and writing, other users cannot open the file at all ("deny other all").
This preference is used for enhanced user authentication on PAP and TCP queues. If set to TRUE, only users that have an open AFP volume (and are therefore authenticated to the AFP Server) can print to this queue. But this authentication only works if the queue and the AFP connection use the same address space. Newer Mac OS versions ( 9) use AppleTalk via TCP/IP, so these connections can only be used by TCP queues. Holding down the option key while you log on to the AFP Server under Mac OS 9, you connect to AFP via AppleTalk. This can be used to authenticate for PAP queues.
If a TCP/IP or PAP printer queue is set to afpsessionsonly = TRUE only users which are authenticated by the AFP Server and are specified by the Groups preference, can use this printer.
Specifies the path of the host directory which contains the server font list "FontDirectory". The fonts are contained in subdirectories of the file, arranged alphabetically.
Specifies the path containing PostScript dictionaries and printer "prep" files, such as "AppleDict..." and "HeliosDict...". You can specify an alternative path here if one of your printers is not fully compatible to the Apple LaserWriter and needs other dictionaries and/or "prep" files. Normally, all PostScript printers share the same files.
Specifies a hold queue out of the already installed printer queues. It corresponds to Hold Queue: in EtherShare Admin's Printers: configuration window.
Specifies an error queue out of the already installed printer queues. It corresponds to Error Queue: in EtherShare Admin's Printers: configuration window.
Specifies the PCShare export name of the particular printer. It corresponds to SMB Name: in EtherShare Admin's Printers: configuration window.
Specifies the address of a specific TCP port for this printer in order to allow easy access for remote printing through a Firewall. If this preference is missing the printer can only be reached via master TCP port. There is no default value for this preference.
Specifies the name under which the TCP printer is registered by SLP, and under which this printer can be reached via the master TCP port. It corresponds to TCP Name: in EtherShare Admin's Printers: configuration window.
This preference sets the AppleTalk (NVE) name of the PAP-Server. This is the name with which it is known to the network. Several names in a row, separated by a comma, are optional. It corresponds to PAP Name: in EtherShare Admin's Printers: configuration window.
This switch determines whether printing to a LaserWriter queue is password-protected or not. In case the flag is set to TRUE, user name and password have to be entered before printing. This setting affects all LaserWriter printer queues on the same server. The setting reflects that of the checkbox Require Authentication in EtherShare Admin's Printers: configuration window.
Specifies if the particular printer is published for PAP clients, i.e. for Macintosh clients. The setting reflects that
of the checkbox Macintosh - PAP in EtherShare Admin's Printers: configuration window.
Specifies if the particular printer is published for SMB clients, i.e. for Windows clients. The setting reflects that of the checkbox Windows - SMB in EtherShare Admin's Printers: configuration window.
Specifies if the particular printer is published for TCP clients. The setting reflects that of the checkbox TCP Printer in EtherShare Admin's Printers: configuration window.
This preference specifies a comma-separated list of scopes under which the printer is registered via SLP. Otherwise, the scopes preference is taken either from "papsrv" or - if not even available - from the local "slpsrv".
This preference is the AppleTalk type of the printer with which it is known to the network. This preference should normally be set to "LaserWriter", "ImageWriter" etc., since only then it will be recognized by the standard Macintosh Chooser extensions on the workstations. If the workstations are provided with a later version of the LaserWriter program, which also allows other printer types, a different type can be specified here if necessary.
Specifies the name of the AppleTalk zone(s) to which the printer should be allocated. Thus, it determines the zone in which the Print Server can be seen in the Chooser. The chosen zone must be one of the local zones that the server is connected to. We strongly recommend to test this using the UNIX program "zones -l".
Specifies the path (including the file name) of an alternative "lpr" program to the one normally used by "papsrv". The lpr parameter can be used to specify another "lpr" program which is different from the one normally selected by "papsrv". You should use this parameter if you have developed your own custom "lpr" program. You can also use this option to specify a shell script.
Specifies the path (including file name) of a custom filter program which is called in a pipe with the "standard input" connected to the print job and the "standard output" connected to "lpr". The job will already be resolved if the resolve preference is set to TRUE.
The "filtercmd" program can then process the file (which is not resolved) as required. The output file should appear under the same name ("spoolfile") given in the argument - "papsrv" will wait until the custom filter program has finished before processing the job further. Compared to the filter parameter, filtercmd can be used for example to add a header (e.g. a PostScript init) or a trailer to the file without having to process the whole file. Use filter instead if you need to parse the entire file, e.g. for font names or job information.
The resolve switch causes "papsrv" to "resolve" all print jobs for the specified printer queue before they are sent to "lpr", i.e. "papsrv" incorporates all required font, dictionary groups and OPI image information into the jobs in advance, and resolves "%%Include..." references. This is needed whenever you want to use printers that cannot be driven directly by the printer interface programs supplied with EtherShare. But be aware that if you use the resolve switch you will need substantially more spooling space on the local server.
Usually, print job resolving is done on-the-fly, by the specified interface program, such as "papif", and jobs queued in the printer's spool directory are not yet resolved. This design approach saves spooling storage, particularly if you are using ImageServer.
The resolve switch causes the "papsrv" to call the pseudointerface program "HELIOSDIR/bin/psresolve", which compares the fonts needed by the document with the printer's resident font list ("FONTS" file in the printer's spool directory), and with the list of available server fonts in
"HELIOSDIR/var/spool/psfonts/FontDirectory". Thus, this is more intelligent than choosing Postscript Job from the application's print dialog - the latter always includes all document fonts, regardless if needed or not.
You should use the resolve switch to prepare print job files for printing offline or with a printer or typesetter whose hardware interface is not supported by EtherShare, but you must not use resolve in conjunction with the standard EtherShare interface programs, because all references will be included twice and the job will fail.
Be aware that if the job then gets printed on a different host and/or printer, it will not contain all required fonts if it has been resolved with an inappropriate "FONTS" file.
The "papsrv" induces Apple's LaserWriter printer driver to spool the jobs directly to the selected EtherShare queue by default.
Specifies the printer connection type for a particular printer, e.g. AppleTalk, TCP, Create PDF, Windows Printer, etc. The setting reflects that of the Connection: field in EtherShare Admin's Printers: configuration window.
Determines whether printer errors are reported back to the originator of the print job through HELIOS Mail. Even if you specify FALSE, printer errors are still recorded in the printer log file, and many types of errors are also written to the system messages file, allowing you to view them later with EtherShare Admin or an editor program such as vi.
Specifies the time interval in seconds with which the printer interface program interrogates the printer's status channel. As a diagnostic aid, you can use the UNIX "lpq" program to check the status of each spooled printer. "lpq" returns the status messages that you normally see in the dialog box of the LaserWriter driver for locally connected AppleTalk printers.
The Print Server does not return such status messages to the workstations - it only returns them to the "Print jobs" window in EtherShare Admin. The watchtime parameter has been provided because the PostScript processors of some printers time out in certain unusual situations if you check the printer's status channel for extended periods of time.
This switch causes the printer's page count to include the number of banner pages in the total amount of pages.
This preference determines that the banner page is ouput after the print job has been terminated on the printer.
PostScript printers normally cannot accept print jobs consisting of "flat" ASCII data. They require the print job to be in PostScript format. ASCII print data can be manually converted to PostScript with the "pstext" utility. In addition to this, the interface programs of the Print Server are also able to automatically detect whether a particular job is in PostScript or ASCII format, by scanning the start of the job for the "signature" string "%!PS-Adobe". If this string is missing, the job is assumed to be non-PostScript, and is converted to PostScript automatically before printing.
This flag determines whether the "Ctrl-D" character should be used to indicate "end-of-print-job". This is necessary if the printer is connected to TCP/IP through a terminal server and a serial interface.
This flag determines whether printer status messages are reported to the AFP-client (or PCShare client, respectively). These messages pop up as display messages and report e.g. paper jams, misfed paper, and other printer-related errors.
This flag determines whether a spooled print job is "marked" with the information that it has already been spooled. If is set to TRUE, a spooled print job is not recognized as already spooled, thus setting this preference to TRUE is only meaningful for the first spooler in line of a chained EtherShare queue.
The parameter ignoreresolveopts, when set, makes a second EtherShare spooler ignore all remarks on resolved references from a prior spooling process. If you merely want a spooler to ignore single references, e.g. references regarding included fonts etc., you may set one or more of the following flags:
With the ignoreprocsetresolveopt flag set, the next (second) EtherShare spooler ignores information about included procsets only.
With the ignorefontresolveopt flag set, the next (second) EtherShare spooler ignores information about included fonts only.
With the ignoreincluderesolveopt flag set, the next (second) EtherShare spooler ignores information about included EPSF files only.
With the ignoreopiresolveopt flag set, the next (second) EtherShare spooler ignores information about resolved OPI-references only.
The preference rsslimit (resident set size limit) is determined by the maximum number of kB a printer interface program can utilize as memory. If this parameter is not set, the memory administration is up to your system settings.
The priority of a printer interface program - compared to other executable programs on the Print Server - can be altered. The UNIX parameter nice lets you increase/reduce the priority, and therefore the speed of a program. The higher the priority of a program, the less "nice" its behavior towards other applications. The values are as follows:
The printer log files ("printer.acct.x") contain information about printing time/date, document name, user, fonts, and more. With this flag set to TRUE, the range of information for each print job is increased by e.g. an OPI image replacement list and the total number of bytes printed.
facility is a string that ought to be set by the system administrator only, since its use requires advanced knowledge on UNIX programming. For further reference see the UNIX manual pages "syslogd(1)".
entity is the NVE name:type@zone of the printer (e.g. printer1:LaserWriter@HELIOS) with which it is known
to the AppleTalk network. This name is not the same as the AppleTalk name of the printer queue. Note that if print jobs are sent from workstations directly to the printer, they bypass the printer queue, and thus do not gain the advantages of spooling, "prep" file management, etc.
Specifies the maximum number of data packets that are passed from "papif" to the printer through the network during a transaction. The number of packets may need to be limited if the buffer size in the printer is too small. This preference can be varied to optimize the data transfer rate.
Specifies the maximum number of data packets that are passed from the printer to "papif" through the network during a transaction. The number of packets may need to be limited if the buffer size in the UNIX host is too small. This preference can be varied to optimize the data transfer rate.
Specifies the Internet number of the printer in the TCP/IP network (or of the printer's terminal server, if any).
This preference specifies the service port number (also called the service code), which specifies the process within host which is responsible for the printer. The port number is between 1 and 65535.
Specifies the name of the remote printer on the remote host, as stated in the "HELIOSDIR/var/conf/printcap" file.
When a print job is processed, and the flag is set to FALSE, the print job remains "untouched" and is passed on without any changes.
Specifies whether a separate communications channel for status messages with the address <port+1> is provided.
Specifies the path (including file name) of the Shared Memory "key" file. The file must already exist. The RIP must be configured with the same path.
The RIP and the "Shared Memory" interface program use the key file's "inode" to create a unique numeric key, and do not modify or write to the file in any other way. Accordingly, any existing file (such as "/bin/ls") can be used for this purpose. See the description of "ftok" in your UNIX documentation for related information.
Specifies if any resolving is done within a PostScript job. When a print job is processed to a "Print To Disk" queue, and the switch is set to FALSE, the print job remains "untouched" and is passed on without any changes.
This flag determines whether the suffix ".ps" is appended to the processed print job file. In case the switch is set to FALSE the file name extension ".ps" is omitted.
Specifies whether files which come from a specific printer queue are "marked" with a prefix before their original file name. This may be quite reasonable when several
"Print To Disk" queues print to the same destination.
Specifies the (absolute) UNIX path of the directory, where the processed print job is stored. The file name results from the print job title with the typically appended suffix ".ps".
If dir points to UNIX FIFO (named "pipe") rather than pointing to a directory, the processed print data are written to that "pipe" directly.
If dir starts with a pipe character ("|") the whole string following "|" is recognized as a UNIX command line, and the processed print data are piped into the executed program.
This parameter will only be recognized if dir is specified as well. notifyprog is called as soon as "diskif" has successfully resolved the print job.
HELIOS_JOBSIZE=
<expected print job size (in bytes). The stated value is often smaller than the actual size>
Determines the compression type. You can choose from different types of compressing: Compress and ZIP. None means that there is no file compression applied at all.
Determines the time a processed print job remains in a
hold/error queue. If jobholdtime is set to 0, the print job perpetually remains in the hold/error queue. This parameter is compulsory, i.e. it has to be set with a certain value.
A string which contains, separated by commas and without any spaces, the logical (UNIX) printer names of those devices which form a printer group for balancing print loads.
This preference specifies the host name of the machine where the CreatePDF Server/Acrobat Distiller is installed.
This parameter will only be recognized if distilldir is specified as well. With "string", you can define a file name prefix for all PDF files that are sent to the selected directory. This can help you classify your PDF files if you have several "Create PDF" queues and save all PDF files into the same directory.
This parameter will only be recognized if distilldir is specified as well. With this preference the path of the "distillnotify" program is specified.
HELIOS_JOBSIZE=
<expected print job size (in bytes). The stated value is often smaller than the actual size>
Specifies if any resolving is done within a PostScript job. When a print job is processed to a "Create PDF" queue, and the switch is set to FALSE, the print job remains "untouched" and is passed on without any changes.
If set to TRUE, this preference determines that the PDF page size is taken automatically from the BoundingBox if the job is an EPSF file rather than a PostScript file. This preference is only meaningful if distillresolve is set to TRUE as well.
With this preference a list of so-called "time spec" strings for a time queue can be defined. This type of printer queue immediately forwards the jobs to the hold queue during the specified date/time. Outside the defined times the jobs remain in the time queue until the next date/time specification is reached.
[!]Duration/StartTime[,StartTime...][/DayOfWeek[,-DayOfWeek...]
||DayOfMonth[,-DayOfMonth...][/Month[,-Month...]]]
Duration Hours:Minutes required
StartTime Hour:Minute required
DayOfWeek Sun-Sat optional
DayOfMonth 1-31 optional
Month 1-12 optional
An "!" character (exclamation mark) before the following specifications negates the entry, i.e. date/time in which the time queue must not forward jobs to the hold queue.
In the above given example, print jobs are immediately forwarded to the hold queue on Tuesdays, Wednesdays, Saturdays and Sundays from 15.001 for 3 hours (and
0 minutes).
Of course, you can specify a set of several "time spec" strings in order to obtain several modes of operation from the same time queue.
Note: By means of EtherShare Admin you can only define one "time spec" string at a time.
Note: Entries in this preference specify when a print job
is forwarded to the hold queue. Therefore, setting printtimes is only meaningful if a hold queue is already set.Specifies a comma-separated list of printer queues to which print jobs are cloned (duplicated) from the original queue.
Specifies the Windows name (or the IP address/host name) of the PC which the printer is connected to.
If a file is sent to a Windows printer queue, with this option set to FALSE, the print job remains "untouched" and is passed on without any changes.
If a file is sent to a TCP, Remote LPR, Print To Disk, or Windows printer queue, with this option set to FALSE, the print job remains "untouched" and is passed on without any changes. For this preference, the key must be extended to "Printers/<printer queue>/pcfilter/postscript".
Specifies the path to the server executable. ExecPath can be either an absolute path (starting with "/") or a relative path. A relative path is interpreted relative to the HELIOS installation directory (e.g.: "/usr/local/helios").
Specifies a list of services that <my_service> depends on. If <my_service> depends on <your_service> then <my_service> will always be started after <your_service> is started, and it will be stopped before <your_service> is stopped.
Specifies a list of services that <my_service> optionally depends on. The only difference to DependsOn is that optional dependencies are ignored if the specified service is not installed.
Specifies the time in seconds that the HELIOS Service Controller waits before it restarts a service.
Specifies the time in seconds during which the HELIOS Service Controller tries to restart a service (according to the value specified in the RestartLimit preference) before resetting the counter to "0".
Specifies whether the server works as a Directory Agent.
If this preference is not set, and more than one network interface is configured, then the server becomes a Directory Agent (8 "Service Location Protocol (SLP)"). The setting reflects that of the SLP Directory Agent: buttons in EtherShare Admin's Server Settings configuration window
(Lists > Server Preferences).
This preference contains the scopes which this server uses for SLP registrations. The setting reflects that of the SLP Scopes: field in EtherShare Admin's Server Settings configuration window (Lists > Server Preferences).
Important: If a Directory Agent is active and a Service Agent uses the scope that is NOT supported by a Directory Agent, its registrations are not available.
| © 2002 HELIOS Software GmbH |
|
|
|
|
|