test

Netra j 2.0 Administrator's Guide

Chapter 6 Using Netra j System Administration

This chapter describes the system administration modules:

Audio Volume

Use the Audio module to adjust the volume for the audio files that are played through the Netra system speaker.

You can test the volume level by playing a sample sound when you set the level.

To Adjust the Audio Volume

  1. From the Main Administration page, under "System Administration," click Audio.

    The Audio Administration page, showing the current volume, is displayed.

  2. Set the volume using the information in Table 6-1.

    Table 6-1 Audio Administration

    Option 

    Description 

    Audio Volume 

    An integer between 0 and 99, inclusive, where  

    0 = no sound 

    99 = maximum volume 

    Output Port 

    The destination of the audio output. Select built-in speaker, headphone jack, or line out. 

    Play Sample Sound 

    Plays a sound at the selected volume on the Netra system speaker. Choices: Yes, No 

External Disks

Note -

The Netra software does not display the External Disks module if you do not have external disks attached to the Netra server. If you add a new external disk to an already-configured Netra server, restart the server with the "Check for new devices during restart" option so that it recognizes the new disk drive.

Use the External Disks module to create mount points for external disks or to erase any unmounted disks. You must provide the mount point for a disk drive.

The External Disk module presents a graphic overview of the external disks attached to the system. Each disk is presented as a colored icon, and the icon color represents its state. The legend correlates the icon color to states described in Table 6-2.

Table 6-2 External Disk State Color Code

Color 

State 

Comment 

Green 

Unused 

Disk is available for formatting and mounting. 

Red 

System 

Disk contains the Solaris operating environment. 

Yellow 

Erased 

Disk has been formatted. 

Aqua 

Mounted 

Disk is accessible through the file system hierarchy. 

Orange 

Non-Netra 

Disk is non-Netra, but partially or totally mounted. 

Purple 

Meta 

Disk which all or part is in use by a metadevice. 

(blank) 

Empty 

No disk. 

Over each disk icon is the disk name. If this name is a link, then following it will present a list of valid operations for that disk. Only unused or disks that have already been erased/mounted by the Netra system will show up as links.

Caution - Caution -

When you erase a disk, you lose all the data on it.

To Mount an External Disk
Note -

If an external disk is attached to the Netra server but is not in the expected Netra format, you will not see the mount option. Erase the disk first. The mount option will then be displayed.

  1. From the Main Administration page, under "System Administration," click External Disks.

  2. Under "External Disk Administration," click disk link, then click Mount External Disk.

    The External Disk Administration page is displayed.

  3. Complete the form using the information in Table 6-3.

    Table 6-3 External Disk Mountpoint Information

    Option 

    Description 

    Mount point 

    The directory on which to mount the disk. If the directory does not exist, it is created before the disk is mounted. 

     

    Note -

    A mounted disk cannot be erased through the External Disks Administration module.

To Unmount an External Disk

  1. From the Main Administration page, under "System Administration," click External Disks.

  2. Under "External Disk Administration," click disk link, then click Unmount External Disk.

    The Unmount External Disk Administration page is displayed.

  3. Click OK to confirm the operation.

To Erase an External Disk

  1. From the Main Administration page, under "System Administration," click External Disks.

  2. Under "External Disk Administration," click disk link, then click Erase External Disk.

    The Erase External Disk Administration page is displayed.

    Caution - Caution -

    When a disk is erased, all the data on it is lost forever.

  3. Click OK only if you want to erase the disk, otherwise click on the Home icon.

Default Web Server Administration

This module enables you to set the default web server. In addition, it provides access to the administration modules for Sun WebServer.

To Set the Default Web Server

  1. From the Main Administration page, under "System Administration," click Default Web Server (Port 80).

    The Default Web Server Administration page is displayed.

  2. Click Change Web Server Info.

    The Change Web Server Info Administration page is displayed.

  3. Complete the form using the information in Table 6-4.

    Table 6-4 Default Web Server Information

    Option 

    Description 

    Web Server Name 

    Enter the name of the web server. The name will appear on the link. 

    Web Server URL 

    The URL of the web server running on port 80. 

To Access Sun WebServer Administration

  1. From the Main Administration page, under "System Administration," click Default Web Server (Port 80).

    The Default Web Server Administration page is displayed.

  2. Click Sun WebServer.

    The Sun WebServer console is displayed.

  3. See the Sun WebServer online help for administration procedures.

File System Backup and Restore

Note -

The Netra software does not display the File System Backup and Restore module if a tape drive is not attached to the Netra server. If you add a new tape drive to a pre-configured Netra server, restart the server with the "Check for new devices during restart" option so that it recognizes the new drive.

