The following describes the steps and inputs needed to configure a Redshift storage location within your Openbridge account. The process is simple and quick, only requiring minimum information need to be able to connect and write data to your instance.
Step 1: Openbridge Storage Name
This is a label that you provide so you can uniquely identify this database in Openbridge. Some customers may have multiple databases so labeling each will help you identify the system you want us to deliver data into.
Step 2: Setup A Schema
We expect a schema to be present in Redshift called openbridge. This is the schema we will write data into.
Step 3: Whitelist Openbridge IP
You’ll need to add our IP addresses else we will not be able to connect to your cluster.
The first step is to log into your AWS account. Navigate to the Security Group Management page, typically Services > Compute > EC2.
Click the Security Groups option, under Network & Security in the menu on the left side of the page.
Click Create Security Group. The window will look like this. We need to fill out all the values
In the Create Security Group interface, fill in the fields as follows:
- Security group name: Enter a unique name for the Security Group. For example
Redshift-Openbridge - Description: Enter a description for the security group. For example:
Openbridge whitelisted IPs - VPC: Select the VPC that contains the Redshift cluster you want us to connect
Note: The Security Group and database must be in the same VPC, or the connection will fail.
Select the Inbound tab and then Add Rule. Fill in the Inbound fields as follows:
- Type:
Custom TCP - Port Range:
5439(if you set a custom port, enter that value.5439is the default) - Source:
Customand enter the IP52.54.227.22/32
Click Add Rule to add an additional Inbound rule for IP address and 52.2.68.68/32.
You should have two rules for 52.54.227.22/32 and 52.2.68.68/32. When finished, click Create to create the Security Group.
Step 4: Name Of Database
This is the name of the Redshift database you want Openbridge to use.
Step 5: Host And Port
Enter the host (or IP) address as well as the port.
Step 6: User and Password
Supply the user and password that Openbridge should use to authorize connections to your system.
Configuring Redshift
This guide will walk you through different commands you can run to make sure that Redshift is set up correctly with the required schema, users, and permissions.
For example, here is a collection of SQL statements that you can use within your Redshift instance to get it set up for us:
/*
You will want to replace {{username}}, {{mydatabase}}, {{userpassword}} with your correct values
*/
create database {{mydatabase}};
\connect {{mydatabase}}
create user {{username}} with password '{{userpassword}}';
grant create on database {{mydatabase}} to {{username}};
create schema if not exists openbridge authorization {{username}};
grant all on schema openbridge to {{username}};