Document multi-db tns admin #269
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Signed-off-by: Anders Swanson <anders.swanson@oracle.com>
oracle-contributor-agreement
bot
added
the
OCA Verified
markxnelson
requested changes
Jun 23, 2025
|
|
||
| 3. In the combined `tnsnames.ora` file, and add the following snippet to each tns alias connection string, to tell the client where the wallet directory is: | ||
|
|
||
| (security=(MY_WALLET_DIRECTORY=/path/to/this/database/wallet)) |
README.md
Outdated
| @@ -811,9 +845,75 @@ log: | |||
| # disable: 0 | |||
| ``` | |||
|
|
|||
| #### Configuring connections for multiple databases using Oracle Database wallet(s) | |||
|
|
|||
| The Oracle Database Metrics exporter uses ODPI-C, which can only initalize the TNS aliases from a `tnsnames.ora` file once per process. To work around this, the exporter can be configured to read from a "combined" `tnsnames.ora` file containing all tns aliases for connections in a multi-database configuration. | |||
README.md
Outdated
|
|
||
| The Oracle Database Metrics exporter uses ODPI-C, which can only initalize the TNS aliases from a `tnsnames.ora` file once per process. To work around this, the exporter can be configured to read from a "combined" `tnsnames.ora` file containing all tns aliases for connections in a multi-database configuration. | ||
|
|
||
| 1. For each database the exporter will connect to, download the corresponding wallet files. If you're using ADB/ATP-S, download the regional wallet instead of the instance wallet IFF the databases are in the same region. |
There was a problem hiding this comment.
keep iff iff you are confident everyone knows what iff means
README.md
Outdated
| db2_high = (description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.****.oraclecloud.com))(connect_data=(service_name=****.adb.oraclecloud.com))(security=(MY_WALLET_DIRECTORY=/wallets/db2)(ssl_server_dn_match=yes))) | ||
| ``` | ||
|
|
||
| 4. Take wallet files (cwallet.sso ewallet.p12 ewallet.pem) for each database, and place them in separate directories. E.g., db1 gets its own directory, db2 gets its own directory, and so forth. |
There was a problem hiding this comment.
i'd put comments between file names
markxnelson
approved these changes
Jun 23, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
fixes #262