The integrated development environment (IDE) is based on Eclipse 3.4.2 and Lotus Symphony. All the steps in this procedure are for a Microsoft® Windows® operating system, but the process on the Linux® operating system is similar. For Linux users, root privilege is required for installing the toolkit. If you have any questions during the setup process, please get help from the Lotus Symphony forum: Lotus Symphony forum.
1. Install Lotus Symphony and the Lotus Symphony toolkit.
b. Install Lotus Symphony to a local disk, for example, D:\IBM\Lotus\Symphony as .
c. Extract the Lotus Symphony toolkit to a local disk.
2. Enable My Widgets panel.
a. Select File > Preferences > Widgets.
b. Select Show Widget Toolbar and the My Widgets Sidebar panel.
3. Enable the Lotus Symphony development feature.
a. Drag the update site development_enablement_updatesite.zip to the My Widgets panel from the Lotus Symphony Toolkit's update_sites folder. For Microsoft Windows Vista and Microsoft Windows 7 users, please disable User Account Control(UAC) before dragging.
b. Select I accept the terms in the license agreements in the Feature License window, and then click Finish.
c. Wait for the installation to finish and restart Lotus Symphony. After it restarts, close Lotus Symphony.
4. Install Eclipse Classic 3.4.2(Eclipse SDK 3.4.2), then install the Lotus Expeditor toolkit update package and the Lotus Symphony toolkit configuration on the Eclipse Classic 3.4.2, JDK version 5.0 or higher version is required.
a. Download Eclipse 3.4.2 Classic from Eclipse Download website and extract it to a local disk.
Note: For Eclipse 3.4.2 Classic reference platforms, see Eclipse embedded readme or readme_eclipse_3.4.2.
b. Download the Lotus Expeditor toolkit and use the update package of 6.2.1 edition, higher version is not recommended.
c. Start the Eclipse IDE. From the main menu, click Help > Software Updates. In the Software Update and Add-ons window, click the Available Software tab. Click Add Site > Local, select the Expeditor_Toolkit_Install from Lotus Expeditor Toolkit download folder, and then click OK.
d. Click Add Site > Archive , and select the toolkit_configuration_updatesite.zip update site from the Lotus Symphony toolkit's update_sites folder, and then click OK.
e. Select all the features available, and then click Install. After the installation is finished, click Next.
f. In the Feature License window, read the licensing information for each feature that you are installing, and, if you agree with the license, select to accept the license and click Next.
g. Click Finish to begin the installation. When installation completes, you are prompted to restart your IDE for changes to take effect. Click Yes to continue.
Important: Clicking Apply Changes does not correctly configure the environment.
5. Configure Lotus Symphony development support.
After restarting the IDE, the Lotus Expeditor Toolkit Configuration window opens. To configure the toolkit, follow these steps:
a. Select Lotus Symphony in the Test Environment list.
b. Use the Browse button to select the eclipse directory of the Lotus Symphony installation location, for example, \framework\rcp\eclipse.
c. Click OK.
6. By now the development environment is ready to create your own project code in this Eclipse environment.
7. Launch Symphony from Eclipse project environment
a. Select Run > Run Configuration or Run > Debug Configuration from the Eclipse main menu.
b. Select the Client Services launch type and click the new icon or double click Client Services. Name the new configuration, such as Symphony.
c. Click Run or Debug to start Lotus Symphony.
The build of Lotus Symphony that was tested with the toolkit does not resolve all plug-ins correctly. Therefore, you might see an error report window named Plug-in Validation. If this error occurs, click OK to continue the launch process. You can disable this checking operation by clearing the mark next to Validate plug-in dependencies at the bottom of the plug-ins tab of the launcher.Restriction: Use Java compiler 5.0 for the compiler plug-ins. Java compiler 1.4 might not work correctly.
Note: On Red Hat systems, sometimes a java.lang.UnsatisfiedLinkError exception is thrown when launching the Lotus Symphony. Try to fix it with the following command:
versionnumber is the version that you have installed.