Set up authentication credentials and scheduled jobs to import SolarWinds data into your CMDB.

1. Navigate to Service Graph Connector for SolarWinds > Setup.
2. On the Getting started page, click Get Started.
3. On the Service Graph Connector for SolarWinds page, in the Configure the connection section, select the task Configure the authentication credentials used to connect to SolarWinds SWIS API.
4. To configure your authentication credentials used to connect to the Solarwinds SWIS API, complete the following steps:
   1. On the next page, in the Configure the authentication credentials task section, click Configure.
   2. On the form, fill in the fields.

      Table 1. Basic Auth Credentials form

      Field	Description
      Name	This field is automatically set to a human-readable name for this credential. You can optionally change this setting.
      User name	SolarWinds user name. Note: The SolarWinds user must have a role with read privileges to the SolarWinds Information Service API for all SolarWinds data sources that the integration can pull data.
      Password	SolarWinds password, which is stored in the database in encrypted form.
      Active	Option to check if this credential is active.
      Credential alias	Advanced selection criteria for this credential.
      Order	Determines the order in which credentials are tried (smaller numbers are tried first)

   3. Click Update if necessary.
   4. In the Configure the authentication credentials used to connect to SolarWinds SWIS API task section, click Mark as Complete.
5. In the Configure SolarWinds HTTP connection task section, click Configure and complete the following steps:
   1. Review the HTTP(s) Connection form and fill in fields as needed.

      Table 2. HTTP(s) Connection form

      Field	Description
      Name	This field is automatically set to the name of the connection, which you can optionally change.
      Use MID server	Option denoting if this Connection uses MID server or not.
      Host	Target fully qualified host value used by the connection. The Connection URL will automatically fill in the <hostname>.
      Credential	Credential value used by this connection.
      Connection alias	Connection alias value with which the connection can be referred.
      URL builder	Use URL builder to build the connection URL.
      Mutual authentication	Enable if this is Mutual Authentication.
      Protocol	Underlying protocol used by the connection.
      Active	Option to activate the HTTP connection.
      Domain	Domain to which the connection belongs.
      Override default port	Target port value used by Connection.
      Base path	Base path for HTTP(s) connection that is required but should not be modified.

   2. Click Update if necessary.
   3. In the Configure SolarWinds HTTP connection task section, click Mark as Complete.
6. In the Configure SolarWinds Modules section, click Configure and complete the following steps:
   1. On the System Properties page, configure the SolarWinds modules. Update the Value for the sn_solarwinds_inte.npm_installed and the sn_solarwinds_inte.sam_installedor properties.
      • Set to true: If the respective module is installed on the SolarWinds instance
      • Set to false: If the respective module is not installed on the SolarWinds instance

      Note: This update changes the API class and the data that is returned from them.
   2. In the Help sidebar, click Mark as Complete.
7. In the Test the connection task section, click Configure and complete the following steps to test the connection:
   1. Review the fields on the Data Source form, which are automatically set.

      Table 3. Data Source form

      Field	Description
      Name	Unique name for this data source.
      Import set table label	Label of the table that will be created for this data source.
      Import set table name	Name of the table that will be created for this data source.
      Type	Data storage type of the data to be imported.
      Format	Format of the data file.
      Path for each row	Path expression used to select JSON objects which will become rows in the import set table.
      Discard Arrays	Determines whether to discard or serialize JSON arrays as a value.
      Expand node children	Determines whether to load inner object attributes as new columns for JSON or XML nodes.
      Data in single column	Data in single column.
      Application	Application containing this record.
      Request action	The Data Source request action that will be invoked to get data.
      Support pagination	Enable pagination to request action.
      Limit	Maximum records per page.
      Offset	Initial offset used for pagination.

   2. Click the Test Load 20 Records related link to test the connection to the SolarWinds API. Testing the connection takes a few moments, after which the page refreshes to show the test results.

      This step tests the SG-Solarwinds Hardware data source and ensures that data is loaded into the staging table. A successful connection for SG-Solarwinds Hardware means that all SolarWinds data sources connect successfully, so you do not need to individually test all data source.

      The connection is successful if the HTTP Status is 200. If there is an Error Code and Error Message, the connection failed and further troubleshooting is required.

   3. In the Help sidebar, click Back to Guided Setup.
   4. In the Test the connection task section, click Mark as Complete.
8. On the left sidebar, click the Set-up scheduled import jobs button.
9. On the Service Graph Connector for SolarWinds page, in the Set up scheduled import jobs section, select the task Configure the scheduled import jobs.
   1. In the Configure the scheduled import jobs task section, click Configure.
   2. Review the fields on the Scheduled Data Import form, which are automatically set.

      Table 4. Scheduled Data Import form

      Field	Description
      Name	Name of the scheduled job.
      Data source	Data source record that defines the data to import.
      Run as	Option to run the scheduled job with the credentials of the specified user.
      Active	Option to activate the scheduled job. Select this option.
      Concurrent Import	Function that loads the data from multiple import sets. The function then processes and transforms the data concurrently.
      Partition Method	Partition method for the concurrent import set.
      Partition Size	Import set size for early scheduling.
      Execute pre-import script	Option to specify a script to run before the import is performed.
      Execute post-import script	Option to specify a script to run after the import is performed.
      Application	Application containing this record.
      Run	Frequency of running the import.
      Conditional	Conditions under which this job is executed.

      Note: All active SolarWinds scheduled jobs will run in their specified order after the SG-Solarwinds Hardware scheduled job runs. You can modify the Active setting for each SolarWinds scheduled job as appropriate for your integration.
   3. Click Update if necessary.
   4. In the Configure the scheduled import jobs task section, click Mark as Complete.