If your RDS instance is not publicly accessible, Ubiq cannot directly connect to it. So you need to connect it via an EC2 instance which has access to your RDS instance, using SSH tunneling.
Here are the steps to add a direct connection via SSH.
Let's say you have an EC2 instance at 220.127.116.11 that you can SSH into. Let's say it has access to your RDS Database with endpoint mysql–instance1.123456789012.us-east-1.rds.amazonaws.com
Go to your project home page. Click 'Add Direct Connection' in 'Data Sources' tab of your project to get the connection form.
You will see the following form.
The form has the following fields:
In the connection form, check 'Use SSH Tunneling'. You'll see SSH-related fields also.
Enter connection details as follows:
1. Connector Name - name of connection to help you identify it easily.
2. Host IP or URL - endpoint of your database ( e.g mysql–instance1.123456789012.us-east-1.rds.amazonaws.com ). Don't use 'http://' at its beginning.
3. Database name - name of database (e.g testdb)
4. Database Username - username for database user
5. Database Password - password for database user
6. Database port - port number for database (e.g 3306 for MySQL)
Check 'Use SSH Tunneling'.Next, enter SSH details
7. SSH Host or IP - public IP of your EC2 instance (e.g 18.104.22.168)
8. SSH username - username used to log into your instance (e.g ubuntu, ec2-user, etc)
9. SSH port - 22
10. SSH authentication type - select key file/password depending on your requirement. Generally, it is 'key file'
11. Upload SSH key - Click 'choose' button and browse to your .ppk or .pem file
12. SSH passphrase - this is optional. you can leave it as blank.
Click connect. Ubiq will connect to your database via the ec2 instance through SSH tunneling. If it is unable to, then you will see an error message.
Please ensure the host name, database name, user name, password & port are entered correctly before you click Connect. On successful connection, you will see the data source listed under the Data Sources Tab. In case of issues, please don't hesitate to mail us at email@example.com if you face any issues. We surely reply within a day.