Install the agent

Snow Inventory Agent for Unix can be installed by using either a prepared installation script or copies of the binary file.

The Snow Inventory Agent for Unix executable file is named snowagent.jar. It is an executable Java archive that performs inventory of hardware and software on the server where it is executed.

Prepare an installation script

Installation shell scripts are prepared by, and ordered from, Snow Support. When ordering the installation script the current configuration file must be supplied. If no configuration file exists, certain information, according to the description below, must be supplied so that a new configuration file can be created.

Required information:

  • address to the Snow Inventory Server, including port number

  • site name

Optional information:

  • name of the configuration file

  • if the Snow Inventory Oracle Scanner should be included

  • if previous versions of the Snow Inventory Client for Unix should be removed

The installation package can be copied to any folder on the target computer.

Install the agent using a prepared installation script

  1. Start a terminal

  2. Convert the shell script to an executable script by running the command:

    chmod +x snowagent-<version>.sh
  3. To install, run the executable script by using the command:

    sudo ./snowagent-<version>.sh --install-path <path>

Note: During the installation, an uninstall script is created.

Install the agent manually

Unix

Install the agent in the path /opt/snow/.

  1. Create the directory:

    $ cd /opt
    $ mkdir snow
    
  2. Put the files snowagent.jar and the snowagent.config in the created directory. If Snow Inventory Oracle Scanner is to be used, also put the file sios.jar in the same directory.

  3. Create a sub-directory called data under opt/snow/ and set permissions:

    $ sudo chmod 0755 data

Java

If the server path contains the Java runtime, the agent can be run as in the examples in the sections that follow. Otherwise the Java runtime needs to be added to the path, alternatively the Java runtime can be started with the path to the Java installation.

Use the commands below to show help and version of the agent:

$ sudo java -jar snowagent.jar -?
$ sudo java -jar snowagent.jar version

Uninstall the agent manually

To uninstall the agent, use the script uninstall.sh located under /opt/snow. The script will remove the opt/snow directory including all files. The scheduling entry must be manually removed from crontab.

Run the script with the following command:

$ sudo /opt/snow/uninstall.sh

Default location of files

The following table shows the default locations of the binary files and log files of the agent after an installation using a prepared script.

File name

Directory

Description

snowagent.jar

/opt/snow

The Snow Inventory Agent binary file

sios.jar

/opt/snow

The Snow Inventory Oracle Scanner binary file

snowagent.config

/opt/snow

The Snow Inventory Agent configuration file

*.snowpack

/opt/snow/data

The inventory result file

snowagent.rotation0.log

/opt/snow/data

The Snow Inventory Agent log file

snowagent.properties

/opt/snow/data

The properties file with information on, for example, installation date and last scan date