6    Postinstallation System Setup and Viewing Online Documentation

This chapter provides information about:

• Setting up your system for general use

• Viewing online documentation

• Enabling realtime preemption after the installation

• Enabling unattended reboots on multiprocessor systems

The goal of this chapter is to provide the information necessary for you to perform the user actions shown in Table 6-1.

Table 6-1: Summary of User Actions

6.1    Setting Up the System from the SysMan Configuration Checklist

If your system has graphics capabilities, system setup is done from the SysMan Configuration Checklist. This checklist provides access to the SysMan applications that are available to set up your system for general use. There are three ways to invoke the checklist:

• The first time you log in as root after a system installation or the first time you log in to a factory installed software (FIS) system with graphics capabilities, the SysMan Configuration Checklist displays automatically.

• To open the SysMan Configuration Checklist from the UNIX command line, as superuser or root, enter the following command:

  #  /usr/sbin/checklist
  

• To invoke the SysMan Configuration Checklist from the Common Desktop Environment (CDE) front panel:

  1. Click on the Application Manager icon on the CDE front panel.

  2. Double click on the System_Admin application group icon.

  3. Double click on the SysMan Configuration Checklist application icon.

For your system to be fully productive and communicative with other systems and users, you may want to set up networking, mail, printing, and user accounts. In addition, when you buy a product from Digital, Digital issues you a license to use the product. The license is described by the license Product Authorization Key (PAK) you received. To be officially authorized to use the Digital UNIX operating system, you must register the license information on the PAK by using the License Manager application.

The SysMan Configuration Checklist provides access to a number of SysMan applications including but not limited to the applications shown in Table 6-2. Table 6-2 also lists the reference pages associated with the SysMan applications. Install the OSFMANWOS400 software subset if you want to view the graphical SysMan application reference pages with the man command.

Table 6-2: SysMan Configuration Checklist Applications and Associated Reference Pages

To invoke a SysMan application, double click on the icon that appears to the left of the application name. After you invoke and exit an application, a check mark appears in the box to the left of the icon. The date and time you last accessed an application is shown under the application name.

You can view an online overview of the SysMan Configuration Checklist applications by clicking on the Help pushbutton located at the lower right hand corner of the SysMan Configuration Checklist main window.

The applications on the SysMan Configuration Checklist appear in the approximate order in which Digital recommends them to be run. For instance, if you plan to connect or add the system to a network, the first task you should perform is to set up the network by using the Network Configuration Application followed by the BIND Configuration Application, NIS - Network Information Service, and the NFS Configuration Application. If you do not want to set up networking, the first task you should perform is to load and register your Product Authorization Keys (PAKs) using the License Manager.

An application is dimmed from the checklist when it cannot be accessed.

Online help is available for each SysMan application by clicking on the Help pushbutton in the application. The online help describes how to use the application, the entries to make in the text entry fields, and reference material.

6.1.1    For More Information About System Setup

If you need more information about setting up the system for general use, read the relevant books in the Digital UNIX documentation set:

• The Network Administration guide provides information about setting up and administering a network.

• The System Administration guide provides information about system administration tasks such as configuring printers, adding user accounts, backing up and restoring files, shutting down the system, and so on.

• The Software License Management guide provides information about loading and registering license PAKs.

Section 6.6 describes how to use Netscape Navigator for online viewing of the Digital UNIX documentation set.

Section 6.7 describes how to activate the Bookreader application for online viewing of associated product documentation that is provided in .decw_book files.

6.2    Setting Up the System from the Command Line

If your system does not have graphics capabilities, you can access a set of menu-driven, text-based system setup scripts to set up your system for general use.

You can access this setup menu from the command line as the user root by entering the following commands:

#  su - 
password: 
 
#  /usr/sbin/setup

A menu similar to the following is displayed:

Use this menu to set up your system and network.  When you
select an item, you will be asked a series of questions.

 

For more information about the items on the menu and the
questions you must answer, see the System Administration
and Network Administration guides.

 


 

         1) Network Configuration Application
         2) BIND Configuration Application
         3) NIS - Network Information Service
         4) NFS Configuration Application
         5) License Manager
         6) Mail Configuration Application
         7) LAT - Local Area Transport
         8) UUCP - UNIX-to-UNIX Copy System
         9) NTP - Network Time Protocol
        10) Printer Configuration Application
        11) Security (BSD/C2)
        12) Security Auditing
        13) Prestoserve I/O Acceleration
        14) Update Administration Utility
        15) Graphical UI Selection Facility
        16) Exit

 

