Troubleshooting virtual server instances for VPC

Permissions not set up in IBM Cloud

Before you can create Virtual Servers for VPC, you need to set up the correct permissions in IBM Cloud console. If your permissions are not correct, you can create a server and it shows Pending status, which quickly turns into Failed status. Make sure that the administrator of the account assigns you the correct permissions.

Servers are all in Unknown status

Most likely you do not have adequate permissions to view the server status. Make sure that you have the correct permissions.

The Unknown status also might be caused by an expired IMS token. Run bx sl init again and rebuild the ims_subject with the new token. Make sure that you are passing in the X-Subject-Token:$ims_subject parameter in the request header.

Error: 409 Conflict when you create an instance action

You can't create certain instance actions if the status of your instance is in conflict with another action. For example, if your instance status is stopped, and you try to create a reboot action, the system returns a 409 error.

Instance not responding to instance-reboot request

If your instance is not responding to an instance-reboot request, you can try an instance-reset request. The instance-reboot request sends an OS-reboot request to the instance, while an instance-reset request performs a hard reset of the virtual server instance. You can think of the difference as typing "ctrl-alt-delete" on your computer's keyboard versus pressing the reset or power button. Remember that the instance-reset request takes longer to complete than the instance-reboot request.

Why can't I add my SSH key?

If you try to add an SSH key to your account and get an error that the key can't be parsed, ensure there are no line breaks in the string. An SSH key is a continuous string of characters; sometimes line breaks are introduced when the SSH key is copied from a terminal. To avoid this issue, first paste your SSH key into a text editor and remove any line breaks. Then, copy the SSH key from the text editor and paste it into the VPC UI, CLI, or API.

How do I reregister a RHEL virtual server instance?

If you see this error message:

This system is not registered with an entitlement server.

Your REHL virtual server instance was unregistered from the capsule server. To resolve this issue, run the reregister-ng-rhel-vsi.sh script to reregister the virtual server instance.

#!/bin/bash
##
## =============================================================================
## IBM Confidential
## © Copyright IBM Corp. 2020
##
## The source code for this program is not published or otherwise divested of
## its trade secrets, irrespective of what has been deposited with the
## U.S. Copyright Office.
## =============================================================================
##
#
# Description: Reregister an RHEL virtual server instance to its respective capsule server
#

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin

argumentsFound=false
FILE_DIR=/var/lib/cloud/instance/scripts/vendor
file=$(grep -src -r -w 'REDHAT_CAPSULE_SERVER\|OS_INSTALL_CODE' $FILE_DIR | awk -F: '$2 == 6 {print $1}')
echo "Processing $file..."
if [ -f  "$file" ]; then
    capsule="$(grep "REDHAT_CAPSULE_SERVER=" $file | cut -d\" -f2)"
    organization="$(grep "OS_REDHAT_ORG_NAME=" $file | cut -d\" -f2)"
    activationKey="$(grep "ACTIVATION_KEYS=" $file | cut -d\" -f2)"
    profileName="$(grep "PROFILENAME=" $file | cut -d\" -f2)"
    if [ ! -z "$capsule" ] && [ ! -z "$organization" ] && [ ! -z "activationKey" ] && [ ! -z "profileName" ]; then
        argumentsFound=true
    fi
fi

if [ "$argumentsFound" = false ]; then
    if [ -z "$4" ]; then
        echo Please provide capsule hostname, organization, activation key and profile name
        exit
    fi

    capsule="$(echo $1 | cut -d. -f1).adn.networklayer.com"
    organization=$2
    activationKey=$3
    profileName=$4
fi
echo "Cleaning metadata..."
yum clean all

echo "Unregistering system..."
subscription-manager unregister
subscription-manager clean

echo "Removing any existing katello-ca RPMs..."
rpm -qa | grep katello-ca | xargs rpm -e

echo "Installing consumer RPM..."
rpm -Uvh http://${capsule}/pub/katello-ca-consumer-latest.noarch.rpm

subscription-manager config --server.hostname=${capsule}
subscription-manager config --rhsm.baseurl=https://${capsule}/pulp/repos

if [ -f /etc/rhsm/facts/katello.facts ]; then
    mv /etc/rhsm/facts/katello.facts /etc/rhsm/facts/katello.facts.bak.$(date +%s)
fi
echo '{"network.hostname-override":"'${profileName}'"}' > /etc/rhsm/facts/katello.facts

echo "Registering system..."
subscription-manager register --org="${organization}" --activationkey="${activationKey}" --force

To run the script:

1. chmod +x reregister-ng-rhel-vsi.sh
2. ./reregister-ng-rhel-vsi.sh

If the script fails, provide the following parameters:

• capsule hostname
• organization
• activation key
• profile name

Can I configure nested virtualization on a virtual server instance?

Nested virtualization on virtual server instances is not a supported configuration.

How do I resolve an SSH key error?

When you copy an SSH key from a terminal to add the key to your VPC, sometimes extra line breaks are introduced which cause a parsing error. To avoid this issue, first paste your SSH key into a text editor and remove any extra line breaks. Then, copy the SSH key from text editor and paste it into the VPC UI, CLI, or API.

Why do I receive an SSH key permission denied error?

When you receive an SSH key permission denied error, your host might not be recognized as an authorized host. To add your host as a known host, run the following command in your terminal. Make sure that you replace [sFTP] with your host.

ssh-keyscan -t rsa [sFTP] >> ~/.ssh/known_hosts

If you need more help, you can open a support case.

For troubleshooting information about z/OS virtual server instances, see IBM Wazi as a Service documentation.

Why am I getting an error when I attempt to add more than 5 network interfaces for an existing virtual server instance?

If the x86 instance profile that you used to provision your virtual server includes 17 or more vCPUs, you can now add more than 5 network interfaces. To take advantage of the ability to add more network interfaces to a virtual server that existed before the network interface limit increased, you must first stop a running virtual server and then start it again. For more information about multiple network interfaces, see Managing network interfaces.