Difference between revisions of "Install Protege5"

From Protege Wiki
Jump to: navigation, search
(33 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<br /><span style="font-weight:bold; font-size:20px;">Protege Desktop 5.0 Beta Installation Instructions</span><br /><br />
+
<br /><span style="font-weight:bold; font-size:20px;">Protege Desktop 5.0 Installation Instructions</span><br /><br />
  
Please refer to the specific installation instructions for your platform.
 
  
 +
__TOC__
  
__TOC__
 
  
 +
== Platform specific instructions ==
 +
 +
Click on the links below for the platform specific instructions. The platforms-specific archives include the Java JRE, so it is not required to have Java installed on your machine. Use the platform-independent archive if you would like to use a specific version of Java, or if your system is 32-bit (the case with older computers).
  
== Windows ==
+
=== [[File:Win-logo.jpg|50px]] [[Instal_Protege5_Win|Windows]] ===  
Protege Desktop 5.0 beta is distributed in the form of a ZIP file and requires Java 7.
+
''Includes the JRE, and works for 64-bit Windows platforms''
  
=== Check for Java 7 ===
+
=== [[File:Mac-logo.jpg|50px]] [[Install_Protege5_Mac|Mac OSX]] ===
There are several possible ways to check your Java version on Windows.
+
''Includes the JRE, and works for 64-bit OSX platforms''
  
==== From the Windows Start menu ====
+
=== [[File:Tux-logo.png|50px]] [[Install_Protege5_Linux|Linux]] ===
* Click the Windows Start button.
+
''Includes the JRE, and works for 64-bit Linux platforms''
* Type "Java" in the "Search programs and files" text box.
 
* Select "About Java" from the results listed under the "Programs" header:
 
  
 +
=== [[File:PlatfIndep-logo.png|50px]] [[Install_Protege5_PlatformIndep|Platform Independent]] ===
 +
''Does not include the JRE, requires a Java version 8 or newer installed, works on any platform''
  
[[Image:InstallP5_AboutJava.png]]
 
  
 +
== Troubleshooting ==
  
Selecting About Java will display a dialog with your Java version:
+
''Q'': ''When I try to run Protege from the platform-independent archive with the run script, I get an <code>UnsupportedClassVersionError</code>, e.g., <code>"Exception in thread "main" java.lang.UnsupportedClassVersionError: Bad version number in .class file"</code>''
  
 +
''A'': Most likely you have an older Java version installed. Protege requires Java 8 or later. Please see the documentation above on how to check which version of Java is installed on your system.
  
[[Image:InstallP5_OracleJavaVersionDialog.png]]
 
  
=== Download the ZIP file ===
+
== How to get help ==
  
* Go to the Products page on the Protege website.
+
If you have problems installing or running Protege Desktop, please refer to the [[Install_Protege5#Troubleshooting|troubleshooting]] section first.  We also recommend searching the [http://protege-project.136.n4.nabble.com/ mailing list archives], as the problem and a solution might have already been posted.
* Click the Download for Windows button.
 
  
=== Unzip Protege ===
+
If you can't find the answers from these resources, send an email to the [http://protege.stanford.edu/support.php#mailingListSupport '''Protege User Support''' mailing list] (you need to be subscribed to post).  Please be as specific as possible and try to include the following items:
Once the download completes, navigate to the folder where
 
  
=== Launch Protege ===
 
To launch Protege, double-click the run.bat file in the root directory of the installation.
 
  
 +
* What is your operating system (e.g., OS X 10.9, Windows 7, etc.)?
 +
* What is your Java version?
 +
* What are the specific steps to reproduce the problem?
 +
* Are there any error messages in the console window or the log file?
 +
* What is the observed behavior?
  
== Mac OS X ==
 
Protege 5.0 is distributed in the form of a ZIP file and requires Java 7.
 
  
== Unix-like ==
+
The more detail you provide up front, the more helpful we can be in terms of a prompt response.
Protege 5.0 is distributed in the form of a tar.gz file and requires Java 7.
 

Revision as of 15:38, May 24, 2016


Protege Desktop 5.0 Installation Instructions



Platform specific instructions

Click on the links below for the platform specific instructions. The platforms-specific archives include the Java JRE, so it is not required to have Java installed on your machine. Use the platform-independent archive if you would like to use a specific version of Java, or if your system is 32-bit (the case with older computers).

Win-logo.jpg Windows

Includes the JRE, and works for 64-bit Windows platforms

Mac-logo.jpg Mac OSX

Includes the JRE, and works for 64-bit OSX platforms

Tux-logo.png Linux

Includes the JRE, and works for 64-bit Linux platforms

PlatfIndep-logo.png Platform Independent

Does not include the JRE, requires a Java version 8 or newer installed, works on any platform


Troubleshooting

Q: When I try to run Protege from the platform-independent archive with the run script, I get an UnsupportedClassVersionError, e.g., "Exception in thread "main" java.lang.UnsupportedClassVersionError: Bad version number in .class file"

A: Most likely you have an older Java version installed. Protege requires Java 8 or later. Please see the documentation above on how to check which version of Java is installed on your system.


How to get help

If you have problems installing or running Protege Desktop, please refer to the troubleshooting section first. We also recommend searching the mailing list archives, as the problem and a solution might have already been posted.

If you can't find the answers from these resources, send an email to the Protege User Support mailing list (you need to be subscribed to post). Please be as specific as possible and try to include the following items:


  • What is your operating system (e.g., OS X 10.9, Windows 7, etc.)?
  • What is your Java version?
  • What are the specific steps to reproduce the problem?
  • Are there any error messages in the console window or the log file?
  • What is the observed behavior?


The more detail you provide up front, the more helpful we can be in terms of a prompt response.