Use the File System Backup and Restore module to make a copy of the user data file system and save it to tape. You can also use it to restore directories from the tape backup copy if a disk fails or if a file is accidentally deleted.

Backup Options

You can back up any or all of the following directories in the user data file system: Mail, HTML documents, Anonymous FTP, and Users' homes, and Netra configuration files. When the backup is complete, the module reports all the directories and files that have been saved via an E-mailed report to the system administrator (root) user.

Note -

The users' home directory option does not back up the system administrator's home directory. For user-specified directories and files, there is an upper limit on the number of characters in the file descriptor: for the path name, the maximum length is 155 characters; for the file name, 100 characters.

The following backup options are available:

Note -

Only a single-tape backup is supported, and the tape is rewound after the backup process is completed.

Restore Options

When a directory is restored, all files and directories in that directory are copied from the backup tape to the Netra file system. For example, if you restore the Users' homes directory, all files in all users' directories are copied to the file system.

The following restore options are available:

To Set Backup Options for a Scheduled Backup

  1. From the Main Administration page, under "System Administration," click File System Backup and Restore.

    The File System Backup and Restore Administration page is displayed.

  2. Under "Backup," click Set Backup Options.

    The File System Backup Options page is displayed.

  3. Complete the form using the information in Table 6-5.

    Table 6-5 Backup Options

    Option 

    Description 

    Backup Device 

    The tape drive that will be used for the backup procedure. If an attached tape drive is not displayed in the list, restart the server with the "Check for new devices during restart option" in the Restart and Shutdown module. 

    Eject Tape 

    Ejects the tape from the drive after the backup is completed. Choices: Yes or No.  

    Directories 

    The directories that will be backed up. You must choose at least one of the following directories: Mail (/export/mail), HTML documents (/export/htdocs), Anonymous FTP (/export/ftp), or Users' homes (/export/home). If the Web server's document root is not /export/htdocs, specify the full path name of the document root in the empty text box.

    oMaximum length for a path name prefix is 155 characters. 

    oMaximum length for a file name is 100 characters. 

    oMaximum length for a full path name is 255 characters.  

    Any file names exceeding these limits are not backed up. 

To Back Up the File System Immediately

  1. From the Main Administration page, under "System Administration," click File System Backup and Restore.

    The File System Backup and Restore Administration page is displayed.

  2. Under "Back up," click Immediate backup.

    The Immediate File System Backup page is displayed.

  3. Enter the information in the form using the information described in the Backup Device, Eject Tape, and Directories fields in Table 6-5.

    The directories you specified are backed up immediately.

To Change the Restore Device

  1. From the Main Administration page, under "System Administration," click File System Backup and Restore.

    The File System Backup and Restore Administration page is displayed.

  2. Under, "Restore" click Change Restore Device.

    The Change Restore Device page is displayed.

  3. Choose the tape drive you want to use to restore the file system (see Table 6-6).

    Table 6-6 Restore Device Administration

    Option 

    Description 

    Restore Device 

    The tape drive that contains the backup tape that will be used to restore the file system. If an attached tape drive is not displayed in the list, restart the server with the Check for new devices during restart option in the Restart and Shutdown module. 

To Restore Groups of Directories
Note -

Before you begin, make sure the tape is in the drive.

  1. From the Main Administration page, under "System Administration," click File System Backup and Restore.

    The File System Backup and Restore Administration page is displayed.

  2. Under "Restore," click Easy Restore.

    The Easy File System Restore page is displayed.

  3. Complete the form using the information in Table 6-7.

    Table 6-7 Easy Restore Administration

    Option 

    Description 

    Directories 

    The directories that will be restored from the backup tape to the Netra server. You must select at least one directory. Choices: Mail (/export/mail), HTML documents (/export/htdocs), Anonymous FTP (/export/ftp), Users' homes (/export/home). If the Web server's document root is not /export/htdocs, then replace the string "Other Directories" in the text box with the full path name of the document root.

    Restore location 

    The directory that receives the restored directories. If not chosen, the directories restored into their default directories. 

    Eject Tape 

    Ejects the tape from the drive after the restore operation is completed. Choices: Yes, No.  

To Restore Selected Directories
Note -

Before you begin, make sure the tape is in the drive.

  1. From the Main Administration page, under "System Administration," click File System Backup and Restore.

    The File System Backup and Restore Administration page is displayed.

  2. Under "Restore," click Selective Restore.

    The Selective File System Restore page is displayed. (Note that it may take several minutes for the form to be displayed because the table of contents on the tape must be read first.)

  3. Complete the form using the information in Table 6-8.

    Table 6-8 Selective Restore Administration

    Option 

    Description 

    Directories 

    The directories that will be restored from the backup tape to the Netra server. You must select at least one directory. Directories are restored recursively. (For example, if you select /export/ftp, all the files in all the directories in /export/ftp will be restored.)

    Restore location 

    The directory that receives the restored directories. If not chosen, the directories restored into their default directories. 

    Eject Tape 

    Ejects the tape from the drive after the restore operation is completed. Choices: Yes, No.  

Host Name

Use the Host Name module to change the name of your Netra server.

To Change the Host Name

  1. From the Main Administration page, under "System Administration," click Host Name.

    The Host Name Administration page is displayed.

  2. Enter the Netra server name.

  3. Restart the Netra server so that the new name is used.

Log Files

Log files should be viewed and cleared periodically. Use the Log Files module to administer the following types of log files:

To View or Clear Log Files

  1. Choose Log Files.

    The Log Administration page is displayed.

  2. Choose one of the following options:

    • To look at a log file, click View.

    • To remove a log file, click Clear; then confirm the operation.

Restart and Shutdown

Use the Restart and Shutdown module to restart or shut down the Netra server. You may need to restart the Netra server when you add new devices.

All users who are logged in to the Netra server receive a message before these operations are performed.

To Restart or Shut Down the System

  1. From the Main Administration page, under "System Administration," click Restart and Shutdown.

    The Restart and Shutdown Administration page is displayed.

  2. Complete the form using the information in Table 6-9.

    Table 6-9 System Restart/Shutdown Administration

    Option 

    Description 

    Shut Down 

    Shuts down and powers off the Netra server. 

    Restart 

    Restarts the Netra server. 

    Check for new devices during restart? 

    If this option is selected, the operating system regenerates the list of devices attached to the Netra server. Use this option if you add a tape drive, CD-ROM drive, external hard disk, or network interface hardware to your server. 

    Delay 

    The number of minutes before the Netra will shut down or restart. 

Save and Restore Configuration

The Save and Restore Configuration module enables you to:

You should save the system configuration whenever it is changed so you can return to this configuration state if necessary.

Save and Restore Options

The following options are available to save and restore your system configuration:

Table 6-10 describes when file system options are displayed on the Netra j 2.0 Main Administration page.

Table 6-10 Options Displayed

Option 

When the Option is Displayed on the Main Administration Page 

Eject Diskette 

The diskette is in the disk drive. 

Save Configuration to Diskette 

The diskette is in the disk drive. 

Restore Configuration from Diskette 

The diskette in the disk drive contains valid Netra configuration information. 

Restore Configuration from File System 

The Netra configuration state has previously been saved to a file on the hard disk. 

To Save the System Configuration

  1. If you are saving to diskette, insert the diskette into the drive; otherwise, proceed to Step 2.

    Make sure the diskette is not write-protected.

  2. From the Main Administration page, under "System Administration," click Save and Restore Configuration

    The Save and Restore Configuration Administration page is displayed.

  3. Click either Save configuration to diskette or Save configuration to file system; then confirm the operation.

To Restore the System Configuration

  1. If you are restoring the configuration from a diskette, insert a diskette into the drive; otherwise, proceed to Step 2.

  2. From the Main Administration page, under "System Administration," click Save and Restore Configuration

    The Save And Restore Configuration Administration page is displayed.

  3. Click either Restore configuration from diskette or Restore configuration from file system.

  4. Complete the form using the information in Table 6-11.

    Table 6-11 Save/Restore Configuration

    Option 

    Description 

    Restore entire configuration  

    Restores all configurations from the diskette/disk.  

    Restore selected configurations  

    Restores only the selected configurations from the diskette/disk. If you select this option, you must also select at least one configuration; if you select any configurations, you must also select this option. 

To Eject a Diskette

  1. From the Main Administration page, under "System Administration," click Save and Restore Configuration

  2. Click Eject diskette.

    The Eject Diskette page is displayed, telling you that the diskette has been ejected.

Software Management

The Software Management module is used to install and remove software on the Netra server. This module recognizes software that is supplied in the Solaris package, patch, or cluster formats. All Sun software and most third-party software can be managed using this module.

A package is a collection of files and directories required to form a software application.

A cluster is a logical grouping of software packages associated with a specific software product.

A patch is a collection of files and directories that replace or update existing files and directories that are preventing proper execution of the software. The existing software is derived from a specified package format, and can be installed only if the package it fixes is already present.

Note -

