Troubleshooting setup issues
You might encounter an issue when you are setting up WebSphere Automation. Learn how to fix the most common configuration issues.
- Missing wsa-ansible or wsa-ansible-win secret
-
ERROR: The /was/ssh directory with the Ansible connection parameters is empty. Make sure the wsa-ansible secret exists.The
wsa-ansibleorwsa-ansible-winsecret is missing with SSH or WinRM connection parameters. See Setting up secure remote access. - Unable to resolve hostname
-
Failed to connect to the host via ssh: ssh: Could not resolve hostname <hostname>Some servers might be configured with hostnames that cannot be resolved by DNS. In such cases, it might be necessary to configure WebSphere Automation with a custom host mapping. Use the
.runbookManager.runbookRunner.hostAliasesparameter in the WebSphereAutomation custom resource to provide more host or IP mappings. For example,apiVersion: automation.websphere.ibm.com/v1 kind: WebSphereAutomation metadata: name: wsa spec: runbookManager: runbookRunner: hostAliases: - hostnames: - myvm ip: 9.46.84.208 - Host key verification failed
-
Failed to connect to the host via ssh: Host key verification failed.WebSphere Automation verifies host keys but the host key of one the servers changed. If the host key change was intentional, update the
wsa-ansible-known-hostsconfiguration with the updated key. See Setting up WebSphere Automation for SSH to Linux or UNIX servers for details. - Fix manager is not deployed error with Secret with Fix Central credentials is not found message
-
The operator reports that
FixManagerReadyandInstallationManagerReadyareFalsewhen the wsa-secure-fixcentral-creds parameter is not configured. To enable the fix installation feature, you must configure WebSphere Automation with credentials to access IBM Fix Central. Without these credentials, WebSphere Automation cannot acquire the list of fixes for vulnerabilities in your managed servers.For more information, see Setting up credentials for Fix Central.
- Deployment manager is not registered
-
If you are registering a WebSphere Application Server deployment manager, it must be version 9.0.5.14 or later. This requirement ensures that the usage metering feature properly reports the server type to WebSphere Automation. Support for version 8.5.5 is planned for a future release of WebSphere Application Server.
To enable registration for a deployment manager that you cannot upgrade to WebSphere Application Server 9.0.5.14, or for a WebSphere Application Server 8.5.5 deployment manager, contact IBM Support.
- Server registration fails with Bad Request Exit error message
-
If you are attempting to register a server that is WebSphere Application Server 9.0.5.14 or later, or an earlier version that has been patched to support deployment manager registration, ensure that your version of WebSphere Automation is version 1.4.5 or later. Versions of WebSphere Application Server that support registration of deployment managers transmit the ServerType parameter during registration, and this parameter is not supported by earlier versions of WebSphere Automation.
- Proxy configuration does not take effect
-
Adding the proxy configuration as outlined in Configuring to use a proxy server does not take effect. The
JVM_ARGSenvironment variable that is added twice in the CVE Monitor cron job is a symptom of this problem. You should see two entries forJVM_ARGSin the output of the following commands:WSA_INSTANCE_NAMESPACE=websphere-automation WSA_INSTANCE_NAME=$(oc get websphereautomation -o name -n $WSA_INSTANCE_NAMESPACE | cut -d/ -f2) oc describe cronjob $WSA_INSTANCE_NAME-secure-cve-monitor -n $WSA_INSTANCE_NAMESPACE | grep JVM_ARGSWSA_INSTANCE_NAMESPACEis the namespace of the instance where WebSphere Automation is installed. The default value iswebsphere-automation. If a different value was chosen at installation, change the value ofWSA_INSTANCE_NAMESPACEaccordingly. The following output is displayed for the commands:JVM_ARGS: -Dhttps.proxyHost=http://10.x.x.x -Dhttps.proxyPort=80 JVM_ARGS: --add-opens=java.base/java.math=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMEDTo work around this issue, set the consolidated value in the configuration directly.
kind: WebSphereSecure spec: cveMonitor: env: - name: JVM_ARGS value: -Dhttps.proxyHost=http://10.x.x.x -Dhttps.proxyPort=80 --add-opens=java.base/java.math=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED