Managing Repository

Cloud Manager provides an easy way to automatically download and manage PeopleSoft Application Update Images (PIs), PeopleSoft Release Patchsets (PRPs), PeopleTools Product Patches and PeopleSoft Custom Images. Cloud Manager uses file server created during bootstrap as a nfs repository to store downloaded artifacts from MOS. To streamline and automate downloads of various PeopleSoft application images and PRPs, Cloud Manager has introduced the new concept of Subscription Channels. Each PeopleSoft application has an associated Channel, which an administrator can choose to subscribe in order to download the latest PIs and PRPs for that particular PeopleSoft application. Cloud Manager is delivered with channels for PeopleSoft applications, which are available after you complete the installation and configuration. An administrator can subscribe to multiple channels and download all necessary PIs and PRPs that his organization needs.

Cloud Manager uses an application called Download Manager to download updates from MOS, which is invoked through process scheduler in asynchronous mode, every-time a channel is subscribed.

On the Repository tile, Administrators can:

  • Subscribe to release channels for latest PeopleSoft application updates.

  • Manage downloaded PeopleSoft Images and PRPs.

Page Name

Definition Page

Usage

Repository Tile

ECL_REPOSITORY_FL_GBL

(CREF for tile)

To access the various features such as, Channel Subscriptions and Download History, and functions such as, downloading logs and deleting downloads.

My Downloads Page

ECL_REPO_AMYDLS_FL

To view the PRPs and PIs downloaded. New entries are added as soon as new artifacts are downloaded.

Download Subscriptions Page

ECL_REPO_BCHNL_FL

To create download channels and subscribe them to initiate downloads. You can also use predefined download channels to initiate downloads.

Download History Page

ECL_REPO_BDLHIS_FL

To view the history of downloads, say PIs and PRPs downloaded.

Logs Page

ECL_REPO_MLOG_FL

To view the download manager logs.

Use the Repository tile to access the following features and functions:

  • View downloaded artifacts

  • Channel subscriptions

  • Download history

  • Download logs

  • Filter and delete downloads

Image: Repository Tile

This example illustrates the Repository Tile.

Repository Tile

Use the My Downloads page (ECL_REPO_AMYDLS_FL) to view the artifacts downloaded. New entries are added as soon as new artifacts are downloaded.

Image: My Downloads page

This example illustrates the fields and controls on the My Downloads page.

My Downloads Page

Note: Clicking on an item in the My Downloads page, displays additional details of the downloaded artifact.

Field or Control

Definition

Filter icon

Use the Filter icon to refine the search results based on search criteria.

Delete icon

Use the Delete icon to delete downloaded PIs and PRPs. Select the check box corresponding to the row you want to delete, and then click Delete button.

File Server Size

File Server capacity is a graphical display of the space available on the file server. You can manually increase the file server size as per requirement. .

Name

Name of the downloaded artifact.

Type

Indicates the artifact type such as PI, PRP, Custom Image, and the like.

Product

Indicates the PeopleSoft application product pillar.

Release

Indicates the PeopleSoft application release.

Version

Indicates the application PI version.

Platform

Indicates the Operating System platform such as Linux, windows.

Size

Total size of the PI or PRP.

Use the Download Subscriptions page (ECL_REPO_BCHNL_FL) to create download channels and subscribe to them to initiate downloads.

Note: Cloud Manager delivers default channels and those channels are available in the unsubscribed list of Download Subscriptions page.

Image: Download Subscriptions page

This example illustrates the fields and controls on the Download Subscriptions page.

Download Subscriptions Page

Field or Control

Definition

Related Actions button

To subscribe or unsubscribe channel, click the Related Actions button corresponding to channel name. If you select Subscribe option, Cloud Manager starts monitoring for any new PIs or PRPs and downloads them from My Oracle Support. If you select the Unsubscribe option, Cloud Manager will no longer monitor or download latest PIs or PRPs.

When a release channel is subscribed, cloud manager invokes download manager application which connects to MOS and downloads latest updates for the release channel. Please note that artifacts like Update Images are larger in size and takes few hours to download. User can view the status of active downloads from Download History page.

+

Click the + button to create a channel. For details on creating channels, see Download Subscriptions Page.

Subscribed tab

Use this tab to view a list of subscribed channels.

Unsubscribed tab

Use this tab to view a list of unsubscribed channels. By default, newly created download channels are listed under the Unsubscribed tab.

Downloading PeopleTools Patches

Cloud Manager can download previous PeopleTools patch releases for Tools channel. But for Application channels, only latest patches get downloaded.

In case of Tools channel subscription, you are presented with a modal window for selecting the patch version you want to download.

Image: Download Filter Modal Window

This example illustrates the fields and controls in Download Filter modal window.

Download Filter Modal Window

Enter the required product patch version in the Minimum Product Patch Number field. For example, if user enters 11 in this field, then CM will download tools patches 8.55.11, 8.55.12, 8.55.13 upto latest.

Use the Download History page (ECL_REPO_BDLHIS_FL) to view the history of downloads.

Note: The entries in Download History page are updated in every three minutes. Clicking on an entry in the Download History page, will show the current state of the download channel (that is, the list of files already downloaded, list of files in the download queue and those that are currently downloading).

Image: Download History page

This example illustrates the fields and controls on the Download History page.

Download History page

Field or Control

Definition

Channel Name

Name of the download channel.

Updates

Number of updates downloaded.

Start Time and End Time

Indicates the time when downloads are started/finished for the release channel.

Use the Logs page (ECL_REPO_MLOG_FL) to view the download logs corresponding to the subscribed channels. It displays download logs for all the files that get downloaded.

Image: Logs Page

This example illustrates the fields and controls on the Logs page.

Logs Page

Field or Control

Definition

Action

The related actions performed on the environment.

Log

Log of the related action performed.

Channel Name

Name of the subscribed channel.

Log File

Log files are generated when a file gets downloaded for a particular channel. Select an appropriate log file in this field.

Number of Lines to Display

Indicates how many lines of the selected log file need to be displayed.

Search String

Used to search for specific keywords in the log file. When user inputs a keyword, such as "ERROR" as an example, then only those lines are displayed which has an Error string in it. Here, only the specified number of lines are displayed.

Regex Search

Enables advanced searching, where a user can provide Unix style regular expressions.

Fetch Logs

Click this button to fetch log data based on the input provided by the user in the Logs page.

Log Data

Data from the logs.

This section details the process flow for subscribing channels using the Cloud Manager Repository.

Note: Cloud Manager has a process scheduler recurring job defined, which invokes download manager for all the subscribed release channels, once every week. This will make sure that latest updates for all the subscribed release channels are download once every week, without any user interaction.

Prerequisites

The administrator needs to define My Oracle Support credentials prior to subscribing channels using the Cloud Manager Repository. For this, perform the following:

  1. Select the Cloud Manager Settings tile.

  2. Edit the value in the User ID field and My Oracle Support password field in the My Oracle Support (MOS) Credentials section, as per requirement.

  3. Click Save Settings to save the details. For details on the Cloud Manager settings, see Cloud Manager Settings Tile.

Note: This is a one-time setup.

Perform the following steps to subscribe channels using the Cloud Manager Repository tile:

  1. Click the Repository home page available on the Cloud Manager home page.

  2. Select Download Subscriptions on the left panel. The Download Subscriptions page is displayed.

  3. Click Unsubscribed.

  4. To subscribe to the release channel, perform the following:

    1. Click the Related Actions button corresponding to channel name.

    2. Select Subscribe action. If there are any new updates, then the system starts downloading the new updates.

  5. To create a channel, perform the following:

    Note: If no channels are available by default, you need to create channels first followed by the subscribing channels procedure.

    1. Click on the '+' button to create a channel. The Create Channel modal window is displayed as shown.

      Image: Create Channel modal window

      This example illustrates the fields and control of the Create Channel modal window.

      Create Channel modal window
    2. Enter the Channel name and corresponding description.

    3. Select the Product name, release name and platform from the drop-down list.

    4. Select MOS from the Source field.

    5. Click Done to create the channel.

    Note: Downloading PIs and PRPs for a download channel, consumes time depending on the size of the artifacts. The status of the download can be viewed by clicking ‘New Updates’ on the Download Subscriptions page and also on the Download history page by clicking on the corresponding entry.

You can manually increase the file server size (using Logical Volumes).

Several steps in this process require you to access the file server through SSH. You can login to the file server by following the steps mentioned below:

  1. Login into CM through SSH.

  2. Find the CM SSH key in the CM VM (/home/psadm2/psft/data/cloud/OPChome/<OPC domain>/<OPC user id>.SSH).

  3. Login to the File Server VM via SSH as "OPC" user using the private key found in the previous step

Note: Use the sudo command to run administrative tasks.

If an existing file server is attached to a CM instance provisioned later, this login will not work. In such case, you need to add your personal public key to the file server manually after provisioning the file server for the first time

To manually increase the file server size, perform the following:

  1. Bring the file system offline.

    • SSH into CM VM. Please note the name of the  device which is mounted on /cm_psft_dpks(example: dev/xdvc), you will require this name in a later step) and then unmount it.

      umount /cm_psft_dpks 

    • SSH into the File Server VM and stop the NFS service and SMB service:

      /sbin/service nfs stop

      /sbin/service smb stop

    • In File Server VM , unmount the storage disk.

      umount /u01/app/oracle/product 

  2. Expand the Disk

    • Login to Oracle Compute Cloud Service Console.

    • Navigate to File Server instance, view instance details, and note down the name of the storage disk which is attached to the File Server.

  3. Navigate to Storage section, identify the disk associated with the file server (found in previous step).

  4. Click Update.

  5. Select the required size.

  6. Click Update to increase its size.

  7. Expand the File System

    In File Server VM, run the following commands to expand the file system in the attached disk.

    e2fsck -f /dev/<device name>

    resize2fs /dev/<device name>

    <device  name> is the device name of the mount in the File Server, for example: dev, xvdb.

  8. Bring the File System Online

    • In File Server VM , mount the expanded disk again with command:

      mount -a

    • In File Server VM, verify the new size with: 

      df -h /u01/app/oracle/product 

    • In File Server VM , start NFS service and SMB service (which you had stopped in the previous step): 

      /sbin/service nfs start 

      /sbin/service smb start 

    • In Cloud Manager VM , re-mount the File Server share with the following command : 

      mount -a