Setup Java.
Syndeia requires Java 8 (or higher). In this section, you will check if Java 8 is installed on your computer and is being used by Rhapsody. If not, instructions are provided to download Java 8 and use it with the SysML modeling tools.
Check if Java 8 is already being used by the SysML tool
If you are using Rhapsody 8.1 (or above) as your SysML modeling tool, then you could be using either the 32-bit or 64-bit edition. You will need to use:
- Java 8 32-bit edition for Syndeia with Rhapsody 8.1 32-bit edition
- Java 8 64-bit edition for Syndeia with Rhapsody 8.1 64-bit edition
First, ensure that Java 8 is installed on your machine by following the steps in the next section and then complete the Java setup instructions with Syndeia plugin installation for Rhapsody.
Check and install Java 8 on your machine
Follow the steps below to: (1) check if you have Java 8 installed on your machine, and (2) install Java 8 if not.
- If you have a 64 bit (or 32bit) edition of the SysML tool, then you need Java 8 64 bit (or 32 bit) edition. Check if you have a folder with name starting in jre8 OR jdk1.8.0 under C:\Program Files\Java (or C:\Program Files(x86)\Java) on Windows. If you have either of these folders, then skip the remainder of this section and continue to section. If not, download Java 8 64-bit edition from the link in next step.
- Download Java 8 from the Oracle's website: http://goo.gl/YsXYkU (short URL) for your specific OS, as shown below. Note – use x64 installer if you have a 64-bit OS and 64-bit installation of the SysML tool, and use x86 installer if you have a 32-bit OS and 32-bit installation of the SysML tool.
- Install Java – If you have admin privileges on your machine, right click on the installer (downloaded above) and select Run as administrator (on Windows) or simply double click the executable (e.g. .dmg file on Mac OS X). If you do not have admin privileges on your machine, try running the installer to check if you can install any programs. If not, please check with your system administrator to install Java 8.
On Windows, if you are installing 64 bit edition, it will install under C:\Program Files\Java folder, and if you are installing 32 bit edition, it will install under C:\Program Files (x86)\Java folder. On Mac OS X, it will typically install under /Library/Java/JavaVirtualMachines.
Setup your SysML tool to use Java 8
In the previous step, you have either (1) identified that Java 8 is already installed in your machine, or (2) downloaded and installed Java 8 in your machine. In this step, you will change settings in Rhapsody to use Java 8. Follow the steps below.
- Close Rhapsody.
- Locate the rhapsody.ini file
- If you have a default installation of Rhapsody 8.1 (or above) wherein Rhapsody is installed only for you on the computer, then the rhapsody.ini file will under your user directory at <Your_User_Directory>\IBM\Rational\Rhapsody\8.1.2x64, e.g. C:\Users\Manas\IBM\Rational\Rhapsody\8.2.1x64
- If you have installed Rhapsody for all users on the computer, then the rhapsody.ini file will be under ProgramData folder, e.g. at C:\ProgramData\IBM\Rational\Rhapsody\8.4x64
If you do not see the rhapsody.ini file at either of the locations above, then also check directly under your Rhapsody installation, e.g. C:\Program Files\IBM\Rational\Rhapsody\8.2.1x64.
- Open the rhapsody.ini file in a text editor.
- Search for the JVM section, as shown below.
Set the value of JavaLocation variable under JVM section to the location of Java 8 on your machine.
- Save and close the rhapsody.ini file
- Start Rhapsody. It is now set to use Java 8.