1. Home
  2. Launch on Amazon Web Services - AWS
  3. Launch Falcon Deploy Community Edition on AWS

Launch Falcon Deploy Community Edition on AWS

Autonomous Database Support

Falcon Deploy now includes support for Oracle Autonomous Databases on Oracle Cloud. Autonomous Database is supported as a repository database and also as a database target for deployments. Use the credentials.zip file that you download from Autonomous Database Cloud service.

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 8443.

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.

AWS RDS

We recommend creating the database using AWS RDS service in the same VPC as the Falcon Deploy compute instance. Create the database in a private subnet and ensure using Security Group that the database instance is accessible only from the Falcon Deploy compute instance (which was created on a public subnet).

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.

Helper Application

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 falcon database user/schema created in the previous step.
  • In the Primary and Backup location Configuration screen, enter the following.
    • The primary location should be /falcon_deploy/primary
    • The backup location should be /falcon_deploy/backup
    • The ORACLE_HOME location should be the path to the sqlplus executable. Oracle Instant Client is already installed in the provisioned host. The path in this field should be /opt/instantclient.

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.

AWS Instance

After the helper application completes, you have to stop/start Falcon Deploy application from Tomcat Manager. Upon application startup, Falcon Deploy will start creating database objects. Please allow few minutes for this step to complete.

Super Administrator

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!

Updated on June 5, 2019