Chapter 4:

After you install

This chapter refers frequently to the online documentation. If you want to read this chapter online and follow the links in the text, then open http://nodename:8458 with any installed browser and look under Installation and Licensing > Getting Started Guide. nodename is your system's network name, IP address, or localhost (if you are using a browser on the UnixWare system).

After you install UnixWare 7, it is recommended you read and follow these instructions:

Complete documentation on all of these tasks is found in DocView, on http://localhost:8458. This chapter presents a brief introduction to these initial setup tasks, with pointers to the online documentation for more information.

Installing Additional Software

After you have installed UnixWare, you can use either the Upgrade Wizard or the pkgadd(1M) command to install any packages that you did not select when you installed CD #2 and CD #3. Any software not selected from CD #1 (or any other CD in the media kit) must be installed using pkgadd. (Note that most software on CD #1 is also on CD #2 for upgrade installations.)

For a complete list of the packages and sets on each CD in the media kit, please see "CD-ROM Contents".

To use the Upgrade Wizard, follow "The upgrade procedure".

To use the pkgadd command:

Step 1.

Log into the system as root.

Step 2.

Insert a CD from the Media Kit into the primary CD drive on your system and enter:

mount /dev/cdrom/cdrom1 /install


Step 3.

List the Sets on the CD. Sets are collections of packages that can be installed as a unit using the set name as the argument to pkgadd. They can be listed using this command:

pkginfo -c set -d /install


Step 4.

List the individual packages on the CD:

pkginfo -d /install


Step 5.

Install the desired packages and sets; use one or more package and set names from the previous two steps in the command below:

pkgadd -d /install name...


Note that you may find that a package will fail to install because one or more prerequisite packages were not found. If this happens, install the indicated prerequisite packages and attempt to install the desired package again.

Step 6.

If you are directed to re-install a package as a result of installing one or more packages in the previous step, do so now.

Step 7.

If the installation of one or more packages requires you to reboot the system, you can do so using the following command after you have installed all desired packages:

shutdown -i6 -g0 -y


Configuring additional hardware

The UnixWare 7 system provides SCOadmin managers and other utilities with which you can install and configure additional hardware.


Use the Audio Configuration Manager to add and configure sound cards. You can play and record audio files with the scosound(X1) utility. For more information, see Hardware > Configuring audio adapters in the online documentation.


Use the Printer Setup Manager to:

For more information, see Managing the print service under Hardware in the online documentation.


Use the Network Configuration Manager to configure LAN network adapter drivers, WAN hardware, and LAN and WAN protocols. For more information, see Configuring network adapters under Networking in the online documentation.


Use the Video Configuration Manager to:

For more information, see Configuring video adapters and monitors under Hardware in the online documentation.


Use the Modem Manager to add serial modems to your system.PCMCIA modems are configured using the Device Configuration Utility (DCU). ISDN bus adapters are configured with the Network Configuration Manager. For more information, see Adding and configuring modems under Hardware in the online documentation.

Serial lines

Use the Serial Manager to configure individual serial ports on COM1 through COM4. For more information, see Configuring serial ports under Hardware in the online documentation.

Mass storage

Use the Device Configuration Utility (DCU) to add support for tape, CD-ROM, and hard disk drives which were not auto-detected during the installation process. See the dcu(1M) manual page, Using the Device Configuration Utility under Hardware in the online help, and "Installing Hardware".

Configuring and administering the system

For information on how to configure and manage the Linux Kernel Personality, see System Management under Linux Kernel Personality in the online documentation.

SCOadmin is the primary system administration tool in UnixWare 7. With SCOadmin managers, you can configure and then administer the following key services on your system. Use the Search mechanism in the online documentation on http://localhost:8458 to find the sections referenced below.

Users and Groups

Use the Account Manager to:

See Administering user accounts under Users and Groups in the online documentation.


Use the Filesystem Manager to add, modify, and remove filesystems.See Administering filesystems under Filesystems in the online documentation.


Use the FTP Server Manager to:

See Administering File Transfer Protocol (FTP) servers under Networking in the online documentation.

Name Service

Use the DNS Manager to:

See Administering Domain Name System (DNS) servers under Networking in the online documentation.


Use the Mail Manager to configure the mail system on your computer.See Configuring mail and messaging under Mail and Messaging in the online documentation.

Network protocols

Use the Network Configuration Manager to:

See Configuring LAN connections and Configuring WAN connections under Networking in the online documentation.

Additional SCOadmin managers enable you to configure advanced networking, security, process management, and other capabilities. For general information on using SCOadmin, see Administering your system with SCOadmin under Desktops in the online documentation.

Specifying a desktop to use

By default, UnixWare 7 displays the graphical login program,dtgreet, when you boot the system into multiuser mode. To choose a desktop, select one of the following from the graphical login's Sessions menu:

CDE Desktop

This desktop is the preferred desktop for UnixWare 7. It conforms to the Common Desktop Environment standard, and provides the following features:

This desktop is enabled by default.

For more information on the CDE desktop, click above the Help icon on the CDE desktop, then click on CDE Help.

Panorama Desktop

This desktop, based on pmwm release 2.0, contains the following features:

For more information, see the manual page for pmwm(X1).

Failsafe Session

This desktop is available if you corrupt your CDE desktop configuration files. It provides a basic, uncustomized CDE desktop.

Configuring and using DocView

DocView is enabled by default in all system profiles except Small Footprint. It serves all the online documentation mentioned in this book on http://localhost:8458. DocView replaces the SCOhelp browser used in previous releases. For more information on DocView, see the Release 7.1.4 section under New Features and Notes in the online documentation.

DocView uses a search engine based on htdig, After you install all software and documentation, you must create the search index using the /usr/lib/docview/conf/rundig command. This process can take an hour or longer depending on how much documentation is installed, so it is recommended that you run the command when the system load is minimal.

To start the docview server (or find out whether it is running), use the /etc/docview command. In most installations, DocView will start by default when the system is booted.

To view the documentation served by DocView:

For more information on configuring and using advanced features of DocView, see Desktops in the online documentation.

Getting updated information about your system

Two important web sites serve information about UnixWare systems:

Verifying the installation of packages

When you install your system or layer on new packages, you might run the pkgchk(1M) command to verify that package installation proceeded correctly.

It is typical to see a number of errors when running this command, due to the interaction between the various packages on your system. You should make a note of any errors you find, but do not attempt to fix these errors with pkgchk -f. This command is currently not supported and may cause your system to fail or not reboot. There is no current workaround.

Large physical memory support

Any machine which contains memory at or above address 4G (2^32) requires large physical memory (LPM) support. Setting ENABLE_4GB_MEM=YES in /stand/boot allows detection of memory above 4GB. Using system tuning, physical memory can be divided into "dedicated" and "general purpose" segments.

See Managing Large Physical Memory in the online documentation at http://localhost:8458/en/SM_perform/CTOC-MngSysPerf.html for details of how to configure LPM support.

Switching auditing on

Even if you select the auditing package and therefore install it during the installation procedure, auditing is not turned on by default when the system boots.

To turn auditing on manually, run auditon as root. You should run auditoff to turn auditing off before you shut down the system. Rebooting the system with auditing switched on is very slow and should be avoided.

To switch auditing on and off automatically, edit /etc/rc2.d/S02audit to remove the comments from the lines that execute the commands auditon and auditoff.

Auditing cannot provide audit records for Linux Kernel Personality (LKP) mode activities on your system. See the auditon(1M) manual page for more details.

© Copyright 2004 The SCO Group, Inc. All Rights Reserved.