setup(1M)
NAME
setup − set up new system after System Generation
SYNOPSIS
setup [ −d device ] [ −u usr-partition ] [ −v var-partition | −V ]
DESCRIPTION
setup creates file systems on the root, usr, and var disk partitions (using newfs(1M)), updates the “whatis” man page database, and loads software products on the system primarily when a System Generation is done. setup may also be used to restore the contents of the “products” tape at any time, should the disk files be destroyed.
When the system is running the “miniroot” version of CX/UX on partition 1 of the root disk, and the swap partition is also on partition 1, setup is run to complete System Generation. It will newfs the root and usr partitions (0 and 2) of the root disk, newfs the var partition if necessary or create a /var symbolic link, load selected products contained on the “products” tape, and update the “whatis” man page database, as selected in its menu.
When the system is not running and swapping on partition 1 of the root disk, setup will not allow the newfs steps to be done. However, it will allow the loading of all products on the “products” tape, including product cx, containing system files. This may be useful in restoring files if the root or usr partitions become corrupted or optional product files are deleted.
setup assumes product tapes are of the following form:
| setup tape_list |
| product 1 |
| . . . |
| product n |
The first product on the “products” tape (which only appears on the first tape) consists of setup and an associated file, tape_list. This file describes the contents of the products tape(s). In order to run setup at a time other than System Generation, use the following commands to extract the setup product from the tape:
| cd / |
| cpio -icBvum < /dev/rmt/0mn |
Use of setup is restricted to the superuser.
setup shows the user a list of the products on the tape and allows the user to select which products are to be loaded. The total disk usage (in bytes) for each filesystem (/, /usr, and /var) is shown for each product on the menu. The user may also select whether or not to newfs file systems or to update the “whatis” database.
All files are loaded relative to the current directory.
setup maintains a log of all products loaded onto a system. The log file is located in /usr/src/PRODUCTS/loaded. It contains the product name, the revision level of the product, the date it was installed, and the directory it was installed under if not “/”. Whenever optional or updated products are installed at a later date, the log is appended to, providing a quick reference for what software at what revision level is on the system, and when it was installed.
Options
−d device The −d option is used to specify a device other than the default /dev/rmt/0mn be used. For setup to function correctly, this device must be non-rewinding. This option is ignored during a system generation.
−u usr-partition
usr-partition is the device name of the usr partition. If not specified, /dev/rdsk/0s2 is assumed. This partition must already exist on the master disk (see format(1M)).
−v var-partition
var-partition is the device name of the var partition. This partition must already exist on the master disk. If neither this option nor −V are specified during a system generation, setup will ask where the /var directory should be located.
−V The /var directory should be created as a symbolic link to /usr/var. If neither this option nor −v are specified during a system generation, setup will ask where the /var directory should be located.
The −u, −v, and −V, options are used only during a system generation.
It is usually best to locate the /var directory on a partition other than the root partition because the files in this directory (log files, accounting files, spool files, mail boxes, temporary files) can grow very large.
SEE ALSO
format(1M), newfs(1M).
cpio(1) in the CX/UX User’s Reference Manual.
CX/UX Administrator’s Reference