Troubleshooting for the IBM Cloud CLI
See solutions to common problems with using the IBM Cloud® Command Line Interface. Often, you can recover from these problems by following a few easy steps.
Why do I get a failure when updating the CLI, updating a plug-in, or installing a plug-in?
If you are attempting to update the IBM Cloud CLI, or update or install a plug-in with a CLI version lower than 2.0.0, you see an error similar to the following message.
An error occurred when fetching latest CLI info:
invalid character '<' looking for beginning of value
This error is caused by the older CLI version attempting to reach the deprecated CLI repo infrastructure.
Download and install or replace the older CLI with the latest CLI version by using these instructions.
Why do I get a failure with the plug-in update or install command after it has downloaded the binary?
If you are attempting to update or install a plug-in and the default downloads folder for your system lacks access rights, you see an error similar to the following message.
FAILED
Unable to obtain plug-in's metadata. Error: fork/exec/tmp/... : permission denied
This error is caused by the download folder or the temp folder on your system not having exec privileges.
There are multiple resolutions depending on your scenario:
- If the problem is with a download folder that is accessed with the
plugin download
command, modify the folder to have exec privileges. - If the problem is with the default download folder and you are unable to change the permissions, use the plugin download command to download to an alternative directory. Then use the plugin install command to install by using the downloaded binary file.
- If the temp folder on your system lacks executable privileges and cannot be modified, specify a different temp folder during plug-in installation or update. Set the environment variable
$TMPDIR
for Mac or Linux, and%TMP%
for Windows.
Why do I get a service broker error when I add the Object Storage capability?
The following error might be displayed if you use the CLI to create two apps with the Object Storage capability:
FAILED
Service broker error: {"description"=>"You can not create this Object Storage instance. Each organization using the Object Storage service is limited to one instance of the Free plan."}
This error is due to the Object Storage service, which provides only one instance of the free Object Storage plan.
Select a different plan.
Why does the ibmcloud catalog search command fail?
Running the ibmcloud catalog search
command displays the following error:
FAILED
'search' is not a registered command. See 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe catalog help'.
The ibmcloud catalog search
command was moved to a separate plug-in in v1.0.0.
To use this command, you must install the catalogs-management plug-in. For more information, see the Catalogs management CLI plug-in.