Universal Discovery Resources for UNIX

Resources

The following script files are available for manual agent installations and upgrades:

Platform Resource Name Description
UNIX agentinstall.sh
  • Installs the Universal Discovery Agent.
  • Replaces the non-native version of the UD Agent with a version that is packaged in the native operating system version of the discovery node.
agentupgrade.sh Upgrades the DDMI agent to a Universal Discovery agent. However, this version of the Universal Discovery agent is not packaged in the native operating system version of the discovery node.

These files are available in the Package Manager. For more information on exporting resources, see How to Export a Package.

Additionally, discovery resources for UNIX and the UNIX variants that are also available in the Package Manager are as follows:

Operating System Platform File Name
HP-UX ia64 ud-agent-hpux-ia64.depot
HPPA ud-agent-hpux-hppa.depot
Linux (Red Hat, SUSE, CentOS, Oracle) x86 ud-agent-linux-x86.rpm
x64 ud-agent-linux-x64.rpm
Linux (Ubuntu) x86 ud-agent-linux-x86.deb
x64 ud-agent-linux-x64.deb
AIX POWER ud-agent-aix-ppc.bff
Solaris x86 ud-agent-solaris-x86.i86pc
SPARC ud-agent-solaris-sparc.sparc
Mac OS X x86 ud-agent-macosx-x86.dmg

Parameters

You can use parameters in a command line interface to customize the discovery installation as follows:

filename [--help] [--url0 ipaddress] [--url1 ipaddress] [--url2 ipaddress] [--port number] [--timeout seconds] [--cert path] [--usage] [--softwareutilization] [--softwareutilizationonly] [--period days] [--home path] [--upgrade] [--uninstall] [--clean] [--temp] [--user] [--group] packagename 
--isnative

where:

Parameter Name Description
cert

Path to install certificate files.

Default: Working directory

clean

Specifies a type of uninstall procedure. Most Universal Discovery Agent files and scanner files are deleted.

Note  This parameter can only be used together with the uninstall and home parameters.

filename

The name of the installation file.

Note

  • This is a mandatory parameter.
  • The filename is usually agentinstall.sh.
group

Specifies the group name for the user account that you want to run the Universal Discovery Agent under.

Note Use this parameter together with the user parameter.

help Displays help messages.
home

Directory that contains the Universal Discovery Agent log and the software utilization data files.

Default: HOME directory

packagename

Full path for the package installation file.

Default: Working directory

Note  This parameter is required when installing or upgrading the Universal Discovery Agent.

period

Number of days to retain software utilization data.

Default: 365 days

port

Port number for the Universal Discovery Agent to use for communication with the Data Flow Probe.

Type 2738 or 7738

Default: 2738

Note  If you change this port number manually after installation, the new port number takes effect only after the Universal Discovery Agent is restarted.

softwaretutilization Enables software utilization.
softwareutilizationonly

Enables the Software Utilization plug-in only.

Note

  • The Universal Discovery Agent is disabled.
  • This parameter is supported only when installing the Universal Discovery Agent manually.
temp

Directory that contains Universal Discovery Agent and scanner temporary files.

Default: $TEMP directory.

timeout

Frequency (in seconds) that the Universal Discovery Agent contacts the Data Flow Probe for Call Home.

Default: 86400 seconds

uninstall

Uninstalls the Universal Discovery Agent.

Note When you use this parameter:

  • All parameters except the clean parameter are ignored.
  • The filename parameter is required.
upgrade Upgrades the Universal Discovery Agent.
url0|url1|url2

IP address for Data Flow Probe that is used for Call Home messages.

usage

Displays help messages.

Note This parameter provides the same information as the help parameter.

user The user account that is used to start up the Universal Discovery Agent.
isnative Returns whether a native or non-native Universal Discovery Agent is installed.

Universal Discovery Agent Error Codes

The following error codes may be returned when using installation or upgrade scripts as follows:

Error Code Description
1 General error
2 Wrong parameter
3 Not root user
4 File creation error
5 Wrong platform
6 Install package error
7 Directory missing
8 File missing
9 File not executable
10 Link startup script error
11 Startup script error

12

Universal Discovery Agent is already installed

Note Applicable only when performing an installation operation.

13 System package installer error
14 Run agent with non-root user error
15 The DDMI agent is installed.