Oracle® Cloud

Using the Platform Services Console on Oracle Public Cloud Machine

17.2

E86640-01

April 2017

Documentation for developers that describes how to use the Platform Services console to view and manage multiple types of platform services. The Platform Services console is available in the Oracle Cloud Services application.

Oracle Cloud Using the Platform Services Console on Oracle Public Cloud Machine, 17.2

E86640-01

Copyright © 2016, Oracle and/or its affiliates. All rights reserved.

Primary Authors: Edwin Spear, Rob Gray

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Contents

Preface

- Audience

- Documentation Accessibility

- Related Resources

- Conventions

1 Understanding the Platform Services Console on Oracle Public Cloud Machine

2 Managing and Monitoring Your Service Instances

- Exploring the Services Page

- Viewing Summary Information

- Creating a New Platform Service

- Adding a New SSH Public Key to a Service

- Deleting a Service Instance

- Viewing the Service Create and Delete History

3 Tracking Service Activities

- Exploring the Platform Services Activity Page

- Monitoring Activity for Service Instances in an Identity Domain

4 Managing SSH Public Key Access

- Exploring the Platform Services SSH Access Page

- Managing SSH Access for Service Instances in an Identity Domain

Preface

The Oracle Cloud Services Platform Services console lets you view and manage multiple types of platform services. Using the Platform Services Console includes information and procedures to help you use the Platform Services console to manage your platform services.

Topics:

- Audience

- Documentation Accessibility

- Related Resources

- Conventions

Audience

Using the Platform Services Console is intended for developers who want to use the Platform Services console to view and manage multiple types of platform services. The Platform Services console is available in the Oracle Cloud Services application.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Related Resources

For more information, see these Oracle resources:

- Oracle Public Cloud Machine documentation in the Oracle Help Center:

http://docs.oracle.com

Conventions

The following text conventions are used in this document:

Convention

Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.

italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

1 Understanding the Platform Services Console on Oracle Public Cloud Machine

The Platform Services console provides easy access to functionality available to all Oracle Cloud Platform services.

What is the Platform Services Console?

The Platform Services console is a user interface that integrates common functionality across Oracle Cloud Platform Services. This is the interface that appears whenever you go to the console for a Platform Service. The console is characterized by three tabs integrated in a region of the user interface called the service banner:

This console is available for these Platform Services:

- Oracle Database Cloud Service

- Oracle Java Cloud Service

- Oracle SOA Cloud Service

What Can I Do With the Console?

The PSM console enables you to perform the following tasks:

- Provision new instances of your specific service and monitor all other service instances running in your identity domain, regardless of the service type; see Managing and Monitoring Your Service Instances.

- Track activity, for example service creation, service backups, rules creation and deletion, and so on, for all service instances running in your identity domain, regardless of the service type; see Tracking Service Activities.

- Locate, view, and manage SSH public keys for all service instances running in your identity domain, regardless of the service type; see Managing SSH Public Key Access.

How Do I Access the Console?

You can access the PSM console by following the service URL given to you either in an email or by your administrator. You must provide an identity domain, user name, and password to sign in. Check your email or contact your administrator for your sign-in credentials. You can also use the REST API instead of the console; see REST API for Oracle Java Cloud Service.

How Do I Get Support?

If you encounter any problems with the Platform Services Console, the following resources should help you resolve them:

- Follow the support instructions that were provided to you when you subscribed to OPCM .

- Visit the Oracle Help Center at http://docs.oracle.com/en/.

2 Managing and Monitoring Your Service Instances

Use the Services tab to create and manage Oracle Platform Services. The Services page provides quick access to common tasks including creating and deleting a service, modifying access rules, and uploading SSH public keys.

Topics

- Viewing Summary Information

- Creating a New Platform Service

- Viewing the Service Create and Delete History

- Deleting a Service Instance

Exploring the Services Page

Use the Service page to create, delete, monitor and manage all of the Oracle Cloud Platform services within your domain ID.

Service Page Functionality

By default, the Services page appears whenever you access the Platform Service console, It contains two panes of information:

- Summary pane, which summarizes activity for all of your configured Platform services. For more information, see Viewing Summary Information.

