5 Provisioning the Appliance

About the Appliance Provisioning Tool

Use the appliance provisioning tool to quickly launch a Oracle Cloud Infrastructure Compute Classic instance (virtual machine) with Oracle Cloud Infrastructure Storage Software Appliance pre-installed on the instance, and with all the required networking and storage settings.

The appliance provisioning tool is a Bash shell script (fscs.sh). The script takes a configuration file, in YAML format, as an argument. In the configuration file, you specify the parameters of the Oracle Cloud Infrastructure Compute Classic instance and Oracle Cloud Infrastructure Storage Software Appliance. When you run the script, it validates the parameters in the configuration file and uses the parameters to create an Oracle Cloud Infrastructure Compute Classic instance with Oracle Cloud Infrastructure Storage Software Appliance deployed on the instance.

Supported Platforms

The appliance provisioning tool is currently supported on Oracle Linux 6.6.

Command Syntax

./fscs.sh [-c|-r|-u|-d|-dd|-i|-l|-a|-v config_file]

Command Parameters

Parameter Description

-c

Creates an Oracle Cloud Infrastructure Compute Classic instance with Oracle Cloud Infrastructure Storage Software Appliance pre-installed on the instance.

See Creating the Appliance.

-r

Deletes and then re-creates the Oracle Cloud Infrastructure Compute Classic instance with Oracle Cloud Infrastructure Storage Software Appliance pre-installed on the instance.

See Re-creating the Appliance.

-u

Upgrades the operating system of the Oracle Cloud Infrastructure Compute Classic instance.

See Upgrading the Appliance.

-d

Deletes the Oracle Cloud Infrastructure Compute Classic instance.

See Deleting the Appliance.

-dd

Deletes the Oracle Cloud Infrastructure Compute Classic instance and the associated resources in Oracle Cloud Infrastructure Compute Classic (that is, the public IP address reservation, all the data disks, and the boot disk).

See Deleting the Appliance.

-i

Retrieves the public and private IP addresses of the Oracle Cloud Infrastructure Compute Classic instance.

-l

Downloads a system dump of the Oracle Cloud Infrastructure Compute Classic instance.

-a

Adds one or more data disks.

See Adding Data Disks to the Appliance Instance.

-v

Returns all the configuration properties of the appliance in a JSON-formatted text file.

If you contact Oracle for support, you may be asked to provide this file for diagnostics purposes.

config_file

The full path and name of the plain-text file, in YAML format, that specifies the parameters of the Oracle Cloud Infrastructure Compute Classic instance and Oracle Cloud Infrastructure Storage Software Appliance.

You must specify this argument with every option of the script.

See Appliance Configuration Parameters.

Creating the Appliance

This section describes how to create the appliance using the appliance provisioning tool and the appliance configuration file.

Before You Begin

  1. Ensure that the appliance configuration file is ready. See Preparing the Appliance Configuration File.

  2. Ensure that you have the latest version of the appliance provisioning tool. See Obtaining the Storage Software Appliance Image.

  3. Provide Execute permission to fscs.sh with chmod command.

Steps

  1. On the host on which you downloaded the appliance provisioning tool, go to the directory that contains the tool, and run the following command:

    ./fscs.sh -c config_file

    In this command, config_file is the full path and name of the appliance configuration file.

  2. The tool prompts you to enter the password for the Oracle Cloud Infrastructure Compute Classic user specified in the configuration file. Enter the password.

    The tool validates your credentials, and then does the following:
    1. Validates the parameters in the configuration file.

    2. Creates a boot disk.

    3. Creates the data disks specified in the configuration file.

    4. Reserves a fixed public IP address for the appliance instance.

    5. Creates an Oracle Cloud Infrastructure Compute Classic instance with Oracle Cloud Infrastructure Storage Software Appliance deployed on the instance.

    6. Starts Oracle Cloud Infrastructure Storage Software Appliance.

    This process may take a few minutes.

    Wait till you see a message like the following example:
    Creating Oracle Cloud Infrastructure Storage Software Appliance instance ... successful
    Extracting IP addresses ...
    Private IP address: 10.196.35.241
    Public IP address: 203.0.113.49
  3. Note the private and public IP addresses.

    Tip:

    At any time later, you can retrieve the IP addresses as described in Finding Out the IP Addresses of the Appliance Instance.
  4. If the tool prompts you to confirm whether you want to create your first filesystem while creating the appliance, enter n. This capability is deprecated and is not supported on Oracle Cloud Infrastructure Storage Software Appliance.

After the installation is complete, you can perform any of the operations for managing the appliance. See Managing the Appliance.

Tip:

Retain a copy of the configuration file. You'll need it to run any further operations on the appliance.

Next Tasks

  1. Log in to the management console of the appliance to create, manage, and monitor filesystems. See Logging In to the Management Console of the Appliance.

  2. On each of the client Oracle Cloud Infrastructure Compute Classic instances that you want to provide shared storage for, mount the filesystem. See Mounting Appliance FileSystems on Client Instances.