1. Home
  2. Launch on Oracle Cloud Infrastructure - OCI
  3. Launch Falcon Deploy on Oracle Cloud Infrastructure

Launch Falcon Deploy on Oracle Cloud Infrastructure

Autonomous Database Support

Look forward to our next release (coming soon) that has support for Autonomous Database on Oracle Cloud. Autonomous Database will be supported as a repository database and also as a database target for deployments.

Oracle Cloud Infrastructure – OCI

Oracle Cloud Infrastructure platform delivers unmatched reliability, scalability, and performance for mission-critical databases and applications.

Oracle Cloud Marketplace is the perfect place to quickly get started with Falcon Deploy application in minutes. When you launch Falcon Deploy application from Oracle Cloud Marketplace, you get a pre-installed, fully configured instance that you can start using with minimal steps.

Launch Falcon Deploy

Prerequisite

Compute instances in Oracle Cloud Infrastructure use an SSH key pair instead of a password to authenticate a remote user. You can use an existing key pair. If you don’t have one, refer to Oracle Cloud Infrastructure Documentation to create an SSH key pair.

You can launch Falcon Deploy from Oracle Cloud Marketplace portal or directly from Oracle Cloud Infrastructure console. We have listed both options below. Choose one to get started.

Deploy from Oracle Cloud Marketplace

To get started, navigate to Falcon Deploy listing in Oracle Cloud Marketplace and click on Get App. Follow the prompts and complete the process to let Oracle Cloud Marketplace deploy a Falcon Deploy instance in a compute instance in your cloud services account. The Oracle Cloud Infrastructure is a high performance platform and this step should only take few minutes to complete.

Deploy from Oracle Cloud Infrastructure

Login to your Oracle Cloud Infrastructure (OCI) Console. Click on Menu icon in the top left corner and select Marketplace. Select Falcon Deploy listing and click on Launch Instance. Follow the prompts and complete the process to let Oracle Cloud Infrastructure deploy a Falcon Deploy instance in a compute instance in your cloud services account.

Here’s what you get from the newly launched instance.

  • Oracle-Linux-7.6-2019.04.18-0
  • Linux User accounts and Groups preconfigured
  • Security permissions preconfigured
  • Storage and Directories preconfigured
  • Direct SSH access disabled for all Users except Oracle provided opc 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 you to make few changes to secure the instance.

Note IP Address

In your Oracle cloud account console, click on Menu (Bars) icon. Under Core Infrastructure section, click on Compute and then Instances. In the instances list page, click on your newly provisioned Falcon Deploy instance. This should take you to the Instance Details page. Make a note of the public IP address.

Enable Ports in VCN Security List

The Falcon Deploy server you launched has ports 8080 and 8443 opened already on the compute instance. You will have to open the above ports on your VCN’s security lists. In your VCN page, at the bottom left corner, look for Security Lists under the Resources section. Add a rule to allow 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 OCID. You can obtain the OCID from your Oracle Cloud Infrastructure Compute instance page.

# Falcon Deploy Application
http://ip_address:8080/falcon-deploy

# Tomcat Manager Application
http://ip_address:8080

Enable Boot volume backup

On the Instance Details page, at the bottom left corner you will find the Resources section. Click on Boot Volume and select the boot volume from the list. This should take you to the Boot Volume Details page. Look for Backup Policy and click on Assign. In the Assign Backup Policy pop-up, select Gold. Click on Assign Backup Policy button to save the policy.

Login to Falcon Deploy compute instance

Use SSH to login as opc user. Use the IP address captured earlier. Follow the step below if you are using a MAC or Linux operating system.

# Set private key permission to 400 
> chmod 400 /directory_path/private_key

# Login as opc user using private SSH key for your cloud instance
> ssh -i /directory_path/private_key opc@ip_address

If you are using Windows, follow the steps listed under Connecting to Your Linux Instance from a Windows System in the Oracle Cloud Infrastructure Documentation documentation.

Change Passwords

Since your Falcon Deploy instance comes with preinstalled software and configurations, we will secure your copy of the instance by changing few default passwords.

Tomcat Manager

Tomcat Manager is an easy to use web application to deploy and manage applications served by Apache Tomcat. Edit tomcat-users.xml file to change the pre-set password of Tomcat Admin user. Make a note of the password. You will need this password to access Tomcat manager via browser.

Note, the Tomcat Manager admin password is initially set to the OCID of your Oracle Cloud Infrastructure Compute instance.

# Edit tomcat-users.xml file and add the content in  tag
> sudo vi /opt/apache-tomcat-8.5.40/conf/tomcat-users.xml

<tomcat-users>
    <user username="admin" password="XXXXXXXX" roles="manager-gui,admin-gui"/>
</tomcat-users>

Operating system accounts

Change the falcon and tomcat operating system user password.

# Change the default password for OS accounts
> sudo passwd falcon
> sudo passwd tomcat

Configure SSL/ HTTPS

Follow the steps in the SSL document 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.

Oracle Database Cloud

We recommend you create the database using Oracle Database Cloud service in the same VCN/tenant as the Falcon Deploy compute instance. Create the database in a private subnet and ensure using Security Lists 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 Oracle Database Cloud 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;

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 OCI 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_19_3.

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 same falcon-deploy app from Tomcat Manager. This time, it will start the Falcon Deploy application.

Oracle Database Cloud

After the helper application completes, you have to 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 May 14, 2019