Page Comparison

...

Category	Default Configuration	Description
Base components	Always installed.	Base components are always installed and activated. They include the Universal Broker, Universal Command (UCM), Universal Data Mover (UDM), and others. Base components provide the core agent infrastructure and workload services.
Universal Automation Center Agent (UAG)	Always installed, but inactive.	Universal Controller utilizes UAG agents to provided distributed, workload automation services. UAG is activated using the Universal Agent for HP-UX Installation#--oms_servers parameter.
Universal Message Service (OMS)	Always installed, but inactive.	OMS is message-oriented middleware that should be deployed on a small set of centrally located servers. It should not be activated on every Agent install. OMS is the network provider for UAG and the Universal Controller. OMS is activated using the Universal Agent for HP-UX Installation# --oms_autostart parameter.
Universal Controller command line programs	Not installed.	Universal Controller command line programs provide a command line interface to the Universal Controller. The installation of Universal Controller command line programs is optional. The command line programs are only required on Agents that need to interface with the Universal Controller via the command line. Universal Controller command line programs are installed using the Universal Agent for HP-UX Installation# --opscli parameter.

Starting the Installation Script

To start the installation script, unvinst, and install all of the HP-UX packages, issue the following command:

Panel

See Universal Agent for HP-UX Installation#HP-UX Installation Script Parameters and Universal Agent for HP-UX Installation#Installation Installation Script Example, below, for a description of the optional parameters that you can issue with unvinst and an example of unvinst with these parameters.

Note

title	Note

