Digital PDFs

AA-MF02C-TE

June 1990

33 pages

Original

1.2MB

Document:	ULTRIX Guide to Remote Installation Services
Order Number:	AA-MF02C-TE
Revision:	000
Pages:	33
Original Filename:

OCR Text

ULTRIX

Guide to Remote Installation Services

Order Number: AA-MF02C-TE
June 1990

Product Version:

digital equipment corporation
maynard, massachusetts

ULTRIX Version 4.0 or higher

Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in
subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause of DFARS 252.227-7013.
© Digital Equipment Corporation 1986, 1987, 1988, 1990
All rights reserved.

The information in this document is subject to change without notice and should not be construed as a commitment
by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may
appear in this document.
The software described in this document is furnished under a license and may be used or copied only in accordance
with the terms of such license.
No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital or its
affiliated companies.

The following are trademarks of Digital Equipment Corporation:

~DmaDmD
CDA
DDIF
DDIS
DEC
DECnet

DECstation
DECUS
DECwindows
DTIF
MASSBUS
MicroVAX
Q-bus

ULTRIX
ULTRIX Mail Connection
ULTRIX Worksystem Software
VAX
VAXstation
VMS
VMS/ULTRIX Connection

UNIX is a registered trademark of AT&T in the USA and other countries.

Contents

About This Manual
New and Changed Information

Audience

Organization

.. .. .. .. . . . .. . .. . . . .. . . . . ... . . ... . .. .. . . .. .. . . ... . . .. . . . .. . . . .. .. . .. . . . .. .. . .. .. .. ... .. . .. . .... . .. . ..

Related Documentation

Conventions

Overview

1.1

Directories
1.1.1

1-2

Software Products and Software Subsets

1-2

1.2

Remote Installation Services Utility

Remote Installation Services Setup Preparation

2.1

Gathering Prerequisite Information

2-1

2.2

Completing Prerequisite Tasks

...................................................................

2-1

Installing an ULTRIX Operating System on the Server .......................
Setting Up a Local Area Network ....................................................
Obtaining Clients' Host Names .......................................................
Finding Out Whether the Client is a RISC or a VAX Processor ...........
Registering Clients' Host Names and IP Addresses with Servers
Obtaining the Hardware Ethernet Address .........................................
Identifying the Distribution Media ...................................................
Obtaining the Device Special File Name or Mount Point ....................

2-2
2-2
2-2
2-3
2-3
2-3
2-3
2-3

2.2.1
2.2.2
2.2.3
2.2.4
2.2.5
2.2.6
2.2.7
2.2.8

Server Setup and Maintenance

3.1

Establishing a New Remote Installation Environment
3.1.1

Installing the First Product into a New Remote Installation Environment.

1-2

3-1
3-1

3.1.2

Adding a Product to an Existing Remote Installation Environment

3-2

3.2

Adding a Client

3-3

3.3

Removing a Client

3-5

3.4

Showing Products in Remote Installation Environments

3.5

Modifying a Client

3.6

Using ris from the Command Line

3.7

Using the ris Database to Manage Multiple Clients
3.7.1

3.7.2

............................... .

.................................................................................. .
............................................................ .

3-5
3-6
3-6

...................................... .

3-7

Adding Multiple Clients ................................................................ .
Removing Multiple Clients ............................................................ .

3-8

3-7

Figures
1-1: Remote Installation Environment Directory Structure

1-2

Tables
2-1: Device Special File Names

ivContents

2-4

About This Manual

This manual describes how to install and maintain your remote installation
environment using the remote installation services utility, r is. Users install
software products over the network using the remote installation services area on the
server as the distribution device.

New and Changed Information
You can now use the r is utility to set up more than one remote installation
environment on a server. New functionality like using the r is database to manage
clients has been added and is described.

Audience
The audience for this manual is anyone installing and maintaining the remote
installation environment. The manual assumes that:
•

You, or a Digital Field Service representative, have checked the hardware to
ensure that it is working properly.

•

You have read the Owner's Manuals supplied with your hardware.

•

You know the location and function of the controls and indicators on your
hardware.

•

You understand how to load and unload the installation media and any disks
needed during the installation.

•

You know how to use ULTRIX software.

Organization
Chapter 1

Overview
Describes the remote installation environment and introduces the
r i s utility.

Chapter 2

Remote Installation Services Setup Preparation
Describes the knowledge, information, and tasks required before
you set up the remote installation environment.

Chapter 3

Server Setup and Maintenance
Describes how to install software into a remote installation
environment and how to manage client information.

Related Documentation
The following list suggests the order in which you should read the related
documentation:
1.

Hardware documentation
You should have on hand the hardware documentation associated with your
processor, particularly the Owner's Manual. These manuals show you how to
set up the processor and its additional devices. These manuals also supply
valuable troubleshooting guidelines.

Release Notes

Before beginning the installation, you should read the current version of the
Release Notes.
3.

Guide to Server Setup

This guide contains information about setting up the remote installation
environment, and supported software subset information.
4.

System and network management guides
Read the appropriate system and network management guides to help you
prepare to install the remote installation environment.

Conventions
The following conventions are used in this manual:
#

A number sign is the default superuser prompt.

»>

The console subsystem prompt is two right angle brackets on
RISC systems, or three right angle brackets on VAX systems.
On a system with more than one central processing unit (CPU),
the prompt displays two numbers: the number of the CPU, and
the number of the processor slot containing the board for that
CPU.

CPUnn»

user input

This bold typeface is used in interactive examples to indicate
typed user input.

system output This typeface is used in interactive examples to indicate system

output and also in code examples and other screen displays. In
text, this typeface is used to indicate the exact name of a
command, option, partition, pathname, directory, or file.
A vertical ellipsis indicates that a portion of an example that
would normally be present is not shown.
cat(1)

vi About This Manual

Cross-references to the ULTRIX Reference Pages include the
appropriate section number in parentheses. For example, a
reference to cat(l) indicates that you can find the material on the
cat command in Section 1 of the reference pages.

IRETURNI

This symbol is used in examples to indicate that you must press
the named key on the keyboard.

Mbyte

Throughout the text, the abbreviation Mbyte is used for
megabyte. One megabyte equals 1,048,576 bytes.

About This Manual vii

Overview

This chapter presents an overview of the remote installation services and introduces
the remote installation services utility, r is.
To understand remote installation services, you must be familiar with:
•

The remote installation environment

•

The remote installation environment directories

•

Software products and software subsets

The following components make up a remote installation environment:
•

A server
The server can be any Digital supported processor. The software subset
containing support for the maintenance operations protocol, MOP, must be
installed in order for your system to be used as a server.
A server processor with either RISC or V AX architecture can serve both RISC
and VAX clients.

•

A distribution device on the server
The distribution device could be an MT9 tape drive, a TK50 tape drive, a TK70
tape drive, or a CDROM optical disc drive. You use the distribution device to
transfer the software subsets for one or more specific products and architectures
to the disk on the server that contains the remote installation environment.
Then, registered clients can access the software.

•

A system disk
The system disk associated with the server contains the software subsets for the
products you install.

•

The Ethernet
You must set up the server and all client processors as hosts on the Ethernet.
Clients use the Ethernet to access the remote installation environment.

•

Clients
Clients are members of the Micro VAX, VAXstation, DECstation, and
DECsystem series of processors. Users do not load any media on the client
processor to install software products. Instead, they type a command and the
installation software transfers the software subsets residing on the server's
remote installation environment over the network to their system disks.

1.1

Directories
When you install an ULTRIX operating system, the installation software creates the
directory, / va r / a drn / r is, that is necessary for r is.
When you install the first product to / var / adrn/ r is, the r is utility creates a
remote installation services environment compatible with the architecture of the
clients who will install the software over the network. The environment is called
either risO .rnips or risO. vax. Each time you install the first product to a new
environment, ris creates another risn. vax or risn .rnips. The letter n
represents the sequential number r is assigns to each environment for each
architecture when it is created. The environments r is 0 . rn ips and r i sO. vax are
used in examples throughout this guide.
Each environment contains one or more ULTRIX software products. The software
subsets for each product reside in a subdirectory of that product's directory. Clients
registered for an environment install software over the network to their processors.
Figure 1-1 shows the directory structure of a remote installation environment.