When installing or removing software associated with specific hardware, ensure that the hardware is already installed and is part of the system device list. For example, before you install the Token Ring Interface software, make sure that the Token Ring Interface card is installed in the Netra server and that the server has regenerated its list of attached devices (see "Restart and Shutdown").

Install and Remove Options

The Software Management module offers the following options:

To Specify the Installation Medium

  1. From the Main Administration page, under "System Administration," click Software Management.

    The Software Management Administration page is displayed.

  2. Under "Select Installation Medium," Select new installation medium.

    The Select Installation Medium page is displayed.

  3. Choose the medium from which you will install packages or patches.

    If you select CD-ROM or Diskette, the medium is automatically mounted onto the system as part of the installation. If you select Mounted Directory, enter the path to the directory from which the software will be installed.

To Install Clusters, Packages, or Patches

  1. From the Main Administration page, under "System Administration," click Software Management.

    The Software Management Administration page is displayed.

  2. Under "Install," click Clusters, Packages, or Patches.

  3. Complete the form using the information in Table 6-12.

    Table 6-12 Installing Packages or Patches

    Option 

    Description 

    Install All Clusters/Packages/Patches 

    Installs all clusters, packages, or patches from the selected installation medium. 

    Install Selected Clusters/Packages/Patches 

    Installs only the clusters, packages, or patches you select from the list. If you select this option, you must also select at least one cluster/package/patch; if you select any clusters/packages/patches, you must also select this option. 

  4. Restart the Netra server using System Administration: Restart and Shutdown.

To Remove Packages or Patches

Note -

The Software Management module cannot remove a package if there is another package on the system that requires its presence. The module attempts to remove packages in the order which they are displayed, and since this may not reflect the dependency order, the removal of a core package may fail even if the packages that depend upon it are also removed. If this happens, re-select the packages that failed and remove them again.

  1. From the Main Administration page, under "System Administration," click Software Management.

    The Software Management Administration page is displayed.

  2. Under "Remove," click Packages or Patches.

  3. Complete the form using the information in Table 6-13.

    Table 6-13 Removing Packages or Patches

    Option 

    Description 

    Remove All Patches 

    Removes all patches on the Netra server. 

    Remove Selected Packages/Patches 

    Removes only the packages or patches you specify from the list. If you select this option, you must also select at least one package or patch; if you select any packages or patches, you must also select this option. 

    You cannot remove all installed packages. 

  4. Restart the Netra server using System Administration --> Restart and Shutdown.

To View Installed Packages or Patches

  1. From the Main Administration page, under "System Administration," click Software Management.

    The Software Management Administration page is displayed.

  2. Under "View," click Installed Packages or Installed patches.

    The Viewed Installed Packages or Viewed Installed Patches page is displayed.

System Administrator Alias

Use the System Administrator Alias module to create the list of people who will receive mail addressed to the system administrator (who is also known as the UNIX root user).

Each person on the list must be a valid mail address. Valid alias members who cannot be reached at configuration time will be added to the alias, but any mail sent to that alias will not be delivered.

To Set Up a System Administrator Alias

  1. From the Main Administration page, under "System Administration," click System Administrator Alias.

    The System Administrator Alias Administration page is displayed.

  2. Enter the mail addresses of the alias members (see Table 6-14).

    Table 6-14 System Administrator Alias Administration

    Option 

    Description 

    Alias Members 

    A list of users, one per line, who will receive mail sent to root. Each listed user must be a valid mail address. If any valid alias members cannot be reached at the time of configuration, they are added to the alias, but mail sent to the alias is returned to the sender.

    The maximum length of the alias is 1000 characters, including implicit commas that are added between successive alias members. 

    Note -

    If the Netra software has been installed onto a server that mounts /var/mail from a remote server, mail is handled by the remote server. This situation requires that the members of the administrator alias are valid mail addresses on the remote server.

System Defaults

Use the System Defaults module to change the time zone and locale for your Netra server.

Note -

If you change the time zone or locale, restart the Netra server so that the new value takes effect.

To Set System Defaults

  1. Choose System Defaults.

    The System Default Administration page, showing the time, date, time zone, and locale, is displayed.

  2. Complete the form using the information in Table 6-15.

  3. If you change the time zone or locale, restart the Netra server so that the new value takes effect.

    Table 6-15 System Defaults

    Option 

    Description 

    Default System Time Zone 

    The default time zone used by the Netra server. You can override the default time zone by setting the TZ environment variable. 

    Default System Locale 

    The default locale used by the Netra server. You can override this default by setting the LANG or LC* environment variables. Some of the available locales are partial locales. Choosing a partial locale sets up the system to display localized numeric, monetary, and calendar formats, but not localized user interfaces or messaging. 

