Help Center/ GeminiDB/ GeminiDB Mongo API/ Getting Started with GeminiDB Mongo API/ Connecting to a Replica Set Instance/ Connecting to a Replica Set Instance over a Public Network/ Connecting to a Replica Set Instance Using Robo 3T
Updated on 2024-08-03 GMT+08:00
View PDF
Share

Connecting to a Replica Set Instance Using Robo 3T

If you connect to an instance from your local device, you can bind an EIP to the instance and use Robo 3T to connect to the instance over a public network.

This section describes how to use Robo 3T to connect to a replica set instance over a public network.

A local Windows device is used as an example.

Robo 3T can connect to an instance with an unencrypted connection or an encrypted connection (SSL). To improve data transmission security, you are advised to connect to instances using the SSL connection.

Prerequisites

  1. An EIP has been bound to a replica set instance, and security group rules have been configured to ensure that the instance is accessible from Robo 3T over the EIP. For details, see Binding and Unbinding an EIP and Configuring Security Group Rules.
  2. Install Robo 3T.

    For details, see How Do I Install Robo 3T?

SSL Connection

If you connect to an instance over the SSL connection, enable SSL first. Otherwise, an error is reported. For details about how to enable SSL, see Configuring an SSL Connection.

  1. Obtain the EIP and port of the replica set instance.

    Primary node: You can read and write data.

    Secondary node: You can only read data.

    • You can click the instance name to go to the Basic Information page. In the Network Information area, the port is displayed in the Database Port field and the node EIPs are displayed in Node Information area.
      Figure 1 Obtaining connection information

    • Alternatively, click the target instance. On the displayed Basic Information page, click Connections in the navigation pane on the left. Obtain the port and EIP on the Connections page.
      Figure 2 Viewing EIPs

  2. Run the installed Robo 3T. On the displayed dialog box, click Create.

    Figure 3 Connections

  3. In the Connection Settings dialog box, set the parameters of the new connection.

    1. On the Connection tab, enter the name of the new connection in the Name text box and enter the EIP and database port that are bound to the replica set instance in the Address text box.
      Figure 4 Connection
    2. On the Authentication tab, set Database to admin, User Name to rwuser, and Password to the administrator password you set during the creation of the replica set instance.
      Figure 5 Authentication
    3. Click the TLS tab, select Use TLS protocol, set Authentication Method to Use CA Certificate, and upload the obtained SSL certificate.
      Figure 6 SSL
    4. Click Save.

  4. On the MongoDB Connections page, click Connect to connect to the replica set instance.

    Figure 7 Replica set connection information

  5. If the replica set instance is successfully connected, the following page is displayed.

    Figure 8 Connection succeeded

Non-SSL Connection

If you connect to an instance over an unencrypted connection, disable SSL first. Otherwise, an error is reported. For details about how to disable SSL, see Configuring an SSL Connection.

  1. Obtain the EIP and port of the replica set instance.

    Primary node: You can read and write data.

    Secondary node: You can only read data.

    • You can click the instance name to go to the Basic Information page. In the Network Information area, the port is displayed in the Database Port field and the node EIPs are displayed in Node Information area.
      Figure 9 Obtaining connection information

    • Alternatively, click the target instance. On the displayed Basic Information page, click Connections in the navigation pane on the left. Obtain the port and EIP on the Connections page.
      Figure 10 Viewing EIPs

  2. Run the installed Robo 3T. On the displayed dialog box, click Create.

    Figure 11 Connections

  3. In the Connection Settings dialog box, set the parameters of the new connection.

    1. On the Connection tab, specify the connection name in Name and enter the EIP and port of the replica set instance obtained in 1 in Address.
      Figure 12 Connection
    2. On the Authentication tab, set Database to admin, User Name to rwuser, and Password to the administrator password you set during the creation of the replica set instance.
      Figure 13 Authentication
    3. Click Save.

  4. On the MongoDB Connections page, click Connect to connect to the replica set instance.

    Figure 14 Connections

  5. If the replica set instance is successfully connected, the page shown in Figure 15 is displayed.

    Figure 15 Connection succeeded