Figure 1-1: Remote Installation Environment Directory Structure

risO.mips

1.1.1

Software Products and Software Subsets
A software product consists of one or more software subsets. A software subset is a
collection of executable files and data files needed to perform a specific function or to
provide a particular class of services for a specific product.
You can install any software product from media that is compatible with the set ld
utility. You can set up a remote installation environment on any processor supported
by the installed version of the ULTRIX operating system. However, you can install
software subsets from the remote installation environment only if your processor is a
member of the Micro VAX, the V AXstation, DEC station, or the DECsystem series of
processors.

1-2 Overview

1.2 Remote Installation Services Utility
You use the Remote Installation Services utility, r is, to set up the remote
installation environment and register remote installation services clients. You also
use the ris utility to manage your client processors. See ris(8) in the ULTRIX
Reference Pages for a summary of the ris functionality.

Overview 1-3

Remote Installation Services Setup
Preparation

This chapter describes how to prepare to set up your remote installation environment.
The chapter describes how to:

2.1

•

Gather prerequisite information.

•

Complete prerequisite tasks.

Gathering Prerequisite Information
As the system manager at the server, you should:
•

Know your superuser password.

•

Make sure that the file system in which the remote installation environment will
reside has enough space to accommodate the software subsets for the products
you want to install. See the documentation supplied with your product to learn
the sizes of its software subsets.

•

Make sure that your clients are licensed for all the software that they access in
the remote installation environment.

•

Understand that the more users who access the remote installation environment
at the same time, the slower the system will run.

•

Let your users know when you have finished setting up the remote installation
environment, so that they can use it to install the software subsets for a specific
product over the network. Tell your users to read the Basic Installation Guide
when they want to perform an installation using the remote installation
environment. Tell your users to read the Advanced Installation Guide as well,
when they want to perform an advanced installation using the remote
installation environment.

•

Tell your users to read the setld (8) manual pages in the ULTRIX Reference
Pages. They can use setld to add and delete software subsets. Proper use of
set ld will help manage disk space.

2.2 Completing PrerequiSite Tasks
Before you set up the remote installation environment, you should complete the tasks
described in this section:
•

Install an ULTRIX operating system on the server.

•

Set up a local area network.

•

Obtain the host name for each client processor.

•

Find out whether the client is a RISC or a VAX processor

2.2.1

•

Obtain the client processor's hardware Ethernet address.

•

Identify the distribution media.

•

Obtain the full pathname of the device special file name or mount point for the
distribution media.

Installing an ULTRIX Operating System on the Server
When you install an ULTRIX operating system, you do not have to choose the
advanced installation option. However, the advanced installation lets you specify
where you want to allocate the /usr file system and whether you want to allocate
the var area as a directory under the /usr file system, or as a separate /var file
system.
The remote installation environment is located in the var area. The remote
installation environment significantly affects the size of jusr, if you allocate the
/var area as a directory under /usr. Be sure you have enough space for the
subsets you want to install. If you want more space, you can mount another file
system under the /var / adm/ ris directory before you set up your first remote
installation environment. See the documentation provided with each product to find
out the subset sizes.
This guide assumes that you allocated the var area as a directory under the /usr
file system. The Basic Installation Guide explains how to install an ULTRIX
operating system. The Advanced Installation Guide tells you how to perform an
advanced installation. It also provides a table that lists supported software subset
sizes.
The subset containing the maintenance operations protocol, MOP, must be installed
on a server.
To load the subset containing MOP, either perform an advanced installation or use
the setld command after the basic installation is complete. For example:
# setld -a /dev/rmtOh ULTMOP400

For more information, refer to setld(8) in the ULTRIX Reference Pages.

2.2.2

Setting Up a Local Area Network
You must connect the r is server and all of your client processors to the Ethernet.
See the Introduction to Networking and Distributed System Services for instructions
on how to set up a local area network (LAN).

2.2.3

Obtaining Clients' Host Names
The setup procedure requests the host name for each client processor that will use the
remote installation environment. You specified this host name when you set up the
LAN. When a client installs the software subsets for a product from the remote
installation environment, the installation software displays the client's host name.
The host name is equivalent to the system name discussed in the Basic Installation
Guide.

