Amazon Web Services – AWS
Amazon Web Services (AWS) is a secure cloud services platform, offering compute power, database storage and several other functionalities as services to help businesses scale and grow. Millions of customers are currently leveraging AWS cloud products and solutions to build sophisticated applications with increased flexibility, scalability and reliability.
AWS Marketplace is a fast and easy way to get started with Falcon Deploy application in minutes. When you launch Falcon Deploy application from AWS Marketplace, you get a pre-installed, fully configured instance that you can start using with minimal steps. The instance is launched in your AWS Infrastructure as an Amazon EC2 Instance.
Deploy from AWS Marketplace
To get started, navigate to Falcon Deploy listing in AWS Marketplace and click on Continue to Subscribe. Follow the prompts and complete the process to let AWS Marketplace deploy a Falcon Deploy instance in a compute instance in your AWS account. AWS is a high performance platform and this step should only take few minutes to complete.
Here’s what you get from the newly launched instance.
- Amazon Linux 2, SSD – (64-bit x86)
- Linux User accounts and Groups preconfigured
- Security permissions preconfigured
- Storage and Directories preconfigured
- Direct SSH access disabled for all Users except AWS provided ec2-user account. You will use your SSH key to login to this account.
- Java version 1.8.0_202
- Apache Tomcat version 8.5.40
- Oracle Instant Client 19.3 (Certified with Oracle Database version 19c, 18c, 12.2, 12.1, 11.2)
- Apache Tomcat preconfigured to run as system service
- Falcon Deploy Community Edition 1.3.1
We recommend few changes to secure your instance.
Note IP Address
In your AWS EC2 console, click on your newly provisioned Falcon Deploy instance. Make a note of the public IP address. Also make a note of the Instance Id.
Enable Ports in VPC Security Group
AWS Marketplace should open the following ports in the Default Security Group assigned to the Falcon Deploy Instance. Look for a rule that allows connections using protocol TCP on HTTP port
8080 and HTTPS port
8443. Once you add a certificate (discussed below), you will only need access enabled on HTTPS port
Test your Falcon Deploy Compute Instance
Falcon Deploy application is ready to use immediately after launching the instance. Lets test the instance in this step before making changes listed in this document. Use a modern web browser and enter the http address listed below.
Note: Tomcat Manager Application will require a username and password. The username is admin and password is your Instance ID. Use the instance id you noted in the previous step.
# Tomcat Manager Application http://ip_address:8080 # Falcon Deploy Application http://ip_address:8080/falcon-deploy
Login to Falcon Deploy compute instance
Use SSH to login as
ec2-user user. Use the IP address captured earlier. Follow the step below if you are using a MAC or Linux operating system.
# Perform in your Local machine - Set private key permission to 400 > chmod 400 /directory_path/private_key # Perform in your Local machine - Login as ec2-user user using private SSH key for your cloud instance > ssh -i /directory_path/private_key ec2-user@ip_address
Instructions for Microsoft Windows operating system can be found here.
Configure SSL/ HTTPS
Follow the steps in the SSL documents referenced below to enable HTTPS. We recommend you to get a CA signed certificate. You may create a self signed certificate temporarily.
Verify SSL/ HTTPS
Falcon Deploy is configured to run on HTTP port
8080 or HTTPS port
8443. If you have enabled SSL, the application will be available only via HTTPS port.
# Falcon Deploy Application https://DNS_or_Hostname_or_IP:8443/falcon-deploy # Tomcat Manager Application https://DNS_or_Hostname_or_IP:8443
Database Configuration – Falcon Schema
In this step we will create a falcon schema that will store the metadata for the Falcon Deploy application.
Falcon Deploy application will automatically create all the required schema objects when it starts the first time (after helper application configuration done in the next step). As a pre-installation requirement, you only need to create an empty schema in an Oracle Database that is accessible from the Falcon Deploy compute instance.
It is not a requirement to use AWS RDS service. You can create this schema in any Oracle Database accessible to the Falcon Deploy compute instance.
If using OMF, the example below will create a falcon tablespace with 100M datafile that will autoextend to 30G.
SQL> CREATE TABLESPACE falcon DATAFILE AUTOEXTEND ON MAXSIZE 30G;
If OMF and ASM is not used, the example below will create a falcon tablespace with 100M datafile that will auto extend to 30G. Please make sure to change the path to match your storage location.
SQL> CREATE TABLESPACE falcon DATAFILE '/u01/app/oracle/oradata/orcl/falcon01.dbf' SIZE 100M AUTOEXTEND ON MAXSIZE 30G;
Create the falcon user. Please make sure to change the password to a strong password.
SQL> CREATE USER falcon IDENTIFIED BY password DEFAULT TABLESPACE falcon TEMPORARY TABLESPACE temp; SQL> ALTER USER falcon QUOTA UNLIMITED ON falcon; SQL> GRANT CONNECT, RESOURCE TO falcon;
Enable Ports in VPC Security Group
If your Falcon Deploy database schema was provisioned in AWS Infrastructure, enable port 1521 (or the custom port used) in VPC security group to accept connections from Falcon Deploy compute instance that was provisioned earlier.
In the Tomcat Manager application, click on /falcon-deploy under Applications (Path) to access the Falcon Deploy application.
Alternatively, you can access it directly by going to
https://DNS_or_Hostname_or_IP:8443/falcon-deploy using a browser.
The helper application will run the very first time you start the application. This application will help you configure database, storage directories, path to sqlplus executable, password encryption salt and email server.
Refer to our post-install guide to complete the helper application. Please note the following for AWS instances.
- In the Database Configuration screen, use the connection string, username and password of the
falcondatabase user/schema created in the previous step.
- In the Primary and Backup location Configuration screen, enter the following.
- The primary location should be
- The backup location should be
ORACLE_HOMElocation should be the path to the
sqlplusexecutable. Oracle Instant Client is already installed in the provisioned host. The path in this field should be
- The primary location should be
Restart to launch Falcon Deploy
After completing the helper application, we are ready to bring up the Falcon Deploy application. Simply stop and start the
falcon-deploy app from Tomcat Manager. This time, it will start the Falcon Deploy application.
The first page that loads when starting up Falcon Deploy application is the Super Admin Sign Up Form. Please complete the form and Submit to get started.
Checkout our articles and documentation in the knowledge base to get started using Falcon Deploy.
Contact us if you need any further information. Happy Deploying!