1. Help Center
  2. License Manager

How do I set up my data gathering configuration?

Learn how to use the OpsCompass data configuration tool to save time!

Getting Started

First navigate to the License Manager using the side navigation within OpsCompass. Next, navigate to the data configuration card on the right side. This will be your hub for all things configuration related. 

License Manager Dashboard Data Gathering Configuration Card Selected

As a first time user, the page will prompt you to name your new configuration. You can rename this file at any time. 

New configuration naming modal appears

Oracle Connections

First, click either of the "Add New Connection" buttons. 
Next, populate the database connection information for each monitored database.

For example:

Add Oracle Database Connections
    1. The Connection Name will be used as part of the generated filename for that database’s script output, so this is typically populated with “hostname_instance”.

    2. The “Connection String” is the properly formatted TNS string used to connect to the database instance. 

Make sure to use the "Save" button in the top right before moving to the "VCenter Configurations" tab.

VCenter Connections

After finishing with Oracle Connections, navigate to the VCenter Configurations tab. You will populate the vCenter connection information for each vCenter that will be monitored in the configuration file.
Add VCenter Connections
    1. Use the entries in the configuration file to identify a connection name and connection information for each vCenter that needs to be monitored. 
    2. The “Connection Name” value will be used as part of the generated filename for that vCenter script output, so this is typically populated with a name that represents the vCenter server.
    3. The “Host” value is the IP Address or FQDN of the vCenter server.
    4. The "User" value is the username that the script will use to connect to the defined vCenter server.
    5. The "Password" value is the password that the script will use to connect to the defined vCenter server.

Data and Log File Settings

Finally you will set the data and log file settings. 

First, click on "Data File Settings" and populate the entries.

These parameters are used by all of the data collection scripts and define the method that will be used to transfer the resulting data files to House of Brick for analysis as well as defining the retention times for local files. 

Data File Settings

  1. The "Days to retain files" value is used by each data collection script to determine how many days to retain encrypted output files locally on the monitoring server.
  2. The “Days to retain immediate information” is used by each data collection script to determine how many days to retain individual script output files (e.g. each database output file) locally on monitoring server 
  3. The “File Tag” value is used by each data collection script as part of the filename generation to prevent duplicate filenames in some cases.
  4. Fill out the email from and email to section before finishing.
Remember to save and then click the "Log File Settings" tab.
Log File Settings

 

These parameters are used by all of the data collection scripts and define the method that will be used to transfer the resulting data files to House of Brick for analysis.

  1. The "Days to retain files" value is used by each data collection script to determine how many days to retain log files locally on monitoring server.
  2. The “File Tag” value is used by each data collection script as part of the log filename generation to prevent duplicate filenames in some cases.

Good To Know

  1. Make sure to always save your configuration before leaving.
  2. A user can have access to multiple configuration files and can access them using the dropdown next to the save.
    Screen Shot 2022-06-27 at 3.59.46 PM
  3. You can add and remove as many Oracle and VCenter connections as you need.