|
|
| (9 intermediate revisions by one other user 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 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].
| |
| − | | |
| − | === Check for Java 7 (optional) ===
| |
| − | | |
| − | This step is optional. Perform this step if you aren't sure if Java 7 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:
| |
| − | | |
| − | | |
| − | [[Image:InstallP5_OracleJavaVersionDialog.png]]
| |
| − | | |
| − | | |
| − | ==== 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:
| |
| − | | |
| − | | |
| − | [[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.
| |
| − | | |
| − | === 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.
| |
| − | | |
| − | === 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:
| + | 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). |
| | | | |
| | + | === [[File:Win-logo.jpg|50px]] [[Instal_Protege5_Win|Windows]] === |
| | + | ''Includes the JRE, and works for 64-bit Windows platforms'' |
| | | | |
| − | [[Image:InstallP5_ExtractFilesDialog.png]] | + | === [[File:Mac-logo.jpg|50px]] [[Install_Protege5_Mac|Mac OSX]] === |
| | + | ''Includes the JRE, and works for 64-bit OSX platforms'' |
| | | | |
| | + | === [[File:Tux-logo.png|50px]] [[Install_Protege5_Linux|Linux]] === |
| | + | ''Includes the JRE, and works for 64-bit Linux platforms'' |
| | | | |
| − | Protege Desktop will be extracted to your selected destination into a folder called "Protege_5.0_beta":
| + | === [[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_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 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. Please consult the Oracle Java website for Java [http://www.java.com/en/download/help/mac_install.xml download and installation instructions].
| |
| − | | |
| − | === Check for Java 7 (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.
| |
| − | | |
| − | * 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 from the [http://protege.stanford.edu/products.php#desktop-protege main Protege website] 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 == | | == Troubleshooting == |
| | | | |
| − | ''Q'': ''When I double-click on the run script, nothing happens, or I see a window that comes up, and goes away!'' | + | ''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'': Try running Protege from a console and report any errors displayed in the console window on the [http://protege.stanford.edu/support.php#mailingListSupport Protege User Support mailing list].
| |
| − | | |
| − | * How to run Protege from the console on Windows:
| |
| − | ** Click the '''Start menu'''
| |
| − | ** Type <code>cmd</code> in the search box and press the Enter key
| |
| − | ** In the resulting Command Prompt, change to the directory where you unzipped Protege (e.g., <code>cd "C:\Program Files\Protege_5.0_beta"</code>)
| |
| − | ** Type <code>run.bat</code>.
| |
| − | | |
| − | * How to run Protege from the console on OS X:
| |
| − | ** Open Finder
| |
| − | ** Select Applications -> Utilities, then double-click on the Terminal application
| |
| − | ** In the resulting Terminal window, change to the directory where you unzipped Protege (e.g., <code>cd /Applications/Protege_5.0_beta</code>)
| |
| − | ** Type <code>sh run.command</code>
| |
| − | | |
| − | | |
| − | ''Q'': ''When I try to run Protege 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 7 or later. Please see the documentation above on how to check which version of Java is installed on your system.
| |
| − | | |
| − | | |
| − | ''Q'': ''The Protege UI occasionally freezes on Linux with Open Java. 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 use another Java implementation, e.g., Oracle Java. | + | ''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. |
| | | | |
| | | | |
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