- Services pane, which lists and provides overview information for every Oracle Cloud Platform service running in your domain ID. You can also create and delete services, access administrative consoles, set access rules, and add SSH keys from within this pane. You can list all services on this pane or limit the display to services with a specific name or name pattern.
To see details about a specific service instance, click the service instance name or its icon. This will open the service instance’s overview page.

Additional topics in this chapter describe how to manage the service instances listed:

- Create a New Platform Service

- Add a New SSH Public Key to a Service

- Delete a Service Instance

- A subset of the Services pane is the Service create and delete history section, where you can see all service creation and deletion information for the domain ID. For more information, see Viewing the Service Create and Delete History.

What You See on the Services Page

The following table describes the key information shown on the Platform Services page.

Element

Description

Click this icon and select a specific cloud service. This page will display instances of this type of service only.

Welcome!

Click to view the Welcome page.

REST API

Click this link to access the RESTful Services API documentation for the specific service type.

Services

This section displays a list of all service instances in this identity domain.

Search by Service Name

Enter a full or partial service instance name. The resulting list includes only the service instances that contain this string in their service name.

Click to refresh the page. The date and time the page was last refreshed is displayed adjacent to this button.

Create Service

Click this button and select a type of service instance to create. Refer to the documentation for this service type for details on creating a new service instance.

Status icon for a service instance in this identity domain. The specific icon will vary according to the type of cloud service and its status (running, in progress, maintenance, failed, and so on). Click this icon to view the Instance Overview page.

service-name

Click the name of the service instance to view the Instance Overview page.

Status

Status of the service instance. Valid values include: In Progress, Maintenance, Terminating, Stopped, and Failed.

Click the status label to view progress messages.

Note:
Running service instances do not display this field.

Service Type

Type of cloud service used to create this service instance.

Subscription

Type of subscription used to create this service instance.

Version

Software version running within this service instance.

Edition

Software edition running within this service instance.

Created On

Date and time in UTC that the service instance was created.

OCPUs

Number of OCPUs allocated for the service instance.

Memory

Amount of memory in GBs allocated for this service instance.

Storage

Amount of storage in GBs allocated for this service instance.

Instance menu icon provides the following options:

- SSH Access—Manage public SSH keys for this service instance.

- Delete—Delete this service instance.

Service Create and Delete History

This section shows details about created or deleted service instances in this identity domain.

- Range—Specifies a range of days for which you are interested in viewing created and failed service instances.

- Show only failed attempts—Check this box if you want to see failed attempts only.

- Details—Click the name of the service instance or expand the Details section to display system messages logged during the creation or deletion process.

- Complete Cleanup— This button appears only if there are failed resources created during a successful auto-retry process. If you click this button, the failed resources are deleted. You might have to click the button again and wait, repeating this process until the button is no longer displayed.

- Retry Delete—This button appears only if an attempt to delete a failed service instances is unsuccessful. The software cleans up failed resources and tries again to delete the service instance. You might have to press the button again and wait, repeating this process until the button is no longer displayed.

Viewing Summary Information

You can view summary information about you configured Platform services on the Service tab’s Summary pane.

The Summary pane displays the following information about your configured Oracle Platform Services:

- Total number of service instances in this identity domain

- Total number of Oracle Compute Units (OCPUs) allocated across all service instances

- Total amount of memory in GBs allocated across all service instances

- Total amount of block storage in GBs allocated across all service instances

- Total number of public IP reservations allocated across all service instances

Hiding and Showing the Summary Pane

You can toggle the Summary panel off or on (the default state):

- To hide the Summary pane, select the Services tab and then click the Hide Summary () icon, as indicated here:

- To display a hidden Summary pane, click .

Creating a New Platform Service

The Create Service button lets you quickly create a service instance for your Oracle Cloud Platform Service.

To create a service instance, from the Services page:

1. Click Create Service (or, in the case of Oracle Application Container Cloud Service, Create Application).

2. From the drop-down menu, select the type of service you want to create.
The Service Creation wizard for the selected service appears.

3. Follow the instructions on the wizard. For more information, see the specific creation instructions for the selected service; for:

