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.
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.
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.38
- Apache Tomcat preconfigured to run as system service
- Oracle Instant Client 18.3
We recommend you to make few changes to secure the instance.
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.
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
Enable Boot volume backup
As a first step, lets enable automatic backups for the Boot volume.
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.38/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
tomcat operating system accounts come locked out of the box. Some steps are performed as falcon user during the initial setup. Unlock falcon user to complete the tasks. Ensure you lock it in the end.
# Lock falcon user > sudo usermod -s /sbin/nologin falcon
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.
Start Tomcat service
Your instance comes with Apache Tomcat preconfigured to run as system service. In this step, we will start the service.
# Start Tomcat service > sudo systemctl start tomcat.service > sudo systemctl status tomcat.service
Verify Tomcat using browser
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. Enter the
DNS/Hostname/IP followed by the port number. This should bring up Tomcat Manager.
Obtain Falcon Deploy software
Go to Falcon Deploy website to review pricing, complete subscription and download the latest version of the software. You will have to create an account by signing up if this is your first time visiting Falcon Deploy website. Select the subscription model that works for you and complete the subscription online.
Note, when processing payments, It is securely transmitted from the your browser to our PCI compliant payment processor. We do not store payment information on our servers.
Deploy the WAR file
falcon-deploy-<ver>.war file to
/tmp on the server.
# Copy the downloaded WAR file to /tmp on the server > cd /path_to_downloaded_war_file > scp -i /directory_path/private_key falcon-deploy-<ver>.war opc@ip_address:/tmp/.
https://DNS_or_Hostname_or_IP:8443/manager/html using a browser.
- Username: admin
- Password: The password you changed in step Change Password above. Note, the Tomcat Manager admin password is initially set to the OCID of your Oracle Cloud Infrastructure Compute instance.
Use Deploy directory or WAR file located on server section to deploy the WAR file.
- Context Path (required): /falcon-deploy
- WAR or Directory URL: /tmp/falcon-deploy-<ver>.war
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-<ver>.war file 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!