Installing DataConnect Studio IDE Site Plug-in for Eclipse on Windows
DataConnect Studio IDE Site Plug-in for Eclipse Prerequisites on Windows
• Eclipse:
• Mars 4.5.2 for DataConnect 11.1.1
• Oxygen 4.7.1 or later for DataConnect 11.2.1
• Eclipse 2018-09 for DataConnect 11.4
• Eclipse 2018-12 for DataConnect 11.5
• com.actian.dcui.site_xxxx.zip and
di-standalone-engine-64-bit-xxxx-win.exe where
xxxx is a version number that must match. You can download these two files from
Actian ESD.
• DataConnect v11 license file (.slc)
Note: DataConnect contains an embedded Adoptium OpenJDK 11.0.12+7.
Installation Process Overview
To install DataConnect Studio IDE as a site plug-in, you will follow these basic steps:
Note: It is important that you run Eclipse with the environment variables that the engine requires. For information about the environment variables, see
Invoking Runtime Engine Using CLI.
Install DataConnect Studio IDE Site Plug-in on Windows
Before installing the DataConnect Studio Site plug-in, make sure you have installed the Runtime Engine. See
Install DataConnect Runtime Engine on Windows.
To install the DataConnect Studio IDE site plug-in
1. Launch eclipse.
2. From the Help menu, click Install New Software…
3. Click Add.
The Add Repository dialog box is displayed.
4. In Name, type DataConnect and click Archive.
5. Navigate to the com.actian.dcui.site_xxxx.zip file, click Open, and then click OK.
6. Select Actian check box (all the other are defaults) and click Next.
The installation details are displayed. It must display DataConnect 11.X.X.xx.
7. Click Next.
8. Accept the EULA and click Finish.
9. When information about unsigned content is displayed, click OK.
10. Restart Eclipse when the prompt appears.
Post DataConnect Studio IDE Site Plug-in Installation Tasks on Windows
After installing the DataConnect Studio IDE site plug-in:
• Click Help, About DataConnect and verify that the license information is displayed. If not, you will see a red error message displayed under Browse).
– If the error starts with .ini, it means any of the following:
• You did not close Eclipse while setting the environment variables. Close it and reopen.
• You did not install the engine.
• You did not set the environment variables that allow the UI to know which engine to use.
– If the error indicates that the license file is invalid or missing, click Browse and specify a valid DataConnect v11 license.
– Click the X in the right corner to close the About DataConnect dialog box.
• If you do not see a DataConnect perspective icon in the top right corner (Cloud with four-dot ring), click Options, Perspective, Open Perspective, Other and click DataConnect Perspective.
• If the DataConnect perspective icon is shown in the top right corner, click on it to work in the DataConnect perspective.
Upgrade DataConnect Studio IDE Site Plug-in on Windows
Before upgrading the DataConnect Studio IDE site plug-in, make sure that you have closed all perspectives. If you do not do this, after uninstalling and reinstalling the DataConnect Studio IDE site plug-in, duplicate perspectives will appear with angle brackets. For example, <DataConnect> and <Process>. If this occurs, do the following:
1. In Eclipse, go to Window, Preferences.
2. Select General, Perspective.
The Available perspectives list is displayed on the right-side.
3. Select the custom perspective that has angle brackets such as <DataConnect>.
4. Click Delete.
To install another version of the DataConnect Studio IDE Site plug-in when there is a version already installed
1. Uninstall DataConnect Studio IDE site plug-in:
a. In Eclipse, click Help, About Eclipse.
b. Click Installation Details.
c. From the list, select DataConnect and click Uninstall.
d. Click Yes to restart.
e. In Eclipse, go to Window, Preferences, Install/Update, Available Software Sites. If you see DataConnect, select it and click Remove.
2. Uninstall the Runtime Engine.
Note: The UI cannot check for the minimum version of the engine that is required. Hence, ensure that the Runtime Engine version and the site plug-in versions are the same.
3. Close Eclipse.
Steps 4 and 5 are required only if you uninstall or reinstall the same version since Eclipse may not clean up some files.
4. Go to the Eclipse, plugins folder and remove the following:
• com.actian jars
• Three di-xxx jars
• jcore.jar
• Three Jackson jars
5. Go to <users folder>/.eclipse/org.eclipse.oomph.p2 and delete the cache folder.
6. Install and configure the Runtime Engine and the DataConnect Studio IDE site plug-in.
7. Perform the post-installation tasks.
Note: If you switch versions and point to the same workspace, you must first click Help, About DataConnect to point to a valid v11 license. If you see a big red X when loading maps, processes, and so on, it means you do not have a valid license or the UI is not able to find the license.