Cloud Software Library (CSWLIB) Management
This section provides tools for managing software images in Oracle Base Database Cloud@Customer environments. Commands like dbaascli cswlib deleteLocal allow for the removal of local images, while dbaascli cswlib download enables the download of new software images. You can also view available images locally with dbaascli cswlib listLocal or check all available Database and Grid Infrastructure images using dbaascli cswlib showImages. These commands help manage and maintain software libraries efficiently.
- dbaascli cswlib deleteLocal
- dbaascli cswlib download
- dbaascli cswlib listLocal
- dbaascli cswlib showImages
dbaascli cswlib deleteLocal
To delete the local image, use the dbaascli cswlib deleteLocal command.
Run the command as the root user.
Syntax:
dbaascli cswLib deleteLocal --imageTag <value>Parameters:
| Parameter | Description |
|---|---|
--imageTag |
specifies Oracle home image tag |
Frequently Asked Questions:
Q: What is the purpose of the dbaascli cswlib deleteLocal command?
A: The dbaascli cswlib deleteLocal command is used to delete a local Oracle home image from the system.
Q: What are the prerequisites for running the dbaascli cswlib deleteLocal command?
A: The command must be run as the root user to ensure the necessary permissions are available to delete the local image.
Q: How do I specify which local image to delete?
A: Use the --imageTag option to specify the Oracle home image tag that you want to delete.
Q: What does the –imageTag option represent in the command?
A: The --imageTag option represents the identifier or tag associated with the Oracle home image that you want to delete.
Q: Can I delete multiple local images at once using this command?
A: No, the dbaascli cswlib deleteLocal command allows you to delete only one local image at a time, specified by its image tag.
Q: What happens if I run the dbaascli cswlib deleteLocal command without specifying the –imageTag?
A: The command will fail because the --imageTag is required to identify which local image should be deleted.
Q: Is it possible to recover a local image after it has been deleted using this command?
A: No, once the local image is deleted using the dbaascli cswlib deleteLocal command, it cannot be recovered. Make sure to verify the image tag before proceeding.
Q: When would I need to use the dbaascli cswlib deleteLocal command?
A: You would use this command when you need to remove an unused or outdated Oracle home image from the local system to free up space or clean up your environment.
Example: dbaascli cswlib deletelocal
dbaascli cswlib deletelocal --imagetag 19.15.0.0.0
DBAAS CLI version MAIN
Executing command cswlib deletelocal --imagetag 19.15.0.0.0
Job id: 8b3e71de-4b81-4832-b49c-7f892179bb4f
Log file location: /var/opt/oracle/log/cswLib/deleteLocal/dbaastools_2022-07-18_10-00-02-AM_73658.log
dbaascli execution completeddbaascli cswlib download
To download available software images and make them available in your Oracle Base Database Cloud@Customer environment, use the dbaascli cswlib download command.
Prerequisites:
Run the command as the root user.
To use the utility, you must connect to an Oracle Base Database Cloud@Customer virtual machine.
See Connecting to a Virtual Machine with SSH.
Syntax:
dbaascli cswlib download --version | --imageTag
[--product]Parameters:
| Parameter | Description |
|---|---|
--version |
specifies an Oracle home image version |
--imageTag |
specifies the image tag of the image |
--product |
specifies the image type. Valid values: database or grid |
Frequently Asked Questions:
Q: What is the purpose of the dbaascli cswlib download command?
A: The dbaascli cswlib download command is used to download available software images and make them available in your Oracle Base Database Cloud@Customer.
Q: What are the prerequisites for running the dbaascli cswlib download command?
A: You must run the command as the root user. Additionally, you need to be connected to an Oracle Base Database Cloud@Customer virtual machine.
Q: How do I connect to the virtual machine required for this command?
A: You need to use SSH to connect to the Oracle Base Database Cloud@Customer virtual machine. Detailed instructions can be found in Connecting to a Virtual Machine with SSH.
Q: What does the –version option specify in the command?
A: The --version option specifies the Oracle home image version that you want to download.
Q: How do I use the –imageTag option in the dbaascli cswlib download command?
A: The --imageTag option is used to specify the image tag of the software image you want to download.
Q: What is the purpose of the –product option in the command?
A: The --product option specifies the type of image you want to download. The valid values are database or grid.
Q: Can I download both database and grid images simultaneously?
A: No, you must specify either database or grid using the --product option, so each download operation is specific to one type of image.
Q: What happens if I do not specify a version or image tag?
A: The command will likely fail or prompt you for the required information since the --version or --imageTag options are necessary to identify the specific software image to download.
Q: Is it necessary to specify both –version and –imageTag together?
A: No, you typically specify either --version or --imageTag depending on how you want to identify the image to download, but not both at the same time.
Q: When would I use the dbaascli cswlib download command?
A: You would use this command when you need to download Oracle home software images for database or grid environments in your Oracle Base Database Cloud@Customer setup.
Example: dbaascli cswlib download –product –imageTag
dbaascli cswlib download --product database --imageTag 19.14.0.0.0Example: dbaascli cswlib download –version 19.9.0.0.0
dbaascli cswlib download --product database --imageTag 19.14.0.0.0dbaascli cswlib listLocal
To view the list of locally available Database and Grid Infrastructure images, use the dbaascli cswlib listLocal command.
Run the command as the root user.
Syntax:
dbaascli cswLib listLocal [--product <value>]Parameters:
| Parameter | Description |
|---|---|
--product |
identifies Oracle home product type. Valid values: database or grid. |
Frequently Asked Questions:
Q: What is the purpose of the dbaascli cswlib listLocal command?
A: The dbaascli cswlib listLocal command is used to view the list of locally available Database and Grid Infrastructure images on your system.
Q: What are the prerequisites for running the dbaascli cswlib listLocal command?
A: The command must be run as the root user to have the necessary permissions to access and list the available images.
Q: How do I specify which type of images to list using this command?
A: Use the --product option to specify the type of Oracle home images you want to list. The valid values are database or grid.
Q: What does the –product option represent in the dbaascli cswlib listLocal command?
A: The --product option identifies the Oracle home product type, allowing you to filter the list of available images to either database or grid types.
Q: Can I list both database and grid images simultaneously?
A: No, the --product option allows you to list either database or grid images at a time. You need to run the command twice with different --product values to see both lists.
Q: What happens if I do not specify the –product option in the command?
A: If the --product option is not specified, the command might list all locally available images or it could require you to specify the product type. The outcome may depend on your environment setup.
Q: When should I use the dbaascli cswlib listLocal command?
A: You should use this command when you want to check which Database or Grid Infrastructure images are currently available locally on your system.
Q: How can I differentiate between database and grid images in the list?
A: The --product option lets you filter the list, so by specifying database or grid, you will only see the images relevant to that product type, making it easier to differentiate.
Q: Is there any risk associated with running the dbaascli cswlib listLocal command?
A: No, this command is non-destructive and only displays information about locally available images. It does not modify or delete any files.
Q: Does this command display remote or cloud-stored images?
A: No, the dbaascli cswlib listLocal command only displays images that are available locally on your system, not those stored remotely or in the cloud.
Example: dbaascli cswlib listlocal
dbaascli cswlib listlocal
DBAAS CLI version MAIN
Executing command cswlib listlocal
Job id: bc4f047c-0a34-4d4d-a1ea-21ddc2a9c627
Log file location: /var/opt/oracle/log/cswLib/listLocal/dbaastools_2022-07-18_10-29-53-AM_16077.log
############ List of Available Database Images #############
1.IMAGE_TAG=12.2.0.1.220419
IMAGE_SIZE=5GB
VERSION=12.2.0.1.220419
DESCRIPTION=12.2 APR 2022 DB Image
2.IMAGE_TAG=18.16.0.0.0
IMAGE_SIZE=6GB
VERSION=18.16.0.0.0
DESCRIPTION=18c OCT 2021 DB Image
3.IMAGE_TAG=19.14.0.0.0
IMAGE_SIZE=5GB
VERSION=19.14.0.0.0
DESCRIPTION=19c JAN 2022 DB Image
dbaascli execution completeddbaascli cswlib showImages
To view the list of available Database and Grid Infrastructure images, use the dbaascli cswlib showImages command.
Run the command as the root user.
Syntax:
dbaascli cswlib showImages
[--product]Parameters:
| Parameter | Description |
|---|---|
--product |
identifies Oracle home product type. Valid values: database or grid. |
Frequently Asked Questions:
Q: What is the purpose of the dbaascli cswlib showImages command?
A: The dbaascli cswlib showImages command is used to view the list of available Database and Grid Infrastructure images that can be downloaded or managed within your Oracle Base Database Cloud@Customer environment.
Q: What are the prerequisites for running the dbaascli cswlib showImages command?
A: The command must be run as the root user to ensure you have the necessary permissions to view the available images.
Q: How do I filter the images listed by this command?
A: You can filter the images by specifying the --product option with either database or grid to list only the images related to that product type.
Q: What does the –product option represent in the dbaascli cswlib showImages command?
A: The --product option identifies the Oracle home product type, allowing you to filter the list of images to either database or grid.
Q: Can I view both database and grid images in a single command execution?
A: No, you need to run the command twice with different --product values (database and grid) to view both types of images.
Q: What happens if I do not specify the –product option in the command?
A: If the --product option is not specified, the command may list all available images or it may prompt you to specify the product type, depending on your environment configuration.
Q: When should I use the dbaascli cswlib showImages command?
A: Use this command when you want to view the list of Database or Grid Infrastructure images that are available for download or deployment in your Oracle Base Database Cloud@Customer environment.
Q: Is there any difference between dbaascli cswlib showImages and dbaascli cswlib listLocal commands?
A: Yes, dbaascli cswlib showImages lists all available images that you can download or manage, while dbaascli cswlib listLocal lists only the images that are already downloaded and available locally on your system.
Q: Can this command be used to view images stored in the cloud?
A: Yes, this command can show images that are available for download from Oracle’s repositories, not just those that are stored locally.
Q: What type of images can I expect to see with this command?
A: You can expect to see images related to Oracle AI Database and Grid Infrastructure, which are essential components for managing and running Oracle databases.
Example: dbaascli cswlib showImages
dbaascli cswlib showImages