RSA Installation
From Skyway Wiki
Contents |
Overview
Skyway Builder RSA Edition supports RSA 7.5.2, RSA 7.5.3, and RSA 7.5.4. If you have an earlier version of RSA, you must update to a supported version.
Installation Instructions: RSA Standard Edition or RSA for Websphere
IMPORTANT NOTE: You must install WTP 3.0.5 prior to installing Skyway Builder.
RSA introduced a dependency on WTP 3.0.5 (the last supported version of WTP for Ganymede), but RSA doesn't include a full copy of WTP 3.0.5. Since Eclipse doesn't have an update site for WTP 3.0.5, you will need to install the full copy of WTP 3.0.5 manually using the WTP 3.0.5 archive that's available from Eclipse.
Here are the steps:
- Download the WTP 3.0.5 archive WTP 3.0.5
- Unzip only the features and plugins folders from the archive into the RSA installation folder (i.e. \IBM\SDP). Do not unzip the "eclipse" folder, because RSA doesn't have an "eclipse" folder.
- Restart RSA
The following Skyway Builder installation instructions are based on a having a clean install of RSA 7.5.2/7.5.3/7.5.4 with WTP 3.0.5 (see installation instructions above):
- In RSA go to Help-->Software Updates
- Add Skyway Builder update site ("Add Site..."). Pick closest regional update site.
- Using on the Available Software Sites window (using the “Manage Sites” button) enable the following update sites (Screenshot):
- Ganymede Update Site - http://download.eclipse.org/releases/ganymede
- The Eclipse Project Updates - http://download.eclipse.org/eclipse/updates/3.4
- Click on checkbox for Skyway Builder update site. From the "Available Software" window, Skyway Builder should be the only option selected. All items listed under Skyway Builder should have been automatically selected. (Screenshot)
- Click "Install..." button.
- Proceed through installation wizards. At the end you will be prompted to restart RSA.
- IMPORTANT: Import the Skyway License before building your first project. Go to Window > Preferences > Skyway > License
Screenshot: Available Software Sites - Enabling update sites for required dependencies
Screenshot: Software Updates and Add-ons - Selecting Skyway Builder plugins
Support & Known Issues
If you have any problems, please check the "Installation and Configuration" of the Skyway Forums.
Deploying to Apache Tomcat
If you are deploying to Apache Tomcat from IBM RSA for WebSphere, you will need to manage the build path manually. See Build Path Management in Eclipse
rt.jar errors
These problems are usually due to the JRE version used. Switching your installed JRE to 1.5 and changing the Web Project facet to 5.0 removes these errors. However, you can also use JRE 1.6 with Skyway by configuring eclipse to ignore these messages as discussed in the following links.
These links talk about it being an error that can be ignored:
This link talks about how to fix it by changing the java build path:
You will then need to change the generated Web Project's build path to point to 1.6. This will be defaulted in later versions of Skyway as reported here:
Import Types causes Unhandled event loop exception - RSA Standard Edition
This is not due to RSA Standard Edition, but has been reproduced in that setup. Since RSA Standard does not come with JPT plugins, the latest JPT version (2.1) is installed during the Skyway plugins install. The Data Store Import Types link will throw an Unhandled loop exception as the code behind it is compiled against the 2.0 version. More details can be found at MOD-2832.
If your environment is experiencing this issue, the workaround we have found is to install the JPT 2.0 plugins first before installing Skyway Builder plugins. (Unless you can find a way to downgrade your JPT 2.1 plugins to 2.0). The JPT 2.0 plugins can be found in the Web Tools (WTP) Update Site > Uncategorized > Dali Java Persistence API(JPA) Tools (2.0.104) (You will need to uncheck the "Show only the latest versions of available software" checkbox)
RSA Standard Edition blank Skyway Database Configuration tab
In RSA Standard 7.5.2, a known issue is fixed where the Skyway Data Store Configuration tab shows up blank. This is fixed in Skyway v6.2.1 released on June 22nd. We have not experienced this issue with RSA WebSphere Edition 7.5.2.
Earlier version of UML Projects does not upgrade
If your UML project was created with Skyway version 6.2.0, the Spring profile may not upgrade due profile version enforcements in RSA 7.5.2. Look at MOD-3024 for more information and workarounds. UML projects containing Spring profiles created with Skyway 6.2.1 or greater are not affected by this issue.
Corrupt JAR Files
Several users have reported an issues where the downloaded plug-ins are corrupted and unusable. This usually manifests in the p2 metadata generation phase as "error in opening zip file" message in the .log file contained in the .metadata directory of the active workspace. The work around is to download the zipped update site from http://sourceforge.net/projects/skywaybuilder/files/. The file name is Skyway6.3.1-UpdateSite.zip. After downloading, unzip the file into a temporary directory and add that location as a local site in the RSA Software updates. IBM stores the plug-ins in a shared depot, with a default location of \Program Files\IBM\SDPShared\plugins\plugins. For each failed jar file, replace with the corresponding file and rerun the 6.3 installation process, selecting the Skyway features from the local update site.



