New Installation Instructions for Core GTAS on a Virtual Machine

[dje04001]

How to Install core GTAS in a VirtualBox Virtual Machine Running CentOS 7

A video deomonstrating how to install core GTAS is available on YouTube at the link below.

https://youtu.be/Jj1WeVz5Cpo

Requirements

Software

• VirtualBox
• CentOS-7-x86_64-DVD-1810.iso ( https://drive.google.com/drive/folders/1iKvAzWHzZCkZxReaMGL0vyjJW8k-67FX ) . This .iso file is 4GB
• Modern web browser (No Internet Explorer)

Additional Hardware Requirements for Virtual Machine (Minimum)

• 4 GB RAM for core GTAS application. More RAM is needed for ELK stack and Neo4j
• 14 GB disk space

Other

• The open internet

Installation

Step 1: Create Virtual Machine and Install CentOS 7

• Download the CentOS-7-x86_64-DVD-1810.iso if you haven't already
• Start VirtualBox application
• Click "New" in Oracle VM VirtualBox Manager
• Name your virtual machine. If you include CentOS it will automatically change to RedHat Linux (64-bit). It is probably the best choice since CentOS was derived from RHEL
• Click Continue
• Adjust RAM greater than or equal to 4GB and click "Continue"
• Select "Create virtual hard disk now" (default) and click "Create"
• Select "VDI (VirtualBox Disk Images)" and click Continue
• Select "Fixed size" (this is a preference, not a requirement) and click "Continue"
• Adjust disk space greater than or equal to 14GB and click "Create"
• Click "Settings" in the Oracle VM VirtualBox Manager
• Click "Display" and increase Video Memory to the maximum
• Click "Storage" and select the "Empty" disk under "Controller: IDE"
• Click the disk icon on the right of "Optical Drive:" under "Attributes"
• Select "choose a disk file" from the dropdown menu and select CentOS-7-x86_64-DVD-1810.iso and click "OK"
• Click "Start" in Oracle VM VirtualBox Manager to start virtual machine
• Wizard should default to the .iso selected previously. Click "Start"
• Select Install CentOS7 and press return
• Adjust screen size in menubar if necessary View>Virtual Screen 1>
• Select "SOFTWARE SELECTION" in "INSTALLATION SUMMARY" window
• in "Base Environment" select "GNOME Desktop" (other Add-Ons for Selected Environment are preferences, not requirements) and click "Done"
• Select "INSTALLATION DESTINATION" and click "Done"
• Select "NETWORK & HOST NAME" and click toggle next to "Ethernet" and click "Done"
• Click "Begin Installation"
• Click "ROOT PASSWORD" to set root password and click "Done"
• Click "USER CREATION" to create other users and click "Done"
• Wait for installation to complete and click "Reboot"
• Accept the License and click "Done"
• Click "FINISH CONFIGURATION"

Step 2: Install VirtualBox Guest Additions and Enable File Sharing

• Login as root under "Not listed?"
• Click "Devices>Insert Guest Additions CD Image" in menubar of Host Machine
• Click Run in wizard window to run installation script
• When prompted, press Return to close the window
• Devices>Shard Folders>Shared Folder Settings
• Click the "Add a folder" icon and select a path to the folder you want to share between your Host and your Virtual Machine. Select "Auto-mount" and "Make Permanent" and click "OK". Then Click "OK" on the next window
• The "sf_Desktop" drive should be visible on your Virtual Machine desktop
• Select Devices>Shared Clipboard>Bidirectional (preference, not requirement)
• Select Devices>Drag and Drop>Bidirectional (preference, not requirement)
• On the Oracle VirtualBox Manager, right click the VM and select close>Power Off and click "Power Off" in the popup.
• On the Oracle VirtualBox Manager, right click the VM and select Start>Normal Start (for bidirectional clipboard/drag and drop changes to take effect)

Step 3 : Install Oracle Java SE Development Kit 8u202

This will require registering as a user with Oracle. It's free.

• Open FireFox and copy this link into the address bar to navigate to Oracle's download page. https://www.oracle.com/java/technologies/javase/javase8-archive-downloads.html

• Download the jdk-8u202-linux-x64.rpm

• you will need to be logged in as root or use sudo to install java

• move it to the /opt directory by opening Terminal (right click on desktop) and running mv ~/Downloads/jdk-8u202-linux-x64.rpm /opt

• Go to /opt directory cd /opt/

• Run local install command yum localinstall jdk-8u202-linux-x64.rpm

• Type "y" when prompted in the installation wizard

• Run alternatives command alternatives --config java

• Select the correct number option for 8u202

• Check version by running the command java -version

Step 4: Install Apache Maven

• In the terminal, use the wget command to download Apache Maven wget https://us.mirrors.quenda.co/apache/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz
• Expand and install tar -xzvf apache-maven-3.6.3-bin.tar.gz
• Give ownership to the user chown -R root:root /opt/apache-maven-3.6.3/
• Add Maven to your paths echo 'export PATH=$PATH:/opt/apache-maven-3.6.3/bin' | sudo tee -a /etc/profile
• Refresh profile to enforce changes cd /etc/ . profile
• Change working directory back to /opt and check version to confirm installation and cd /opt/ mvn -version
• Check paths to ensure /opt/apache-maven-3.6.3/bin is there echo $PATH

Step 5: Install Apache ActiveMQ

• In the terminal, use the wget command to download Apache ActiveMQ wget http://archive.apache.org/dist/activemq/5.16.0/apache-activemq-5.16.0-bin.tar.gz
• Expand and install tar -xzvf apache-activemq-5.16.0-bin.tar.gz
• Start ActiveMQ ./apache-activemq-5.16.0/bin/activemq start
• Confirm installation and status by viewing in web browser http://localhost:8161/admin

user: admin password: admin

Step 6: Install Apache Tomcat

• In the terminal, use the wget command to download Apache Tomcat wget http://archive.apache.org/dist/tomcat/tomcat-9/v9.0.37/bin/apache-tomcat-9.0.37.tar.gz
• Expand and install tar -xzvf apache-tomcat-9.0.37.tar.gz

Step 7: Install MariaDB Client and Server

• update yum repositories sudo yum -y update
• modify MariaDB repo to select correct versions for GTAS use sudo tee /etc/yum.repos.d/MariaDB.repo<<EOF
• Copy and paste all of this text into the document editor and press "return"

[mariadb]
name = MariaDB
baseurl = http://yum.mariadb.org/10.4/centos7-amd64
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1
EOF

• Update the cache sudo yum makecache fast
• Download and install MariaDB server and client software sudo yum -y install MariaDB-server MariaDB-client
• Enable MariaDB as a service sudo systemctl enable --now mariadb
• Configure MariaDB installation sudo mysql_secure_installation
• Follow the prompts. Configure to suit your preferences

Step 8: Install GTAS from Source Code on GitHub

• Download the source code git clone --branch dev --single-branch https://github.com/US-CBP/GTAS.git

• To create the GTAS database, navigate to gtas-commons cd GTAS/gtas-parent/gtas-commons/

• Run the following command mvn clean install

• Run each of these commands sequentially, after the previous is successful mvn hibernate:update mvn hibernate:drop mvn hibernate:create

• check for creation of database and table population mysql -u root -p

• enter password from MaraiDB configuration

• Select GTAS database use gtas;

• check tables show tables;

• check user table select * from user;

• To compile .war files from source code, navigate to the gtas-parent directory cd /opt/GTAS/gtas-parent/

• Run clean install command mvn clean install

• Copy .war files and application.configuration file to the tomcat server cp /opt/GTAS/gtas-parent/gtas-job-scheduler-war/target/gtas-job-scheduler.war /opt/apache-tomcat-9.0.37/webapps/ cp /opt/GTAS/gtas-parent/gtas-webapp/target/gtas.war /opt/apache-tomcat-9.0.37/webapps/ cp /opt/GTAS/gtas-parent/gtas-commons/src/main/resources/default.application.properties /opt/apache-tomcat-9.0.37/conf/application.properties

• Create directories for messages. The best place for them is in the Host/Virutal Machine shared directory mkdir /media/sf_Desktop/in mkdir /media/sf_Desktop/working mkdir /media/sf_Desktop/out mkdir /media/sf_Desktop/error

• Change the directory addresses in "application.properties" for the file loader to match the directories made vim /opt/apache-tomcat-9.0.37/conf/application.properties

press "i" to insert make required edits to the doc press "esc" to stop press ":" to enter prompt type "wq" and press "enter" to write and quit

• change the directory addresses for the file loader to match the directories made (i.e. message.dir.origin=/media/sf_Desktop/in )

message.dir.origin=/media/sf_Desktop/in
message.dir.working=/media/sf_Desktop/working
message.dir.processed=/media/sf_Desktop/out
message.dir.error=/media/sf_Desktop/error

• To start the server, enter the command /opt/apache-tomcat-9.0.37/bin/catalina.sh run
• You can now access the GTAS webapp by opening a browser and navigating to: http://localhost:8080/gtas/login.html username: admin password: password

Step 9 Optional: Forward ports to access GTAS on Host Machine

• In the CentOS user interface, in the menu bar, go to firewall settings: Applications>Sundry>Firewall

• configuration permanent add 8080

• configuration runtime add 8080

• on Oracle VM VirtualBox Manager go to the menu bar on the Host Machine: Network>Advanced>Port Forwarding

• Add a rule

Name: webapp Protocol: TCP Host IP: 127.0.0.1 Host Port: 8080 Guest IP: 10.0.2.15 Guest Port: 8080

• Access the web application on your host machine at the address: http://127.0.0.1:8080/gtas/login.html username: admin password: password

[mfscripts]

The GTAS build process (step 8) requires the MySQL root user to have the password "admin" otherwise it'll fail. I'd recommend adding it to the guidance above.

[AlanMFortunaR]

Apache maven link is broker.

you can use this: https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz