previous - next - up - title - contents - index

4.11.1 Overview of server parameters


Note: The default values of the server parameters are given in square brackets.

Dynamic parameters

autodc [1]

This parameter controls the caching of the directory structure of a disk (see "The directory cache" on page 34). If a disk is inserted into a drive, iXOS-JUKEMAN checks if the root directory is cached. If it is not cached already then autodc controls the further behavior:

autodc =

Meaning

0

no caching will be performed

1

caching is performed only if a permanent hard disk directory cache is configured

2

iXOS-JUKEMAN will cache the entire directory structure, even if only a RAM cache is configured

The dynamic caching performed due to file system requests is not affected by this parameter.


blanks [0]
After changing a disk or issuing a `test' command iXOS-JUKEMAN tries to determine the type of disk. For empty CD-Rs or disks which are not ISO 9660-conforming or non-finalized disks written with the incremental file system (see "Burning disks incrementally" on page 154) this test cannot be completed successfully with many reader drivers. In these cases the disk will be tested in a recorder drive to determine the disk type.

The parameter blanks can be used to speed up the test procedure:

blanks =

Meaning

0

disks are preferably tested in reader drives (faster than recorders)

1

disks are always tested in recorder drives, if available

2

no testing is performed and the disks are assumed to be blank

cachew [1]

Specifies the caching behaviour for harddisk images:

cachew =

Meaning

0

No caching for harddisk images.

1

Store directories of the harddisk images in the directory cache

2

Store directories in the directory cache, and data in the data cache.


fullvn [0]

Specifies the format of disk names views that use the format pc.

fullvn =

Meaning

0

Disk names are converted to 8.3 format.

1

Allow long filenames (up to 32 characters). This is useful for networks, where only Windows NT or Windows 95 PCs are used, but not if Windows for Workgroups clients are used.


hfsiso [1]
iXOS-JUKEMAN supports Apple HFS CDs and Hybrid CDs which contain both HFS and ISO 9600 directory structures. For Hybrid CDs, by default iXOS-JUKEMAN reads the ISO 9660 directory structure and ignores the HFS structure. If this parameter is set to 0, preferences are reversed, and Hybrid CDs will appear as HFS, not as ISO 9660. The default value of hfsiso is 0 for new installations on NT.
ignore [0]
Setting this parameter to 1 causes the server to ignore all file system requests on UNIX. This can be changed dynamically, for example to block the server for a while.
iotimo [60]
Time-out in seconds until failed disk reads are abandoned.
loglev [4]
iXOS-JUKEMAN maintains a log file called logfile.txt in the JUKEMAN directory. The messages in this file are classified in ten log levels, where level 0 is of highest priority (see also "Log file logfile.txt" on page 257). The parameter loglev is the limit that keeps log messages with a higher log level than this limit out of the log file. For your first try, use a value of 5 or 6 to see if everything works fine.
lwords [5]
The iXOS-JUKEMAN server internally stores last recent log messages in a buffer. If problems occur, then this buffer is written to the log file. This parameter sets the log level for the `last words'.
mdelay [3]
iXOS-JUKEMAN has a sophisticated adaptive scheduling policy for accessing disks. It learns from accesses in the past. When the server has to move a disk out of a drive to insert a new one, the server must first select, which disk will be removed from the drive to make room for the new disk. It is often preferable to delay this disk exchange as data requests are usually queued for the current disk. This parameter sets a limit for the delay. Value 0 means a strict serial use of the access queue (not very sensible). The greater the value the longer the delay even if there is no access to the disk.
oldifs [1]

Specifies whether non-finalized CDs written with IFS 2.1 will be detected. (see "How to migrate from IFS 2.1 and 2.2 to 2.3" on page 43):

oldifs =

Meaning

0

CDs written with IFS 2.1 will not be detected.

1

CDs written with IFS 2.1 will be detected.

rahead [3]
Specifies the number of chunks the data cache reads ahead from disks. The chunk size is given by the parameters rtrack or atrack.
reject [1]
Specifies how incomplete disks are treated (e. g., if the burning process for a CD was interrupted). For reject=0, iXOS-JUKEMAN tries to read as much as it can from the incomplete disk. For reject=1, no incomplete iXOS-JUKEMAN-CDs will be accepted. If set to 2, incomplete disks will not be accepted at all.
The default is reject=1. If the disk is not fully readable, it is very likely that some error occurred during burning the disk, and it appears as a bad disk. This setting will make sure to mark only those disks as readable where disk length and actually written data match.
satdpb [1]

Specifies the behavior of the NSM Satellite's pack buttons that control the removal of packs while the jukebox is running. Changing this parameter while the server is running will only become active when the Satellite jukebox is detached and then attached again.

