HELIOS PCShare UB Benutzerhandbuch

6 Pr�ferenzen

Hinweis: Dieses Kapitel wurde nicht �bersetzt, um die Eindeutigkeit der Beschreibung zu bewahren.

This chapter lists all the preferences that are pertinent to PCShare. Find a description of how to set, view, change or delete preferences, with the HELIOS utility programs "prefdump", "prefvalue", and "prefrestore", in the Base manual.

Important: Make sure that preference keys DO NOT start or end with a slash ("/") character, and note that they are case-sensitive! Also, if any preference key or preference value includes spaces, that key or value must be enclosed in quotes.

6.1 PCShare Pr�ferenzen

(Requires a restart of the service (see "srvutil" in the Base manual) to take effect.)

Key: Programs/pcshare/<preference>

Preference

Type Default (""=empty string)

locks

int (see text)

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.

offerNTCaps

bool TRUE

If set to FALSE, an "older" protocol version compatibility mode is activated, for e.g. Windows 9x, but not NT.

unicode

bool TRUE

Offers Windows clients to use Unicode based file names.

oplocks

bool TRUE

Files which are accessed from the file server are locally cached. This brings a significant speed up to file access.

interfaces

strlist ""

Specifies the IP address the "pcshare" program offers to the SMB clients for logging in via IP-protocol. (If this value remains unspecified, i.e. empty, all IP addresses on all network interfaces are offered.)

url

str "smb://<ip-number>/?NAME=<hostname>"

Specifies the SLP (Service Location Protocol) URL of the PCShare server that is to be registered.

slplifetime

int 300

While logging on to the SLP server, each process sends along a "lifetime" value (in seconds). At intervals, the SLP server verifies that each service is still running. If so, it renews the lifetime. Otherwise, the SLP server removes the process registration from its list.

scope

str ""

This preference contains the scopes which this server uses for SLP registrations.

Important: If a Directory Agent is active and a Service Agent uses a scope that is NOT supported by a Directory Agent, its registrations are not available.

files

int 512

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 512, whichever is less.

comment

str "%p %n"

Comment field for the server in the Network Neighborhood field of the Windows client.

The default is built from the PCShare server version and the machine architecture, e.g. PCShare 4.0.0 ankh SunOS 2.8 Generic 10.

hostname

str <hostname>

Specifies the name PCShare uses to register in the SMB domain/workgroup for Windows' Network Neighborhood.

logdenied

bool FALSE

If set to TRUE, this parameter lets "pcshare" append a record to the system messages if, due to the IP access list, access to one or more users has been denied.

telnetport

int 2003

Specifies the port number of the Name Binding Service where NBS and status information can be queried (see 4.2.4 "PCShare WINS- & Konfigurationsinformationen").

RemoteAccess

bool FALSE

If set to TRUE, access to the PCShare service port (2003) is enabled to remote users (subject to the restrictions in the ipaccess list). The default is that access to the PCShare service port is only enabled for users on the same host.

ipaccess

str "var/conf/ipaccess"

Specifies the path of the file containing the access list with the IP addresses which are permitted to log on to "pcshare".

dynage

int (see text)

PCShare clients can optionally be configured for dynamic IP address allocation, rather than manually configuring the address on each client. "HELIOSDIR/var/conf/ethers.pcs" is used in this case to store a list of client IP addresses which have been automatically allocated. Dynamically allocated IP addresses will be reused by the server for other clients if they are not used by the original client for dynage days.

The default for dynage is 62 (days). If dynage=0, the server never reuses IP addresses which have been dynamically allocated.

gateway

str (e.g: "172.16.0.1")

For more information see gateways below.

gateways

strlist (e.g.: "172.16.0.1",
"172.16.1.1")

PCShare clients can be optionally configured for dynamic IP address allocation, rather than manually configuring the address on each PC. This preference specifies the name(s) and/or IP address(es) of one or more IP routers on the network (if any).

PCShare clients configured for dynamic IP address allocation are then allocated to the gateway in this list which is appropriate to their IP address. The gateways list has the same function as the "gateway" entry in the local HOSTS file, which is not present if the client is configured for dynamic IP address allocation.

primaryage

int 60

Specifies the time interval (in seconds) in which a secondary boot server synchronizes the data with the primary boot server. At each client boot request this synchronization is intended to be carried out if at least primaryage time has passed after the last synchronization.

primarydownage

int 300

Has the same effect as primaryage (see above), but takes effect only if the primary boot server fails.

staticaddresses

bool TRUE

Specifies if DHCP static "Ethernet-to-IP address" mappings, which are defined in "/etc/bootptab" or
"/etc/ethers", are used too.