Enter the menu item number that you want:

Availability of the setup scripts on this menu depends on the software subsets that were installed. In the previous sample menu, all mandatory and optional software subsets were installed, so all setup scripts are available. If a setup script does not have an option number next to it, the setup script is not available for use.

Each of the setup scripts is a series of interactive prompts during which questions are displayed on the screen and you respond accordingly. Most questions provide you with default responses and in most cases, you can choose the defaults. Any default parameters that you accept can always be changed at a later time.

The setup scripts appear on the menu in the order in which Digital recommends them to be run. For instance, if you want to set up the system to run in a networked environment, the first task you should perform is to set up networking information by using the Network Configuration Application followed by the BIND Configuration Application, NIS - Network Information Service, and the NFS Configuration Application. If you do not want to set up your system to run in a networked environment, the first task you should perform is to load and register your Product Authorization Keys (PAKs) using the License Manager.

You should read the relevant sections of the Digital UNIX documentation set before running a setup program or choosing an option from the Setup menu. The documentation lists the prerequisites to running a specific setup program.

• The Network Administration guide provides information about setting up and administering a network.

• The System Administration guide provides information about system administration tasks such as configuring printers, adding user accounts, backing up and restoring files, shutting down the system, and so on.

• The Software License Management guide provides information about loading and registering license PAKs.

Section 6.6 describes how to use Netscape Navigator for online viewing of the Digital UNIX documentation set.

Section 6.7 describes how to activate the Bookreader application for online viewing of associated product documentation that is provided in .decw_book files.

6.3    Files Left on Your System After the Installation

The installation procedure leaves the init file in the /tmp directory. This is an unnecessary file that you can delete.

Many files with the prefixes .new.. and .proto.. are left on the system. The update installation process (documented in Chapter 2) requires the .new.. and .proto.. files to retain customizations during the update installation process. Do not remove these files.

6.3.1    Installation Log Files

A list of the log files created during the installation is displayed on the screen (or in the console log if you have a workstation) after you log in for the first time. The display is similar to the following:

Digital UNIX V4.0 (Rev. xxx); Fri Mar 15 15:54:51 EDT 1996
Digital UNIX V4.0 Worksystem Software (Rev. xxx)

 

The installation software has successfully installed your system.

 

There are log files that contain a record of your installation.
These are:

 

  /var/adm/smlogs/install.cdf     - configuration description file
  /var/adm/smlogs/install.log     - general log file
  /var/adm/smlogs/install.FS.log  - file system creation logs
  /var/adm/smlogs/setld.log       - log for the setld(8) utility
  /var/adm/smlogs/fverify.log     - verification log file

The previous message is also recorded in the /etc/motd file for your future reference. The /etc/motd file contains the message of the day that is displayed each time a user logs in. The installation log files are located in the /var/adm/smlogs directory and include the choices you made during the installation (such as the disks and partitions you chose, the software subsets you installed, and so forth).

6.4    Enabling Realtime Preemption After the Installation

The Digital UNIX kernel provides options to enhance the performance of realtime applications conforming to POSIX 1003.1b-1993 (formerly 1003.4 Draft 14). The realtime kernel makes it possible for the operating system to guarantee that an application has access to resources in a timely and predictable manner.

The realtime kernel that supports kernel preemption was previously installed as an option during base system installation. Now, the POSIX 1003.lb portions are included in the kernel automatically and a separate kernel is not needed. Preemption capabilities are disabled by default, but can be selected and enabled when the kernel is configured and built.

There are two methods to obtain additional realtime capabilities:

• Use a text editor of your choice to edit the /etc/sysconfigtab file and set the rt-preempt-opt parameter equal to 1 as shown in the following example:

  rt-preempt-opt=1

  After setting this parameter, you must reboot your system. When the rt-preempt-opt parameter is set, the system chooses the correct lockmode to support realtime preemption. On a uniprocessor system, the lockmode is set to 1. On a multiprocessor system, the lockmode is set to 3.

You can also do the following to enable realtime preemption:

• Use the setld command as shown in the following example:

  1. Issue the following command:

     #  setld -c OSFBIN400 RT_ON
     

  2. Run doconfig without any options to generate a new kernel configuration file. Then, copy the new kernel file which is created in /usr by default to the root directory as the file /vmunix. After the RT_ON operation shown in Step 1, the configuration file will contain the entry options RT_PREEMPT_OPT that causes preemption to be on by default (in the appropriate lockmode).

