Register Repositories

Registering a repository provides ALTR the database’s name, hostname, and port, for use by the sidecar or an agent.

Prerequisites

• A database exists that you want to register as a repository.
• You plan to connect to this repository through the sidecar or an agent. Neither needs to be installed yet to register the repository itself; contact ALTR Support to get started with either.

To register a database as a repository:

1. Log in to ALTRNet through your identity provider (IdP).
2. Select Data Configuration > Data Sources in the navigation menu.
3. Click Add Data Source.
4. Locate the OLTP data source card and click Select.
5. Enter a Repository Name to identify the repository in ALTR’s control plane. The repository name must be unique, use only lowercase letters, and contain no spaces.
6. Enter the Hostname. The hostname must be in RFC 1123 format — a URL without http://. For example: 123.dbhost.com.
7. Enter the Port number of the database’s configured listening port. The sidecar uses this port to connect to the repository. For example: 1521.
8. Click Save. ALTRNet adds the repository to the Data Sources list.

Remove a Repository

Removing a repository from ALTR prevents any sidecar from accessing it. Before removing a repository, remove all sidecar listener port bindings that tie a sidecar to it — see Bind a Sidecar Listener Port to a Repository.

To remove a repository from ALTR:

1. Log in to ALTRNet through your IdP.
2. Select Data Configuration > Data Sources in the navigation menu.
3. Select Repositories from the Type dropdown.
4. Click the repository to view its details.
5. Click Remove Data Source. ALTRNet displays a confirmation modal.
6. Click Remove Data Source to confirm.