If you want to install multiple Agents on the same machine, or add one or more additional Agents to a machine with a previously installed Agent, some of these installation parameters are required (see Universal Agent for HP-UX Installation#Installing Installing Multiple Agents on a Single Machine).

This is a silent install. The output from unvinst is written to file install.log in the current directory.

...

The parameters are grouped into the following categories:

Category	Description
Universal Agent for HP-UX Installation#Base Base	Used for base install.
Universal Agent for HP-UX Installation#OMS OMS	Used for an active OMS configuration.
UAG	Universal Agent for HP-UX Installation#UAG	Used for an Used for an active UAG configuration.
Universal Agent for HP-UX Installation#CLI CLI	Used for Universal Controller CLI programs install.
Universal Agent for HP-UX Installation#User User Mode	Used for user mode installation.

Parameter

Description

Default

Anchor

	Base
	Base

Base Parameters

-u
‑user

Anchor

	--user
	--user

--user

Normal UNIX username that is used to execute the Universal Broker daemon. The install grants this user account ownership of all installed files, with the exception of the Universal Agent server components (for example: ucmsrv, udmsrv, and uemsrv) which, due to security requirements, are owned by root and will have their "set user ID on execution" bit set.

If the user account that you want to use already exists, specify that user account.
If the user account does not exist, the install creates it.
If you want to change the user account for an installed Universal Agent for HP-UX system, you must perform a re-installation and use this parameter to change the user account.
If --user is omitted from unvinst, the default is used.
If Universal Agent for HP-UX Installation# --usermode_install is yes, there is no default.

ubroker

‑create_user

Anchor

	--create_user
	--create_user

‑‑create_user

Specification (yes or no) for whether or not to create the user name that will own the installed files as a local user.

yes

‑userdir
‑‑userdir

Home directory for the created user account specified by Universal Agent for HP-UX Installation#--user.

If this directory does not exist, it is created when the specified user is created.
If the user specified by Universal Agent for HP-UX Installation#--user already exists, but the home directory of that user is not the default directory (/home/<username>), --userdir must specify the path to that home directory.
If --userdir is omitted from unvinst, the default is used.

/home/<username>

-g
‑group
‑‑group

Normal UNIX groupname; the Universal Broker daemon will run as this specified group. All installed files will be assigned to this group.

If the group that you want to use already exists, specify that group.
If this group does not exist, the install creates it.
If --group is omitted from unvinst, the default is used.

ubroker

‑create_group

Anchor

	--create_group
	--create_group

‑‑create_group

Specification (yes or no) for whether or not to create the group that will own the installed files as a local group.

yes

Anchor

	-keystore
	-keystore

‑keystore
‑‑keystore

Specification (yes or no) for whether or not to create encryption keys during installation and set up the local Universal Broker as a keystore owner.

no

Anchor

	UAG
	UAG

UAG Parameters

-c
‑convert

Anchor

	--convert_opsagent
	--convert_opsagent

‑‑convert_opsagent

Causes unvinst to execute opsmerge.sh (residing in /opt/universal/uagsrv/bin), which performs the following tasks:

Searches for an existing Opswise Automation Center Agent 1.6 or 1.7 install and converts properties stored in the agent.props file to corresponding configuration options in the Universal Automation Center Agent (UAG) configuration file, uags.conf.
Searches for an active Opswise Automation Center Agent 1.6 or 1.7 daemon process and attempts to stop it.
Assigns the ID used by the Opswise Automation Center Agent 1.6 or 1.7 to UAG by moving the qname file from the Opswise Automaton Center install directory to the /var/opt/universal/uag/var directory.

-d
‑opsdir
‑‑opsdir

If Universal Agent for HP-UX Installation#--convert_opsagent is specified: Identifies the primary install directory for Universal Agent.

If --opsdir is omitted from unvinst, the default is used.

/home/opswise

‑oms_servers

Anchor

	--oms_servers
	--oms_servers

‑‑oms_servers

Specifies a value, in the format port@host[,port2@host,...,portn@hostn], for the port and network address of the OMS server(s) to be used as network communications providers.

Note

title	Note

You should always include --oms_servers in unvinst; OMS is the network communications provider between Controller 7.1.x.x and Agent 7.1.x.x.

UAG configuration: The value specified for --oms_servers is set automatically for the UAG OMS_SERVERS configuration option.

(none)

‑ac_agent_clusters
‑‑ac_agent_clusters

Specifies the Universal Controller-defined clusters to which this agent will belong.

UAG configuration: The value specified by --ac_agent_clusters is set automatically for the UAG AGENT_CLUSTERS configuration option.

(none)

‑ac_agent_ip
‑‑ac_agent_ip

Specifies the IP address or host name (which resolves to an IP address) that the Agent reports to the Controller.

UAG configuration: The value specified by --ac_agent_ip is set automatically for the UAG AGENT_IP configuration option.

(none)

‑ac_netname
‑‑ac_netname

Specifies the network ID that Universal Agent will use.

UAG configuration: The value specified by --ac_netname is set automatically for the UAG NETNAME configuration option.

(none)

‑ac_enable_ssl
‑‑ac_enable_ssl

This option is deprecated starting with Universal Agent 7.1.0.0. UAG Server will always attempt to use SSL/TLS for OMS connections.

n/a

‑uag_autostart
anchor

-ac_process_cancel_timeout
--

uag_autostart

ac_process_cancel_timeout

Set the PROCESS_CANCEL_TIMEOUT UAG configuration option, which specifies the length of time an OS task is given to complete its response to a CANCEL request.

If the task fails to finish its own termination processing within the specified timeout period, UAG Server will forcefully terminate the task.

The specified timeout must be numeric, but a one-letter suffix is accepted to specify (s)econds, (m)inutes, (h)ours, or (d)ays. If no time unit is specified, the default is seconds.

The following maximums are enforced:

2147483647 or 2147483647s
35791394m
596523h
24855d

Minute, hour, and day maximums are set to ensure that their value represented as a number of seconds does not exceed 2147483647.

10

‑uag_autostart

Anchor

	--uag_autostart
	--uag_autostart

‑‑uag_autostart

Specifies (yes or no) whether or not the Universal Automation Center Agent (UAG) Server starts automatically when the Universal Broker is started.

UAG component definition: The value specified by --uag_autostart is set automatically for the UAG AUTOMATICALLY_START component definition option.

yes

Anchor

	OMS
	OMS

OMS Parameters

‑oms_port
‑‑oms_port

Specifies the port to use to listen for OMS connection requests.

OMS configuration: The value specified by --oms_port is set automatically for the OMS SERVICE_PORT configuration option.

(none)

‑oms_autostart

Anchor

	--oms_autostart
	--oms_autostart

‑‑oms_autostart

Specifies (yes or no) whether or not OMS is started automatically by Universal Broker when Universal Broker starts.

OMS component definition: The value specified by --oms_autostart is set automatically for the OMS AUTOMATICALLY_START and RESTART component definition options.

no

Anchor

	CLI
	CLI

CLI Parameters

‑opscli

Anchor

	--opscli
	--opscli

‑‑opscli

Specifies (yes or no) whether or not the Universal Controller Command Line Interface (CLI) tools will be installed.

no

Anchor

	User Mode
	User Mode

User Mode Parameters

Anchor

	--usermode_install
	--usermode_install

-U
-usermode_install
--usermode_install

Specifies (yes or no) for a user mode installation, which defines both of the following:

Whether or not this Agent can be installed on a machine where an Agent already is installed (see Universal Agent for HP-UX Installation#Installing Installing Multiple Agents on a Single Machine).
Whether or not the user can specify installation parameters (Universal Agent for HP-UX Installation#--unvdir, Universal Agent for HP-UX Installation# --unvcfgdir, Universal Agent for HP-UX Installation# --unvdatadir, and Universal Agent for HP-UX Installation# --unvport) that control where the Agent will be installed and configured (see Universal Agent for HP-UX Installation#Changing Changing the Default Installation Directories).

no

Anchor

	--unvdir
	--unvdir

-unvdir

Anchor

	unvdir
	unvdir

--unvdir

If Universal Agent for HP-UX Installation#--usermode_install is set to yes: Specifies the Agent binaries (installation) directory.

(none)

‑unvcfgdir

Anchor

	unvcfgdir
	unvcfgdir

‑‑unvcfgdir

If Universal Agent for HP-UX Installation#--usermode_install is set to yes: Specifies the Agent configuration files directory.

<#--unvdir>/etc

‑unvdatadir

Anchor

	unvdatadir
	unvdatadir

‑‑unvdatadir

If Universal Agent for HP-UX Installation# --usermode_install is set to yes: Specifies the Agent data files directory.

<#--unvdir>/var

‑unvport

Anchor

	unvport
	unvport

‑‑unvport

If Universal Agent for HP-UX Installation#If --usermode_install is set to yes: Specifies the Universal Broker port.

(none)

Additional Parameter

-?
-h
‑help
‑‑info

Displays command line help.

n/a

...

A user mode installation, implemented through use of the Universal Agent for HP-UX Installation#usermode usermode_install installation parameter, lets you install multiple Agents on a single machine and change the default installation directories for any Agent being installed.

...

Installation Parameter	Value
Universal Agent for HP-UX Installation#--usermode_install	yes
Universal Agent for HP-UX Installation#--user	A username that is different than the username specified for any other Agent installation on this machine.
Universal Agent for HP-UX Installation#--unvdir	An Agent binaries (installation) directory that is different than the installation directory specified for any other Agent installation on this machine.
Universal Agent for HP-UX Installation#--unvport	A Universal Broker port that is different than the port specified for any other Agent installation on this machine.

...

If you want to change these default directories, or if you want to install multiple Agents on the same machine, you must set the Universal Agent for HP-UX Installation#--usermode_install parameter to yes and specify new values in the following parameters. These directories must be different for each Agent on the same machine.

...

Installation Parameter	Default Directory	Files Installed
Universal Agent for HP-UX Installation#--unvdir	/opt/universal	Agent binaries
Universal Agent for HP-UX Installation#--unvcfgdir	/etc/universal	Agent configuration files
Universal Agent for HP-UX Installation#--unvdatadir	/var/opt/universal	Agent data files

...

Versions Compared

Old Version 1

New Version 2

Key

Starting the Installation Script