 |
Index for
Section 8 |
|
 |
Alphabetical
listing for R |
|
 |
Bottom of
page |
|
ris(8)
NAME
ris - remote installation services (RIS) utility
SYNOPSIS
/usr/sbin/ris [arguments]
OPTIONS
client
Used with the -a and -m operands, client is the network-recognized host
name of the client system.
-h addr
The -h option, used with the -a and -m operands, is used to specify the
hardware Ethernet or FDDI address addr of the client system.
-p path,prod[,prod][,prod]...
The -p option, used with the -a and -m operands, is used to specify the
RIS area path and one or more products (prod) that the client system is
authorized to install from the server over the TCP/IP network. The -p
option is required with the -a operand, and is optional with the -m
operand.
·
The RIS area is specified as risN.arch, where N is an integer (0 or
higher) indicating a RIS area that you have set up on your server,
and arch is the system architecture, such as alpha. These are
provided when you install a software product into a RIS area with the
ris utility.
·
The product is specified as product_N, where N is an integer (1 or
higher) indicating a software product that you have installed in a
RIS area on your server. This is provided when you install a software
product into a RIS area with the ris utility.
OPERANDS
Invoking the ris utility without arguments displays the RIS Utility Main
Menu for an interactive session. (See DESCRIPTION.)
-a client -h addr -p path,prod[,prod][,prod]...
Adds a client system client with hardware Ethernet or FDDI address
addr, allowing the client to install the specifed product or products
(prod) from RIS area path.
-l Lists registered clients.
-m client [-h addr] [-ppath,prod[,prod][,prod]...]
Modifies client system client. Optionally specifies an hardware
Ethernet or FDDI address addr and one or more products (prod) from RIS
area path.
-r client
Removes client system client.
-s Shows software products in RIS environments.
DESCRIPTION
The ris utility provides remote installation services management, allowing
you to install software from a disk area on the server on to 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.)
With no arguments, /usr/sbin/ris displays the RIS Utility Main Menu for an
interactive RIS session.
*** RIS Utility Main Menu ***
Choices without key letters are not available.
a) ADD a client
d) DELETE software products
i) INSTALL software products
l) LIST registered clients
m) MODIFY a client
r) REMOVE a client
s) SHOW software products in remote installation environments
x) EXIT
Enter your choice:
As the menu states, choices without key letters are not available.
Available menu options depend upon previous actions. For example, you
cannot list, modify, or remove clients until you have added client systems.
In that case, the m, l, and r are not displayed in front of their
respective options:
) LIST registered clients
) MODIFY a client
) REMOVE a client
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 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 selected function is passed to the utility as an argument (see
OPERANDS, OPTIONS, and 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
Invoke the ris utility with no arguments to start an interactive session:
# /usr/sbin/ris
*** RIS Utility Main Menu ***
Choices without key letters are not available.
a) ADD a client
d) DELETE software products
i) INSTALL software products
l) LIST registered clients
m) MODIFY a client
r) REMOVE a client
s) SHOW software products in remote installation environments
x) EXIT
Enter your choice:
You must use an interactive session to install or delete software products.
You can use either an interactive session or the ris command line arguments
to add, list, modify, or remove client systems, or to show software
products in RIS environments.
The examples that follow use command line arguments to manage a client
named stlouis. Backslashes (\) indicate line continuation and are not part
of the command syntax. (See OPERANDS and OPTIONS.)
Add a Client System
Use the following syntax to add a client system:
/usr/sbin/ris -a client -h addr
-p path,prod[,prod][,prod]...
Add client system stlouis and allow that client to install a product over
the network:
# /usr/sbin/ris -a stlouis -h 08-00-2B-03-05-8B -p \
ris0.alpha,product_1
Modify a Client System
Use the following syntax to modify a client system:
/usr/sbin/ris -m client [-h addr] [-ppath,prod[,prod][,prod]...]
Modify client system stlouis and allow that client to install an additional
product over the network:
# /usr/sbin/ris -m stlouis -p ris0.alpha,product_2
Remove a Client System
Use the following suntax to remove a client system:
/usr/sbin/ris -r client
Remove client system stlouis:
# /usr/sbin/ris -r stlouis
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.
SEE ALSO
Commands:
setld(8)
Documents:
Sharing Software on a Local Area Network
Installation Guide
Installation Guide -- Advanced Topics
|
Index for
Section 8 |
|
|
Alphabetical
listing for R |
|
 |
Top of
page |
|