Tenants and Datasources
This section allows you to manage the tenants and datasources. Datasources can be managed via CLI and User Interface.
Manage Tenants
Create a Tenant
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
Modify a Tenant
$ sevone-cli exec graphql -- npm run reconfig-tenant
Manage Datasources via CLI
Tip:
When prompted to Login instead of providing an API key you should type y.
This will generate the API key for you based off of the NMS username and password you provide.
When prompted to Login instead of providing an API key you should type y.
This will generate the API key for you based off of the NMS username and password you provide.
Create a Datasource
- SOA is a required dependency and must be installed on your SevOne NMS.You will be prompted to enter a password. This will be the root password for your NMS.SOA version
SOA must be on the latest version on all appliances in SevOne NMS cluster. 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 / upgrade 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
- Create the
datasource.
$ sevone-cli exec graphql -- npm run create-datasource
Modify a Datasource
If you need to modify the datasource information such as, IP address or SOA API Key, please execute the command below.
To maintain the existing settings of the
datasource, leave the prompt empty and press ENTER.
$ sevone-cli exec graphql -- npm run reconfig-datasource
Manage Datasources via User Interface
Obtain Authentication Token
As of SevOne NPM release 6.6,
authentication token is no longer required.
- 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
- Choose REST API version as Version 3.
- Click on Users to view Users operations.
- Under Users, click on POST endpoint /api/v3/users/signin.
- Under Parameters, all the way to the right, locate the Model Schema field. Click on the field to copy its content under Value.
- 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.
- After "password":, replace string with the corresponding SevOne NMS password. Make sure to enter it within the quotes.
- At the bottom of the POST section, click the Try it out! button.
- 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.
- 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.
- Now, obtain the API Key.
Obtain API Key
- Under Users, click on POST endpoint /api/v3/users/apikey.
- Under Parameters, all the way to the right, locate the Model Schema field. Click on the field to copy its content under Value.
- 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.
- At the bottom of the POST section, click the Try it out! button.
- 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.
- You are now ready to create a datasource.
Create a Datasource
- Using a web browser of your choice, enter the URL for your SevOne Data Insight.
- From the left navigation bar, click Configure and select Data Sources. You are now on Datasource Manager page.
- From the drop-down, select NMS, for example.
- In the Name field, enter the name of the datasource you want to create. For example, myDatasource.
- In API Server field, enter the URL for SevOne NMS appliance that is connected to this SevOne Data Insight.
- By default, Authentication field is set to Token.
- In API Token field, paste the API Key obtained in step 5. under section Obtain API Key.
- From Type drop-down, choose METRICS/FLOW option.
- Click Test connection button to confirm you can connect to the server.
- Click Add Datasource in the upper-right corner. You will see your datasource, myDatasource, available from the ACTIVE DATASOURCES list.
Modify a Datasource
- From ACTIVE DATASOURCES list, select the datasource to view its details or to modify its configuration.
- After modifying, click Save.
As you modify the fields, real-time health
checks are performed.