Snow Inventory Oracle Hardware Scanner

Version 2.0

2022-07-07

Description

The Snow Inventory Oracle Hardware Scanner is a Java application and a component of Snow's Oracle Management Option. The scanner is platform-independent, which enables it to run on a variety of operating systems. The scanner collects hardware-related data as part of the Oracle verified data solution for Oracle Databases and Database options.

Prerequisites

  • Dependency on other Snow products:

    The Snow Inventory Oracle Hardware Scanner component is triggered through a crontab job in Linux/Unix environments and by a PowerShell script for Windows.

    This component is dependent on Snow Inventory Agents for Windows, Linux, and macOS version 6.0.0 or later and Snow Inventory Agent for Unix version 7.0.0 or later, and compatible with Snow Inventory Server 6.0.2 or later.

  • Java runtime environment:

    Snow Inventory Oracle Hardware Scanner requires Java Runtime Environment 8 (1.8), 11, or 17 installed on the target computer.

    Supported versions of Java Runtime Environments are Oracle Java SE and Oracle OpenJDK (versions 8, 11, and 17).

  • Permissions and environment variables:

    The operating system user running the Snow Inventory Oracle Hardware Scanner needs the following permissions and environment variables, depending on the platform:

    Platform

    Permissions and environment variables

    Linux

    Must have write permissions to: /var/run/SnowSoftware/Inventory/Agent/ script-output

    Must have execute rights to the following operating system commands:

    • General commands:

      • /proc/cpuinfo

      • /usr/sbin/dmidecode

    • In case of LPAR:

      • /proc/ppc64/lparcfg

    • In case of Oracle VM for x86:

      • /usr/sbin/xm

      • /usr/sbin/xenpm

      • /usr/sbin/ovs-agent-db

      • /usr/local/bin/ovm-info

    • In case of Oracle Database Appliance:

      • /opt/oracle/oak/bin/oakcli

      • /opt/oracle/dcs/bin/odacli

    • In case of Oracle VM for x86, must have read permissions on the following files:

      • /OVS/Repositories/*/VirtualMachines

      • /OVS/running_pool/*/

      • /var/log/ovs-agent.log

    SunOS

    Must have write permissions to: /var/tmp/SnowSoftware/Inventory/Agent/ script-output

    Must have execute rights to the following operating system commands:

    • General commands:

      • /usr/sbin/prtconf

      • /usr/sbin/prtdiag

      • /usr/sbin/psrinfo

      • /usr/bin/kstat

      • /bin/kstat

      • /sbin/zonename

      • /usr/sbin/zoneadm

      • /usr/sbin/zonecfg

      • /usr/sbin/pooladm

    • In case of LDOM:

      • /usr/sbin/virtinfo

      • /usr/sbin/ldm

      • /opt/SUNWldm/bin/ldm

    HP-UX

    Must have write permissions to: /var/tmp/SnowSoftware/Inventory/Agent/ script-output

    Must have execute rights to the following operating system commands:

    • General commands:

      • /usr/sbin/icapstatus

      • /usr/sbin/icod_stat

      • /usr/sbin/ioscan

      • /usr/bin/getconf

      • /usr/contrib/bin/machinfo

    • In case of an Itanium box:

      • /opt/hpvm/bin/hpvmstatus

      • /usr/sbin/setboot

    • In case of nPars:

      • /usr/sbin/parstatus

    • In case of vPars:

      • /usr/sbin/vparstatus

      • /usr/sbin/vparhwmgmt

    • In case of Secure Resource Partitions/HP Containers:

      • opt/hpsrp/bin/srp

    AIX

    Must have write permissions to: /var/tmp/SnowSoftware/Inventory/Agent/ script-output

    Must have execute rights to the following operating system commands:

    • General commands:

      • /usr/sbin/lsdev

      • /usr/sbin/prtconf

      • /usr/bin/lparstat

      • /usr/bin/errpt

      • /usr/sbin/lsattr

      • /usr/sbin/lsdev

      • /usr/sbin/smtctl

    Windows

    Should run the component with an admin user account (Local Admin on the server).

Deployment

The Snow Inventory Oracle Hardware Scanner can be packaged and deployed separately, or together with Inventory Agents. Snow recommends you deploy this component using a Snow Inventory Agent installation package.

Output

The data retrieved by the Snow Inventory Oracle Hardware Scanner is stored in a JSON file and placed in a designated location, depending on the platform: 

Platform

Output path

Linux

/var/run/SnowSoftware/Inventory/Agent/script-output/<script name>

Unix

/var/tmp/SnowSoftware/Inventory/Agent/script-output/<script name>

Windows

%ProgramData%/SnowSoftware/Inventory/Agent/script-output/<script name>

Snow Inventory Agents version 6 or higher search these designated locations for output from other Snow Inventory components such as Snow Inventory Oracle Hardware Scanner, or other scripts.

Install and configure Snow Inventory Oracle Hardware Scanner

Installation

The Snow Inventory Oracle Hardware Scanner is a component of Snow's Oracle Management Option. When requesting a Snow Inventory Agent deployment package, specify that the Oracle Hardware Option needs to be included.

Configuration

The Snow Inventory Oracle Hardware Scanner does not require a configuration file. Some configuration parameters, which are outlined below, can be executed at the command line level.

Schedule the scan in a Linux or Unix environment

In Linux and Unix environments, the scanner is triggered through a crontab job, which must be created by the user.

  • Run the following crontab to schedule the execution of the scanner:

    # run five minutes after midnight, every day

    5 0 * * * $JAVA_HOME/bin/java -jar /opt/snow/siohws.jar

    # to run the scanner with verbose logging, run the following command:

    $JAVA_HOME/bin/java -jar siohws.jar -v

Command

Description

version

Print current version to stdout

-v

Verbose logging

Schedule the scan in a Windows environment

In a Windows environment, the scanner is triggered by a PowerShell script. The script must be included in the Windows agent installation package.

  • To schedule the execution of the scanner, run the following command with any option to show what options are available:

    $java -jar siohws.jar help

    Unknown arguments on the command line [help]

    Help for Snow Inventory Oracle Hardware Scanner

    Usage: java -jar siohws.jar [options]

Command

Description

version

Print current version to stdout

-v

Verbose logging

Example 57.

From the command line, run the following script to run the scanner with verbose logging and the output file shall be saved in the default location:

$JAVA_HOME/bin/java -jar siohws.jar -v