Versions Compared

Old Version 5

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user IT Stonebranch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Macro name changed from html to html-bobswift during server to cloud migration processing.

...

To uncompress and extract the installation files from the distribution file, issue the following command:

Panel
Html bobswift
<pre>
zcat sb-7.2.x.x-hpux-11.23-ia64.tar.Z | tar xvf -
</pre>

This command assumes the following:

...

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

Panel

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
titleNote

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).

...

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
titleNote

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

...

Base

...

Used for base install.

...

OMS

...

Used for an active OMS configuration.

...

UAG

...

Used for an active UAG configuration.

...

CLI

...

Used for Universal Controller CLI programs install.

...

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.

...

Html bobswift
<pre>
sh ./unvinst [--user <i>username</i> [--userdir <i>directory</i>] [--create_user {<b>yes</b>|<b>no</b>}] ] [--group <i>group name</i> [--create_group {<b>yes</b>|<b>no</b>}] ] 
             [--keystore {<b>yes</b>|<b>no</b>}] [--convert_opsagent [--opsdir <i>directory</i>] ] [--oms_servers <i>network address</i>] [--oms_port <i>port</i>]
             [--ac_agent_clusters <i>clusters</i>] [--ac_agent_ip <i>IP address</i>] [--ac_netname <i>ID</i>] 
             [--ac_process_cancel_timeout <i>value</i> {<b>s</b>|<b>m</b>|<b>h</b>|<b>d</b>}] [--oms_autostart {<b>yes</b>|<b>no</b>}]  
             [--uag_autostart <i>yes</i>] [--opscli {<b>yes</b>|<b>no</b>}] [--usermode_install {<b>yes</b>|<b>no</b>} [--unvdir <i>directory</i>]
             [--unvcfgdir <i>directory</i>] [--unvdatadir <i>directory</i>] [--unvport <i>port</i>] ]
</pre>

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
titleNote

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
titleNote

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
HP-UX Installation Script Parameters
HP-UX Installation Script Parameters
HP-UX Installation Script Parameters

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

Base

Used for base install.

OMS

Used for an active OMS configuration.

UAG

Used for an active UAG configuration.

CLI

Used for Universal Controller CLI programs install.

User Mode

Used for user mode installation.

The following example illustrates Universal Agent for HP_UX installed with the installation script, unvinst, and optional parameters.
 

...

‑create_user
‑‑create_user‑create_group
‑‑create_group‑keystore
‑‑keystoreUAG Parameters-c
‑convert
‑‑convert_opsagent‑oms_servers
‑‑oms_servers‑uag_autostart
‑‑uag_autostartOMS Parameters‑oms_autostart
‑‑oms_autostartCLI Parameters‑opscli
‑‑opscliUser Mode Parameters-U
-usermode_install
--usermode_install-unvdir
--unvdir‑unvcfgdir
‑‑unvcfgdir‑unvdatadir
‑‑unvdatadir‑unvport
‑‑unvport

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 --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 --user.

  • If this directory does not exist, it is created when the specified user is created.
  • If the user specified by --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:

  1. 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.
  2. Searches for an active Opswise Automation Center Agent 1.6 or 1.7 daemon process and attempts to stop it.
  3. 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 --convert_opsagent is specified: Identifies the primary install directory for Universal Agent.

  • If --opsdir is omitted from unvinst, the default is used.
  • If --usermode_install is yes, there is no default.

ubroker

Anchor
--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 --user.

  • If this directory does not exist, it is created when the specified user is created.
  • If the user specified by --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

Anchor
--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

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
UAGUAG
Anchor
--convert_opsagent--convert_opsagent

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

  1. 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.
  2. Searches for an active Opswise Automation Center Agent 1.6 or 1.7 daemon process and attempts to stop it.
  3. 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 --convert_opsagent is specified: Identifies the primary install directory for Universal Agent.

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

/home/opswise

Anchor
--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
titleNote

You should always include --oms_servers in unvinst; OMS is the network communications provider between Controller 7.2.x.x and Agent 7.2.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

-ac_process_cancel_timeout
--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
Anchor
--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
OMSOMS

‑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)

Anchor
--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
CLICLI
Anchor
--opscli--opscli

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

no

Anchor
User ModeUser Mode
Anchor
--usermode_install--usermode_install

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

no

