Welcome
IBM® Workload Scheduler
Welcome to the IBM® Workload Scheduler documentation, where you can find information about how to install, maintain, and use IBM Workload Scheduler. The documentation has been updated for IBM Workload Scheduler Version 10.2.7.
Planning and Installation
Troubleshooting installation, migration, and uninstallation
An overview on troubleshooting installation, migration, and uninstallation of the IBM Workload Scheduler.
Problem scenarios: install, reinstall, upgrade, migrate, and uninstall
Known problems and troubleshooting
Truststore password not found at upgrade time

Product requirements
This section contains links to the IBM® Workload Scheduler Download Documents, System Requirements, and Release Notes.
Product Library in PDF format
This section contains links to the PDF versions of all the publications provided in IBM Documentation for IBM Workload Automation.
Considerations for GDPR readiness
Overview
Best practices
Mobile Applications Userʼs Guide
Dynamic Workload Console User's Guide
AI Data Advisor (AIDA) User's Guide
IBM® Workload Scheduler
Welcome to the IBM® Workload Scheduler documentation, where you can find information about how to install, maintain, and use IBM Workload Scheduler. The documentation has been updated for IBM Workload Scheduler Version 10.2.7.
- Quick Start Guide
- Planning and Installation
  - Planning your IBM® Workload Scheduler environment
    IBM® Workload Scheduler orchestrates unattended, scheduled, and event-driven tasks for business and IT processes across on-premises and cloud environments organized in a network. A network consists of a set of linked workstations on which you perform job scheduling and processing to automate and manage your workflows. An IBM Workload Scheduler network is composed of a master domain manager, one or more Dynamic Workload Console servers, dynamic domain managers, and dynamic agents. You might also have fault-tolerant agents, extended agents, standard agents connected to the master domain manager or to domain managers.
  - Installing IBM® Workload Scheduler
    Available installation methods
  - Configuring
    Configuring IBM Workload Scheduler components after installation.
  - Upgrading
    How to upgrade IBM Workload Scheduler to the current version.
  - Enabling and disabling FIPS
    FIPS is a U.S. government security standard that defines security requirements for cryptographic modules used to protect sensitive information. FIPS 140-3 is the latest version of the U.S. and Canadian government security standard that defines security requirements for cryptographic modules in IT and telecommunications products. Its purpose is to ensure that products handling sensitive data via cryptography are secure and reliable. Federal agencies must use FIPS 140-3 validated modules. It is also widely adopted by defence contractors and financial institutions.
  - Moving from on-premises to cloud
    A quick procedure to move your workload from an on-premises to a cloud environment
  - Troubleshooting installation, migration, and uninstallation
    An overview on troubleshooting installation, migration, and uninstallation of the IBM Workload Scheduler.
    - The twsinst log files
    - Analyzing return codes for agent installation, upgrade, restore, and uninstallation
      Check how your operation completed by analyzing the return codes that are issued by twsinst.
    - Problem scenarios: install, reinstall, upgrade, migrate, and uninstall
      Known problems and troubleshooting
      - Truststore password not found at upgrade time
      - Installation or upgrade fails on RHEL version 9 and later
        Installing or upgrading on RHEL version 9 and later fails if you were using default certificates.
      - Linking a fault-tolerant agent earlier than 10.2 in an environment configured with certificates
      - Uninstallation of Dynamic Workload Console fails
        You are trying to uninstall an instance of the Dynamic Workload Console which is installed in a subfolder of the master domain manager installation directory.
      - Error in testing a connection or running reports on an engine returned from Fix Pack 1 to GA level when using an MSSQL database
      - Error in upgrading the IBM® Workload Scheduler database when using a DB2 database
      - Problems in encrypting the useropts file
      - WebSphere Application Server Liberty server does not start when applying a fix pack to the backup master domain manager
      - Error received when creating MSSQL database
        Error received when creating MSSQL database
      - Incorrect collation settings in PostgreSQL database
        Job ordering and extract from folders might work incorrectly when using a PostgreSQL database
      - Error at upgrade time due to multiple certificates in the TWSServerKeyFile keystore
    - Plug-in version mismatch after the master domain manager upgrade
      After upgrading the master domain manager to V10.2.7, a version mismatch occurs between the plug-in JAR files in different directories.
    - Uninstalling IBM Workload Scheduler manually
      Steps to take when manually uninstalling the IBM Workload Scheduler master domain manager.
  - Uninstalling
    An overview on how to uninstall the product.
  - Reference
- User's Guide and Reference
- Administration Guide
- Scheduling with the Agent for z/OS
- Database Views
- High Availability Cluster Environment
- Troubleshooting
- Driving IBM Workload Automation
IBM Z Workload Scheduler
Welcome to the IBM Z Workload Scheduler documentation, where you can find information about how to install, maintain, and use the product. The documentation has been updated for version 10.2 (with APAR PH68599).
Messages and Codes
Glossary
Notices

Truststore password not found at upgrade time

About this task

If you are upgrading from a version earlier than 10.2.1, certificates are automatically upgraded to work with version 10.2.7 and no intervention is required on your part.

However, if IBM® Workload Scheduler cannot retrieve the password for the truststore, the upgrade stops and a message similar to the following is displayed: WAINST0508E: unable to obtain the truststore password. Ensure that the Liberty password utility is installed. If not, install it or define an environment variable named JKS_SSL_PASSWORD and set it to the missing password.

In this case, proceed as stated in the message:

Procedure

Define an environment variable with name JKS_SSL_PASSWORD.
Set it to the password you defined for the certificates.
Restart the upgrade process.