- Oracle Database Cloud Service, see Creating a Database Deployment in Using Oracle Database Cloud Service.

- Oracle Java Cloud Service, see Creating an Oracle Java Cloud Service Instance in Using Oracle Java Cloud Service.

Adding a New SSH Public Key to a Service

When accessing a service, a SSH key provides greater security than using a password alone. You can upload or paste a new SSH public key.

To add a new SSH public key to a service, from the Services page:

1. Click for the service and select SSH Access.

2. Select one of these options:

- Select Upload a new SSH Public Key value from file and then Browse to add a new SSH public key from an existing file.

- Select Key Value and then paste the new key value in the field.

3. Click Add New Key.

Deleting a Service Instance

Delete a service instance when it is no longer required.

To delete a service instance, from the Services page:

1. Click for the service and select Delete.

2. Click Delete.
The Delete Service dialog appears.

3. Fill in the necessary fields on the dialog and click Delete.

Viewing the Service Create and Delete History

View the service and delete history to view the services created and deleted in a specific period. You can also limit the view to failed attempts to create a service.

To view Service creation and deletion history, from the Services page:

1. Click next to Service Create and Delete History.

2. If necessary, select a period to filter the results by:

- Last 24 hours: displays the services created or deleted in the past 24 hours.

- Last 7 days: displays the services created or deleted in the past seven days.

- Last month: displays the services created or deleted in the last month.

3. To view only failed attempts to create a service, select Show only failed attempts .

4. To view system messages logged during the creation or deletion process, click the service name or next to Details

3 Tracking Service Activities

You can track the activity across multiple platform cloud services by using the Activity tab on the Platform Services page.

Topics

- Exploring the Platform Services Activity Page

- Monitoring Activity for Service Instances in an Identity Domain

Exploring the Platform Services Activity Page

Monitor the activity across multiple platform cloud services by using the Activity Page on the Platform Services console.

Activity Page Functionality

The Activity Page is divided into two sections:

- The Search Activity pane, from which you can specify search criteria that determines which services you will see. This criteria includes:

- Date and time range

- Activity status

- Service name and type

- Operation type

- The Results pane, which shows the results of the search operation. You can limit the number of results to return, per page, to five, ten 50 or 100.

for instructions on using this page, see Monitoring Activity for Service Instances in an Identity Domain.

What You See on the Activity Page

Element

Description

Start Time Range

Filters activity results to include only operations started within a specified time range. The range defaults to the previous 24 hours.

Status

Filters operations by status of the operation:

- All

- Scheduled

- Running

- Succeeded

- Failed

You can select any subset of status types. The default value is All.

Service Name

Filters the activity results to include operations only for the specified service instance. You can enter a full or partial service instance name.

Service Type

Filters the activity results to include operations only for instances of the specified service type. The default value is the current cloud service.

Operation

Filters the activity results to include selected types of operations. You can select any subset of the given operations. The default value is All.

Search

Searches for activities by applying the filters specified by the Start Time Range, Status, Service Name, Service Type and Operation fields, and displays activity results in the table.

Reset

Clears the Start Time Range and Service Name fields, and returns the Status and Operation fields to their default values.

Results per page

Specifies the number of results you want to view per page. The default value is 10.

Displays status messages for the given operation. Clicking on the resulting downward arrow hides the status messages.

Service Name

Shows the name of the service instance and its identity domain:

service_instance:identity_domain

You can sort the column in ascending or descending order.

Service Type

Shows the type of cloud service for this instance.

You can sort the column in ascending or descending order.

Operation

Shows the type of operation performed on the service instance.

You can sort the column in ascending or descending order.

Status

Shows the status of the operation performed on the service instance.

You can sort the column in ascending or descending order.

Start Time

Shows the time the operation started.

You can sort the column in ascending or descending order.

End Time

Shows the time the operation ended, if the operation is complete.

You can sort the column in ascending or descending order.

Initiated By

Shows the user that initiated the operation. The user can be any user in the identity domain who initiated the operation or, for certain operations such as automated backup, System.

You can sort the column in ascending or descending order.

