A database connection is a set of JDBC connection data that you define to make a database
available to the product. You can manually add connections, import connections from a CSV file, or
discover databases on your servers and automatically add them.
About this task
Before IBM® Data
Server Manager (DSM) can monitor a database you must add a database connection in the web console. Any DSM user can
create a database connection.
Procedure
-
Log in to the DSM web console.
Use one of the following URLs:
http://server_host_name_or_ip:http_port/console
https://server_host_name_or_ip:https_port/console
Note: When using versions of DSM older than V2.1.5, omit /console from the URL
path.
-
Add database connections.
| Option |
Description |
| Manually add a connection |
Go to , select from the command bar, and enter/select connection parameters in the fields provided.
The following information is required:
- Data server type
- Database name
- Host name
- Port number
- Operation credential: needed to perform operational tasks on connected databases, such as
administration tasks, querying the database, or optimization through tuning
- Data Collection credential: needed to collect data from a connected database for monitoring and
alert generation
Choosing either of these credential options (Enable operation, Enable
data collection) opens a new Credentials tab, where the user can enter a user name and
password for either credential, which are saved as the Operation and/or Data Collection credentials
for the connection profile
Specific database privileges are needed for the above credentials, as DSM will use the
credentials to conduct specific tasks against connected databases. For more details, see Privileges required for the ID used by DSM
|
| Import connections from a CSV file |
Go to . Click the icon and follow the dialog prompts. The
database connection information that you can import must be in CSV (comma-separated value) text
format. For a sample CSV-file, see
setup_directory/ibm-datasrvrmgr/samples/DatabaseConnectionsImportCSV.txt.
|
| Discover databases |
Instead of manually adding database connections one by one, you can discover and add databases
that exist on your database servers as database connections. To use the discover feature, go to and select from the command bar. In the wizard that opens, specify the host name for a database
server and the credentials of a user with the required privileges on the database server. You can
then find existing Db2® instances on the server, and discover and add connections for any associated databases.
- Db2 server
requirements:
-
- The SSH PasswordAuthentication configuration setting must be set to
yes
- The Db2 instance
must be configured for Db2 discovery
- User ID requirements per platform:
-
Linux:
- SSH access
- SYSADM
- Access to the db2nodes.cfg file and /etc/services
- Optional: To see instance status, the user ID must be the instance owner or have root
user authority
-
Windows:
- SSH access
- SYSADM
- Local administrator
- Access to the db2nodes.cfg file and to
system32/drivers/etc/services
-
If your configuration is PureScale
- One of the following authorities: SYSADM, SYSCTRL, or SYSMAINT
|
Results
A database connection is added. The database shows up as a tile on the Home
page and can be accessed with the web console.
What to do next
By default, the user ID that created the database connection has the Database owner
access role on the new database connection. Go to and select the Database Access tab to assign database access
roles for the database to other product user IDs.