Anchor
--unvdir--unvdir
Anchor
unvdirunvdir

If --usermode_install is set to yes: Specifies the Agent binaries (installation) directory.

(none)

Anchor
unvcfgdirunvcfgdir

If --usermode_install is set to yes: Specifies the Agent configuration files directory.

<--unvdir>/etc

Anchor
unvdatadirunvdatadir

If --usermode_install is set to yes: Specifies the Agent data files directory.

<--unvdir>/var

Anchor
unvportunvport

If --usermode_install is set to yes: Specifies the Universal Broker port.

(none)

Additional Parameter

-?
-h
‑help
‑‑info

Displays command line help.

n/a

...

/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
titleNote

You should always include --oms_servers in unvinst; OMS is the network communications provider between Controller 7.2.x.x and Agent 7.2.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

-ac_process_cancel_timeout
--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:

no

Anchor
--unvdir
--unvdir
-unvdir
Anchor
unvdir
unvdir
--unvdir

If --usermode_install is set to yes: Specifies the Agent binaries (installation) directory.

(none)

‑unvcfgdir

Anchor
unvcfgdir
unvcfgdir
‑‑unvcfgdir

If --usermode_install is set to yes: Specifies the Agent configuration files directory.

<--unvdir>/etc

‑unvdatadir

Anchor
unvdatadir
unvdatadir
‑‑unvdatadir

If --usermode_install is set to yes: Specifies the Agent data files directory.

<--unvdir>/var

‑unvport

Anchor
unvport
unvport
‑‑unvport

If --usermode_install is set to yes: Specifies the Universal Broker port.

(none)

Additional Parameter



-?
-h
‑help
‑‑info

Displays command line help.

n/a

Anchor
Installation Script Example
Installation Script Example
Installation Script Example

The following example illustrates Universal Agent for HP_UX installed with the installation script, unvinst, and optional parameters.
 

Panel
Html bobswift
<pre>
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
</pre>

Anchor
User Mode Installation
User Mode Installation
User Mode Installation

...

To list information for Universal Agent for HP-UX, issue the following command:

Panel
Html bobswift
<pre>
swlist -l subproduct OPSCLI
swlist -l subproduct UNV
</pre>

Removing Universal Agent for HP-UX

...


 

Step 1

Stop the ubrokerd daemon.

Step 2

Make a backup copy of the /etc/universal and /var/opt/universal directories.

Step 3

Using the superuser ID, remove all Universal Agent for HP-UX sub-products by issuing the following commands:
 

Panel
Panel
Html bobswift
<pre>
swremove OPSCLI
swremove UNV
</pre>

System initialization files /sbin/init.d/ubrokerd and /sbin/rc3.d/S850ubrokerd are removed.
 

Panel
Html bobswift
<pre>
rm -rf /etc/universal
</pre>
Panel
Html bobswift
<pre>
rm -rf /var/opt/universal
</pre>

Step 4

Delete the Agent user account (ubroker) and its home directory:
 

Panel


 

Panel
Html bobswift
<pre>
userdel -r ubroker
</pre>

Step 5

Delete the Agent group (ubroker):
 

Panel
Html bobswift
<pre>
groupdel ubroker
</pre>

User Mode Install Removal

panel

Using the superuser ID, remove all Universal Agent for Linux packages by issuing the following commands:
 


 

Step 1

Stop the Usermode Broker.

Step 2

Make a backup copy of the <--unvcfgdir> and <--unvdatadir> directories.

Step 3

Panel
Panel
Panel
Html bobswift
<pre>
rm -rf <---unvdir>
</pre>
Panel
Html bobswift
<pre>
rm -rf <--unvcfgdir>
</pre>
Panel
Html bobswift
<pre>
rm -rf <--unvdatadir>
</pre>

Step 4

Delete the Agent user account (ubroker) and its home directory:
 

Panel
Html bobswift
<pre>
userdel -r [Usermode Broker user]
</pre>

Step 5

Delete the Agent group (ubroker):
 

Panel
Html bobswift
<pre>
groupdel [Usermode Broker group]
</pre>
Note
titleAgent

To remove an Agent executing in an unprivileged user mode environment (see User Mode Installation), simply stop the ubrokerd daemon and remove the ./universal installation directory. To make sure that you do not mistakenly remove a system install directory, attempt the removal with a non-privileged user account or the Broker account.