Using a MySQL Client to Connect to a DB Instance Over a Public Network

Step 1: Buy an ECS

1. Log in to the management console and check whether there is an ECS available.
   • If there is a Linux ECS, go to 3.
   • If there is a Windows ECS, see Connecting to a DB Instance Using MySQL-Front.
   • If no ECS is available, go to 2.
2. Buy an ECS and select Linux (for example, CentOS) as its OS.

   To download a MySQL client to the ECS, bind an EIP to the ECS.

   For details about how to purchase a Linux ECS, see Purchasing an ECS in Elastic Cloud Server Getting Started.

3. On the ECS Information page, view the region and VPC of the ECS.
   Figure 1 ECS information
   
4. On the Basic Information page of the DB instance, view the region and VPC of the DB instance.
   Figure 2 DB instance information
   

Step 2: Test Connectivity and Install a MySQL Client

1. Log in to the ECS. For details, see Logging In to a Linux ECS Using an SSH Password in Elastic Cloud Server User Guide.
2. On the Instances page of the GaussDB(for MySQL) console, click the instance name to go to the Basic Information page.
3. In the Network Information area, obtain the EIP and database port.
   Figure 3 EIP and database port
   

   If no EIP has been bound to the DB instance, see Binding an EIP.

4. On the ECS, check whether the EIP and database port of the DB instance can be connected.

   telnet EIP 3306

   • If yes, network connectivity is normal.
   • If no, check the security group rules.
     • If in the security group of the ECS, there is no outbound rule with Destination set to 0.0.0.0/0 and Protocol & Port set to All, add an outbound rule for the EIP and port of the DB instance.
     • If in the security group of the DB instance, there is no inbound rule with Source set to 0.0.0.0/0 and Protocol & Port set to All, add an inbound rule for the private IP address and port of the ECS. For details, see Configuring Security Group Rules.
       Figure 4 DB instance security group
       

5. Download the MySQL client installation package for Linux locally.

   Find the corresponding version, for example, mysql-community-client-8.0.21-1.el6.x86_64.rpm, and download the installation package. A MySQL client running a version later than that of the DB instance is recommended.

6. Upload the installation package to the ECS.

   You can use any terminal connection tool, such as WinSCP and PuTTY, to upload the installation package to the ECS.

7. Run the following command on the ECS to install the MySQL client:

   rpm -ivh --nodeps mysql-community-client-8.0.21-1.el6.x86_64.rpm

   

   • If any conflicts occur during the installation, add the replacefiles parameter to the command and try to install the client again.

     rpm -ivh --replacefiles mysql-community-client-8.0.21-1.el6.x86_64.rpm

   • If a message is displayed prompting you to install a dependency package during the installation, add the nodeps parameter to the command and install the client again.

     rpm -ivh --nodeps mysql-community-client-8.0.21-1.el6.x86_64.rpm

Step 3: Connect to the DB Instance Using Commands (SSL Connection)

1. On the Instances page of the GaussDB(for MySQL) console, click the instance name to go to the Basic Information page.
2. In the Instance Information area, check whether SSL is enabled.
   • If yes, go to 3.
   • If no, click . In the displayed dialog box, click Yes to enable SSL. Then, go to 3.
3. Click under SSL to download Certificate Download.zip, and obtain the root certificate ca.pem and bundle ca-bundle.pem from the package.
4. Upload ca.pem to the ECS.
5. Run the following command on the ECS to connect to the DB instance:

   mysql -h <host> -P <port> -u <userName> -p --ssl-ca=<caName>

   Example:

   mysql -h 172.16.0.31 -P 3306 -u root -p --ssl-ca=ca.pem

   Table 1 Parameter description

   Parameter	Description
   <host>	EIP of the DB instance.
   <port>	Database port of the DB instance. The default value is 3306.
   <userName>	Administrator account root.
   <caName>	Name of the CA certificate. The certificate should be stored in the directory where the command is executed.

6. Enter the password of the database account if the following information is displayed:

   Enter password:

FAQs

What Should I Do If I Can't Connect to My GaussDB(for MySQL) Instance?