3 Plan Your OMCe Instance

Before you begin setting up an Oracle Mobile Cloud Enterprise(OMCe) instance, you should think about what you are going to use OMCe for and make a number of decisions, such as whether you need a database with Enterprise or High Performance packaging.

When you start to plan your OMCe instance, these are some of the things to consider:

• Do you want the full OMCe stack, which includes Bots and Analytics, or do you want a Bots-only stack? If you only want to work with Bots, you can create the instance using the Bots-only template.

• Are you are trying out OMCe to produce pilot applications or as proof of concept, or are you setting up a production environment? The database and OCPU requirements are different for each.

• How are you going to manage the conversation history that Bots will be writing to the database over time? Do you have a plan to archive and purge the data so that database limits aren’t breached. See Archive and Purge Bots Data.

Provisioning the Database for OMCe for Proof of Concept

If you want to try out OMCe and examine the features available and understand the concepts, and perhaps develop some trial applications, you can use these recommendations.

For a full OMCe stack you need:

• DB requirements (type and OCPU): Enterprise Package minimum

• OCPU for Oracle Event Hub Cloud Service: 1 for each environment

• OCPU for Oracle Big Data Cloud Service: 2 for each environment

For Bots-only you need:

• DB requirements (type and OCPU): Standard Package minimum

• OCPU for Oracle Event Hub Cloud Service: 1 for each environment

Provisioning the Database for a Production OMCe Environment

When you are confident that you want to create an OMCe environment suitable for a production environment, use these recommendations.

For a full OMCe stack you need:

• DB requirements (type and OCPU): Enterprise Package minimum, although if you’re planning to work with larger sets of analytics data then you should ensure that you start with a High Performance database that can handle analytics queries across larger data sets.

• OCPU for Oracle Event Hub Cloud Service: 1 for each environment

• OCPU for Oracle Big Data Cloud Service: 2 for each environment

For Bots-only you need:

• DB requirements (type and OCPU): Enterprise Package minimum

• OCPU for Oracle Event Hub Cloud Service: 1 for each environment

Logging In to Oracle Cloud Services

You use the Oracle Cloud MyServices applications dashboard to create and manage the OMCe stack and the services associated with it.

To log in:

1. In the email with the subject, Your Oracle Cloud Services Are Ready - Get Started Now, click the My Services Administration link. This is the one that starts with https://myservices-cacct-….
2. Sign in using the credentials in the email with the subject Welcome to Oracle Cloud – Infrastructure and Platform Free Promotion. If this is the first time you have signed in, you must set up a new password and the new password must match the password criteria that you’ll see listed.

The first time that you log in, you are taken to the Guided Journey page, which lets you explore different Oracle Cloud Services. Because you know you want to provision Oracle Mobile Cloud Enterprise, you can ignore the Guided Journey for now and click Dashboard in the header to access the MyServices dashboard.
Description of the illustration guided-journey.png

Do These Tasks First

Before you begin setting up an Oracle Mobile Cloud Enterprise (OMCe) instance, you have to provision the database and storage instances and carry out a few other tasks.

Important:

There are some tasks you must perform before you can create an OMCe stack:

1. If this is the first time you've created a service on Oracle Public Cloud, choose a georeplication policy.

2. Create a Storage Service admin user.

3. Provision Database Cloud Service, if needed.

Important Pre-Provisioning Tasks

Use this workflow as a guide to perform the tasks you must carry out before you can create and provision OMCe.

Task	Description
Set a georeplication policy for the storage service instance	If this is a new Cloud account and you’ve never set up a service, you must select a georeplication policy. If you’ve already set up at least one service, you can skip ahead to provisioning the database. Choose a georeplication policy that defines your primary data center and also specifies that your data should be replicated to a geographically distant (secondary) data center. See Selecting a Georeplication Policy for Your Storage Service Instance
Create a storage service admin user and update storage container settings	Create a Storage Service admin user for all the services you create. See Creating a Storage Service Admin User and Update Settings for the Storage Container
Create a database service and a storage service	From the Oracle Cloud My Services application, create a database service and specify the storage service to be used for backup. See Provisioning the Database Cloud Service

After you have carried out these tasks, the next step is to create the OMCe stack.

Selecting a Georeplication Policy for Your Storage Service Instance

If this is a brand new Cloud account and you’ve never set up a service, you must select a georeplication policy.

About Georeplication

You must choose a georeplication policy that defines your primary data center—which you can find in your Welcome email—and also specifies that your data should be replicated to a geographically distant (secondary) data center. Data is written to the primary data center and replicated asynchronously to the secondary data center. In addition to being billed for storage capacity used at each data center, you’ll also be billed for bandwidth used during replication between data centers.

Note:

Once you select a replication policy, you can’t change it, so select your policy carefully.

Selecting a Georeplication Policy

1. From the MyServices page, first select Customize Dashboard, then select Show for the Storage Classic service:

2. On the Dashboard, look for Storage Classic, and from select Open Service Console.

   This takes you to the Storage Services console. If you haven’t set a georeplication policy yet, you will be prompted to do so.

   
   Description of the illustration customize-dashboard.png

   For trials, the default value is sufficient. For paying accounts, see About Replication Policy for Your Account in Using Oracle Cloud Infrastructure Object Storage Classic for an explanation of the policies. You may not see all the policies described in the documentation, as availability is based on account type and service location. Selecting a policy can be confusing, but the main decision point is whether you need data replication (replication of files between data centers in the same region) or not. Only the policies that are available for your account type and service location are shown.

   Choose the replication policy based on your needs.

3. When you see the Storage Classic overview page, you’ve finished this procedure.

   
   Description of the illustration storage-overview.png

At a later date, you can see the georeplication policy that’s selected for your storage service instance. Sign in to the MyServices Dashboard. Expand Account Information. The details of your account are displayed in the Account Information pane. Look for the Georeplication Policy field.

Creating a Storage Service Admin User

Because storage service admin credentials are requested every time a service needs to access storage, we recommend that you create a dedicated storage admin to use across all services. The admin user’s credential is accessed very frequently—in fact, any time any service needs to access storage, the credential is required to authenticate. The credential (token) is also cached, so if you change this user’s password, storage access will actually fail, and the account will be locked.

WARNING:

After you use this storage admin user to create a service, do not change the password! Doing so will lead to runtime failures for these services.

To create a dedicated storage service admin user:

1. Click Users on the upper right corner of the MyServices Dashboard:

   
   Description of the illustration users-link.png

2. On the Dashboard, look for Storage Classic, and from select Open Service Console.

   This takes you to the Storage Services console. If you haven’t set a georeplication policy yet, you will be prompted to do so.

3. In the User Management page, click Identity Console.

   
   Description of the illustration user-management-page.png

4. On the Identity Console’s User tab, click Add.

5. Fill out the User Details. You need to use a different email address from your admin ID. Click Finish when complete.

6. Click the Applications tab.

7. In the search box, type Storage, then click Enter.

   You should now see the Storage service entry.

8. Click the storage service entry, then click the Application Roles tab.

9. Click the hamburger icon in the Storage_Administrator role entry, then click Assign Users:

   
   Description of the illustration assign-users.png

10. Select the checkbox next to the newly created user, and click Assign.

    The new user is assigned the Storage Service administrator role, and they will receive an email with instructions to activate the account. Make sure the account is activated before you proceed. You can test this by simply logging in using this account.

    
    Description of the illustration assigned-roles.png

Update Settings for the Storage Container

After you create the OMCe stack you must run commands to set the replication policy for storage account and set the storage container to allow anonymous read.

Use the cURL command-line tool to run commands to update settings for the storage container.

Install cURL

These steps describe the procedure on a Windows 64-bit system.

1. In your browser, navigate to the cURL home page at http://curl.haxx.se and click Download in the left navigation menu.

2. On the cURL Releases and Downloads page, locate the SSL-enabled version of the cURL software that corresponds to your operating system, click the link to download the ZIP file, and install the software.

3. Navigate to the cURL CA Certs page at http://curl.haxx.se/docs/caextract.html and download the ca-bundle.crt SSL CA certificate bundle in the folder where you installed cURL.

4. Open a command window, navigate to the directory where you installed cURL, and set the cURL environment variable, CURL_CA_BUNDLE, to the location of an SSL certificate authority (CA) certificate bundle. For example:

   C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt

There are four commands that need to be run. Run them in the order shown.

Storage Container - Setup Replication Policy

Run these commands to set the replication policy for storage account.

get token

curl -v -X GET -H 'X-Storage-User:Storage-<Cloud Account>:<User>' -H 'X-Storage-Pass:<Password>' <Storage URL>/auth/v1.0

Example

curl -v -X GET -H 'X-Storage-User: Storage-mjondcm208:[e-mail]' -H 'X-Storage-Pass: welcome1' https://foo.storage.oraclecloud.com/auth/v1.0

set policy

curl -v -X POST -H 'X-Auth-Token: <AUTH_Token>' -H 'X-Account-Meta-Policy-Georeplication: <Data Center>' <Storage URL> /v1/Storage-<Cloud Account>

Example

curl -v -X POST  -H 'X-Auth-Token:AUTH_tka2f992ca45781566f48f7e7332a92c77' -H 'X-Account-Meta-Policy-Georeplication: dc1' https://foo.storage.oraclecloud.com/MyService-bar

Storage Container - Set Anonymous Read

The storage container needs to set the anonymous read flag

set read flag

curl -v -X POST -H 'X-Auth-Token: <AUTH_Token>' -H 'X-Container-Read: .r:*,.rlistings' <Storage URL> /v1/Storage-<Cloud Account>

Example

curl -v -X POST  -H 'X-Auth-Token:AUTH_tka2f992ca45781566f48f7e7332a92c77' -H 'X-Container-Read: .r:*,.rlistings' https://foo.storage.oraclecloud.com/MyService-bar

