Difference between revisions of "Install Protege5 PlatformIndep"

From Protege Wiki
Jump to: navigation, search
 
(3 intermediate revisions by the same user not shown)
Line 9: Line 9:
 
The platform-independent archive contains the Protege software, including the run scripts to launch Protege on any platform. '''It does not include the Java Runtime Environment (JRE), so you must have a working Java installation on your machine''' prior to using this archive. Also, the platform-independent archive will work with older 32-bit machines.
 
The platform-independent archive contains the Protege software, including the run scripts to launch Protege on any platform. '''It does not include the Java Runtime Environment (JRE), so you must have a working Java installation on your machine''' prior to using this archive. Also, the platform-independent archive will work with older 32-bit machines.
  
The required Java version is 7 or newer.
+
The required Java version is 8 or newer.
  
  
== If you have Java 7 or newer on your system ==
+
== If you have Java 8 or newer on your system ==
  
 
Then, it's very easy:
 
Then, it's very easy:
  
* Download the platform-independent archive from the [http://protege.stanford.edu/products.php#desktop-protege main Protege website].
+
* Download the platform-independent archive from the [http://protege.stanford.edu/products.php#desktop-protege main Protege website]. The link is under the platform-specific download button, and it is called: ''Download platform independent version''.
 
* Run the appropriate run script for your platform (e.g., run.bat on Windows, run.sh on Linux and run.command on Mac OSX).
 
* Run the appropriate run script for your platform (e.g., run.bat on Windows, run.sh on Linux and run.command on Mac OSX).
  
  
'''Note''': You may need to adjust the java path in the run scripts.
+
'''Note''': You may need to adjust the java path in the run script.
  
 
If this does not work, read more in the section below corresponding to your operating system.
 
If this does not work, read more in the section below corresponding to your operating system.
Line 29: Line 29:
 
== Windows ==
 
== Windows ==
  
=== Check for Java 7 (optional) ===
+
=== Check for Java 8 (optional) ===
  
This step is optional. Perform this step if you aren't sure if Java 7 or later is installed on your computer.
+
This step is optional. Perform this step if you aren't sure if Java 8 or later is installed on your computer.
  
 
To follow are two possible ways to check your Java version:
 
To follow are two possible ways to check your Java version:
Line 39: Line 39:
 
* Type "Java" in the search field.
 
* Type "Java" in the search field.
 
* Select "About Java" from the results list to display a dialog with your Java version information:
 
* Select "About Java" from the results list to display a dialog with your Java version information:
 
 
[[Image:InstallP5_OracleJavaVersionDialog.png]]
 
  
  
Line 49: Line 46:
 
* Select "cmd.exe" from the results list to launch the Command Prompt application.
 
* Select "cmd.exe" from the results list to launch the Command Prompt application.
 
* Type "java -version" at the prompt to view your Java version information:
 
* Type "java -version" at the prompt to view your Java version information:
 
 
[[Image:InstallP5_CommandPromptJavaVersion.png]]
 
 
 
=== Install JDK 7 on Windows 7 or 8 (if necessary) ===
 
 
In case the check for Java 7 from the previous test did not work, please follow this [http://javarevisited.blogspot.com/2013/02/how-to-install-jdk-7-on-windows-8-java-32bit-64.html step-by-step guide] to install Java JDK 7 on your Windows 7 or 8. Make sure at the end that you edit the <code>PATH</code> environment variable to add the path to the newly installed Java 7 (usually it is installed in:<code>C:\Program Files\Java\jdk1.7.0_13\bin</code>). This [http://javarevisited.blogspot.sg/2013/02/windows-8-set-path-and-classpath-java-windows-7.html step-by-step guide] helps you set the environment variable.
 
  
 
=== Launching Protege ===
 
=== Launching Protege ===
Line 67: Line 56:
 
  'java' is not recognized as an internal or external command, operable program or batch file.
 
  'java' is not recognized as an internal or external command, operable program or batch file.
  
''A'': Windows cannot find Java on your system. This can happen either if: (1) you do not have Java installed on your computer, or (2) you have Java installed, but it is not found on the <code>PATH</code> environment variable of your system. The solution is either to install java (if you don't have it), and/or to add it to the <code>PATH</code> variable. Both solutions are described [[Install_Protege5#Install_JDK_7_on_Windows_7_or_8_.28if_necessary.29|here]].
+
''A'': Windows cannot find Java on your system. This can happen either if: (1) you do not have Java installed on your computer, or (2) you have Java installed, but it is not found on the <code>PATH</code> environment variable of your system.  
  
  
 
== Mac OSX ==
 
== Mac OSX ==
  
=== Check for Java 7 (optional) ===
+
=== Check for Java 8 (optional) ===
This step is optional.  Perform this step if you aren't sure if Java 7 or later is installed on your computer, and used by the Terminal application.
+
This step is optional.  Perform this step if you aren't sure if Java 8 or later is installed on your computer, and used by the Terminal application.
  
 
* Open Finder.
 
* Open Finder.
Line 79: Line 68:
 
* Double-click the Terminal application.
 
* Double-click the Terminal application.
 
* At the prompt, type "java -version" to see your Java version number:
 
* At the prompt, type "java -version" to see your Java version number:
 
[[Image:InstallP5_Terminal.png]]
 
  
 
=== Launching Protege ===
 
=== Launching Protege ===
Line 89: Line 76:
 
== Linux ==
 
== Linux ==
  
=== Check for Java 7 (optional) ===
+
=== Check for Java 8 (optional) ===
This step is optional. Perform this step, if you are not sure if you have Java 7 or later installed on your computer.
+
This step is optional. Perform this step, if you are not sure if you have Java 8 or later installed on your computer.
  
 
To check that you have Java installed, open a terminal window, and type: <code>java -version</code>. You should see something like this:
 
To check that you have Java installed, open a terminal window, and type: <code>java -version</code>. You should see something like this:
Line 96: Line 83:
 
<pre>
 
<pre>
 
  myuser@mycomputer:/$ java -version
 
  myuser@mycomputer:/$ java -version
  java version "1.7.0_51"
+
  java version "1.8.0_91"
  OpenJDK Runtime Environment (IcedTea 2.4.4) (7u51-2.4.4-0ubuntu0.13.04.2)
+
  Java(TM) SE Runtime Environment (build 1.8.0_91-b14)
  OpenJDK 64-Bit Server VM (build 24.45-b08, mixed mode)
+
  Java HotSpot(TM) 64-Bit Server VM (build 25.91-b14, mixed mode)
 
</pre>
 
</pre>
  
(The version should be 1.7 or later)
+
(The version should be 1.8 or later)
  
=== Install Java 7 (if necessary) ===
 
 
Please consult the documentation for your Linux distribution on how to install Java. Usually, you can install [http://openjdk.java.net/ Open Java] easily from the package manager of your Linux distribution (e.g., <code>apt-get</code> in Ubuntu and Debian distributions, <code>yum</code> in RedHat ). You may also use other Java implementations, such as [http://www.oracle.com/us/technologies/java/overview/index.html Oracle Java].
 
For Ubuntu, you can find the installation instructions for different Java implementations [https://help.ubuntu.com/community/Java here]. For RedHat, the installation instructions for Open Java are [https://access.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6/html/Installation_Guide/Install_OpenJDK_on_Red_Hat_Enterprise_Linux.html here], and for Oracle Java [https://www.java.com/en/download/help/linux_x64rpm_install.xml here]. General Oracle Java installation instructions for Linux distributions are [http://docs.oracle.com/javase/7/docs/webnotes/install/linux/linux-jdk.html here].
 
  
 
=== Launching Protege ===
 
=== Launching Protege ===
Line 113: Line 96:
  
  
=== Troubleshooting ===
+
== If you do not have Java 8 installed on your computer ==
 
 
''Q'': ''The Protege UI occasionally freezes on Linux with Open Java 7. Protege still seems to be running (CPU at normal levels), but I can't click on any of the entities, tabs. or menus.''
 
  
''A'':  There's a bug in Open Java on Linux distributions (e.g., Ubuntu) with parentless dialogs that will cause this behavior. The workaround is to upgrade to Java 8. See the bug report here: https://github.com/protegeproject/protege/issues/48
+
In case the check for Java 8 did not work, please install go to the [http://protege.stanford.edu/products.php#desktop-protege Protege website], and download a version that comes with a bundled JRE.
  
  
 
'''[[Install_Protege5#Troubleshooting|See more troubleshooting help on the main Protege 5 installation page]]'''
 
'''[[Install_Protege5#Troubleshooting|See more troubleshooting help on the main Protege 5 installation page]]'''

Latest revision as of 14:48, May 24, 2016

PlatfIndep-logo.png Protege 5 Installation instructions (Platform-Independent)


Go to the main Protege 5 installation page


The platform-independent archive contains the Protege software, including the run scripts to launch Protege on any platform. It does not include the Java Runtime Environment (JRE), so you must have a working Java installation on your machine prior to using this archive. Also, the platform-independent archive will work with older 32-bit machines.

The required Java version is 8 or newer.


If you have Java 8 or newer on your system

Then, it's very easy:

  • Download the platform-independent archive from the main Protege website. The link is under the platform-specific download button, and it is called: Download platform independent version.
  • Run the appropriate run script for your platform (e.g., run.bat on Windows, run.sh on Linux and run.command on Mac OSX).


Note: You may need to adjust the java path in the run script.

If this does not work, read more in the section below corresponding to your operating system.

Also, read more on the installation instructions for your platform from here.


Windows

Check for Java 8 (optional)

This step is optional. Perform this step if you aren't sure if Java 8 or later is installed on your computer.

To follow are two possible ways to check your Java version:

From the Start menu

  • Click the Start menu.
  • Type "Java" in the search field.
  • Select "About Java" from the results list to display a dialog with your Java version information:


From the Command Prompt

  • Click the Start menu.
  • Type "cmd" in the search box.
  • Select "cmd.exe" from the results list to launch the Command Prompt application.
  • Type "java -version" at the prompt to view your Java version information:

Launching Protege

Read the instructions here.

Troubleshooting

Q: When I run run.bat in Windows, I get the error message:

'java' is not recognized as an internal or external command, operable program or batch file.

A: Windows cannot find Java on your system. This can happen either if: (1) you do not have Java installed on your computer, or (2) you have Java installed, but it is not found on the PATH environment variable of your system.


Mac OSX

Check for Java 8 (optional)

This step is optional. Perform this step if you aren't sure if Java 8 or later is installed on your computer, and used by the Terminal application.

  • Open Finder.
  • Go to Applications -> Utilities.
  • Double-click the Terminal application.
  • At the prompt, type "java -version" to see your Java version number:

Launching Protege

Read the instructions here.


Linux

Check for Java 8 (optional)

This step is optional. Perform this step, if you are not sure if you have Java 8 or later installed on your computer.

To check that you have Java installed, open a terminal window, and type: java -version. You should see something like this:

 myuser@mycomputer:/$ java -version
 java version "1.8.0_91"
 Java(TM) SE Runtime Environment (build 1.8.0_91-b14)
 Java HotSpot(TM) 64-Bit Server VM (build 25.91-b14, mixed mode)

(The version should be 1.8 or later)


Launching Protege

Read the instructions here.


If you do not have Java 8 installed on your computer

In case the check for Java 8 did not work, please install go to the Protege website, and download a version that comes with a bundled JRE.


See more troubleshooting help on the main Protege 5 installation page