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

Launch Falcon Deploy on Oracle Cloud Marketplace

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.

  • Oracle-Linux-7.6-2019.01.17-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.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.

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

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.

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.

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.38/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

Lock falcon user

The falcon and 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

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.

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.

https://DNS_or_Hostname_or_IP:8443

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

Copy the 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/.

Go to 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.

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_18_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-<ver>.war file from Tomcat Manager. This time, it will start the Falcon Deploy application.

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 March 13, 2019