Provisioning the Database Cloud Service

If you have already provisioned a Database Cloud Service and wish to use the same instance for OMCe, skip ahead to Set Up the OMCe Service. You’ll need to supply some database-related details when you get to the OMCe provisioning step, so make sure you have that information handy.

Database Cloud Service creation typically takes 1 to 2 hours.

1. Go to the MyServices dashboard.
2. Click Create Instance.
3. Click the Create button next to Database.
4. On the QuickStarts page, click Custom in the upper right corner to create a Database Cloud Service with custom configuration:
   Description of the illustration custom-database.png
5. In the Create Instance dialog, fill in the provisioning configuration details:

   1. Service Name: Name of the DBCS instance you’re creating. Choose a name that reflects its usage. The name has to be unique. It can be up to 50 characters, although it’s best to use a short name. It must start with a letter, and can contain only letters, numbers and hyphens (-). It cannot end with a hyphen (-).

   2. Description: Enter the purpose of this DBCS instance.

   3. Notification Email: This is the email account receiving DBCS instances event notifications. Enter the Admin’s email address.

   4. Region: This is the data center/region of the DBCS instance. See About Replication Policy for Your Account in Using Oracle Cloud Infrastructure Object Storage Classic for a mapping between data center code (e.g. uscom-central-1) and the actual location. The Region list contains only a subset of all data center codes. Select the data center location based on what you set up in the georeplication policy.

      Note:

      When you provision OMCe, you must select the same region that you select here.

   5. Bring Your Own License: If you are setting up a trial environment, select this to help save free trial credits.

      You may activate the Bring Your Own License (BYOL) version of OMCe and you will be charged the BYOL rate for the activated OMCe provided that you have sufficient supported on-premises licenses as required and specified in the Service Description for Oracle PaaS. See Overview of Oracle Cloud Subscriptions in Getting Started with Oracle Cloud.

   6. Software Release: The version of DBCS. Select Oracle Database 12c Release 2. Do not accept the default value.

   7. Software Edition: The edition of DBCS. Choose either Enterprise Edition - Enterprise or Enterprise Edition – High Performance. For most situations, an Enterprise Edition database is sufficient. High Performance Edition is recommended only if:

      • You plan to use Mobile/Bot Customer Analytics features, and

      • There will be a large amount of historical data.

      See Plan Your OMCe Instance.

   8. Database Type: Leave as the default Single Instance.

6. Click Next and fill in database configuration information:

   1. DB Name: Enter a name for the DB instance.

   2. PDB Name: The name of the PDB. Use the default value.

   3. Administration Password and Confirm Password: The password for SYS and SYSTEM database users, the admin Oracle GlassFish Server user, and the admin Oracle Application Express user.

      Note:

      The password must be alpha numeric and can contain the special characters $, # , _. However, the password must not start with a special character or a number, otherwise provisioning of some services will fail.

   4. Usable Database Storage: For OMCe, the storage service uses DB Storage, as they are stored as BLOBs. Leave as the default of 25GB.

   5. Compute Shape: The amount of resources allocated to this DBCS instance. See Classic Compute Shapes Available.

      Use the default, OC3.

   6. SSH Public Key: The public and private key pairs to use for DBCS SSH access. If you created a key pair previously, you can use it.

      To create a new public and private key pair:

      1. Click Edit, then Create a New Key. A public and private key pair are created.

      2. Click Download to download the key. Save the key for later use.

      3. Enter the public key in SSH Public Key.

7. Provide the information for backup and recovery:

   1. Backup Destination: The destination of the DBCS backup. Select Cloud Storage Only.

   2. Cloud Storage Container: Use the default value for the Cloud Storage Container name for your service instance backups. It has the format https://<account_name>.<country>.storage.oraclecloud.com/v1/Storage-<account_name>/DBaaS-DBname, where DBaaS-DBname is the container name. If you are recreating an OMCe stack, use a new container name.

      The container name must consist of UTF-8 characters only. The name can start with any character and can’t exceed 1061 bytes. Don’t include a slash (/), angled brackets (<>) , or strings (/../) in the name.

   3. User Name: This is the Storage Cloud Service Admin ID. Use the storage service user ID created in Creating a Storage Service Admin User. Do not use a real user’s ID.

   4. Password: Use the password for the storage service admin user.

   5. Create Cloud Storage Container: Select this to create the Cloud Storage Container.

8. Specify whether to initialize data from backup.

   Create Instance from Existing Backup: Specify whether the instance should be created from an existing backup. Choose No, unless you are really restoring from a previously DBCS instance.

9. Click Next and review the information you provided.
10. Click Create to kick off the database creation process.

    On the Database Cloud Service page, you’ll see your new database instance listed. When you see Creating instance …, you know that DBCS provisioning is taking place. DBCS creation typically takes 1-2 hours.

Once provisioned, you will see the service overview for DBCS. It should be started and ready to go.

Description of the illustration dbcs-overview.png