For your system to be fully productive and communicative with other
systems and users, you may want to add user accounts, and configure the network,
mail, and printers. 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 OSFMANWOS410 software subset if you want to view
the graphical SysMan application reference pages with the man command.
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:
# /usr/sbin/checklist
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, because it is not installed on the system.
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.
Section 6.6 describes how to use Netscape Navigator
for online viewing of the Digital UNIX documentation set.
Section 6.6.2 describes how to activate the
Bookreader application for online viewing of associated product documentation
that is provided in .decw_book files.
You can access this setup menu from the command line as the user root by entering the following commands:
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.
Section 6.6 describes how to use Netscape Navigator
for online viewing of the Digital UNIX documentation set.
Section 6.6.2 describes how to activate the
Bookreader application for online viewing of associated product documentation
that is provided in .decw_book files.
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.
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).
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:
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.
To enable unattended reboot functionality, halt the system and set the
following console parameters:
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:
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.
mount-r /dev/rzunit_numberc 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:
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.
The /usr/bin/X11/netscape file is a shell script
that performs the following:
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:
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.
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:
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.6.2.2
for the Bookreader application.
Enter the following command to start Netscape:
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.
mount-r /dev/rzunit_numberc /usr/share/doclib/online
For example, enter the following commands to mount the /usr/share/doclib/online directory on rz4c:
The system will now mount the CD-ROM on /usr/share/doclib/online on every reboot.
The following steps assume that networking is set up on the server system.
For more information on setting up a network, refer to the
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:
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:
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.6.2.2.
To start the Bookreader application, enter the following command:
After 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.
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:
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.
# 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:
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.
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.0B (Rev. xxx); Fri Dec 13 15:54:51 EDT 1996
Digital UNIX V4.0B 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
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.
You can also do the following to enable realtime preemption:
# setld -c OSFBIN410 RT_ON
6.5 Enabling Unattended Reboots on Multiprocessor Systems
To reduce system down time due to a processor failure on a multiprocessor
system, an unattended reboot feature is available for multiprocessor platforms.
>>> 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.0B
is shipped with Netscape Navigator Gold V3.0 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.
# 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.
# mount -r /dev/rz4c /usr/share/doclib/online
The /usr/share/doclib/online directory already exists; there is no need
to create it.
# /usr/bin/X11/netscape &
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.
This information may be important to know if you should download
newer copies of Navigator from other sources (for example, Netscape) and install
the files from those kits over the links in $HOME/.netscape.
Should you want to revert to using Navigator Gold V3.0, you will first need
to remove these files so that the /usr/bin/X11/netscape
script is able to recreate the symbolic links mentioned above that point to
the 3.0 Gold versions of these files. Also, if you choose to run a version
of Navigator directly (that is, not through the /usr/bin/X11/netscape script), you will at least want to set the LD_LIBRARY_PATH environment
variable to point to /usr/lib/netscape before doing so
to ensure the proper functioning of Java applets.
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.
# cd /mnt/DOCUMENTATION/HTML
# tar chpvf - . | (cd /usr/share/doclib/online/ \
DOCUMENTATION/HTML; tar xvpf -)
# umount /dev/rr4c
Refer to Appendix B if you do
not know how to unmount a CD-ROM.
# /usr/bin/X11/netscape &
6.6.2 Invoking the Bookreader Application to View Documentation
In Digital UNIX Version 4.0B, 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.6.2.1 Accessing Online Documentation from a Workstation
To access the documentation on a workstation, follow these steps:
For more information, read the online book Using
Bookreader.
# 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.
# 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.
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
# /usr/bin/X11/dxbook &
Bookreader is run in the background by including an
ampersand (&) after the command. After
Bookreader is running, use it to read the books on the documentation CD-ROM.
6.6.2.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).netconfig
(8X)
and nfsconfig
(8X) reference pages or Network Administration.
/usr/share/doclib/online -ro
/usr/share/doclib/online@<server_name> /usr/share/doclib/online nfs ro,bg 0 0
where <server_name> is the name of the remote
server.
#
mount /usr/share/doclib/online
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
# /usr/bin/X11/dxbook &
Bookreader is run in the background by including an
ampersand (&) after the command. After
Bookreader is running, use it to read the books on the compact disc. For more
information, read the online book Using Bookreader.
6.6.2.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.
# cd /mnt/DOCUMENTATION/BOOKREADER
# tar chpvf - . | (cd /usr/share/doclib/online/ \
DOCUMENTATION/BOOKREADER; tar xvpf -)
# umount /dev/rr4c
Refer to Appendix B if you do
not know how to unmount a CD-ROM.
# /usr/bin/X11/dxbook &