...
To uncompress and extract the installation files from the distribution file, issue the following command:
Panel |
---|
zcat sb-7.2.x.x-hpux-11.23-ia64.tar.Z | tar xvf - |
This command assumes the following:
...
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. |
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. |
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. |
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 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 | ||
---|---|---|
| ||
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 Multiple Agents on a Single Machine). |
...
System initialization files /sbin/init.d/ubrokerd and /sbin/rc3.d/S850ubrokerd are created to start the ubrokerd daemon when the system boots to runlevel 3.
The Universal Broker daemon will be installed and run as the username and groupname specified with the installation script parameters, below.
Note | ||
---|---|---|
| ||
With the Solaris, HP-UX, and AIX installs, the previous installation directories are removed when the native installer has detected that additional directories or files have not been added to the original installation directories. If they have been modified, the directories will remain and can be reviewed and removed, as desired, by your Administrator. |
...
The following table describes the optional parameters that are available in the installation script, unvinst, when installing Universal Agent.
The parameters are grouped into the following categories:
...
Category
...
Description
...
Universal Agent for HP-UX Installation#Base
...
Used for base install.
...
Universal Agent for HP-UX Installation#OMS
...
Used for an active OMS configuration.
...
Universal Agent for HP-UX Installation#UAG
...
Used for an active UAG configuration.
...
Universal Agent for HP-UX Installation#CLI
...
Used for Universal Controller CLI programs install.
...
Universal Agent for HP-UX Installation#User Mode
...
Used for user mode installation.
...
Parameter
...
Description
...
Default
...
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
...
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.
...
sh ./unvinst [--user username [--userdir directory] [--create_user {yes|no}] ] [--group group name [--create_group {yes|no}] ] [--keystore {yes|no}] [--convert_opsagent [--opsdir directory] ] [--oms_servers network address] [--oms_port port] [--ac_agent_clusters clusters] [--ac_agent_ip IP address] [--ac_netname ID] [--ac_process_cancel_timeout value {s|m|h|d}] [--oms_autostart {yes|no}] [--uag_autostart yes] [--opscli {yes|no}] [--usermode_install {yes|no} [--unvdir directory] [--unvcfgdir directory] [--unvdatadir directory] [--unvport port] ] |
See HP-UX Installation Script Parameters and 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 | ||
---|---|---|
| ||
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 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.
System initialization files /sbin/init.d/ubrokerd and /sbin/rc3.d/S850ubrokerd are created to start the ubrokerd daemon when the system boots to runlevel 3.
The Universal Broker daemon will be installed and run as the username and groupname specified with the installation script parameters, below.
Note | ||
---|---|---|
| ||
With the Solaris, HP-UX, and AIX installs, the previous installation directories are removed when the native installer has detected that additional directories or files have not been added to the original installation directories. If they have been modified, the directories will remain and can be reviewed and removed, as desired, by your Administrator. |
Anchor | ||||
---|---|---|---|---|
|
The following table describes the optional parameters that are available in the installation script, unvinst, when installing Universal Agent.
The parameters are grouped into the following categories:
Category | Description |
---|---|
Used for base install. | |
Used for an active OMS configuration. | |
Used for an active UAG configuration. | |
Used for Universal Controller CLI programs install. | |
Used for user mode installation. |
The following example illustrates Universal Agent for HP_UX installed with the installation script, unvinst, and optional parameters.
...
Parameter | Description | Default | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
-u
| 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.
| ubroker | |||||||||||||||||||
‑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 | Home directory for the created user account specified by --user.
|
| |||||||||||||||||||
-g | Normal UNIX groupname; the Universal Broker daemon will run as this specified group. All installed files will be assigned to this group.
| ubroker | |||||||||||||||||||
‑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 | |||||||||||||||||||
‑‑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 | |||||||||||||||||||
| |||||||||||||||||||||
-c
| Causes
| ||||||||||||||||||||
-d | If --convert_opsagent is specified: Identifies the primary install directory for Universal Agent.
| ubroker | ‑create_group
| ||||||||||||||||||
‑ac_agent_clusters | Specifies the Universal Controller-defined clusters to which this agent will belong. | (none) | |||||||||||||||||||
‑ac_agent_ip | Specifies the IP address or host name (which resolves to an IP address) that the Agent reports to the Controller. | (none) | |||||||||||||||||||
‑ac_netname | Specifies the network ID that Universal Agent will use. UAG ‑oms_servers
| 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 | ‑keystoreSpecification (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|||||||||||||||||||
Anchor | --convert_opsagent | --convert_opsagent | ‑‑convert_opsagentCauses
| ||||||||||||||||||
-d | If Universal Agent for HP-UX Installation#--convert_opsagent is specified: Identifies the primary install directory for Universal Agent.
|
| |||||||||||||||||||
Anchor | --oms_servers | --oms_servers | ‑‑oms_serversSpecifies a value, in the format
| (none) | |||||||||||||||||
servers | Specifies a value, in the format
| (none) | |||||||||||||||||||
‑ac_agent_clusters | Specifies the Universal Controller-defined clusters to which this agent will belong. | (none) | |||||||||||||||||||
‑ac_agent_ip | Specifies the IP address or host name (which resolves to an IP address) that the Agent reports to the Controller. | (none) | |||||||||||||||||||
‑ac_netname | Specifies the network ID that Universal Agent will use. | (none) | |||||||||||||||||||
‑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 | |||||||||||||||||||
-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:
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
| Specifies (yes or no) whether or not the Universal Automation Center Agent (UAG) Server starts automatically when the Universal Broker is started. | yes | |||||||||||||||||||
| |||||||||||||||||||||
‑oms_port | Specifies the port to use to listen for OMS connection requests. | (none)‑ac | |||||||||||||||||||
‑oms_ ‑‑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 | |||||||||||||||||||
-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:
Minute, hour, and day maximums are set to ensure that their value represented as a number of seconds does not exceed 2147483647. | 10 | |||||||||||||||||||
Anchor | --uag_autostart | --uag_autostart | ‑‑uag_autostartSpecifies (yes or no) whether or not the Universal Automation Center Agent (UAG) Server starts automatically when the Universal Broker is started. | yes | |||||||||||||||||
Anchor | OMS | OMS | OMS Parameters|||||||||||||||||||
‑oms_port | Specifies the port to use to listen for OMS connection requests. | (none) | |||||||||||||||||||
Anchor | --oms_autostart | --oms_autostart | ‑‑oms_autostartSpecifies (yes or no) whether or not OMS is started automatically by Universal Broker when Universal Broker starts. | no | |||||||||||||||||
Anchor | CLI | CLI | CLI Parameters‑opscli|||||||||||||||||||
Anchor | --opscli | --opscli | ‑‑opscliSpecifies (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 | -USpecifies (yes or no) for a user mode installation, which defines both of the following:
| no | |||||||||||||||||
Anchor | --unvdir | --unvdir | -unvdir|||||||||||||||||||
Anchor | unvdir | unvdir | --unvdirIf Universal Agent for HP-UX Installation#--usermode_install is set to yes: Specifies the Agent binaries (installation) directory. | (none) | ‑unvcfgdir|||||||||||||||||
Anchor | unvcfgdir | unvcfgdir | ‑‑unvcfgdirIf Universal Agent for HP-UX Installation#--usermode_install is set to yes: Specifies the Agent configuration files directory. | ‑unvdatadir | |||||||||||||||||
Anchor | unvdatadir | unvdatadir | ‑‑unvdatadirIf Universal Agent for HP-UX Installation#--usermode_install is set to yes: Specifies the Agent data files directory. | ‑unvport | |||||||||||||||||
Anchor | unvport | unvport | ‑‑unvportIf Universal Agent for HP-UX Installation#--usermode_install is set to yes: Specifies the Universal Broker port. | (none) | Additional Parameter | ||||||||||||||||
-? | Displays command line help. | n/a |
...
autostart
| Specifies (yes or no) whether or not OMS is started automatically by Universal Broker when Universal Broker starts. | no | ||||||||||||
| ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
‑opscli
| Specifies (yes or no) whether or not the Universal Controller Command Line Interface (CLI) tools will be installed. | no | ||||||||||||
| ||||||||||||||
-usermode_install --usermode_install | Specifies (yes or no) for a user mode installation, which defines both of the following:
| no | ||||||||||||
| If --usermode_install is set to yes: Specifies the Agent binaries (installation) directory. | (none) | ||||||||||||
‑unvcfgdir
| If --usermode_install is set to yes: Specifies the Agent configuration files directory. |
| ||||||||||||
‑unvdatadir
| If --usermode_install is set to yes: Specifies the Agent data files directory. |
| ||||||||||||
‑unvport
| If --usermode_install is set to yes: Specifies the Universal Broker port. | (none) | ||||||||||||
Additional Parameter | ||||||||||||||
-? | Displays command line help. | n/a |
Anchor | ||||
---|---|---|---|---|
|
The following example illustrates Universal Agent for HP_UX installed with the installation script, unvinst, and optional parameters.
Panel |
---|
sh ./unvinst --user user1 --userdir /homedir/user --group usergroup
--keystore no --convert_opsagent --opsdir /homedir/ops
--oms_servers 7878@oms2 --oms_port 7878 --oms_autostart yes
--ac_agent_clusters GA Cluster,CA Cluster --ac_agent_ip 127.0.0.1
--ac_netname OPSAUTOCONF --opscli yes
--uag_autostart yes --usermode_install yes --unvdir /opt/universal
--unvcfgdir /etc/universal --unvdatadir /var/opt/universal --unvport 7887 |
Anchor | ||||
---|---|---|---|---|
|
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. |
An Agent binaries (installation) directory that is different than the installation directory specified for any other Agent installation on this machine. | |
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 |
---|---|---|
/opt/universal | Agent binaries | |
/etc/universal | Agent configuration files | |
Universal Agent for HP-UX Installation#--unvdatadir | /var/opt/universal | Agent data files |
...
To list information for Universal Agent for HP-UX, issue the following command:
Panel |
---|
swlist -l subproduct OPSCLI
swlist -l subproduct UNV |
Removing Universal Agent for HP-UX
...
Step 1 | Stop the ubrokerd daemon. | ||||||||
---|---|---|---|---|---|---|---|---|---|
Step 2 | Make a backup copy of the | ||||||||
Step 3 | Using the superuser ID, remove all Universal Agent for HP-UX sub-products by issuing the following commands:
System initialization files
| ||||||||
Step 4 | Delete the Agent user account (
| ||||||||
Step 5 | Delete the Agent group (
|
User Mode Install Removal
Step 1 | Stop the Usermode Broker. | ||||||
---|---|---|---|---|---|---|---|
Step 2 | Make a backup copy of the | ||||||
Step 3 | Using the superuser ID, remove all Universal Agent for Linux packages by issuing the following commands:
| ||||||
Step 4 | Delete the Agent user account (
| ||||||
Step 5 | Delete the Agent group (
|
Note | ||
---|---|---|
| ||
To remove an Agent executing in an unprivileged user mode environment (see User Mode Installation), simply stop the |
...