Customizing the VOS Data Collector (customizing the vosdc.conf configuration file)


Customizing the VOS Data Collector (customizing the vosdc.conf configuration file)


A configuration file is provided to customize the default behavior of the VOS Data Collector script.  The file is called vosdc.conf and can be found in the same directory as the Data Collector script (~/vos),  Modifications made to this file will affect all systems specified when the Data Collector script is run.  This file contains very detailed comments to explain the setting of the individual configuration variables.  

For example ...

The Data Collector is capable of collecting data from any supported Unix system on the network using OS or service based rsh or ssh remote protocols.  The default order in which these protocols are checked is ssh then rsh.  This can be reversed by changing the order of these protocols in the following variable.

# Sequence for checking presence of daemon running on target host.
# By default VOS will try first ssh and then rsh if ssh fails.

Another example ...

The Data Collector will attempt to contact the VOS server to perform an upgrade check.  This will timeout in a couple seconds if it is unable to connect to the server.  If it is desired to disable this feature, the following variable can be set to "no".

# Connect to vos website to check the latest version if RUN_LIVE_UPGRADE is yes

For this particular variable, there is an associated value; the VOS server URL.  This is currently configured in the vosdc.conf file as follows.

VOS_URL = ""

In addition, an OS level environment variable can be set in order to use a proxy if required for external access to the Internet (this is found in the Data Collector usage message).

If the system can connect to the Internet only via a proxy server, set the https_proxy environment variable.

In sh syntax, set it as follows:
   export https_proxy=

In csh or tcsh syntax, set it as follows:
   setenv https_proxy=

where proxy is the proxy server name, is the domain name, and port is the port number for the proxy server.

The default value of the variables in the vosdc.conf file are fine for most environments.  Several of these values can also be modified by running the Data Collector in Expert mode (./vosdc -expert).

There are several configuration variables that determine which Risk Assessment checks are performed.  These follow the comment:

# Risk assessment specific parameters

There are a few reasons for disabling one or more checks.  A check may look for a condition which may be considered "normal" for a specific environment and having this output eliminated from the report is desired.  Another reason may be that one or more checks require more time to perform than desired.  Another reason could be that one or more checks may not be considered applicable for a specific environment.

The following sections control if one or more Risk Assessment check(s) are enabled or disabled.

# Section 1: Disabling or enabling risk assessment based on categories

# Section 2: Disabling or enabling individual risk assessment checks

The comments in the vosdc.conf file are self-explanatory and detailed.  Please use the Feedback link on the VOS website for additional information.

These checks are further detailed in the Risk Assessment report of the General Checklist widget at the VOS website.  The commands that are used by the Data Collector script are detailed in the online Help function at the VOS website.

Some checks have configurable thresholds which can also be modified in the vosdc.conf file.  These are located after the comment:

# Section 3: Configuring risk assessment parameters

Terms of use for this information are found in Legal Notices.



Did this article answer your question or resolve your issue?


Did this article save you the trouble of contacting technical support?


How can we make this article more helpful?

Email Address (Optional)