Installing Phoenix

Back to Main Page

Overview

This guide covers downloading, installing, and setting up Phoenix for the first time.

Downloading Phoenix

Customers download new versions of Phoenix from the FRG FTP site.

Consult your communications from FRG to get login info to access our FTP site. New Phoenix versions will be placed in your FTP directory on our server.

Installing Phoenix

Users should untar the latest Phoenix version by

> tar -C /usr/local -zxvf phoenix_version.tar.gz

Phoenix uses UDP port 45454 for interprocess communication. Open the port with the following command (CentOS 7 and higher)

> sudo firewall-cmd --add-port=45454/udp --permanent --zone=public
> sudo firewall-cmd --reload

and CentOS 6

> sudo iptables -I INPUT -p udp -m udp --dport 45454 -j ACCEPT
> sudo service iptables save

After Phoenix has been installed, run it with

> /usr/local/phoenix/PhoenixGUI.sh

Configuring MPI

The mpi.sh shell script (located /usr/local/phoenix/mpi.sh) will need to be modified to point to your compute nodes.

Please refer to the line with ‘mpirun’:

> mpirun -np 5 -bind-to none -host master,node1,node3,node2,node4 ./FRG_MPI

The number after ‘-np’ is the total number of nodes. It should match the total number of nodes listed after ‘-host’.

In this example, we use 5 nodes: master, node1, node2, node3, node4. You will need to modify this to use the hostnames of your compute nodes.

Configuring Phoenix

The first time users run Phoenix, they will need to specify a PhoenixData directory for Phoenix to save physics models, picks and various internal information to.

Picture of that here

After configuring Phoenix for the first time, users should consult the SegyImport guide to load their first dataset in.