|
|
# Compatibility
|
|
|
The MP Gryphon toolset is compatible with Linux flavors and currently has limited support for Mac and Windows systems.
|
|
|
|
|
|
* **Linux flavors** - An installer is available for several Linux flavors.
|
|
|
* **Mac** - An installer is available. Newer Mac systems offer a limited demo mode (MacOS High Sierra 10.13.4 and newer).
|
|
|
* **Windows** - Windows support is currently not available. MP Gryphon may be accessed on Windows using a Linux emulator, see [Running Gryphon on Windows](Running Gryphon on Windows).
|
|
|
|
|
|
# Installing Gryphon
|
|
|
The Gryphon Python GUI works in tandem with the Monterey Phoenix V4 trace generator. To install these, download the MP Gryphon installer, make it executable, and then run it:
|
|
|
|
|
|
1. Browse to https://gitlab.nps.edu/monterey-phoenix/user-interfaces/gryphon/-/blob/master/install_mp.bash.
|
|
|
1. Click on the download icon near the upper right: ![download](uploads/509a7e72dfa75dded2c31b3cb70d0fdc/download.png) and save the installer in your Downloads folder.
|
|
|
1. In a terminal emulator command window ![terminal_emulator](uploads/2e92ad4cfa2db13bd7f47976ca2c184d/terminal_emulator.png) type this to make the installer executable:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
chmod +x install_mp.bash
|
|
|
|
|
|
1. Identify your operating system from the following table:
|
|
|
|
|
|
| Your OS | Use this |
|
|
|
| --- | --- |
|
|
|
| Ubuntu 20+ | ubuntu20 |
|
|
|
| Ubuntu 18 | ubuntu18 |
|
|
|
| Centos 8+ | centos8 |
|
|
|
| Centos 7 | centos7 |
|
|
|
| Older Mac OS | macos |
|
|
|
| Newer Mac OS (Gryphon only) | macos_demo |
|
|
|
|
|
|
1. Identify what version of Gryphon and Trace Generator you would like to use:
|
|
|
|
|
|
| | Latest stable | Latest under development |
|
|
|
| --- | --- | --- |
|
|
|
| Trace Generator | master | master |
|
|
|
| Gryphon | v0.5.0 | master |
|
|
|
|
|
|
1. Run the installer by typing `./install_mp.bash <OS> <trace-generator version> <Gryphon version>`. For example to install MP on Ubuntu 18 with Gryphon v0.5.0 and the latest trace-generator type:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash ubuntu18 master v0.5.0
|
|
|
|
|
|
or to install the latest Gryphon and Trace Generator code under development type:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash ubuntu18 master master
|
|
|
|
|
|
If the installer does not support your operating system, please suggest that one be made for it. For a reference of packages required by MP please see the installation steps that are most similar to your OS under "update packages" in the MP install file at https://gitlab.nps.edu/monterey-phoenix/user-interfaces/gryphon/-/blob/master/install_mp.bash.
|
|
|
|
|
|
### Special provisions
|
|
|
|
|
|
#### Centos 7
|
|
|
|
|
|
1. Download and run the MP installer for Centos 7 as described above.
|
|
|
|
|
|
1. The installer for Centos 7 additionally installs and sets up a Python environment for running Gryphon. Enable this environment by typing the following in a shell before starting Gryphon:
|
|
|
|
|
|
```bash
|
|
|
source /opt/rh/rh-python36/enable
|
|
|
source ~/python_gryphon_venv/bin/activate
|
|
|
```
|
|
|
1. Then run Gryphon:
|
|
|
```
|
|
|
cd ~/mp_gryphon/gryphon/python
|
|
|
./mp.py
|
|
|
```
|
|
|
|
|
|
Note: If you are running Centos 7 virtually from a .vdi image downloaded from virtualbox.org then configure it to reach the the network through your host OS by adding this text to the bottom of your virtual OS file `/etc/sysconfig/network-scrpts/ifcfg-enp0s3` and then rebooting your virtual OS:
|
|
|
|
|
|
DNS1=8.8.8.8
|
|
|
DNS2=8.8.4.4
|
|
|
ONBOOT=yes
|
|
|
|
|
|
#### Mac OS
|
|
|
MP Gryphon support may be limited depending on your Mac OS version.
|
|
|
|
|
|
Before running the MP installer, install Python3 from https://www.python.org/downloads/mac-osx/.
|
|
|
|
|
|
When running the MP installer, if Developer Tools is not installed, a pop-up will ask if you if you want it installed. If this is the case, install it and when done, re-run the MP installer.
|
|
|
|
|
|
##### High Sierra OS 10.13.4
|
|
|
Type:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash macos master master
|
|
|
|
|
|
##### Mojave OS 10.14
|
|
|
Disable automatic updates and then install older Xcode 9.4.1 available at https://download.developer.apple.com/Developer_Tools/Xcode_9.4.1/Xcode_9.4.1.xip, see https://stackoverflow.com/questions/52470524/xcode-9-support-on-macos-mojave. After installing Xcode 9.4.1 type:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash macos master master
|
|
|
|
|
|
##### Older than High Sierra 10.13.4
|
|
|
Might work, try typing:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash macos master master
|
|
|
|
|
|
##### Catalina 10.15 and newer
|
|
|
The Trace Generator is currently not available on newer Mac systems. However Gryphon may be run in demo mode and .gry files may be imported and viewed. Type:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash macos_demo master master
|
|
|
|
|
|
#### Ubuntu 20
|
|
|
The master branch of trace-generator currently does not build on Ubuntu 20. A temporary work-around is to install the unofficial `modernize_build` branch by running the MP installer as follows:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash ubuntu20 modernize_build master
|
|
|
|
|
|
#### Windows
|
|
|
See [Running Gryphon on Windows](Running Gryphon on Windows).
|
|
|
|
|
|
# Running Gryphon
|
|
|
To run the Gryphon GUI open a command window and type:
|
|
|
|
|
|
cd ~/mp_gryphon/gryphon/python
|
|
|
./mp.py
|
|
|
|
|
|
# Updating Gryphon
|
|
|
Re-run the MP installer to update Gryphon to the latest version. Alternatively, install a specific version of MP Gryphon using version parameters.
|
|
|
|
|
|
To just update Gryphon type:
|
|
|
|
|
|
cd ~/Downloads
|
|
|
./install_mp.bash gryphon_only master master
|
|
|
|