1. Home
  2. Custom Installation
  3. Install Method 1 – Using bundled Tomcat Server

Install Method 1 – Using bundled Tomcat Server

In this method we will start and run Falcon Deploy web application using the Tomcat Server bundled with Falcon Deploy WAR file. This method does not require you to install or configure Tomcat or any other webserver or servlet container.

Note

Please ensure you have completed the steps listed in the Pre-Install document.

Pre-Installation Checklist

The checks below are done as falcon user.

Ensure FALCON_HOMEORACLE_HOMELD_LIBRARY_PATHJAVA_HOME environment variables are set.

# Check that you are logged in as 'falcon' user
> id
uid=11777(falcon) gid=11777(deploy) groups=11777(deploy),10(wheel)

# Check FALCON_HOME is set.
> echo $FALCON_HOME
/falcon_deploy/app

# Check ORACLE_HOME is set.
echo $ORACLE_HOME
/u01/app/oracle/product/instantclient_12_2

# Check LD_LIBRARY_PATH is set.
echo $LD_LIBRARY_PATH
/u01/app/oracle/product/instantclient_12_2

# Check JAVA_HOME is set.
echo $JAVA_HOME
/usr/lib/jvm/jre

If FALCON_HOME does not return the above value, refer to pre-installation document to complete the setup.

Next, ensure sqlplus is in the path.

> sqlplus

SQL*Plus: Release 12.2.0.1.0 Production on Wed Oct 17 17:39:49 2018

Copyright (c) 1982, 2016, Oracle.  All rights reserved.

Enter user-name:

If sqlplus is not working, check that you have completed the Oracle Client installation. If you have installed the Oracle full client it comes with sqlplus and is usually in the $ORACLE_HOME/bin directory. If you have installed the Oracle Instant Client, you have to download and install sqlplus separately. In this case, sqlplus can be in the root folder of $ORACLE_HOME.

Next, ensure java is in the path.

> java -version
openjdk version "1.8.0_181"
OpenJDK Runtime Environment (build 1.8.0_181-b13)
OpenJDK 64-Bit Server VM (build 25.181-b13, mixed mode)

Copy the downloaded falcon-deploy-ver.war to FALCON_HOME directory on the server. Once copied, update the permission of the WAR file. This step ensures WAR is executable and is accessible only to falcon user and deploy group.

> cd /falcon_deploy/app
> ls -ltr
-rwxr--r-- 1 root deploy 53387165 Oct 23 17:25 falcon-deploy-1.0.war

> sudo chown falcon:deploy falcon-deploy-1.0.war
> sudo chmod 770 falcon-deploy-1.0.war
> ls -ltr falcon-deploy-1.0.war
-rwxrwx--- 1 falcon deploy 53387165 Oct 23 17:25 falcon-deploy-1.0.war

Start using bundled Tomcat Server

As falcon user, start Falcon Deploy using java -jar. Falcon Deploy application will launch using the bundled Tomcat server.

> cd /falcon_deploy/app
> java -jar falcon-deploy-1.0.war &
[1] 4718
>
18:45:18.003 [main] INFO  com.Falcon.FalconApplication - Starting FalconApplication v1.0 on ip-10-0-1-248.ec2.internal with PID 4718 (/falcon_deploy/app/falcon-deploy-1.0.war started by falcon in /falcon_deploy/app)
18:45:28.486 [main] INFO  com.Falcon.FalconApplication - Started FalconApplication in 11.731 seconds (JVM running for 13.206)

That is all you have to do to launch the application.

Note, if a command is terminated by the control operator &, the shell executes the command in the background in a sub-shell. The shell does not wait for the command to finish, and the return status is 0.

Log File

Log file can be found at $FALCON_HOME/log/falconDeploy.log

Validation

Open a web browser and enter the address – the server and port where application is running. The address is of the form hostname:8080 or ip_address:8080.

This will launch the Falcon Deploy Installation and Configuration (Helper) application. If you see this screen, the installation is successful.

Post Install Step

Refer to the Post-Install document to complete the Falcon Deploy Installation and Configuration (Helper) Application. It is a mini web application bundled with Falcon Deploy application to help you complete the configurations with ease.

Updated on March 13, 2019

Related Articles