A datasource is a combination of a specific database and the credentials to access it.
Adding a datasource is a relatively simple process, assuming that you’ve met all of the relevant prerequistes.
Before beginning, you must ensure that the datasource you’re attempting to add is accessible from at least one of your gateways or relays. Additionally, you must have a properly configured account (username, password) on the datasource you’ll be adding.
Login to the Admin UI at https://app.strongdm.com and select Datasources on the left hand navigation.
In the upper right hand section of the screen, click the ‘add datasource’ button. You’ll be presented with a dialog like this:
In this dialog, you’ll configure how your gateways or relays will connect to the datasource.
Type in a Display Name - this is how the datasource will show up in the Admin UI and local clients - in this case, ‘testdb-01’
Select the type of datasource from the available list of database types - in this case, PostgreSQL
Enter the hostname. It’s imperative that the entry you choose for Hostname is one that at least one gateway or relay can connect to. To verify this, hop on the gateway or relay, and from a command prompt, type:
$ ping <YOUR_HOSTNAME>
If the gateway/relay can connect to this hostname, you’ll be able to proceed. In this case, ‘testdb-01.fancy.org’
EXCEPTION: If you are connecting to a Mongo Replica Set, enter the hostnames and ports of the members of the replica set here in the format
host1:port1,host2:port2,...,hostX:portX. Fill in the name of the replica set in the Replica Set field below.
When you select the datasource type, it will automatically fill in the Port field with that database’s default port for connectivity - in this case, 5432. If you know that your database is set to connect on a different port, enter that port here now.
The Port Override field provides an organization-wide standard port for users to connect to this datasource via their client. In most organizations this field will automatically populate; you can overwrite it with your own preferred port.
Type in the name of the database you’ll be connecting to with this datasource; in this case, ‘booktown’
Type in the Username that the relay be connecting to the database with; in this case, ‘testdbuser’
Type in the Password of the username entered in Step 10.
If the user has a particular schema they should use upon logging in, enter that here.
By default, for PostgreSQL and its derivative DBMS (e.g. Greenplum), strongDM will limit all connections to the configured database. If you would like to change that, uncheck this option.
Click the ‘create’ button. Once this is done, the Admin UI will update and show your new datasource with a yellow icon while it runs initial health checks.
Eventually, you should see the icon turn gray, then green:
If it does not turn green, check the Diagnostics tab for errors.
If you have multiple datasources to create, follow the above steps for each datasource.
If any errors occur, please copy them into an email and send to firstname.lastname@example.org.