2-2 Remote Installation Services Setup Preparation

2.2.4

Finding Out Whether the Client is a RISC or a VAX Processor
Find our whether the client is a RIS or a VAX processor so that you can decide from
which environment to serve the client.

2.2.5

Registering Clients' Host Names and IP Addresses with Servers
If the host system is served by any of the following naming services,
jete/hosts

Berkeley Internet Name Domain (BIND)
Yellow Pages (YP)
check with your site administrator to be sure that your clients are registered with the
appropriate naming service servers.
You automatically place each client processor's host name and Internet Protocol (IP)
address in the jete/hosts file when you initially set up your LAN using the
netsetup utility. The netsetup utility is described in the Introduction to
Networking and Distributed System Services.
You can also place the host name and IP address in the / etc/hosts file by using
a text editor, such as vi. The host name and IP address for each client processor
must be unique.
See the Guide to the Yellow Pages Service for information about the Yellow Pages
(YP) service. See the Guide to the BINDIHesiod Service for information about
Berkeley Internet Name Domain (BIND) server.

2.2.6

Obtaining the Hardware Ethernet Address
See the Guide to Ethernet Communications Servers for information about obtaining
the hardware Ethernet address for each client processor.

2.2.7

Identifying the Distribution Media
See the bill of materials for the distribution media types and associated labels for
your products.

2.2.8

Obtaining the Device Special File Name or Mount Point
Obtain the full path for the device special file name or mount point associated with
your software distribution media. The device special file name points to the device
on which you mount the media containing the software subsets.
Table 2-1 lists possible distribution media and, where applicable, the device special
file name for each. The first column lists the distribution media type, the second
column lists the full pathname for the device special file or mount point, and the last
column contains the Digital name for the distribution media.
The letter n in the device special file name represents the unit number of the
distribution device. For example, if the distribution device is a TU81 unit 0, then the
device special file name is / dev / rmt 01 .

Remote Installation Services Setup Preparation 2-3

Table 2-1: Device Special File Names
Media Type

Device Special File Name

Digital Name

TK50 tape cartridge

/ dey / rmtn

TK50, TK70, TZ30

9-track magnetic tape

/ dey / rmtn

TS05, TU80
TU45, TE16
TU77
TA78, TA79, TA81
TU81, TU81E
TU78, TU79

/dev/rmtn

CDROM optical disc

/dev/rzn

2-4 Remote Installation SeNices Setup Preparation

RRD40

Server Setup and Maintenance

This chapter describes the tasks you perform to set up and maintain the remote
installation environment. The instructions tell you how to perform the following
tasks:
•

Establish a new remote installation environment.

•

Add a client.

•

Remove a client.

•

Show products in remote installation environments.

•

Modify a client.

•

Use the r is utility from the command line.

•

Use the ris database to manage multiple cljents.

Be sure you have read Chapter 1 before starting to set up your remote installation
environment.

3.1

Establishing a New Remote Installation Environment
This section contains instructions for establishing a new remote installation
environment. The sample sessions that follow describe how you would install the
first product to a new environment, r is 0 . mi p s, then install an additional product
to that environment.

3.1.1

Installing the First Product into a New Remote Installation
Environment
The sample session that follows describes how to install all the ULTRIX software
subsets into one area, r i sO. mi p s, of a remote installation environment. You
would perform this procedure again to set up multiple risn.mips or risn. vax
areas that contain different software products. For example, the second set of
ULTRIX software subsets might be installed in r is 0 . vax.
1.

Type the following command at the system prompt to invoke the r i s utility:
# /ete/ris

Select the Install Software option from the r i s menu.
REMOTE INSTALLATION SERVICES (RIS) UTILITY MENU
a r s m -

Add Client
Remove Client
Show Products in Remote Installation Environments
Modify Client

i - I n s t a l l Software
e - Exit
Type your choice: i

A message appears describing the software installation options available
followed by a menu. Choose option 1:
RIS Software Installation Menu
1
2
3

Establish a New Area
Add Software to Existing Area
Return to Previous Menu

Enter your choice: 1

