Difference between revisions of "Install Protege5 Mac"

From Protege Wiki

Jump to: navigation, search
 
(18 intermediate revisions by 3 users not shown)
Line 6: Line 6:
 
'''[[Install_Protege5|Go to the main Protege 5 installation page]]'''
 
'''[[Install_Protege5|Go to the main Protege 5 installation page]]'''
  
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]]
 
  
 +
Protege Desktop 5.x.y is distributed in the form of a ZIP file from the [http://protege.stanford.edu/products.php#desktop-protege main Protege website], and includes the 64-bit Java Runtime Environment (JRE). So, it is not necessary to have Java pre-installed on your computer to run Protege.
  
 
== Download the ZIP file ==
 
== Download the ZIP file ==
 
* Go to the [http://protege.stanford.edu/products.php#desktop-protege Products page] on the Protege website.
 
* 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.
 
* Click the "Download for Mac OSX" button to download the ZIP file to your machine.
 
  
 
== Move Protege to Applications ==
 
== 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:
+
* Once the download completes, navigate to the folder where the ZIP file was downloaded. On a Mac, this will typically be your "Downloads" folder. Unpack it and you should see a Protege-5.x.y folder that contains the <code>Protégé.app</code>.
 
+
[[Image:InstallP5_DownloadsFolder.png]]
+
  
Drag the Protege_5.0_beta folder to the Applications directory.
+
* Drag the Protege_5.x.y folder to the Applications directory.
  
 +
Alternatively, you may also copy it to another folder (e.g., your own home folder).
  
 
== Launch Protege ==
 
== 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>).
+
To launch Protege Desktop, double-click the <code>Protégé.app</code> file in the root directory of the installation (<code>Applications/Protege_5.x.y</code>).
  
 +
== Allow Protege to run on macOS 10.12 (Sierra) and newer versions  ==
 +
The first time you will try to run the <code>Protégé.app</code>, you will get a warning:
  
== Allow Protege to run ==
+
[[File:MacOSXAppDamaged.png]]
The first time you will try to run the <code>run.command</code>, you will get a warning:
+
  
[[File:MacOSXWarning.png]]
+
To fix this issue, start Spotlight (press Command + Space), type "terminal", and select the <code>Terminal</code> application:
  
 +
[[File:MacOSXStartTerminal.png|600px]]
  
To allow Protege to run, go to your ''System Preferences'' (in the dock, or in Finder->Applications->System Preferences), and go to the ''Security & Privacy'', and then the ''General'' tab. It will look like this:
+
In the Terminal, type:
  
[[File:MacOSXSecurityPrefs.png]]
+
<pre>
 +
sudo xattr -cr /Applications/Protege-5.x.y/Protégé.app
 +
</pre>
  
 +
(replace x.y with the Protege version number)
  
Click on the button ''Open anyway'' and you will get to another dialog, like:
+
The prompt will ask for your password:
  
[[File:MacOSXWarning2.png]]
+
[[File:MacOSXxattr.png]]
  
 +
The next time you will start the Protege.app, you will not get the warning anymore.
  
Click on ''Open'' and Protege will start.
+
You can find [https://www.youtube.com/watch?v=6FF1c_7lnGo here] a short screencast that shows these steps for a generic application.
  
Alternatively, you may also select for the ''Allow apps downloaded from:'' the checkbox: ''Anywhere'' in the ''Security & Privacy'' preferences panel.
+
== Allow Protege to run on OS X 10.11 (El Capitan) and earlier versions  ==
 +
The first time you will try to run the <code>Protégé.app</code>, you may get a warning:
  
 +
[[File:MacOXWarningProtegeApp.png]]
  
= Troubleshooting =
+
If you get this warning, it means that your Mac's security setting doesn't allow unidentified software to run. There are several ways to allow an exception to the rule.The simplest way is to press the Control key and click on the Protégé.app icon, then choose and click on "Open" from the shortcut menu:
  
''Q'': ''When I double-click on the run script, nothing happens, or I see a window that comes up, and goes away!''
+
[[File:MacOSXOpenProtegeApp.png]]
  
''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].
+
You will get another warning:
  
* How to run Protege from the console on OS X:
+
[[File:MacOSXRunProtegeApp.png]]
** 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>
+
  
Then report the results back on the [http://protege.stanford.edu/support.php protege-user] mailing list.
+
Click on "Open" and Protégé.app will start. The application is saved as an exception to your security settings, and you can open it in the future by double-clicking it just as you can any registered app.
  
 +
For other ways of granting exception or of configuring your Mac's security setting, see Apple's support page [https://support.apple.com/kb/PH21769?locale=en_US].
  
  
 
'''[[Install_Protege5|Go to the main Protege 5 installation page]]'''
 
'''[[Install_Protege5|Go to the main Protege 5 installation page]]'''

Latest revision as of 22:01, March 14, 2017

[edit] Mac-logo.jpg Protege 5 Installation instructions for MacOSX

Contents


Go to the main Protege 5 installation page


Protege Desktop 5.x.y is distributed in the form of a ZIP file from the main Protege website, and includes the 64-bit Java Runtime Environment (JRE). So, it is not necessary to have Java pre-installed on your computer to run Protege.

[edit] Download the ZIP file

  • Go to the Products page on the Protege website.
  • Click the "Download for Mac OSX" button to download the ZIP file to your machine.

[edit] Move Protege to Applications

  • Once the download completes, navigate to the folder where the ZIP file was downloaded. On a Mac, this will typically be your "Downloads" folder. Unpack it and you should see a Protege-5.x.y folder that contains the Protégé.app.
  • Drag the Protege_5.x.y folder to the Applications directory.

Alternatively, you may also copy it to another folder (e.g., your own home folder).

[edit] Launch Protege

To launch Protege Desktop, double-click the Protégé.app file in the root directory of the installation (Applications/Protege_5.x.y).

[edit] Allow Protege to run on macOS 10.12 (Sierra) and newer versions

The first time you will try to run the Protégé.app, you will get a warning:

MacOSXAppDamaged.png

To fix this issue, start Spotlight (press Command + Space), type "terminal", and select the Terminal application:

MacOSXStartTerminal.png

In the Terminal, type:

sudo xattr -cr /Applications/Protege-5.x.y/Protégé.app

(replace x.y with the Protege version number)

The prompt will ask for your password:

MacOSXxattr.png

The next time you will start the Protege.app, you will not get the warning anymore.

You can find here a short screencast that shows these steps for a generic application.

[edit] Allow Protege to run on OS X 10.11 (El Capitan) and earlier versions

The first time you will try to run the Protégé.app, you may get a warning:

MacOXWarningProtegeApp.png

If you get this warning, it means that your Mac's security setting doesn't allow unidentified software to run. There are several ways to allow an exception to the rule.The simplest way is to press the Control key and click on the Protégé.app icon, then choose and click on "Open" from the shortcut menu:

MacOSXOpenProtegeApp.png

You will get another warning:

MacOSXRunProtegeApp.png

Click on "Open" and Protégé.app will start. The application is saved as an exception to your security settings, and you can open it in the future by double-clicking it just as you can any registered app.

For other ways of granting exception or of configuring your Mac's security setting, see Apple's support page [1].


Go to the main Protege 5 installation page

Personal tools