Before You Begin
This 30-minute tutorial shows you how to how to obtain the Public IP of your service instance, configure PuTTy to connect to your VM and start VNC server, and then launch ODI Studio.
Background
Now that you have your Data Integration Platform Cloud services provisioned, you can configure VNC server for your VM and launch ODI Studio.
What Do You Need?
- Your Oracle Cloud account
- A Data Integration Platform Cloud subscription
- Database Cloud and Data Integration Platform Cloud services provisioned
- PuTTy or other SSH client
- Your private key in a PuTTy-compatible or OpenSSH format (Need a new key pair? Learn how to update your private/public keys.)
- VNC Viewer
Obtaining the Public IP of your Data Integration Platform Cloud Instance
-
After you log in to Oracle Cloud, open the navigation menu in the upper left corner, select Platform Services, and then Data Integration Platform or Data Integration Platform Classic.
Description of the illustration 01_001_dashboard.png -
Select your Data Integration Platform Cloud instance from the list of services.
Description of the illustration 01_002_selectinstance.png -
In the Services Overview, locate the Resources section and copy the Public IP.
Description of the illustration 01_003_publicIP.png
Verifying Your Listening Port
- Open PuTTY and connect to your Data Integration Platform Cloud instance using the Public IP.
- Switch to the opc user:
$ sudo su - opc
- Start VNC Server:
$ vncserver -nolock
- Verify that VNC Server is running:
$ ps -ef |grep vnc
- Verify the listening port:
$ netstat -tulpn
Take note of the port number. For the purposes of this tutorial, the listening port number is 5901.
- (Optional) Use Telnet to test the connection:
$ telnet 127.0.0.1:<listening_port_number>
- Close the PuTTy window.
Configuring PuTTy to Connect to Your VM and Start VNC server
- Open PuTTy.
-
Enter your instance's Public IP address into the Host Name field.
Description of the illustration 02_001.png -
In the Category pane, expand Connection, select Data, and then enter
opc
in the Auto-login username field.Description of the illustration 02_002_puttyconfig.png - In the Category pane, under Connection, expand SSH, and select Tunnels.
-
Enter the listening port number for VNC Server in the Source port field and
127.0.0.1:<listening_port_number>
into the Destination field, then click Add.Description of the illustration 02_003.png - In the Category pane, under SSH, select Auth.
-
For Private key file for authentication, click Browse and locate your private key.
Description of the illustration 02_004_puttyconfig.png -
In the Category pane, select Session, and then enter a name for this session under Saved Sessions and click Save.
Description of the illustration 02_005_puttyconfig.png - Click Open to establish the connection.
-
After you've successfully connected, enter the following command to switch to the
oracle
user:$ sudo su - oracle
Description of the illustration 02_006a_putty.png -
Enter the following command to start VNC server:
$ vncserver -nolock
Description of the illustration 02_007_putty.png If you're prompted to enter a password to connect to the VNC server, enter a password and confirm the password. VNC server will start automatically.
The SSH tunnel redirects the VNC output of your VM to localhost (127.0.0.1).
-
Open Tiger VNC Viewer, enter
127.0.0.1:<listening_port_number>
in the VNC server field, and then click Connect.Description of the illustration 02_008_vncviewer.png -
Enter the password that you set in step 11 and click OK.
Description of the illustration 02_009_vncviewer.png - After you've successfully connected to your VM with VNC viewer, your desktop appears similar to the following:
Description of the illustration 02_010_vncviewer.png - (Optional) Disable the screen saver to avoid getting locked out of the instance. In the System menu, go to Preferences, and select Screensaver. Deselect Activate screensaver when the computer is idle, and then click Close.
Description of the illustration 02_011_screensaver.png Alternatively, you can set a password for the opc user.
Launching Oracle Data Integrator 12c Studio
- Open a Terminal window and enter the following:
/u01/app/oracle/suite/suite_mw/odi_studio/odi/studio/bin/odi
Description of the illustration 03_001.png - Oracle Data Integrator Studio 12c starts and is ready to use.
Description of the illustration 03_002.png
Granting users access to ODI Studio
- Using Identity Cloud, you can assign roles to users to access ODI Studio through Data Integration Platform. You can assign any of the following roles:
- Administrator (Service application administrator role), which is equivalent to ODI Supervisor
- Developer (Service application developer role), which is equivalent to ODI Designer
- User (Service application user role), which is equivalent to ODI Operator
For more information on how to assign roles to users, see Manage Security for Services Instances.
Connecting to the ODI Repository
- From your Oracle Cloud Service Console, locate your service instance, and then from the Manage this Service menu, select Open WebLogic Server Console.
Description of the illustration 05_001.png - Log in to the WebLogic Server Console.
Description of the illustration 05_002.png -
In the Change Center panel, click Lock & Edit.
Description of the illustration 05_003.png - In Domain Structure, expand Services, and then click Data Sources.
Description of the illustration 05_004.png - Select odiMasterRepository from the list of Data Sources.
Description of the illustration 05_005.png - Under Settings for odiMasterRepository, click Connection Pool, and then copy the user and URL values.
Description of the illustration 05_006.png - Back in ODI Studio, click Connect to Repository.
Description of the illustration 05_007.png -
In the Oracle Data Integrator Login dialog, click New.
Description of the illustration 05_008.png -
In the Repository Connection Information dialog, complete the fields. Paste the user and URL values from the WebLogic Server Console into the User and URL fields in the Database Connection (Master Repository) section. Use your WebLogic Server as the Master Repository password.
Description of the illustration 05_009.png - Click Test to test the connection details. If successful, click OK. If not successful, go back to the WebLogic Server Console to check your user and URL details.