A message like the following appears:
You have chosen to install the first product to a new
remote installation environment.

A prompt asks for the full pathname of the device special file name or mount
point for the distribution media.
Enter the device special file name or mount point of your distribution media.
See the worksheet you filled out in Chapter 2 for the correct entry.
The following example shows how to mount the 9-track magnetic tape labeled
ULTRIX V4.0/ULTRIX WS V4.0 SUPPORTED (RISC) #1 on a TU81 tape
drive, unit 0:
Enter the device special file name or the path of the directory where the
software is located, for example, Idev/rmtOh: /dev/rmtOl

A menu appears listing the mandatory and optional subsets that you can select.

After you enter your selections, you are prompted for confirmation. If you are
installing from MT9 tapes, you are prompted to remove Volume 1 and insert
Volume 2 at the appropriate time.

When you confirm your selection, the subsets are installed. A message like the
following appears when the installation is complete:
Media extraction complete.

The r is utility loads the software subsets for the specified product. When the
product has been installed, a message appears giving the name of the remote
installation environment, for example:
The new environment is in Ivar/adm/ris/risO.mips.

The r is main menu appears.

3.1.2

Adding a Product to an Existing Remote Installation Environment
The sample session that follows describes how to add the ULTRIX W orksystem
Software product to risO. mips.
1.

Choose the Install Software option again.

Choose option 2, Add Software to Existing Area.

3-2 Server Setup and Maintenance

A list of available environments appears from which you might select
risO .rnips:
You have chosen to add a new product into an existing environment.
Select the remote installation environment:
1

/var/adm/ris/risO.mips
ULTRIX V4.0/ULTRIX WS V4.0 MANDATORY SUPPORTED (RISC)

/var/adm/ris/risO.vax
ULTRIX V4.0/ULTRIX WS V4.0 SUPPORTED (VAX)

Enter your choice: 1

You are prompted for the device special file name or mount point.

A menu appears listing the mandatory and optional subsets that you can select.

After you enter your selections, you are prompted for confirmation. If you are
installing from MT9 tapes, you are prompted to remove Volume 1 and insert
Volume 2 at the appropriate time.

When you confirm your selection, the subsets are installed. A message like the
following appears when the installation is complete:
Media extraction complete.

The r is main menu appears.

3.2 Adding a Client
Use the following procedure to add a client processor:
1.

Type the following command at the system prompt to invoke the r is utility:
# fete/ria

Select the Add Client Processor option from the menu that appears by
typing a:
REMOTE INSTALLATION SERVICES (RIS) UTILITY MENU
a - Add Client
r Remove Client
s Show Products in Remote Installation Environments
m - Modify Client
i - I n s t a l l Software
e Exit
Enter your choice: a

A message appears indicating that you have chosen to add a client processor.
The message also supplies some additional information.

A prompt asks if you want to continue with the add client processor procedure.

After you confirm that you want to continue, a prompt asks you to enter the
client's host name.

Server Setup and Maintenance 3-3

Note
For registration, the MOP protocol and DECnet/ULTRIX software
recognize only six characters for the host name. A host name can
contain more than six characters, but the first six characters must be
unique. The name must contain alphanumeric characters only and
be entered in lower case, with the initial character an alphabet
character.
Enter the client's host name. For example:
Enter the client processor's host name: bergal

If the client processor's host name has not been registered with the appropriate
naming service servers, the r is utility displays an appropriate error message
and repeats the prompt.

The next prompt asks you to type the hardware Ethernet address for the client.
In this example, the system manager specifies the hardware Ethernet address for
the client bergal:
Enter the client processor's hardware Ethernet address, for
example, 08-00-2f-03-f5-08: 08-00-2B-03-05-8B

If you do not enter the address in the correct format, the r is utility displays an
appropriate error message and repeats the prompt.

8.
The r i s utility displays the prompts asking you to select the environment for
which the client is to be registered. For example:
Select the remote installation environment to which this client
is to be added:
1

/var/adm/ris/risO.mips
ULTRIX V4.0/ULTRIX WS V4.0 SUPPORTED (RISC)

/var/adm/ris/risO.vax
ULTRIX V4.0/ULTRIX WS V4.0 SUPPORTED (VAX)

