|
|
| (20 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.x Installation Instructions</span><br /><br /> |
| − | | |
| − | Please refer to the specific installation instructions for your platform.
| |
| | | | |
| | | | |
| Line 7: |
Line 5: |
| | | | |
| | | | |
| − | == Windows == | + | == Platform specific instructions == |
| − | Protege Desktop 5.0 beta is distributed in the form of a ZIP file and requires Java 7.
| |
| | | | |
| − | If you already know that Java 7 is installed on your Windows machine, skip to next section on [[#Download_the_ZIP_file|downloading the ZIP file]].
| + | 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). |
| | | | |
| − | If you check for Java 7 and determine that you don't have Java installed on your Windows machine, please refer to the Oracle Java website for [http://www.java.com/en/download/help/windows_manual_download.xml download and installation instructions]. After installing Java 7, proceed to the next section on [[#Download_the_ZIP_file|downloading the ZIP file]].
| + | === [[File:Win-logo.jpg|50px]] [[Instal_Protege5_Win|Windows]] === |
| | + | ''Includes the JRE, and works for 64-bit Windows platforms'' |
| | | | |
| − | === Check for Java 7 (optional) === | + | === [[File:Mac-logo.jpg|50px]] [[Install_Protege5_Mac|Mac OSX]] === |
| | + | ''Includes the JRE, and works for 64-bit OSX platforms'' |
| | | | |
| − | This step is optional. Perform this step, if you are not sure if you have Java 7 or later installed on your computer.
| + | === [[File:Tux-logo.png|50px]] [[Install_Protege5_Linux|Linux]] === |
| | + | ''Includes the JRE, and works for 64-bit Linux platforms'' |
| | | | |
| − | There are several possible ways to check your Java version on Windows.
| + | === [[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'' |
| | | | |
| − | ==== From the Windows Start menu ====
| |
| − | * Click the Windows Start button.
| |
| − | * Type "Java" in the "Search programs and files" text box.
| |
| − | * Select "About Java" from the results listed under the "Programs" header:
| |
| | | | |
| | + | == Troubleshooting == |
| | | | |
| − | [[Image:InstallP5_AboutJava.png]]
| + | ''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>'' |
| − | | |
| − | | |
| − | Selecting About Java will display a dialog with your Java version:
| |
| − | | |
| − | | |
| − | [[Image:InstallP5_OracleJavaVersionDialog.png]]
| |
| − | | |
| − | | |
| − | ==== From the Command Prompt ====
| |
| − | * Click the Windows Start button.
| |
| − | * Type "Command Prompt" in the "Search programs and files" text box.
| |
| − | * Select "Command Prompt" from the results list to launch the Command Prompt application.
| |
| − | * Type "java -version" at the prompt to view your Java version:
| |
| − | | |
| − | | |
| − | [[Image:InstallP5_CommandPromptJavaVersion.png]]
| |
| − | | |
| − | | |
| − | ==== From the Java Control Panel ====
| |
| − | Detailed instructions for determining your version of Java via the Java Control Panel are [http://www.java.com/en/download/help/version_manual.xml#jcpl available on the Oracle Java website].
| |
| − | | |
| − | | |
| − | === Download the ZIP file ===
| |
| − | | |
| − | * Go to the [http://protege.stanford.edu/products.php#desktop-protege Products page] on the Protege website.
| |
| − | * Click the "Download for Windows" button to download the ZIP file to your machine.
| |
| | | | |
| | + | ''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. |
| | | | |
| − | === Unzip Protege ===
| |
| − | Once the download completes, navigate to the folder where the ZIP file was downloaded. On a Windows machine, this will typically be your "Downloads" folder, e.g., "C:/Users/<your-username>/Downloads".
| |
| − |
| |
| − | Right-click on the ZIP file and choose "Extract All..." from the context menu to launch the Extract Compressed Folders dialog. Click the Browse... button to select a destination for your Protege Desktop installation, e.g., the "C:/Program Files" folder:
| |
| − |
| |
| − |
| |
| − | [[Image:InstallP5_ExtractFilesDialog.png]]
| |
| − |
| |
| − |
| |
| − | Protege Desktop will be extracted to your selected destination into a folder called "Protege_5.0_beta":
| |
| − |
| |
| − |
| |
| − | [[Image:InstallP5_ProtegeUnzipped.png]]
| |
| − |
| |
| − |
| |
| − | === Launch Protege ===
| |
| − | To launch Protege Desktop, double-click the '''run.bat''' file in the root directory of the installation.
| |
| − |
| |
| − | For quicker access to Protege Desktop going forward, right-click on the run.bat file and select "Send to" -> "Desktop (create shortcut)". This will create a shortcut to Protege Desktop's launcher on your Windows Desktop called "run.bat - Shortcut". Select the shortcut and press the F2 key to rename the shortcut to something more user friendly, e.g., "Protege 5.0 beta".
| |
| − |
| |
| − |
| |
| − | == Mac OS X ==
| |
| − | Protege 5.0 is distributed in the form of a ZIP file and requires Java 7.
| |
| − |
| |
| − | If you already know that Java 7 is installed on your Mac, skip to next section on [[#Download_the_ZIP_file_2|downloading the ZIP file]].
| |
| − |
| |
| − | If you check for Java 7 and determine that you don't have Java installed on your Mac, please refer to the Oracle Java website for [http://www.java.com/en/download/help/mac_install.xml download and installation instructions]. After installing Java 7, proceed to the next section on [[#Download_the_ZIP_file_2|downloading the ZIP file]].
| |
| − |
| |
| − | === Check for Java 7 (optional) ===
| |
| − | This step is optional. Perform this step, if you are not sure if you have Java 7 or later installed on your computer.
| |
| − |
| |
| − | There are several ways to check for Java 7 on your Mac.
| |
| − |
| |
| − | ==== From the Java Control Panel ====
| |
| − | * Click the Apple icon in the upper left of the screen.
| |
| − | * Choose System Preferences...
| |
| − | * Click the Java icon to bring up the Java Control Panel.
| |
| − | * On the General tab, click About... to see your Java version number:
| |
| − |
| |
| − |
| |
| − | [[Image:InstallP5_MacJavaControlPanel.png]]
| |
| − |
| |
| − |
| |
| − | ==== From the Terminal ====
| |
| − | * Open Finder.
| |
| − | * Go to Applications -> Utilities.
| |
| − | * Double-click the Terminal application.
| |
| − | * At the prompt, type "java -version" to see your Java version number:
| |
| − |
| |
| − | [[Image:InstallP5_Terminal.png]]
| |
| − |
| |
| − | === Download the ZIP file ===
| |
| − | * Go to the [http://protege.stanford.edu/products.php#desktop-protege Products page] on the Protege website.
| |
| − | * Click the "Download for Mac OSX" button to download the ZIP file to your machine.
| |
| − |
| |
| − |
| |
| − | === Move Protege to Applications ===
| |
| − | * Once the download completes, navigate to the folder where the ZIP file was unpacked. On a Mac, this will typically be your "Downloads" folder:
| |
| − |
| |
| − | [[Image:InstallP5_DownloadsFolder.png]]
| |
| − |
| |
| − | Drag the Protege_5.0_beta folder to the Applications directory.
| |
| − |
| |
| − |
| |
| − | === Launch Protege ===
| |
| − | To launch Protege Desktop, double-click the <code>run.command</code> file in the root directory of the installation (<code>Applications/Protege_5.0_beta/run.command</code>).
| |
| − |
| |
| − |
| |
| − | == Linux and Unix-like ==
| |
| − | Protege 5.0 is distributed in the form of a <code>tar.gz</code> file and requires Java 7 or later.
| |
| − |
| |
| − | 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].
| |
| − |
| |
| − | === Check for Java 7 (optional) ===
| |
| − | This step is optional. Perform this step, if you are not sure if you have Java 7 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.7.0_51"
| |
| − | OpenJDK Runtime Environment (IcedTea 2.4.4) (7u51-2.4.4-0ubuntu0.13.04.2)
| |
| − | OpenJDK 64-Bit Server VM (build 24.45-b08, mixed mode)
| |
| − | </pre>
| |
| − |
| |
| − | (The version should be 1.7 or later)
| |
| − |
| |
| − | === Download the tar.gz file ===
| |
| − | * Go to the [http://protege.stanford.edu/products.php#desktop-protege Products page] on the Protege website.
| |
| − | * Click the "Download for Linux" button to download the tar.gz file to your machine.
| |
| − |
| |
| − | To unpack the archive, either use your file explorer and double-click on the archive, and extract it to the desired location, or type in a terminal window:
| |
| − |
| |
| − | tar zxvf protege-5.0.0-beta-06_2014_05_20.tar.gz
| |
| − |
| |
| − | (the archive name might differ, please use the right file name that you downloaded.)
| |
| − |
| |
| − | === Launch Protege ===
| |
| − |
| |
| − | To launch Protege Desktop, double-click on the <code>run.sh</code> in the ''Protege folder'' in the file explorer, or type <code>run.sh</code> in a terminal window, once you have changed the directory to the Protege folder (<code>cd Your_Protege_folder</code>).
| |
| − |
| |
| − |
| |
| − | == Troubleshooting ==
| |
| − |
| |
| − | ''Q'': ''When I double-click on the run script, nothing happens, or I see a window that comes up, and goes away!''
| |
| | | | |
| − | ''A'': Try to run Protege from a console window and [http://protege.stanford.edu/support.php report back] the errors that show up in the console. In Windows, to start a console window, click on the ''Start menu'' and type <code>cmd</code> in the search box, then in the console, change the directory to where you unzipped Protege (for example, <code>cd "C:\Program Files\Protege_5.0_beta"</code>), and then type <code>run.bat</code>. To start a terminal window on Mac OS X, go in Finder -> Applications -> Utilities -> Terminal.
| + | == How to get help == |
| | | | |
| | + | 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. |
| | | | |
| − | ''Q'': ''When I try to run Protege with the run script, I get a <code>UnsupportedClassVersionError</code>, something like: <code>Exception in thread "main" java.lang.UnsupportedClassVersionError: Bad version number in .class file</code>'' | + | 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: |
| | | | |
| − | ''A'': Most likely you have an older Java version installed. You need to have at least Java 7 or later installed to run Protege desktop. Please see the documentation above on how to check which version of Java you have installed.
| |
| | | | |
| | + | * 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? |
| | | | |
| − | ''Q'': ''The Protege UI freezes occasionally on Linux with Open Java. Protege still seems to be running (CPU at normal levels), but I cannot click on any of the entities, tabs or menus.''
| |
| | | | |
| − | ''A'': There is a known bug in Open Java on Linux with parentless dialogs that will cause this behavior. The workaround is to use another Java implementation, like Oracle Java.
| + | The more detail you provide up front, the more helpful we can be in terms of a prompt response. |
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
Mac OSX
Linux
Platform Independent