bootpsyslogs

bool FALSE

Specifies if an error message is written to the "syslog" file when the "Ethernet-to-IP address" mapping is missing at BOOTP protocol requests.

dns

strlist ""

Forms the list of one or more IP addresses of the servers which can be used. It is transferred to the client via DHCP. By default, the server uses the information from the local
"/etc/resolv.conf" file.

dnsadd

str ""

Template which is used to add a new IP address to the "nsupdate" program. The default is:

update add %h.%d. %t in a %a
update add %r.in-addr.arpa. %t in ptr %h.%d.

The "% escapes" are replaced as follows:

%h Host Name
%d DNS Update Domain
%a IP Address
%r Reverse IP Address
%t DNS TTL

For more information on "nsupdate" see the respective UNIX manual pages.

dnsdel

str ""

Template which is used to delete IP addresses to the "nsupdate" program. The default is:

update delete %h.%d. in a
update delete %r.in-addr.arpa. in ptr

The "%escapes" are the same as those described in dnsadd.

dnsidletime

int 120

Stops the "nsupdate" program if it has been idling for the specified amount of time (in seconds). If necessary, it is started again.

dnsttl

int 3600

Time (in seconds) how long a DNS entry is allowed to remain in the cache.

dnsupdate

str "nsupdate"

Program which is used for dynamic DNS updates. This is part of the UNIX-named DNS bind daemon packets. The program is called in a pipe and controlled by the dnsadd and dnsdel templates.

leasetime

int 57600

Specifies the DHCP lease time (in sec.) for an IP address.

nameserver

str ""

Specifies the IP address of the primary WINS server.

nameserverbackup

str ""

Has the same effect as nameserver (see above), but only takes effect if the primary name server fails.

logserver

str <ip-addr or name>

Specifies the IP addresse(s) of those syslog servers which are to be given to DHCP clients. More than one IP address can be specified by comma-separation.

enablewins

bool FALSE

Specifies whether the built-in WINS server is switched on.

nowinsbackup

bool FALSE

Specifies whether saving the WINS data to file is switched off.

enableproxy

bool FALSE

If specified, broadcasting nodes can see WINS clients on other subnets but may get confused due to the increased name resolution network traffic.

enableproxyregcheck

bool FALSE

Can only be used in conjunction with the enableproxy preference. It helps to avoid duplicate computer names. Duplicate computer names in one network will not work reliably.

domainname

str "workgroup"

Specifies the name of the SMB domain/workgroup in which PCShare is registered.

primarydomaincontroller

bool FALSE

Specifies if PCShare simulates a Primary Domain Controller.

scopeid

str ""

This preference is normally not set. If the Windows PC is configured to use a scope identifier it needs to be identical to the Windows client configuration.

avoidelections

bool FALSE

Specifies if PCShare attempts to become LMB.

6.2 "pcfilter" Pr�ferenzen

Key: Printers/<printer>/pcfilter/<preference>

ctrld

bool FALSE

If set to TRUE, this flag filters out "Ctrl-D" characters which are used to indicate "end-of-print-job", and prefixes each job with "%!PS".

formfeed

bool FALSE

Adds a "form feed" character to the last page of the print job.

input

str ""

Specifies the file name of the input character set mapping table.

output

str ""

Specifies the file name of the output character set mapping table.

init

str ""

Specifies the byte sequence at the start of a PostScript print job.

exit

str ""

Specifies the byte sequence at the end of a PostScript print job.

cr

str ""

Specifies whether CR (carriage return) characters are converted to CRLF (carriage return/line feed).

lf

str ""

Specifies if LF (line feed) characters are converted to CRLF (carriage return/line feed).

postscript

bool TRUE

Specifies if PostScript jobs to a TCP, Remote LPR, Print To Disk, or Windows printer queue are resolved.

6.3 "smbif" Pr�ferenzen

Key: Printers/<printer>/<preference>

SMBPrinterHost

str ""

(HELIOS Admin option Computer Name)

Specifies the Windows name (or the IP address/host name) of the PC which the printer is connected to.

SMBPrinterUser

str ""

(HELIOS Admin option User Name)

Specifies the name of the user who has shared the printer.

SMBPrinterPasswd

str ""

(HELIOS Admin option Password)

Specifies the (encrypted) user password.

SMBPrinterName

str ""

(HELIOS Admin option Printer Name)

Specifies the name under which the printer is shared on the network.

SMBPrinterResolve

bool TRUE

(HELIOS Admin option PostScript Printer)

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.

postscript

bool TRUE

(HELIOS Admin option PostScript Printer)

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".