Digital

NAME

doconfig − a program to aid system configuration

SYNOPSIS

/usr/sbin/doconfig [ -c config_file] [ -e ed_script ]

DESCRIPTION

The doconfig shell script creates a new or modifies an existing system configuration file for a new system kernel. The script prompts you for the configuration file name and timezone information. 

Whether the configuration file is built or not, the script then allows you to edit, configure, and build until both the configuration and the kernel build run without errors. Additional runs of doconfig can be made to tune the configuration further. 

When new hardware is added to a system, the configuration file should be updated to reflect the new system configuration. When updating an existing configuration file or creating a new configuration file with doconfig, the system must be operating the generic kernel or new hardware may not be found. To successfully complete the doconfig process, follow these steps:

     1.Log on as root or become superuser. You must be superuser to execute the doconfig script. 

     2.Save a copy of the running kernel. Because of disk space constraints, the kernel must be saved in a file system other than root. For example to copy the kernel to the /usr directory, issue the following command:

# cp /vmunix /usr/vmunix.save

     3.Install the generic kernel as the running kernel and reboot the system by using the cp and shutdown commands as follows:

# cp /genvmunix /vmunix
# /usr/sbin/shutdown -r +5 "Shutting down to build new kernel"

     4.Log on as root and shutdown the system to single user mode as follows:

# /usr/sbin/shutdown +1

     5.Run the doconfig script as follows:

# /usr/sbin/doconfig

The doconfig program then prompts you for information about your system configuration. 

     6.Type yes when the doconfig program asks if you want to edit the configuration file only if you need to make additional changes. The doconfig program then invokes the editor specified by the EDITOR environment variable. 

     7.The doconfig program builds the new kernel.  When the doconfig program finishes, it prints a message showing the path and location of the new vmunix kernel. 

     8.Move the new vmunix (from the message noted above) to /vmunix as follows:

# mv /sys/DECOSF/vmunix /vmunix

     9.Reboot the system as follows:

# /usr/sbin/shutdown -r now

If the new vmunix fails to boot, you can recover by using the following procedure:

     1.Boot the generic kernel (/genvmunix) to single-user mode using the appropriate boot command for your system. If you are unsure of the command syntax, Guide to System Administration provides information on booting your system. 

     2.Check all local file systems using the fsck command with the -p option as follows:

# fsck -p

     3.Write-enable the root file system using the mount command with the -u option as follows:

# mount -u /

     4.If you want to revert to the vmunix kernel saved in step 2, mount the /usr file system, copy the saved kernel to the root file system, and reboot as follows:

# mount /usr
# cp /usr/vmunix.save /vmunix
# shutdown -r now

If you want to continue trying to build a bootable kernel, bring the system up to multiuser mode by issuing a CTRL/D as follows:

# CTRL/D

Proceed to step 4. 

FLAGS

−cThe name of the existing configuration file should be supplied without specifying the pathname. This file should exist in the /sys/conf directory. A new kernel is built using the specified configuration file. 

−eWhen specified, the configuration file is edited by the ed script before building the new kernel. 

FILES

/tmp/SYSTEMNAME
/sys/SYSTEMNAME
/sys/conf/SYSTEMNAME

RELATED INFORMATION

ed(1), config(8)
Guide to Installing DEC OSF/1
Guide to System Administration