satdpb =

Meaning

0

Pack buttons are not locked, packs can be removed.

1

Pack buttons are locked, packs cannot be removed.

trayto [60]
This parameter can be used together with Kodak CDL 144, Hyundai HAS-550, Plasmon D-Series, and Sony CDL-2*** jukeboxes. It is the time in seconds that the server waits until the mail slot of a jukebox is closed manually. After that time, the mail slot tray is closed automatically and the new (or old) disk is tested.
For the Pioneer DRM 5004 X and the Grundig GMS 1035 the parameter has a special meaning due to the virtual mail slot and the door hiding the mail slot, respectively: It specifies the time-out for the user to open the door, exchange the disk, and close the door again for a disk change. After this time-out normal operation is resumed.
For all other types of jukeboxes this parameter is irrelevant.
The following table lists the dynamic parameters as well as the units, the default values, the minimum and the maximum values:

Table 5 - Dynamic parameters

Name

Unit

Default value

Minimum

Maximum

autodc


1

0

2

blanks


0

0

2

cachew


1

0

2

fullvn


0

0

1

hfsiso


1

0

1

ignore


0

0

1

iotimo

seconds

60

0

3,600

loglev


4

0

9

lwords


5

0

9

mdelay


3

0

99

oldifs


1

0

1

rahead


3

0

1000

reject


1

0

2

satdpb


1

0

1

trayto

seconds

60

0

99,999,999

Static parameters

admdno [4,028]
For communication with cdadm, cdnfsd opens a TCP socket on the port specified by this parameter.
atrack [32]
Similar to rtrack, but used for audio CDs. Specifies the number of audio blocks (2352 bytes) that form a chunk. The number of chunks which the cache reads ahead from audio CDs is given by the parameter rahead. The value of atrack must be divisible by 4.
cdnfsp [100,003]
This parameter defines with which program number iXOS-JUKEMAN registers its NFS service, if no other program of that kind exists. Value 0 means no registration.
dcheck [300]
iXOS-JUKEMAN performs a periodic disk check for single drives and towers. This simplifies changing of disks, since no interaction with the server is required. The change is detected automatically.
The parameter defines a time intervall in centiseconds. After this time iXOS-JUKEMAN checks whether a disk has been changed. Value 0 turns off the check.
jobnum [192]
Defines how many file system requests the server can queue internally. If you have more than 1,000 clients, this number should be increased.
maxcvt [1,000]
This parameter defines how many nodes the view tree of the controlled disks can have.
maxthr [40]
Specifies how many processes can be started.
mountp [20,000,234]
Defines the program number the server uses to register its mount service if there is no such program already registered. Use 0 for no registration at all.
mpsize [4,194,304]
For fast memory allocation and short time caching iXOS-JUKEMAN maintains a memory pool. The size of this pool limits some capabilities like drives per jukebox or size of an ISO 9660 directory. The default value of 4 MB is enough to define jukeboxes with more than 1,000 drives per jukebox, and read directories with about 20,000 entries. The value of mpsize must be a multiple of 64.
nonfsd [0]
Set this parameter to 1 to prevent the NFS server built in iXOS-JUKEMAN from starting. This is only useful on Windows NT, as NFS is the only way to connect to the file system if iXOS-JUKEMAN is running on UNIX.
portno [4,027 (UNIX) or 2,049 (NT)]
Defines the UDP port for NFS and cdadm requests.
rtrack [65,536]
Defines the chunk size of files to be cached in the data cache (in RAM or as a file). This value must be a multiple of 8,192 (8 KB). The size of rtrack is related to the size of the regular data cache: If rtrack is more than half the size of the data cache, the server will automatically increase the data cache size to at least twice the size of rtrack (data cache >= 2*rtrack).
synclm [0]
With a value of 1 log messages will not be buffered but written directly to the log file.
waitpm [0]
This parameter defines the time (in seconds) the server waits for a delayed portmapper to be started.
The following table lists the static paramters as well as the units, the default values, the minimum and the maximum values:

Table 6 - Static parameters

Name

Unit

Default value

Minimum

Maximum

admdno


4,028

1

65,535

atrack

2,352 bytes

32

4

1,028,576

cdnfsp


100,003

0

99,999,999

dcheck

1/100 seconds

300

0

999,999

jobnum


192

9

8,192

maxcvt


1,000

10

65,536

maxthr


40

12

1,024

mountp


20,000,234

0

99,999,999

mpsize

bytes

4,194,304

262,144

2,147,483,648

nonfsd


0

0

1

portno


4,027 (2,049)

1

65,536

rtrack

bytes

65,536

8,192

16,777,216

synclm


0

0

1

waitpm

seconds

0

0

3,600


previous - next - up - title - contents - index