Difference between revisions of "Install Protege5 Mac"

From Protege Wiki

Jump to: navigation, search
(Launch Protege)
 
(7 intermediate revisions by 2 users not shown)
Line 7: Line 7:
  
  
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 includes the 64-bit Java Runtime Environment (JRE). So, it is not necessary to have Java pre-installed on your computer to run Protege.
+
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 downloaded. On a Mac, this will typically be your "Downloads" folder. Unpack it and you should see:
+
* 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>.
  
[[File:MacOSXInstalledProtegeFolder.png]]
+
* Drag the Protege_5.x.y folder to the Applications directory.
  
Drag the Protege_5.0.0 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>Protégé.app</code> file in the root directory of the installation (<code>Applications/Protege_5.0.0</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 ==
+
== 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 may get a warning:
+
The first time you will try to run the <code>Protégé.app</code>, you will get a warning:
  
[[File:MacOXWarningProtegeApp.png]]
+
[[File:MacOSXAppDamaged.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. Press the Control key and click the Protégé.app icon, then choose and click Open from the shortcut men:
+
To fix this issue, start Spotlight (press Command + Space), type "terminal", and select the <code>Terminal</code> application:
  
[[File:MacOSXOpenProtegeApp.png]]
+
[[File:MacOSXStartTerminal.png|600px]]
  
You will get another warning:
+
In the Terminal, type:
  
[[File:MacOSXRunProtegeApp.png]]
+
<pre>
 +
sudo xattr -cr /Applications/Protege-5.x.y/Protégé.app
 +
</pre>
  
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.
+
(replace x.y with the Protege version number)
  
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]
+
The prompt will ask for your password:
  
= Troubleshooting =
+
[[File:MacOSXxattr.png]]
  
''Q'': ''When I double-click on the run script, nothing happens, or I see a window that comes up, and goes away!''
+
The next time you will start the Protege.app, you will not get the warning anymore.
  
''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 can find [https://www.youtube.com/watch?v=6FF1c_7lnGo here] a short screencast that shows these steps for a generic application.
  
* How to run Protege from the console on OS X:
+
== Allow Protege to run on OS X 10.11 (El Capitan) and earlier versions  ==
** Open Finder
+
The first time you will try to run the <code>Protégé.app</code>, you may get a warning:
** 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.
+
[[File: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:
 +
 
 +
[[File:MacOSXOpenProtegeApp.png]]
 +
 
 +
You will get another warning:
 +
 
 +
[[File: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 [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 21: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