Content-type: text/html Man page of ris

ris

Section: Maintenance Commands (8)
Index Return to Main Contents
 

NAME

ris - remote installation services utility  

SYNOPSIS

/usr/sbin/ris  

DESCRIPTION

The ris utility performs remote installation services to install software 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 creates 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 architectures can be set up for organizational or performance reasons.

A RIS area contains one or more software products. Each product contains the software subsets that can be installed to clients on a network. 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

Tru64 UNIX remote installation servers cannot install the base operating system on clients that do not support the bootp network bootstrapping 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 functions.

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 <clientname> -h <Ethernet_address> \
-p path,product[,product]

The following command adds client vizier and allows that client to install 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 database
/usr/var/adm/ris/clients/cdf
Directory containing configuration description files (CDF) used for installation cloning.
 

RELATED INFORMATION

Commands: setld(8).

Sharing Software on a Local Area Network
Installation Guide delim off


 

Index

NAME
SYNOPSIS
DESCRIPTION
RESTRICTIONS
EXAMPLES
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:31 GMT, October 02, 2010