6.5    Enabling Unattended Reboots on Multi Processor Systems

To reduce system down time due to a processor failure on a multiprocessor system, an unattended reboot feature is available for multiprocessor platforms.

To enable unattended reboot functionality, halt the system and set the following console parameters:

>>>  set boot_osflags a
>>>  set boot_reset off
>>>  set auto_action restart

When processor failures are detected on a multiprocessor platform, the system marks the faulting processor as failed, and the entire system is rebooted without any operator intervention. The faulting processor will not be restarted when the reboot occurs. To restart the faulting processor, corrective action must be taken. The system will not try to restart the failed processor until the power has been recycled on the system or the console init command is issued at the console prompt (>>>).

6.6    Invoking Netscape Navigator to View Digital UNIX Documentation

Each book in the Digital UNIX documentation set is shipped as individual files in HTML format which enables them to be viewed with the Netscape Navigator World Wide Web browsing program. Digital UNIX Version 4.0 is shipped with Netscape Navigator Version 1.12I and the Netscape software subset is installed automatically if the installation procedure detects graphics capabilities on your system. After installing Digital UNIX, you can invoke Netscape from an icon on the CDE front panel or directly from the command line. Detailed help for Netscape is available through the help menus.

After invoking Netscape, a Digital UNIX home page is located at the following location: usr/doc/netscape/Digital_UNIX.html. The home page contains links to helpful documentation, including a local copy of the Netscape User's Handbook (consider adding this link to your list of Netscape bookmarks).

Follow these steps to mount the documentation CD-ROM and invoke Netscape:

1. As superuser or root, mount the CD-ROM labeled Digital UNIX V4.0 Documentation Volume 1 under the /usr/share/doclib/online directory:

   1. If you do not know the CD-ROM device name, use the file command specifying the raw device to find it. CD-ROM devices are prefixed with the letters RRD. Using the | (pipe) command to filter the output of the file command to the grep command to search for RRD ensures that only your CD-ROM devices are output in the result of the command. Enter a command similar to the following:

      #  file /dev/rrz*c | grep RRD
      

      /dev/rrz4c: character special (8/4098) SCSI #0 RRD44 disk #32 \
      (SCSI ID #4)
      

      In the previous example, the CD-ROM device is RRD44 on device /dev/rz4c. The backslash in the previous example indicates line continuation and is not in the actual display. If you have more than one RRD device connected to your system, specify the device where the CD-ROM will be mounted.

      Standard device names begin with rz for the block special file and rrz for the raw (character) special file. The result of the file command displays the raw device name, but you must specify the block special file when mounting the CD-ROM device.

   2. Enter the mount command with the following syntax and substitute the unit number of your CD-ROM drive for the unit_number:

      mount -r /dev/rz unit_number c mount_point

      If your CD-ROM device is rz4c, use a command similar to the following to mount the CD-ROM on /usr/share/doclib/online:

      #  mount -r /dev/rz4c /usr/share/doclib/online
      

      The /usr/share/doclib/online directory already exists; there is no need to create it.

2. Start Netscape from either the command line or from the common desktop environment (CDE) front panel:

   1. To invoke Netscape from the command line, enter the following command:

      #  /usr/bin/X11/netscape &
      

   2. To invoke Netscape from the CDE front panel:

      • Click on the Application Manager icon on the CDE front panel.

      • In the Application Manager window, double click on the Desktop_Apps folder.

      • In the Desktop_Apps folder, double-click on the Netscape icon.

3. In the Netscape main window, load the Digital UNIX home page by clicking on the Open icon and entering the following file location in the Open Location: text entry field:

   file:/usr/doc/netscape/Digital_UNIX.html
   

   Save the home page as a bookmark by clicking on the Bookmarks menu and selecting the Add Bookmark option. Creating a bookmark lets you access the Digital UNIX home page quickly and easily.

4. When the Digital UNIX home page is loaded, click on the Digital UNIX documentation link to load the Digital UNIX documentation bookshelf.

A sample resource defaults file for Netscape is located in the file /usr/doc/netscape/Netscape.ad. Comments within this file show possible settings for each resource.

To convert your existing NCSA Mosaic hotlist file into an equivalent Netscape bookmark file, invoke the shell script /usr/doc/netscape/hot-convert.sh with no arguments.

Digital recommends that you define the Global Types File and Global Mailcap File used by Netscape as follows:

• Global Types File: /usr/lib/netscape/mime.types

• Global Mailcap File: /usr/lib/netscape/mailcap

These files allow Netscape to invoke the proper helper applications for viewing file types not directly viewable in Netscape. You can do this by selecting Preferences... from the Netscape Options menu. Then select Helper Applications in the resulting dialog box, and enter the correct values.

If a .netscape-preferences file does not exist in your home directory when Netscape is invoked, a default version of this file will be created. This default preferences file sets your home page to point to the Digital UNIX home page. It also incorporates the recommended settings for the global types and mailcap files described previously.

For more information about using Netscape, refer to the Netscape Navigator Online Handbook which is available by clicking on the link to Other documentation on the Digital UNIX home page.

6.6.1    Copying HTML Files From CD-ROM to Disk

Instead of using Netscape to read the Digital UNIX documentation from the CD-ROM, you can copy the documentation from the CD-ROM to a disk on your system. Copying the HTML files to a disk eliminates the need to keep the CD-ROM permanently mounted. The documentation files consume about 100 MB of disk space.

Digital strongly recommends using the same directories shown in the examples so you will not have to modify library bookshelf files.

Follow these procedures to copy the HTML files to a disk on your system:

1. Log in as the user root or become superuser.

2. Ensure that the CD-ROM labeled Digital UNIX V4.0 Documentation Volume 1 is mounted on /mnt. Refer to Appendix B if you do not know how to mount the CD-ROM.

3. Do the following to copy the HTML files from the CD-ROM to the /usr/share/doclib/online/DOCUMENTATION/HTML directory. The backslash (\) in the tar command line is used to show command line continuation; do not enter the backslash in the command line. This example illustratres the process with the CD-ROM mounted on the directory /mnt.

   #  cd /mnt/DOCUMENTATION/HTML
   #  tar chpvf - . | (cd /usr/share/doclib/online/ \    DOCUMENTATION/HTML; tar xvpf -)
   

4. Unmount the CD-ROM using a command similar to the following:

   #  umount /dev/rr4c
   

   Refer to Appendix B if you do not know how to unmount a CD-ROM.

If you copied the files to a server system, you must export the directory to a workstation similar to the instructions shown in Section 6.7.2 for the Bookreader application.

Enter the following command to start Netscape:

#  /usr/bin/X11/netscape &

6.7    Invoking the Bookreader Application to View Documentation

In Digital UNIX Version 4.0, the Bookreader application is provided for you to view documentation that is provided as files in DECW_BOOK format. To use Bookreader, you must install the OSF-BASE, UNIX-SERVER, or UNIX-WORKSTATION PAK that was provided with your kit.

6.7.1    Accessing Online Documentation from a Workstation

To access the documentation on a workstation, follow these steps:

1. If you do not know the CD-ROM device name, use the file command specifying the raw device to find it. CD-ROM devices are prefixed with the letters RRD. Using the | (pipe) command to filter the output of the file command to the grep command to search for RRD ensures that only your CD-ROM devices are output in the result of the command. Enter a command similar to the following:

   #  file /dev/rrz*c | grep RRD
   

   /dev/rrz4c: character special (8/4098) SCSI #0 RRD44 disk #32 \
   (SCSI ID #4)
   

   The backslashes in the previous example indicate line continuation and are not in the actual display.

   In the previous example, the CD-ROM device is RRD44 on device /dev/rz4c. If you have more than one RRD device connected to your system, specify the device where the CD-ROM will be mounted.

   Standard device names begin with rz for the block special file and rrz for the raw (character) special file. The result of the file command displays the raw device name, but you must specify the block special file when mounting the CD-ROM device.

2. As superuser or root, use the mount command to mount the CD-ROM. As shown in the following example, substitute the unit number of your CD-ROM drive for the unit_number.

   mount -r /dev/rz unit_number c /usr/share/doclib/online

   For example, enter the following commands to mount the /usr/share/doclib/online directory on rz4c:

   #  mount -r /dev/rz4c /usr/share/doclib/online
   

   To ensure that the CD-ROM is remounted in the event that your system crashes or is rebooted, use the text editor of your choice and open the /etc/fstab file. Add the following line:

   /dev/rz4c   /usr/share/doclib/online   ufs   ro   0  0
   

   When your edits are correct, write and quit the file.

   The system will now mount the CD-ROM on /usr/share/doclib/online on every reboot.

3. Use the text editor of your choice to edit the /usr/lib/dxbook/library.decw_bookshelf file and ensure that the following three lines are included in the file. The backslashes at the end of a line indicate line continuations and are not included in the file.

   TITLE\/usr/lib/dxbook\Digital UNIX Online Books
    
   book\/usr/share/doclib/online/DOCUMENTATION/BOOKREADER/  \
   d32vbkrd\Using Bookreader
    
   shelf\/usr/share/doclib/online/DOCUMENTATION/BOOKREADER/  \
   decosf1\Digital UNIX Online Books
   

4. Start Bookreader by entering the following command:

   #  /usr/bin/X11/dxbook &
   

   Bookreader is run in the background by including an ampersand (&) after the command. Once Bookreader is running, use it to read the books on the documentation CD-ROM.

For more information, read the online book Using Bookreader.

6.7.2    Accessing Online Documentation from a Server

If you have a server system without graphics capabilities, to view the Digital UNIX Bookreader files, you must export them to a workstation running either ULTRIX Version 4.2 (or higher) or Digital UNIX Version 1.3 (or higher).

The following steps assume that networking is set up on the server system. For more information on setting up a network, refer to the netconfig(8X) and nfsconfig(8X) reference pages or Network Administration.

Digital strongly recommends using the same directories shown in the examples so you will not have to modify library bookshelf files.

To export the Bookreader files to a workstation, follow these steps:

• On the server system:

  1. Log in as root or become superuser.

  2. Ensure that the CD-ROM containing the documentation is mounted or that the Bookreader files have been copied to disk. This example mounts the CD-ROM on /usr/share/doclib/online. For instructions on how to mount a CD-ROM, refer to Section 6.7.1.

  3. Using the text editor of your choice, place an entry in the /etc/exports file for the /usr/share/doclib/online directory and make sure that you specify the -ro option for a read-only export, as follows:

     /usr/share/doclib/online -ro
     

• On the client system:

  1. Log in as root or become superuser.

  2. Run nfsconfig and import the /usr/share/doclib/online directory from the server as a read-only file system.

  3. When you are finished running nfsconfig, mount the /usr/share/doclib/online directory by entering the following command:

     #  mount /usr/share/doclib/online
     

  4. Use the text editor of your choice to edit the /usr/lib/dxbook/library.decw_bookshelf file and ensure that the following three lines are included in the file. The backslashes at the end of a line indicate line continuations and are not included in the file.

     TITLE\/usr/lib/dxbook\Digital UNIX Online Books
      
     book\/usr/share/doclib/online/DOCUMENTATION/BOOKREADER/  \
     d32vbkrd\Using Bookreader
      
     shelf\/usr/share/doclib/online/DOCUMENTATION/BOOKREADER/  \
     decosf1\Digital UNIX Online Books
     

  5. Start Bookreader by entering the following command:

     #  /usr/bin/X11/dxbook &
     

     Bookreader is run in the background by including an ampersand (&) after the command. Once Bookreader is running, use it to read the books on the compact disc. For more information, read the online book Using Bookreader.

6.7.3    Copying Bookreader Files from CD-ROM to Disk

Instead of reading the Bookreader documentation from CD-ROM, you can copy the documentation from the CD-ROM to a disk on your system. Copying the Bookreader files to disk eliminates the need to keep the CD-ROM permanently mounted to view Bookreader documentation.

Digital strongly recommends using the same directories shown in the examples so you will not have to modify library bookshelf files.

Follow these steps to make the Bookreader version of the documentation accessible from a disk on your system:

1. Log in as as the user root or become superuser.

2. Ensure that the CD-ROM that contains the documentation is mounted on /mnt. Refer to Appendix B if you do not know how to mount the CD-ROM.

3. Use commands similar to the following to copy the Bookreader documentation to the /usr/share/online/doclib directory. This example illustrates the process with the CD-ROM mounted on the directory /mnt. The backslash (\) in the tar command line is used to show command line continuation; do not enter the backslash in the command line.

   #  cd /mnt/DOCUMENTATION/BOOKREADER
   #  tar chpvf - . | (cd /usr/share/doclib/online/   \    DOCUMENTATION/BOOKREADER; tar xvpf -)
   

4. Unmount the CD-ROM using a command similar to the following:

   #  umount /dev/rr4c
   

   Refer to Appendix B if you do not know how to unmount a CD-ROM.

If you copied the files to a directory on a server system, you must export the directory to a workstation as shown in Section 6.7.2.

To start the Bookreader application, enter the following command:

#  /usr/bin/X11/dxbook &

Once Bookreader is running, you can use it to read the books. For more information about using the Bookreader application, read the online book Using Bookreader.