Enter your choice []:

A prompt appears asking you to select the products this client can install. For
example, if you chose the r is 0 . mips environment, the following might
appear:
Select one or more products for the client to install
from /var/adm/ris/risO.mips:
Product
1

Description
ULTRIX 4.0/ULTRIX WS V4.0 SUPPORTED (RISe)

Enter your choice, for example, 1 2:

After you make your selections, a message appears showing your choice and
requesting confirmation. For example:
You chose the following products:
1

ULTRIX 4.0/ULTRIX WS V4.0 SUPPORTED (RISC)

3-4 Server Setup and Maintenance

Is that correct (yin)?

[y]:

10. When you confirm your choice, a message similar to the following appears:
bergal has been added.

3.3 Removing a Client
To remove a client:
1.

Type the following command at the system prompt to invoke the r is utility:
# /ete/ris

A menu like the following appears:
3.

Invoke the ris utility and select the Remove Client option by typing r:
REMOTE INSTALLATION SERVICES (RIS) UTILITY MENU
a - Add Client
r - Remove Client
s Show Products in Remote Installation Environments
m - Modify Client
i - I n s t a l l Software
e - Exit
Enter your choice: r

A message appears indicating that you have chosen to remove a client
processor.
4.

A list of existing environments appears. Select the environment you want.

A list of clients registered for that environment appears.

A prompt appears asking you to specify the name of the client that you want to
remove. In the following example, the system manager removes the client called
profun.
You have chosen to remove a client from the remote installation services.
Type the name of the client processor you want to
remove: profun

If you type an invalid name, an appropriate error message appears.

After you specify a valid client processor, the r is utility prompts for
verification. For example:
Remove profun?

(yin)

[n]: y

After you specify a valid client processor, the r is utility deletes it and returns
you to the system prompt.

3.4 Showing Products in Remote Installation Environments
You can view the current products in a remote installation environment by using the
following procedure:

Server Setup and Maintenance 3-5

Invoke the ris utility and select the Show Products .in Remote
Installation Environments option by typing s.
REMOTE INSTALLATION SERVICES (RIS) UTILITY MENU
a - Add Client
r - Remove Client
s Show Products in Remote Installation Environments
m - Modify Client
i - I n s t a l l Software
e - Exit
Enter your choice: s

A display similar to this appears:
Show Products in Remote Installation Environments:
1

risO.mips
ULTRIX Work system Software V4.0 (RISC)

3.5 Modifying a Client
You can use the Modify Client option to change a client processors's hardware
Ethernet address and to change the products the client can install over the network.
A summary of the procedure for modifying a client follows:
1.

Invoke the ris utility and select the Modify Client option by typing m:
REMOTE INSTALLATION SERVICES (RIS) UTILITY MENU
a - Add Client
r - Remove Client
s Show Products in Remote Installation Environments
m - Modify Client
i - I n s t a l l Software
e - Exit
Enter your choice: m

A list of clients available for modification appears, followed by a prompt to
enter the client's hostname.

A prompt appears asking you to type in the client's hardware Ethernet address.

A list of the environments available and the products in each appears, with a
prompt for you to select an environment for the client.

A list of products in the environment you selected appears, with a prompt for
you to choose the products the client can install from that environment.

After you select the products the client can install and confirm your choice, a
message appears saying that the client has been modified.

3.6 Using ris from the Command Line
You can use the r is utility from the command line to manage clients. This section
includes the syntax of the r is utility commands with an example for each where
appropriate.

3-6 Server Setup and Maintenance

The syntax of the command to add a client follows:
/ete/ris -a <elientname> -h <Ethernet_address> -p path,produet[,product]

The following command would add client bergal and allow that client to install a
product over the network:
# /ete/ris -a bergal -h OS-OO-2B-03-05-SB -p risO.mips,produet_l

The syntax of the command to remove a client follows:
/ete/ris -r <elientname>

The following command would remove client bergal:
# /ete/ris -r bergal

The syntax of the command to show products in a remote installation environment
follows:
/ete/ris -s

For example, if you type the following command:
# lete/ris -s

A display similar to this appears:
Show Products in Remote Installation Environments:
1