User Accounts

The User Accounts module enables you to add new user accounts, or change or delete existing accounts. The User Accounts module enables the addition of new user accounts, and to modify or delete existing ones. Creating an account allocates the new user a home directory on the Netra server and enables the user to access the services that are available on it, which may include mail for example. The account can be accessed through standard protocols such as telnet, rlogin, ftp and rsh, provided the server is configured to accept them.

When creating the account, specify an initial password for the user. This enables users to log in to the Netra server the first time. Before they can do anything with their accounts, they are asked to provide and verify a new password.

The form asks to specify a default shell for the user, including an option No shell (email only). If this option is chosen, the user is not able to log in, but receives mail on the server if it is configured as a mail server. This scenario is useful if the Netra server is acting as a mail host whose mailbox directory is mounted onto the clients, but not as a login host.

If no users are defined, only the Add A User option is available. When user accounts have been added, there are also options to Modify or Delete specific users. When a user account is removed, the corresponding home directory is deleted recursively and the users mailbox is removed. The user is no longer be able to log into the server.

The user account module can only be used for ordinary users. System users such as root and ftp or the Netra setup user cannot be administered from the module.

To Add a User Account

  1. From the Main Administration page, under "System Administration," click User Accounts.

    The User Accounts Administration page is displayed.

  2. Under "New Users," click Add A User.

    The Add A Local User page is displayed.

  3. Complete the form using the information in Table 6-16.

    Table 6-16 User Accounts

    Option 

    Description 

    User Name 

    The login name of the user to add or modify. For example, jsmith. The user name must be unique and must not be among the list reserved for systems users. If such a name is chosen, the User Accounts module asks for another. The reserved user name list is displayed on the help page. 

    Password 

    The password the user must provide when logging in to the Netra server for the first time. The user is not able to log in unless the Activate login with password shown above? option below is chosen. 

    Retype Password 

    As the password is not echoed on the screen, it must be confirmed by re-entering it. 

    Activate login with password shown above? 

    Account activation needs to be deliberately confirmed. If checked yes, this option activates the account login with the password entered in the 'Initial password' field for the user's first login.  

    Full Name 

    The full name of the user you want to add/modify. Example: Jerry The Mouse 

    Login Shell 

    The default shell for the user. Choices: C shell (csh), Korn shell (ksh), Bourne shell (sh), No shell (mail only). If you choose No shell (email only) the user will get mail on the Netra server, but will not be able to log in.

    Home Directory Server Name 

    Specify the host name and the full path name of the home directory of the user. If the local host is a NIS master, then this information is used to update the auto.home map. If the user's home directory is on this local system itself, then sharing of the user's home directory through NFS is enabled. The user's password entry is also added to the NIS password maps. If the user's home directory resides on a remote system, the server will update the local auto.home. However the directory on the remote system has to be created manually on the remote system.

    Home Directory Path Name 

    Specify the full path name of the user's home directory. A typical home directory path would be like /export/home/username.

To Add Users From a File

The default password will set to the username.

  1. From the Main Administration page, under "System Administration," click User Accounts.

    The User Accounts Administration page is displayed.

  2. Under "New Users," click Add users from a file.

    The Add users from a file page is displayed.

  3. Complete the form using the information in Table 6-17.

    Table 6-17 Users From a File Administration

    Option 

    Description 

    Input File 

    Full path to a UNIX file which must be correctly formatted. No comments or blank lines are allowed. For example, if the field separator specified below is a comma, each line entry must be formatted as follows: username,<UID>,password. The username and password must be composed of one to eight alphanumeric characters. Each username must be unique and must NOT be any of the following system account names; root, daemon, bin, sys, adm, lp, smtp, uucp, nuucp, listen, nobody, noaccess, nobody4, setup, ftp. The UID must be between 1000 and 59999. The administrator can optionally leave the uid field blank and one will be assigned. For security reasons, the input file must be owned by root with all group/other permissions removed.

    Field Separator 

    The character used to delimit each field in the input file.  

    Home base directory 

    Full path to a directory that will hold the users home directories. For example, if /export/home is specified as the home base directory, a valid input file entry for a user called sample will create a home directory, /export/home/sample. The root directory is not acceptable as a base. Where the base directory does not exist, it will be created if possible.

To Modify or Delete a User Account

  1. From the Main Administration page, under "System Administration," click User Accounts.

    The User Administration page is displayed, with a Modify or Delete option for each existing account.

  2. Under "Existing Users," click one of the following options:

    • To modify an existing account, click Modify and make the changes in the form using Table 6-16.

    • To delete a user account, click Delete, then confirm the operation.