|
|
| (18 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]].
| |
| − | | |
| − | 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]].
| |
| − | | |
| − | === 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 possible ways to check your Java version on Windows.
| |
| − | | |
| − | ==== 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:
| |
| − | | |
| − | | |
| − | [[Image:InstallP5_AboutJava.png]]
| |
| − | | |
| − | | |
| − | 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.
| |
| − | | |
| − | | |
| − | === 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:
| + | 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). |
| | | | |
| − | tar zxvf protege-5.0.0-beta-06_2014_05_20.tar.gz
| + | === [[File:Win-logo.jpg|50px]] [[Instal_Protege5_Win|Windows]] === |
| | + | ''Includes the JRE, and works for 64-bit Windows platforms'' |
| | | | |
| − | (the archive name might differ, please use the right file name that you downloaded.)
| + | === [[File:Mac-logo.jpg|50px]] [[Install_Protege5_Mac|Mac OSX]] === |
| | + | ''Includes the JRE, and works for 64-bit OSX platforms'' |
| | | | |
| − | === Launch Protege === | + | === [[File:Tux-logo.png|50px]] [[Install_Protege5_Linux|Linux]] === |
| | + | ''Includes the JRE, and works for 64-bit Linux platforms'' |
| | | | |
| − | 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>).
| + | === [[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'' |
| | | | |
| | | | |
| | == 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 to run Protege from a console window and [http://protege.stanford.edu/support.php report back on the ''protege-user'' mailing list] 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. | + | ''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. |
| | | | |
| | | | |
| − | ''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>''
| + | == How to get help == |
| − | | |
| − | ''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.
| |
| | | | |
| | + | 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'': ''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.'' | + | 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'': 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.
| |
| | | | |
| | + | * 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? |
| | | | |
| − | == How to get help ==
| |
| | | | |
| − | If you have problems installing or running Protege Desktop, please take a look first at the [[Install_Protege5#Troubleshooting|Troubleshooting]] section. 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. If you cannot find the answers from these resources, please send an email on the [http://protege.stanford.edu/support.php ''protege-user'' mailing list] (you need to be subscribed to post), and be as specific as possible. Please let us know of: (1) your operating system, (2) java version, (3) what you were trying to do, including the steps, (4) the error messages that show up in the console or in the log files, and (5) the observed behavior. Please be as specific as possible, so that we can help effectively.
| + | 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