Monitoring Activity for Service Instances in an Identity Domain

Use the Activity page to view activities for Oracle Cloud Platform Service instances in your identity domain. You can restrict the list of activities displayed by using search filters.

To monitor activities for your Oracle Cloud Platform Service instances:

1. From the Platform Service console, open the Activity tab.

2. By default, the Activity page shows the list of all activities started within the past 24 hours. To specify a start time range other than the default of the previous 24 hours, enter the desired time in the Start Time Range field.

3. To locate a specific activity, complete these fields in the Search Activity Log area:

- Start Time Range: Select the time range to search for operations started within a specified time range. The range defaults to the previous 24 hours.

- Status: Select the operation status. The default value is All.

- Service Name: Enter a full or partial service name to filter the results by a specific service name.

- Service Type: Select the service type to filter the results by a specific service type. The default value is the current cloud service.

- Operation: Select the operation to filter the results by a specific operation type. The default value is All.

Then click Search.

4. If necessary, you can limit the maximum number of search results by specifying that number in Results per page.

4 Managing SSH Public Key Access

You can locate, view, and manage SSH public keys for your Oracle platform services by using the Platform Services SSH Access page.

Topics

- Exploring the SSH Access Page

- Managing SSH Access for Service Instances in an Identity Domain

Exploring the Platform Services SSH Access Page

View and manage public SSH keys across multiple platform cloud services by using the SSH Access tab on the Platform Services page.

SSH Access Page Functionality

The SSH Access Page is divided into two sections:

- The Search Activity pane, from which you can specify the service name and type when you want to see SSH information for a specific service or group of services.

- The Results pane, which shows the results of the search operation. You can limit the number of results to return, per page, to five, ten 50 or 100.

For instructions on using this page, see Managing SSH Access for Service Instances in an Identity Domain.

What You See on the SSH Access Page

Element

Description

Service Name

Filters the results to include SSH keys only for the specified service instance. You can enter a full or partial service instance name.

Service Type

Filters the results to include SSH keys only for instances of the specified service type. The default value is the current cloud service.

Search

Searches for SSH keys by applying the filters specified by the Service Name and Service Type fields, and displays the results in the table.

Results per page

Specifies the number of results you want to view per page. The default value is 10.

Displays a description of an item in the results table. Clicking on the resulting downward arrow hides the description.

Service Name

Shows the name of the service instance.

Service Type

Shows the type of cloud service for this instance.

Last Update

Shows the most recent time the SSH keys for this instance were updated. When the credential update is in progress, an hourglass icon is displayed before the date/time, indicating that the service instance is in Maintenance mode.

Actions

Click the Add New Key button to add a new SSH public key to this instance. This button is grayed out when the key is in the process of being added..

Managing SSH Access for Service Instances in an Identity Domain

Use the SSH Access page to view and add SSH public keys for the Platform Services instances in your identity domain.

Adding a New SSH Public Key

If the SSH private key that you use to access a Platform Services instance becomes lost or corrupted, you can add a new public key to the service instance. You might also need to add a new public key to a service instance in order to comply with your organization’s security policies or regulations.

To add an SSH keys for your Platform Services instances:

1. On the SSH Access page, locate on the list of all service instances in your identity domain the instance for which you want to manage the SSH public key.
If necessary, filter the list of service instances by typing a Service Name or by selecting a Service Type.

2. In the Actions column for a specific instance, click Add New Key. When finished, click the Services link.
The Add New Key dialog is displayed, showing the value of the most recent SSH public key is shown.

3. Specify the new public key using one of the following methods:

- Select Upload a new SSH Public Key value and click Choose File to select a file that contains the public key.

- Select Key value. Delete the current key value and paste the new public key into the text area. Make sure the value does not contain line breaks or end with a line break.

4. Repeat this process to add SSH keys for other service instances.

For information about features on the SSH Access page, see Exploring the SSH Access Page.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2017, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Pre-General Availability Draft Documentation Notice

If this document is in public or private pre-General Availability status:

This documentation is in pre-General Availability status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Pre-General Availability Draft Documentation Notice

If this document is in private pre-General Availability status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your pre-General Availability trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.