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
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.
- 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
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
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.
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 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
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.
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;
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
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 same
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!