... | ... | @@ -9,40 +9,20 @@ The MP Gryphon toolset consists of the following: |
|
|
Gryphon is compatible with Mac, Windows, and Ubuntu Linux. For Mac and Windows, trace generation currently must be performed on a remote server. For Linux, trace generation is performed locally and does not need and Internet connection.
|
|
|
|
|
|
# Installing Gryphon
|
|
|
* **Windows, and Mac** installations currently require access to a Gryphon server to generate traces and to perform syntax checking. If you are on the NPS Intranet, please use the default server. Otherwise, use the AWS Server at 52.61.41.234 port 6000.
|
|
|
* **Linux** installations have the trace generator built in. Linux users generate traces without being connected to a Gryphon server or even to the Internet.
|
|
|
The installation approach is different based on the operating system you are using. **Windows** and **Mac** installations currently additionally require access to a Gryphon server to generate traces and to perform syntax checking.
|
|
|
|
|
|
## Windows, Mac M1 (Monterey), Mac x86 (Monterey)
|
|
|
## Windows
|
|
|
|
|
|
1. Download the latest Gryphon executable for your operating system from https://nps.box.com/s/dfzn0344l3h3q8jopdio1q0kt1ejctim. Use List View to see the full filenames as a list if the full filenames are cut off.
|
|
|
1. If desired, move the executable file to another folder. For example Mac users may want to move MP Gryphon to the Applications folder.
|
|
|
|
|
|
1. Mac users need to make the Gryphon file executable:
|
|
|
|
|
|
* For Mac, make the Gryphon file executable:
|
|
|
1. Open a terminal window:
|
|
|
* Click on Launchpad in the task bar.
|
|
|
* In the search area type in `Terminal`.
|
|
|
* Open a terminal window by clicking on the `>_` Terminal icon.
|
|
|
1. In the terminal window move to the folder containing the Gryphon executable using the "change directory" (`cd`) command, for example type `cd Downloads`.
|
|
|
1. Make MP Gryphon executable: type `chmod +x MP*`.
|
|
|
* Enable the file to be run: Using Finder, Control-click on the MP executable and select Open. After doing this once, you should be able to simply double-click on the MP executable to run it.
|
|
|
* If your Mac continues to block you from running MP Gryphon because it has set the quarantine flag on it, then you may need to turn off the quarantine flag:
|
|
|
1. In a terminal window, navigate to the folder containing the Gryphon executable, for example type `cd Downloads`.
|
|
|
1. Observe that the quarantine flag is set on this file: Type `xattr MP*` and observe that text `com.apple.quarantine` is in the list of its attributes.
|
|
|
1. Remove the quarantine flag by typing:
|
|
|
|
|
|
sudoxattr -d com.apple.quarantine MP*
|
|
|
1. If desired, move the executable file to another folder.
|
|
|
|
|
|
1. Download the latest preloaded examples .zip file, also from https://nps.app.box.com/folder/166624065458. You may need to right-click the .zip file to download it.
|
|
|
1. If desired, move the preloaded examples .zip file to another folder.
|
|
|
1. Unzip the preloaded examples .zip file.
|
|
|
1. To Run Gryphon, double-click on the MP Gryphon executable.
|
|
|
1. When Gryphon starts, set the preloaded examples path to the path where you unzipped the preloaded examples. You may change the preloaded examples path using the `Settings | Preloaded Examples Path...` menu option.
|
|
|
1. Connect Gryphon to the MP Gryphon server:
|
|
|
* If you have access to the NPS Intranet then use the default value. The default value may be selected using the `Restore Default` button reached using the `Settings | MP Gryphon Server...` menu option.
|
|
|
* If you do not have access to the NPS Intranet then use the public AWS Gryphon Server. Use the `Settings | MP Gryphon Server...` menu option and set the Gryphon server hostname to `52.61.41.234` and set the port number to `6000` shown here:
|
|
|
![AWS_Gryphon_Server_Endpoint](uploads/773673fe8e2d39d6d72e62ea5b9d0060/AWS_Gryphon_Server_Endpoint.png)
|
|
|
|
|
|
## Mac
|
|
|
|
|
|
## Ubuntu Linux
|
|
|
Download the MP Gryphon installer from https://gitlab.nps.edu/monterey-phoenix/user-interfaces/gryphon/-/blob/master/install_mp.bash. Make the installer executable and then run it by typing this in a command window ![terminal_emulator](uploads/2e92ad4cfa2db13bd7f47976ca2c184d/terminal_emulator.png):
|
... | ... | @@ -56,3 +36,28 @@ Once installed, run Gryphon from a command window by changing to the directory c |
|
|
cd ~/mp_gryphon/gryphon/python
|
|
|
./mp.py
|
|
|
|
|
|
# Connecting to the MP Gryphon Server
|
|
|
Windows and Mac users must connect to a MP Gryphon server. Several options are available:
|
|
|
|
|
|
| MP Gryphon server | Gryphon server hostname | Port |
|
|
|
| --- | --- | --- |
|
|
|
| NPS | podman01-srvhvp.ern.nps.edu | 8443 |
|
|
|
| AWS (Outside NPS) | 52.61.41.234 | 6000 |
|
|
|
| Same machine | localhost | 6000 |
|
|
|
|
|
|
* If you are connected to the NPS Intranet please use the NPS server. This is the default.
|
|
|
* If you are outside the NPS Intranet, use the Amazon Web Service (AWS) server.
|
|
|
* If you have the Gryphon server running locally through a Docker container, use "Same machine".
|
|
|
|
|
|
Select a server as follows:
|
|
|
|
|
|
1. Open MP Gryphon and click on the `Settings | MP Gryphon Server...` menu option.
|
|
|
1. Enter the Gryphon server hostname and port values.
|
|
|
1. Click `OK`.
|
|
|
|
|
|
This screenshot shows the configuration used for the AWS server:
|
|
|
|
|
|
![AWS_Gryphon_Server_Endpoint](uploads/773673fe8e2d39d6d72e62ea5b9d0060/AWS_Gryphon_Server_Endpoint.png)
|
|
|
|
|
|
# Pointing to the Preloaded Examples
|
|
|
Set the preloaded examples path to the `preloaded-examples` folder that you previously unzipped using the `Settings | Preloaded Examples Path...` menu option. |
|
|
\ No newline at end of file |