A.1 Using NSS Commands

A.1.1 Issuing NSS Commands at Command Consoles

Enter NSS commands at the NetWare server console or the NSS Console (NSSCON, nsscon(8)) on an OES 2 Linux server. For information about NSSCON, see Section B.13, NSSCON (Linux).

A.1.2 Issuing NSS Commands at Server Startup (NetWare)

NSS startup commands can run as part of the OES NetWare c:nwserver\server.exe command by using the -z option. However, these commands are not persistent through a server reboot; you must enter them each time you boot your server.

At the server command line, enter

server -z“/parameter=value

In the above example, the -z tells the server to look for specific NSS startup commands. The information in quotes is the actual command with command values, if any. For example:

server -z“cddvd”

A.1.3 Making NSS Commands Persist Through a Reboot

NSS commands issued at the command line do not persist through a server reboot. To make non-persistent command settings persist automatically through a server reboot, place the commands in the nssstart.cfg file, which NSS reads on startup. On NetWare, the file is in the c:nwserver directory. On Linux, it is in the /etc/opt/novell/nss directory. Some commands cannot be used in the nssstart.cfg file. Refer to the individual commands for information.

  1. In a text editor, create a file called nssstart.cfg in the c:nwserver directory on NetWare, or in the /etc/opt/novell/nss/ directory on Linux

  2. Enter any NSS commands that you want to persist through server reboots.

    Each NSS command should be preceded by a forward slash (/) and followed with a space.

    For example, on NetWare, the cddvd and dosfat options allow NetWare to automatically manage CDDVDs and DOS FAT partitions:

    /numworktodos=40 /cddvd /dosfat
    

    For example, on Linux, the ListXattrNWmetadata option enables the ability to return the netware.metadata extended attribute for a file or directory at listxattr(2) time. The ZLSSUpgradeNewVolumeMediaFormat option creates all new NSS volumes with the upgraded media structure that supports hard links. This applies to volumes on both local and shared pools.

    /numworktodos=40 /ListXattrNWmetadata /ZLSSUpgradeNewVolumeMediaFormat
    
  3. Save and close your nssstart.cfg file.

A.1.4 Permissions

On Linux, you must be logged in as the root user, or as a Linux user with equivalent privileges.

On NetWare, you must be logged in as the administrator user for the server, or a user with equivalent Novell eDirectory™ permissions.

A.1.5 Descriptions

The descriptions of commands provide information about the default values, range of valid values, and persistence of the command.

Default Value

The default value is the setting used for a given server configuration parameter. Initially, the value reported is the default setting for the parameter. If you modify the value, it reports the actual value.

IMPORTANT:Default values are the best choice for a majority of server configurations, but you can modify the settings to meet your needs.

Range of Valid Values

The range of valid values establishes the constraints for any particular variable setting.

Persistence

If a command’s setting is persistent, the value or policy you set remains in effect for the server through any subsequent server reboots until you next modify the settings. If a command is not persistent, the setting remains in effect only until the next server reboot. Some commands can be issued in the nssstart.cfg file in order to make the settings persist across reboots.

On Linux, the file is /etc/opt/novell/nss/nssstart.cfg. On NetWare, the file is c:nwserver\nssstart.cfg.