Preparing the Upgrade

Prepare to Execute Upgrade Factory

Upgrade Factory REST API Endpoint URI List

Prepare your list of REST API End point Uniform Resource Identifiers (URIs) by replacing <PUBLIC_IP> with the IP address which is assigned to your SCM OCI VM Instance:

• POST - http://<PUBLIC_IP>:<Port>/scm/api/v1.0/upgradefactory - To trigger upgrade process with payload
• GET - http://<PUBLIC_IP>:<Port>/scm/api/v1.0/upgradefactory - To get upgrade process status anytime
• DELETE - http://<PUBLIC_IP>:<Port>/scm/api/v1.0/upgradefactory - To cleanup upgrade env before triggering the fresh request
• PUT - http://<PUBLIC_IP>:<Port>/scm/api/v1.0/upgradefactory - To retrigger the upgrade from the failed point

Upload Files on OCI Object Storage Bucket (OSB)

To upload files to the bucket

1. Log on to Oracle Cloud.
2. Navigate to buckets and drill down on the Buckets Object Storage.
3. Pick your preferred compartment and region.
4. If you want to create a new bucket, click Create Bucket. Leave the default options untouched and click Create.
5. Drill down to the bucket name.
6. Click Upload and browse the dump or repository file, which you want to upload .
7. Click Upload at the bottom and wait for the upload to complete.

Create a Pre-Authenticated Request URL

To create a pre-authenticated request URL

1. Go to More options > Create pre authenticated request.
2. Select an expiration date of your choice or leave it default (one week).
3. Click Create pre authenticated request.
4. Copy the pre-authenticated request URL and keep it safe.
   Note: This pre-authenticated URL can be used to download files from the OSB until the request expires.

Set up Boomerang for REST API Calls

Boomerang is a client application used to trigger REST API calls. However, you can use any REST API client of your preference to trigger the API requests.

To set up Boomerang

1. Search for Boomerang SOAP REST Chrome extension on the Chrome browser.
2. Install the Boomerang Chrome extension.
3. Click the Chrome Extensions (next to the address bar on the chrome browser) or under Chrome > Options, and launch Boomerang.
4. In the Boomerang application, click New Request on the top.
5. Enter the API URI in the address bar of the application and select the input body format from the dropdown as JSON.
6. Enter the input payload data on the left pane and select the type of request (POST/GET/DELETE/....) you want to trigger from the dropdown.
7. To trigger the request, click Send. You will see the response in the right pane.
   Note:

   REST API endpoints are protected, and you need to enter a username and password.

   Enter these credentials:

   • USERNAME - admin

   • PASSWORD - get a token from the SCM instance by signing in with an SSH key. Go to the folder /home/opc/cmapp/UPGRADEFACTORY/config and view the api_creds.ini file.

   Make a note of the basic_auth_password.