An Oracle blog about PeopleSoft Technology

In previous blog, we set up OCI tenancy.  In this blog let us understand how to get Cloud Manager images into your tenancy.  In OCI Classic, Cloud Manager images can be easily downloaded into your identity domain simply by going to Oracle Cloud Marketplace and using the Get App feature. Currently there is not a similar capability for OCI. Instead, you must download the Cloud Manager OCI images to a local system and then upload them into an object storage bucket in your tenancy. 

Although you cannot use the Get App feature in Oracle Cloud Marketplace to automatically download the Cloud Manager Images into OCI, you begin in Oracle Cloud Marketplace to locate the Cloud Manager images for OCI.

Locate and Download the Images from My Oracle Support

To begin, go to Oracle Cloud Marketplace, search for Cloud Manager, and select the instance for PeopleSoft Cloud manager Image 06 for OCI, as shown in this example.

When you click on ‘Get App’ on this listing, you will be redirected to a My Oracle Support Knowledge Base document with links to the Cloud Manager Image 6.0 and a PeopleSoft Linux image.  The PeopleSoft Linux Image for Cloud Manager is an Oracle Linux 6.9 image that can be used to deploy PeopleSoft environments.  You can use this Linux image with no further changes to get started, or use it as a base image to create your own custom image by installing any packages that are required by your organization. 

You can download these images on any existing Linux or Microsoft Windows instance in OCI, or use your local on-premise system. To upload these images to your OCI tenancy, you must first install OCI Command Line Interface (CLI).   Since there are multiple methods to install and configure OCI CLI, let’s take a quick look at which one is best suited to upload Cloud Manager images to OCI object storage.

Install OCI CLI

Using the automated CLI installer is the easiest option.  Let’s assume that we are using an on-premise Linux desktop to download images.  You can also choose to use a Microsoft Windows desktop or laptop with the same approach.  For the Microsoft Windows desktop or laptop, there will be differences in the commands you will need to run, which is clearly documented here

To upload these images, you need to set up OCI CLI on the Linux desktop where you downloaded the images.  Login to the Linux desktop and follow the instructions below to install OCI CLI.  More details on installing OCI CLI can be found in the Oracle Cloud documentation.

  1. Open a terminal.
  2. To run the installer script, run the following command (all on one line).

bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"

  1. Respond to the installer's prompts. 

Configure OCI CLI

At this point, the OCI CLI is installed on your Linux desktop.  Now, you must configure it to work seamlessly with your OCI tenancy. 

To simplify configuration, use the setup dialog process, which walks you through the first-time setup process step-by-step. For the setup dialog process, use the oci setup config command, which prompts you for the information required for the config file and the API public/private keys. The setup dialog generates an API key pair and creates the config file. 

After setting up the OCI CLI, it is important to add the API public key to your user settings.  Log in to OCI web console and navigate to Identity > Users > <your user name> > Add Public Key.

Upload Cloud Manager Images to OCI

Now the OCI CLI setup is complete and we can use CLI to upload Cloud Manager images that were downloaded earlier. Using the OCI web console, create an object storage bucket. You can then upload the downloaded images into this bucket using OCI CLI.  The command to upload a file to an object storage bucket is as shown below.  Modify it to suit your tenancy and execute the command on the Linux desktop for each image file, to upload the downloaded images.

oci os object put  -ns <tenancy_name>  -bn <bucket_name>  --file <cm_image_file> --name <destination_file_name>  --no-multipart

Both Cloud Manager images take a while to upload.  After the upload is complete, follow the process explained in the OBE for Installing Cloud Manager in OCI to import them as custom images into your tenancy.