5 Managing an OMCe Stack

After you’ve created an Oracle Mobile Cloud Enterprise (OMCe) service, you’ll need to monitor various aspects of it. You can easily do this from the Oracle Cloud Stack Manager. You’ll be able to get a summary of your OMCe stack, view performance metrics, storage, and database information for the stack and for each resource used in the stack and any services associated with those resources. From the PaaS Service Manager Services page, you can view details for and monitor the operations for the individual components of the OMCe stack.

A cloud stack is a collection of related cloud services that you’ve provisioned. A single stack represents a complete OMCe environment (OMCe core, custom code components, Analytics, and Bots, which are the individual elements of the stack).

Sign in to Oracle Cloud Stack Manager, to see a summary of information for your OMCe service. Click a tab to get service and deployment, operation, and security information:

• Click the Stacks tab to create a stack and to see a summary of the resources currently being used and general service information for an existing stack:

  • Summary. For all existing stacks in this identity domain, you can see:

    • How many configured deployments you have.

    • The total number of Oracle CPUs (OCPUs) that are allocated across all your deployments.

    • How much memory is allocated across all your deployments.

    • The total amount of Oracle Compute Cloud Service storage is allocated across all your deployments.

    • The number of public IP addresses are allocated across all your deployments.

    • The list of existing stacks in this domain. For each stack, there is a link to the stack template, the date the stack was created, the OCPU, memory, and storage allocation for that stack, and the Manage this stack menu.

      Select the Show only failed attempts option to see only a list of stack creation and deletion jobs that failed. Click a job to see more information about it.

  • Stack Creation and Delete History. Expand this section to see a history of when stacks were created or deleted over the last 24 hours, the last seven days, or the last month. You can also choose to view all failed creation and deletion jobs.

• Click the Templates tab to view the details of the stack template. From the Templates tab, you can:

  • View the topology of a template.

  • Import or export a template.

  • Update or delete a template.

  Note:

  You should never alter an OMCe template. When you provision a service, use the supplied OMCe template.
• Click the Activity tab to view the operations for all of your OMCe stacks in the current identity domain. Use the Search Activity Log to filter your results by start time, range of time, service name, service type, the type of operation, and operation status.

  • See the time range for the listed activity results.

  • For each operation, view the type of operation, the service instance, the operation status, the start and end time of the operation, and who initiated that operation.

If you have questions, need assistance, or want to discuss your experiences with other users in the Oracle Cloud community, click the Contact Us () .

In addition, you can also manage your OMCe stack using the Platform-as-a-Service Manager Command-Line Interface (PSM CLI) or directly with REST APIs. See Managing OMCe with the PaaS CLI.

View Your OMCe Stack

As the service administrator, you can examine information about your OMCe service instance using Oracle Cloud Stack Manager.

To view information about the stack:

1. Sign in to the Oracle Cloud Stack Manager.

   You’ll need to provide the access information that you received in the Welcome email (the identity domain name and user name and password).

   You can see an overall summary of the OMCe stack, which lists the number of stacks, the of Oracle CPUs (OCPUs) in use, the amount of memory and storage used, and the number of public IPs used for the entire stack. In the Stack list, you can see the same information for each stack you’ve created.
2. Click on a stack icon or name to see its details.

   A stack overview is displays displaying resource, OCPU, memory, storage, and public IP allocated for the selected stack.

   For each resource, you can see its name, type, version, creation date, and the number of OCPUs, memory, and block storage that are allocated.

   Click the Action menu () for a resource to start, stop, or restart the resource.

   You start or stop all the resources listed by click the Start () or Stop () icon. Click () to view the stack template.

3. Click a resource name to see its details.
   You can see the latest information for the resource:

   • Service information, including status, compute shape, deployment type, version, and connect descriptor address.

   • Resource details, including host name, public IP address, the instance the resource runs, the OCPU, memory, and storage allocation.

   • Associated services, their name, service type, status, and the whether the resource is a member of an associated service or is hosted on the service.

   • The number of nodes in the resource and the partitions used and total partitions available.

   • The Administration panel shows the number of patches available. Click Administration to review patching information.

View Stack Activity

You can see if an operation on a stack has successfully completed or failed:

1. Sign in to Oracle Cloud Stack Manager.
2. Click the Activity tab.

   Use the filter field to search the stack activity log by start time, a specific time range, operation status, service name, service type, or operation.

Review the log table to see information for each operation in the stack, its service name and type, operation status, start and end times, and who initiated the operation.

Start and Stop an OMCe Stack

There are times when you need to stop OMCe resources within a stack. For instance, you’ll need to stop it when you need to apply a patch or debug some issue. Use Oracle Cloud Stack Manager to start and stop a stack. Dependencies between the resources in the stack determine the order in which they stop or start. You can also start and stop a single resource in the stack.

How Do I Start or Stop a Stack with the Console?

Use the Stack Manager UI to start or stop a stack:

1. Sign in to Oracle Cloud Stack Manager.

   If you’re viewing the details of a specific stack, you can also start or stop it from the Stack Details page.

2. Locate the stack you want to start or stop and open the Manage this service ( ) menu.
3. Select Start or Stop.

   Confirm your action in the dialog.

The stack’s icon changes to indicate that it’s in either the starting or stopping state. You can monitor the operation’s progress from the Activity page.

Deleting an OMCe Stack

You can delete a stack when you no longer need it to free up resources. Deleting a stack terminates all the resources in that stack.

How Do I Delete an OMCe Stack with the Console?

1. Sign in to Oracle Cloud Stack Manager.
2. On the Stacks tab, locate the stack that you want to delete.
3. Open the Manage this service () menu and select Delete.

   Click OK in the confirmation dialog.

Add a New SSH Public Key

Some Oracle Cloud resources are accessed through the Secure Shell (SSH) protocol. You provide a key when create such a resource. If you need to add more keys to a resource in your OMCe stack, you can add them with Oracle Cloud Stack Manager.

1. Sign in to Oracle Cloud Stack Manager and navigate to the Stacks page.
2. Click a stack icon or name to go to its Details page.
3. Click the Manage this resource menu () for the resource you want to update and select SSH Acess.
   This menu item only appears for resources accessed by an SSH Public Key.
4. On the SSH Access page, locate the resource and click Add New Key.
5. Add a new key in one of the following ways:

   • Upload a new SSH Public Key from an existing file.

   • Select the Key value option and paste the value of the new public key in the text pane.

6. Click Add New Key.

Return to the Stacks page by clicking Stacks in the navigation breadcrumb on the page.

Add an Access Rule

Set access rules to control access from external clients or other Oracle Cloud resources to the components that make up a resource. Default access rules are created by default by Oracle Cloud when the resource is provisioned; however, you can create custom rules to control access.

1. Sign in to Oracle Cloud Stack Manager and navigate to the Stacks page.
2. Click a stack icon or name to go to the Details page.
3. Click the Manage this resource menu for the resource you want to update and select Access Rules.
4. On the Access Rules page, click Create Rule.
5. Provide the following information:

   • A name for the Access Rule.

   • (Optional) A description of the rule.

   • Select a source. The source selections listed depend on the type and configuration of the resource.

   • Select a destination. Like the Source field, the destination selections listed depend on the type and configuration of the resource.

   • Enter the port or port range that the source uses to access the destination you selected.

   • Select a protocol type, either TCP or UDP.

6. Click Create.

Return to the Stacks page by clicking Stacks in the navigation breadcrumb on the page.