remote_newprod(8) CLIX remote_newprod(8)
NAME
remote_newprod - Installs Intergraph software products on remote systems
SYNOPSIS
/usr/ip32/deltools/node/remote_newprod
DESCRIPTION
The remote_newprod command enables an administrator to deliver Intergraph
software products to a number of networked machines from a central system.
The remote_newprod command operates by reading an input file that lists
the following information:
⊕ The delivery media to be used.
⊕ The machines to which software will be delivered.
⊕ The software packages to be delivered to those machines. This
information is typically held in a file called r_newprod.dat in the
current working directory, unless the DATAFILE environment variable
specifies the pathname of a different input file.
The data file consists of lines that assign values to various keywords.
Blank lines and lines beginning with the pound (#) character are ignored.
If a keyword is supplied without any value, its value reverts back to its
default definition. Keywords may be reassigned multiple times within the
data file.
The following keywords are available:
DEBUG {YES | NO}
Tells remote_newprod to display information useful for
troubleshooting. It is not necessary to define this keyword. This
data is displayed in the window from which remote_newprod is
executed. The default value of this keyword is NO.
SERVER nodename.username.password
Establishes a network connection string
(nodename.username.password) for the system acting as the newprod
delivery node.
Connections may be initiated over TCP/IP or XNS networks. If no
SERVER keyword is defined in the file, remote_newprod will fail.
The system defined to be the server does not have to be the same
system that is running remote_newprod and controlling the delivery.
MEDIA {DISK | CDROM}
Specifies the type of newprod connection which the target node will
make to the server.
2/94 - Intergraph Corporation 1
remote_newprod(8) CLIX remote_newprod(8)
The value CDROM indicates that the products are available from
remote CD/ROM (a CD/ROM drive attached to the server). The value
DISK indicates that the products are available from a delivery
structure (constructed by makenode) on the server. The default
value is DISK.
This option can be specified multiple times throughout the file.
LOGWHERE {emailpath!user | user@emailpath | /path/filename}
Directs where the remote systems will send their logging
information for their delivery sessions. If this keyword is not
defined, then remote_newprod will direct each remote machine to
mail its log file to its root user. If a value is specified for
LOGWHERE, remote_newprod considers values containing a slash (/) to
be a directory on the local machine. The command will create this
directory if it does not exist. All other values are treated as
mailpaths.
If LOGWHERE specifies a directory, remote_newprod will retrieve the
logfile from the remote system and place it in the given directory.
The remote_newprod command will name the file with a name
constructed from the nodename of the remote system.
If LOGWHERE is a mail path, the remote system will use the mailer
to send the logfile to the named user. The address style given as
the value for LOGWHERE should conform to the addressing style for
the mailer used by the systems in your network.
MAX number_of_systems
Defines the maximum number of systems that remote_newprod will
update at the same time. For example, if you have 18 systems to
which software must be delivered, but the bandwidth of your network
and/or server is saturated at 8 simultaneous deliveries, you should
specify a value of 8 for MAX. The remote_newprod command will
start no more than MAX delivery processes at any given time.
The default value for MAX is 8; it will be reset to that value if
MAX is used in the data file without a value assignment.
This keyword can be important in preventing conflicts if there will
be multiple target entries for a single system in the data file.
If MAX is set too high or the target entries for the machine are
placed too closely, remote_newprod may initiate multiple delivery
sessions to the machine at the same time. This may cause file
access conflicts and software delivery failures.
MODEL {nodename.username.password | /path/filename}
Specifies a file that holds pre-configured answers for the
questions asked by product installation scripts. If a
nodename.username.password value is used, the target system will
contact the specified system to recover its /usr/ip32/.defaults
2 Intergraph Corporation - 2/94
remote_newprod(8) CLIX remote_newprod(8)
file. If a /path/filename value is used, the target system will
copy the specifed file from the system controlling remote_newprod
to its own file system.
The information in either of these files is merged with the pre-
configured answers on the target system. This means that the
model's answers will take precedence over answers in the target
system's own defaults file.
FILESYSTEM mounted_file system
Allows the specification of a file system that will be the base
file system for product delivery. If this keyword is not used or
is specified without a value, the /usr file system is used as the
base file system.
Pre-existing products are updated in the file system in which they
are already installed.
PRODUCTS u productname | productnumber =file system
Specifes the products to be installed on the remote system.
Product names are specified in the same format that newprod uses
for products specified on the command line: they may be product
numbers or product names. The following special modifiers are
defined for this keyword:
u
Delivers all products that are out-of-date.
!product
Exempts the named product from delivery, even if it is out-of-date
and the u modifer is used.
%product
Delivers the named product only if it is out-of-date.
product=file
Delivers the named product to file system, instead of to the base
directory specified by FILESYSTEM.
TARGET nodename.root.password
Specifies the nodename and password for a remote machine to be
updated. The remote machine will invoke newprod to download
software from the node specified by the SERVER keyword. The root
user must be specified; specifying any other user will cause the
delivery to fail due to insufficient permissions.
If the remote_newprod input file has been created using the vprod
command, the root password will be stored in an encrypted form for
greater security.
When remote_newprod encounters this keyword, it establishes a
connection to the remote machine and verifies the name and password
2/94 - Intergraph Corporation 3
remote_newprod(8) CLIX remote_newprod(8)
of the user. If the remote system allows the connection,
remote_newprod sends a request containing the information
pertaining to the delivery session, gathered from the current
values of the keywords PRODUCTS, LOGWHERE, MODEL, FILESYSTEM,
REBOOT, and MEDIA. The remote system performs the software delivery
and returns a reply that indicates whether or not the delivery was
successful.
The remote_newprod command will fail if this keyword is not
specified. Avoid specifying a remote system multiple times as a
target, since errors can occur if two conflicting deliveries are
attempted on a machine at the same time.
REBOOT { YES | NO}
Tells the remote system whether or not it should reboot when it has
completed installing software. The default value for this keyword
is NO.
EXIT Allows the user to terminate the remote_newprod session without
processing the rest of the input file. It is useful for debugging
or for updating a small number of systems using a pre-existing
input file which defines many systems.
EXAMPLES
An example r_newprod.dat file follows:
SERVER server.wsdel
MEDIA CDROM
LOGWHERE server!mylogin
MODEL dbsys.sys.syspassword
MAX 4
PRODUCTSu
REBOOT YES
TARGET dbsysa.root.rootpassword
PRODUCTSsg01005 SYSVDOC u
TARGET dbsysb.root.rootpassword
TARGET dbsysc.root.rootpassword
TARGET grasysa.root.rootpassword
TARGET grasysb.root.rootpassword
FILESYSTEM /usr3
# products will now be loaded to /usr3 until the
# next FILESYSTEM definition
PRODUCTSBSPMATH u
MODEL grasys.sys.syspassword
# dbsysc will load BSPMATH and update existing products on
# /usr3 using
# answers from the defaults file copied from grasys
TARGET dbsysc.root.rootpassword
FILESYSTEM
# the remaining TARGETs will be loaded to the /usr
4 Intergraph Corporation - 2/94
remote_newprod(8) CLIX remote_newprod(8)
# file system using
# the answers from the defaults file copied
# from grasys above
TARGET grasysa.root.rootpassword
TARGET grasysb.root.rootpassword
TARGET grasysc.root.rootpassword
TARGET grasysd.root.rootpassword
NOTES
The vprod command provides a graphical interface that allows the
administrator to manage remote machines and software packages in
customizable groups, and to perform remote_newprod delivery sessions
interactively or scheduled at a later time.
FILES
$PWD/r_newprod.dat
default input file
DIAGNOSTICS
The remote_newprod command will print error messages to stderr for
important failures. To obtain further detailed messages, use the DEBUG
keyword in your input file.
RELATED INFO:
Commands: newprod(8), makenode(8), vprod(8)
2/94 - Intergraph Corporation 5