risO.mips
ULTRIX Worksystem Software V4.0

(RISe)

The syntax of the command to modify a client follows:
/ete/ris -a <elientname> [-h <Ethernet_address>]

[-p <path, product ,product>]

The following command would modify client be rg a 1 and allow that client to install
a product over the network:
# /ete/ris -m bergal -p risO.mips,produet_2

3.7 Using the ris Database to Manage Multiple Clients
The r is utility generates a database file automatically when you register the first
client for the first remote installation environment. The pathname for the file is
Ivar/adm/ris/clients/risdb.
Every time you add, delete, or modify a remote installation services client using the
ris utility interactively, the database file is updated. The database file has the
following format:
hostname:Ethernet_address:path,product[,produet]

For example, the database file entry for bergal might look like the following:
bergal:08-00-2B-03-05-8B:risO.mips,produet_l

3.7.1

Adding Multiple Clients
You can edit the I var I adml r is I cl ient sir i sdb file to add a group of
clients, then use a r i s command line to add the clients.

Server Setup and Maintenance 3-7

In the example that follows, the system manager adds a group of four remote
installation services clients, after editing Ivar/adm/ris/clients/risdb.
The file contains the following entries before editing:
bergal:OS-OO-2B-03-0S-8B:risO.mips,product_l,product_2,product_3
erlang:OS-OO-6A-03-0S-2B:risO.mips,product_l
mostro:OS-OO-2B-06-0S-SB:risO.vax,product_l,product_2
noturn:OS-OO-2B-03-04-7B:risO.mips,product_l
profun:OS-OO-2B-03-09-SB:risO.vax,product_l

The system manager uses a text editor to add entries to the file, for example:
bergal:OS-OO-2B-03-0S-SB:risO.mips,product_l,product_2,product_3
erlang:OS-OO-6A-03-0S-2B:risO.mips,product_l
mostro:OS-OO-2B-06-0S-SB:risO.vax,product_l,product_2
noturn:OS-OO-2B-03-04-7B:risO.mips,product_l
profun:OS-OO-2B-03-09-SB:risO.vax,product_l
extra:OS-OO-2B-03-06-3B:risO.mips,product_l
miler:OS-OO-6A-03-07-SB:risO.mips,product_l,product_2
pastry:OS-OO-2B-16-0S-4B:risO.vax,product_l,product_2,product_3
overly:08-00-4B-03-09-3B:risO.vax,product_l

Then, the system manager enters a command like the following to register the group
of clients:
# /ete/ris -a extra miler pastry overly

3.7.2

Removing Multiple Clients
You can also use a r is command line to remove a group of clients, for example:
# /ete/ris -r pastry overly profun

3-8 Server Setup and Maintenance

Index

device special file name
defined, 2-3
getting, 2-3

naming service servers

reference list, 24t

registering clients, 2-3

distribution media
identifying, 2-3

remote installation environment
components, 1-1
environment, 1-1

overview, 1-1, 1-1 to 1-3

letclhosts file
See hosts file

preparing for setup, 2-1 to 2~

remote installation services client
adding, 3-3 to 3-5
defined, 1-1

modifying registration, 3-6

hosts file
adding client host name, 2-3

removing, 3-5
remote installation services server
maintaining, 3-3 to 3-8

preparing to configure, 2..:..1 to 2~

LAN
remote installation services server and, 2-2
Local Area Network
See LAN

remote installation services server area
installing software, 3-1 to 3-3, 3-1
remote installation services utility
See ris utility

ris
using from the command line, 3-6 to 3-7

M
Maintenance Operation Protocol
See MOP
MOP
installing on server, 2-2
mount point
defined, 2-3

ris database
adding multiple clients, 3-7
removing multiple clients, 3-8

ris utility
database, 3-7
defined, 1-2

s
server
defined, 1-1

u
ULTRIX operating system
installing on server, 2-2

Index-·2

How to Order Additional Documentation

Technical Support
If you need help deciding which documentation best meets your needs, call 800-343-4040
before placing your electronic, telephone, or direct mail order.

Electronic Orders
To place an order at the Electronic Store, dial 800-234-1998 using a 1200- or 2400-baud
modem from anywhere in the USA, Canada, or Puerto Rico. If you need assistance using the
Electronic Store, call 800-DIGITAL (800-344-4825).

