Tenants and Datasources

To add a tenant, execute the following command. The prompts are similar to Connect NMS in SevOne Data Insight Installation Guide > section Install Single-Node.

$ sevone-cli exec graphql -- npm run create-tenant

$ sevone-cli exec graphql -- npm run reconfig-tenant

1. SOA is a required dependency and must be installed on your SevOne NMS.
   Note: You will be prompted to enter a password. This will be the root password for your NMS.
   Note: SOA version
   SOA must be on the latest version on all appliances in SevOne NMS cluster.
   
   If your peers are on SevOne NMS 7.x or above, skip the following command. However, if your peers are on SevOne NMS 6.x,

   • Command Line Interface (CLI) must be used to upgrade SOA on all peers as the graphical user interface (GUI) only upgrades SOA for the NMS appliance you are connected to.
   • Add flag --all-peers if you want to install SOA on all peers in the cluster.

   
   $ sevone-cli soa upgrade \
   /opt/SevOne/upgrade/utilities/SevOne-soa-*.rpm \
   <enter SevOne NMS IP address> --all-peers
   

2. Create the datasource.

   
   $ sevone-cli exec graphql -- npm run create-datasource
   

If you need to modify the datasource information such as, IP address or SOA API Key, please execute the command below.

$ sevone-cli exec graphql -- npm run reconfig-datasource

1. Using a web browser of your choice, enter the URL for SevOne NMS appliance you want to connect SevOne Data Insight to.

   https://<enter SevOne NMS hostname or IP address>/api/v3/docs

2. Choose REST API version as Version 3.
3. Click on Users to view Users operations.
4. Under Users, click on POST endpoint /api/v3/users/signin.
5. Under Parameters, all the way to the right, locate the Model Schema field. Click on the field to copy its content under Value.
6. On the left side of the Parameter section, locate the body under Value. After "username":, replace string with the corresponding SevOne NMS user name. Make sure to enter it within the quotes.
7. After "password":, replace string with the corresponding SevOne NMS password. Make sure to enter it within the quotes.
8. At the bottom of the POST section, click the Try it out! button.
9. Scroll down to the Response Body field. You should see a long alphanumeric string after <token>. This is the token that you need. Double-click the token to select it. Then copy it.
10. In the upper right corner of the SevOne API Documentation page, locate the bearer token field. Paste the token into this field. You should now have permissions to perform operations.
11. Now, obtain the API Key.

1. Under Users, click on POST endpoint /api/v3/users/apikey.
2. Under Parameters, all the way to the right, locate the Model Schema field. Click on the field to copy its content under Value.
3. On the left side of the Parameters section, locate the body under Value. After "application":, replace string with a unique identifier. For example, testAPIKey. Make sure to enter it within the quotes.
4. At the bottom of the POST section, click the Try it out! button.
5. Scroll down to the Response Body field. You should see a long alphanumeric string after <apiKey>. This is the API Key that you need. Double-click the key to select it. Then copy it.
6. You are now ready to create a datasource.

1. Using a web browser of your choice, enter the URL for your SevOne Data Insight.
2. From the left navigation bar, click Configure and select Data Sources. You are now on Datasource Manager page.
3. From the drop-down, select NMS, for example.
4. In the Name field, enter the name of the datasource you want to create. For example, myDatasource.
5. In API Server field, enter the URL for SevOne NMS appliance that is connected to this SevOne Data Insight.
6. By default, Authentication field is set to Token.
7. In API Token field, paste the API Key obtained in step 5. under section Obtain API Key.
8. From Type drop-down, choose METRICS/FLOW option.
9. Click Test connection button to confirm you can connect to the server.
10. Click Add Datasource in the upper-right corner. You will see your datasource, myDatasource, available from the ACTIVE DATASOURCES list.

1. From ACTIVE DATASOURCES list, select the datasource to view its details or to modify its configuration.
2. After modifying, click Save.