Difference between revisions of "Install Protege5 PlatformIndep"

From Protege Wiki
Jump to: navigation, search
 
(9 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
__TOC__
 
__TOC__
  
''' Work in progress '''
 
  
 +
'''[[Install_Protege5|Go to the main Protege 5 installation page]]'''
  
== Windows ==
 
  
 +
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 [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).
 +
 +
 +
'''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 [[Install_Protege5|here]].
  
Protege Desktop 5.0 is distributed in the form of a ZIP file from the [http://protege.stanford.edu/products.php#desktop-protege main Protege website], and requires Java 7 or later.  Please consult the Oracle Java website for Java [http://www.java.com/en/download/help/windows_manual_download.xml download and installation instructions].
 
  
 +
== 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:
  
 
+
''' From the Start menu '''
==== From the Start menu ====
 
 
* Click the Start menu.
 
* Click the Start menu.
 
* Type "Java" in the search field.
 
* Type "Java" in the search field.
Line 25: Line 41:
  
  
[[Image:InstallP5_OracleJavaVersionDialog.png]]
+
''' From the Command Prompt '''
 
 
 
 
==== From the Command Prompt ====
 
 
* Click the Start menu.
 
* Click the Start menu.
 
* Type "cmd" in the search box.
 
* Type "cmd" in the search box.
Line 34: Line 47:
 
* Type "java -version" at the prompt to view your Java version information:
 
* Type "java -version" at the prompt to view your Java version information:
  
 +
=== Launching Protege ===
 +
 +
Read the instructions [[Instal_Protege5_Win|here]].
 +
 +
=== Troubleshooting ===
 +
 +
''Q'': ''When I run <code>run.bat</code> in Windows, I get the error message:
 +
'java' is not recognized as an internal or external command, operable program or batch file.
  
[[Image:InstallP5_CommandPromptJavaVersion.png]]
+
''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.  
  
  
=== Install JDK 7 on Windows 7 or 8 (if necessary) ===
+
== Mac OSX ==
  
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.
+
=== 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.
  
=== Troubleshooting ===
+
* 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 [[Install_Protege5_Mac|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: <code>java -version</code>. You should see something like this:
 +
 
 +
<pre>
 +
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)
 +
</pre>
 +
 
 +
(The version should be 1.8 or later)
 +
 
 +
 
 +
=== Launching Protege ===
 +
 
 +
Read the instructions [[Install_Protege5_Linux|here]].
  
''Q'': ''When I run <code>run.bat</code> 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 <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]].
+
== 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 [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 15: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