Telephone and Direct Mail Orders
Your Location

Call

Contact

Continental USA,
Alaska, or Hawaii

800-DIGITAL

Digital Equipment Corporation
P.O. Box CS2008
Nashua, New Hampshire 03061

Puerto Rico

809-754-7575

Local Digital Subsidiary

Canada

800-267-6215

Digital Equipment of Canada
Attn: DECdirect Operations KA02/2
P.O. Box 13000
100 Herzberg Road
Kanata, Ontario, Canada K2K 2A6

International
Internal *

Local Digital subsidiary or
approved distributor
SSB Order Processing - WMO/E15
or

Software Supply Business
Digital Equipment Corporation
Westminster, Massachusetts 01473

* For internal orders, you must submit an Internal Software Order Fonn (EN-01740-07).

Reader's Comments

ULTRIX

Guide to Remote Installation Services
AA-MF02C-TE

Please use this postage-paid form to comment on this manual. If you require a written reply to a software
problem and are eligible to receive one under Software Performance Report (SPR) service, submit your
comments on an SPR form.
Thank you for your assistance.

Please rate this manual:
Accuracy (software works as manual says)
Completeness (enough information)
Clarity (easy to understand)
Organization (structure of subject matter)
Figures (useful)
Examples (useful)
Index (ability to find topic)
Page layout (easy to find information)

Excellent

Good

Fair

Poor

0
0
0
D
D
0
0
D

0
D
D
D
D
D
0
D

0
0
0
0
0
0
0
0

D
D
D
D

What would you like to see more/less of?

What do you like best about this manual?

D What do you like least about this manual?

Please list errors you have found in this manual:
Page

Description

Additional comments or suggestions to improve this manual:

What version of the software described by this manual are you using?
Dept.
Nameffitle
___________________________________________________ Date
Company
Mailing Address
Email

Phone

D
D
D

,,,
,,
,
-- - - - - -

Do Not Tear - Fold Here and Tape

IJII~allmD1M

-----------------------------r---r------------------------,
NO POSTAGE
NECESSARY
IF MAILED IN THE
UNITED STATES

BUSINESS REPLY MAIL
FIRST-CLASS MAIL PERMIT NO. 33 MAYNARD MA
POSTAGE WILL BE PAID BY ADDRESSEE

DIGITAL EQUIPMENT CORPORATION
OPEN SOFTWARE PUBLICATIONS MANAGER
ZK03-2/Z04
110 SPIT BROOK ROAD
NASHUA NH 03062-9987

1111111 IIhlllllllli 1IIIIIh h1I1I11I1 II 111111111111
-------.

Do Not Tear - Fold Here

Cut

Along
Dotted
Line

Reader's Comments

ULTRIX
Guide to Remote Installation Services
AA-MF02C-TE

Excellent

Good

Fair

Poor

0
0
0
0
0
0
0
0

What would you like to see more/less of?

What do you like best about this manual?

What do you like least about this manual?

Please list errors you have found in this manual:
Page

Description

Additional comments or suggestions to improve this manual:

What version of the software described by this manual are you using? _ _ _ _ __
Nameffitle _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ __ Dept. _________
Company __________________________________ Date _ _ _ _ __
Mailing Address
Email _____________ Phone

I
I
I
I
I
I

-- - - - - .

Do Not Tear - Fold Here and Tape

~1I~aDmaTM

-----------------------------rrl-r-~----------::~::A~:---1
NECESSARY
IF MAILED IN THE
UNITED STATES

BUSINESS REPLY MAIL
FIRST-CLASS MAIL PERMIT NO. 33 MAYNARD MA
POSTAGE WILL BE PAID BY ADDRESSEE

DIGITAL EQUIPMENT CORPORATION
OPEN SOFTWARE PUBLICATIONS MANAGER

ZK03-2/Z04
110 SPIT BROOK ROAD
NASHUA NH 03062-9987

II 1IIIIIIhllllllllllllllih 111111111111.111111 lIul
,------,

Do Not Tear-Fold Here

Cut
Along
Dotted

Line