Citation: Copyright © 2000 Compaq Computer Corporation.   All rights reserved.


 Compaq Remote Deployment Console Utility

The Compaq Remote Deployment Console Utility (SETUPC.EXE) is a companion application to the Compaq Remote Deployment Utility (SETUP.EXE).  The Compaq Remote Deployment Utility is a tool that can be scripted to perform local or remote installation of Compaq Support Paqs and individual Compaq components.


 Using the Command Line

Command line (silent) mode allows components to be installed or updated without any user interaction or graphical user interface.  This method may be used to perform batch operations on either one or several different computers at the same time.

The general syntax format is the following:

SETUPC [/help | [/t[arget]:computer] [/s[ilent]] [/f[orce]] [/r[eboot]] file ...]

The table below describes the commands that are supported by the Compaq Remote Deployment Console Utility’s command line interface.

Parameter	Description
/help, /h, /?	Displays the available command line options and example usage. Note: The usage information is also displayed if an incorrect command line option is sent to the application.
/target:, /t:	Specifies a target computer to use for the installation. Note: If this parameter is not specified, the local computer is used by default.
/silent, /s	Causes the application to suppress all console messages.  This option only applies to the messages that are generated by the Compaq Remote Deployment Console Utility.  This application always runs components silently.
/force, /f	Changes the behavior of a component installation in the following ways: • If the component is already installed and up to date, it will reinstall itself and the installed version number will remain the same. • If a newer version of the component is already installed, the component will install itself and downgrade the component to the older version number.
/reboot, /r	Allows the server to reboot if one or more components require a reboot for complete installation.
file ...	A list of one or most Support Paq or component filenames.  The application will read this list in the order in which it occurs on the command line and create a single list of components to install on the target computer.


 Command Line Return Codes

The Compaq Remote Deployment Console Utility sets the error level to one of the following values when it exits:

Return Code	Description
0	Installation was successful for all components.
1	An application error occurred that prevented installation from completing successfully.  Possible errors include failure to communicate across the network connection, failure to start the installation of a component, or failure to determine the installation results.
2	One or more components failed to install properly.
3	A user error occurred that prevented the application from continuing.  This is most likely caused by incorrect command line options.


 Command Line Examples

The following examples illustrate how you would perform various activities using the Compaq Remote Deployment Console Utility:

Example 1

The following example installs the Support Paq named BP000001.XML on the computer named COMPUTER1:

SETUPC /target:COMPUTER1 BP000001.XML

Example 2

The following example installs the Support Paq named BP000001.XML and an additional component named CP000150.EXE on the computer named COMPUTER2:

SETUPC /target:COMPUTER2 BP000001.XML CP000150.EXE

Example 3

The following example installs the Support Paq named BP000001.XML on the local system and suppresses console messages:

SETUPC /silent BP000001.XML

Example 4

The following example installs the Support Paq named BP000001.XML on the local system. If the components are already updated, this command causes the components to be reinstalled:

SETUPC /force BP000001.XML

Example 5

The following example installs the Support Paq named BP000001.XML on the local system and allows the server to reboot if one or more components require a reboot for complete installation:

SETUPC /reboot BP000001.XML

Example 6

The following example is a Windows .CMD script that installs the Support Paq named BP000002.XML on the following computers: CPQSYS1, CPQSYS2, CPQSYS3, and CPQSYS4.

@echo off

for %%i in (CPQSYS1 CPQSYS2 CPQSYS3 CPQSYS4) do SETUPC /target:%%i BP000002.XML


Component

A component is a single piece of value-add software that can be deployed using the Compaq Remote Deployment Console Utility or other Compaq-provided tools.


Support Paq

A Support Paq is an ordered set of components that can be installed using the Compaq Remote Deployment Console Utility or other Compaq-provided tools.


Local Computer

The local computer is the computer in which the Compaq Remote Deployment Console Utility is running on.


Target Computer

The target computer is the computer that the Compaq Remote Deployment Console Utility will install software on.


Downgrade

To downgrade is to revert back to a previously installed version of a component rather than installing the latest version.