Providing Platform Images
Platform images are provided during Private Cloud Appliance installation, and new platform images might be provided during appliance upgrade or patching operations.
During installation, upgrade, and patching, new platform images are placed on the management
node in /nfs/shared_storage/oci_compute_images. During patching and upgrade,
you can run commands to make these images available to Compute Enclave users. See the patchOCIimages
command in "Patching Oracle Cloud Infrastructure Images" in the
Oracle Private Cloud Appliance Patching Guide, and the
upgradeOCIImages command in "Upgrading Oracle Cloud Infrastructure Images" in the Oracle Private Cloud Appliance Upgrade Guide.
The image import command described in Importing Platform Images also makes the images
available to Compute Enclave users. Run this
importPlatformImages command if images were not imported during patch or
upgrade, or you need to re-import images. You can also use this command to make custom images
available to all Compute Enclave users after you put the
image in /nfs/shared_storage/oci_compute_images on the management node.
During upgrade and patching, new versions of an image do not replace existing versions on the management node. If more than three versions of an image are available on the management node, only the newest three versions are shown when images are listed in the Compute Enclave. Older platform images are still available to users by specifying the image OCID.
Importing Platform Images
Run the importPlatformImages command to make all images that are in
/nfs/shared_storage/oci_compute_images on the management node also
available in all compartments in all tenancies in the Compute Enclave.
PCA-ADMIN> importPlatformImages Command: importPlatformImages Status: Running Time: 2022-11-10 17:35:20,345 UTC JobId: f21b9d86-ccf2-4bd3-bab9-04dc3adb2966
Use the JobId to get more detailed information about the job. In the
following example, no new images have been delivered:
PCA-ADMIN> show job id=f21b9d86-ccf2-4bd3-bab9-04dc3adb2966 Command: show job id=f21b9d86-ccf2-4bd3-bab9-04dc3adb2966 Status: Success Time: 2022-11-10 17:35:36,023 UTC Data: Id = f21b9d86-ccf2-4bd3-bab9-04dc3adb2966 Type = Job Done = true Name = OPERATION Progress Message = There are no new platform image files to import Run State = Succeeded Transcript = 2022-11-10 17:35:20.339 : Created job OPERATION Username = admin
Listing Platform Images
Use the listplatformImages command to list all platform images that have
been imported from the management node.
PCA-ADMIN> listplatformImages Data: id displayName lifecycleState -- ----------- -------------- ocid1.image.unique_ID uln-pca-Oracle-Linux-7.9-2024.05.29_0.oci AVAILABLE ocid1.image.unique_ID uln-pca-Oracle-Linux-8-2024.05.29_0.oci AVAILABLE ocid1.image.unique_ID uln-pca-Oracle-Linux-9-2024.05.29_0.oci AVAILABLE ocid1.image.unique_ID uln-pca-Oracle-Linux8-OKE-1.26.6-20240611.oci AVAILABLE ocid1.image.unique_ID uln-pca-Oracle-Linux8-OKE-1.27.7-20240602.oci AVAILABLE ocid1.image.unique_ID uln-pca-Oracle-Linux8-OKE-1.28.3-20240602.oci AVAILABLE ocid1.image.unique_ID uln-pca-Oracle-Solaris-11-2024.05.07_0.oci AVAILABLE
Compute Enclave users see the same
lifecycleState that listplatformImages shows. Shortly
after running importPlatformImages, both
listplatformImages and the Compute Enclave might show new images with lifecycleState
IMPORTING. When the importPlatformImages job is complete,
both listplatformImages and the Compute Enclave show the images as
AVAILABLE.
If you delete a platform image as shown in Deleting Platform Images, both
listplatformImages and the Compute Enclave show the image as DELETING or DELETED.
Deleting Platform Images
Use the following command to delete the specified platform image. The image shows as
DELETING and then DELETED in listplatformImages output and in the Compute Enclave, and eventually is not listed at all.
However, the image file is not deleted from the management node, and running the
importPlatformImages command re-imports the image so that the image is
again available in all compartments.
PCA-ADMIN> deleteplatformImage imageId=ocid1.image.unique_ID_7 JobId: 401567c3-3662-46bb-89d2-b7ad1541fa2d PCA-ADMIN> listplatformImages Data: id displayName lifecycleState -- ----------- -------------- ocid1.image.unique_ID uln-pca-Oracle-Linux-7.9-2024.05.29_0.oci AVAILABLE ocid1.image.unique_ID uln-pca-Oracle-Linux-8-2024.05.29_0.oci AVAILABLE [...] ocid1.image.unique_ID uln-pca-Oracle-Solaris-2024.05.07_0.oci DELETED