*** UNIX MANUAL PAGE BROWSER ***

ris(8) System Manager's Manual ris(8) NAME ris - remote installation services utility SYNOPSIS /usr/sbin/ris DESCRIPTION The ris utility performs remote installation services to install soft- ware from a disk area on the server onto a client machine through the TCP/IP local network. Both base system software and optional products can be installed remotely. The client can be any system that uses the setld utility for installing software. (See RESTRICTIONS.) The ris utility uses the directory /usr/var/adm/ris as a base. As part of installing the first product into /usr/var/adm/ris, the utility cre- ates a remote installation services (RIS) disk area. RIS areas have names of the form risn.arch, where n is a sequentially-assigned number beginning with 0 and arch is a name identifying the client's machine architecture. The first RIS area for Alpha clients would thus be named ris0.alpha. Additional areas for the same or other client architec- tures can be set up for organizational or performance reasons. A RIS area contains one or more software products. Each product con- tains the software subsets that can be installed to clients on a net- work. Once products are installed into an area, clients registered for that area can install the software over the network using the setld utility. The ris utility performs the following functions: a - Add client d - Delete software i - Install software l - List registered clients m - Modify client s - Show products in remote installation environments r - Remove client The ris utility must be used interactively to set up a RIS area. After a RIS area is set up on the server, the ris utility can be used either interactively or from the command line to manage clients. For command- line use, the desired function is passed to the utility as a flag. See EXAMPLES. The /usr/var/adm/ris directory also holds a subdirectory, /usr/var/adm/ris/clients. This directory contains a database file, risdb, that is used to manage multiple clients. RESTRICTIONS DIGITAL UNIX remote installation servers cannot install the base oper- ating system on clients that do not support the bootp network boot- strapping protocol. EXAMPLES The following example invokes the ris utility interactively: # /usr/sbin/ris A menu appears from which you can select options to perform ris func- tions. The examples that follow manage a client named vizier using the command line. Backslashes (\) indicate line continuation and are not part of the command syntax. The command syntax to add a client follows: /usr/sbin/ris -a <client- name> -h <Ethernet_address> \ -p path,product[,product] The following command adds client vizier and allows that client to in- stall a product over the network: # /usr/sbin/ris -a vizier -h 08-00-2B-03-05-8B \ -p ris0.alpha,product_1 The command syntax to modify a client follows: /usr/sbin/ris -a <clientname> [-h <Ethernet_address>] \ [-p <path,product,product>] The following command modifies client vizier and allows that client to install a product over the network: # /usr/sbin/ris -m vizier -p ris0.alpha,product_2 The command syntax to remove a client follows: /usr/sbin/ris -r <clientname> The following command removes client vizier: # /usr/sbin/ris -r vizier FILES /usr/var/adm/ris Base directory for remote installation areas /usr/var/adm/ris/clients Directory for database /usr/var/adm/ris/clients/risdb Remote installation information data- base /usr/var/adm/ris/clients/cdf Directory containing configuration de- scription files (CDF) used for instal- lation cloning. RELATED INFORMATION Commands: setld(8). Sharing Software on a Local Area Network Installation Guide delim off ris(8)