Note

Before using this information and the product it supports, read the information in Notices.

This edition applies to Fix Pack 6 for version 9, release 5, modification level 0 of HCL Workload Automation (program number 5698-WSH) and to all subsequent releases and modifications until otherwise indicated in new editions.

HCL Workload Automation version 9.5.0 Readme File for Fix Pack 6

Date
June 17, 2022
Fix Pack
9.5.0-HCL-IWS-FP0006
Product
HCL Workload Automation version 9.5.0
General Description
HCL Workload Automation Fix Pack 6 for version 9.5.0

This readme file provides important information about Fix Pack 6 for HCL Workload Automation version 9.5.0.

The most up-to-date version of this readme can be accessed at the following URL: Fix Pack readmes.

You can find the readme files for previous Fix Packs here:
It is divided into the following sections:

HCL Workload Automation version 9.5.0 Fix Pack 6 supports all product versions indicated in the Release Notes for HCL Workload Automation.

For the most up-to-date information about supported operating systems, software and hardware requirements, see HCL Workload Automation Detailed System Requirements.

Review this section thoroughly before installing or using this Fix Pack.

About this Fix Pack

This section contains information specific for this Fix Pack including what has been modified or introduced, what has been fixed, product versions or components to which the Fix Pack applies, and compatibility issues, if any.

Product versions and components to which the Fix Pack applies
This Fix Pack can be applied only on top of HCL Workload Automation V9.5.0, and subsequent Fix Packs.

This section includes the following subsections:

Features introduced with Fix Pack 6

Version 9.5 Fix Pack 6 delivers the following enhancements:
USERJOBS clean up utility
The USERJOBS tool has been developed to clean up Broker Tables in case of jobs in never ending EXEC status inside the USERJBOBS job stream. To resolve USERJOBS carryforward issues, a new command has been provided in the TWDWB/bin to automate the procedure: cleanuserjobs.sh(bat). The command can be invoked as follows:
cleanuserjobs.sh(bat)-dbUsr <username> -dbPwd <password> -jobnum <jobnumber> | -file <filename>
  • jobnumber can be written in these formats: #Jjobnumber, Jjobnumber or jobnumber.
  • filename can contain a list of jobs, limited to one job per row.
WebSphere Liberty available ciphers
The new ./listciphers.sh(bat) command has been provided in the TWDWB/bin to automate the procedure that lists all available ciphers defined in WebSphere Liberty.
enDbGetOpsAudit
You can now enable or disable auditing on database GET operations. Disabling this auditing feature might improve performance. All other database operations are not affected. Find more detailed information in Setting global options.
Changed features and feature capabilities
Supported WebSphere Application Server Liberty Base versions
HCL Workload Automation Version 9.5 Fix Pack 6 was formally tested by using WebSphere Application Server Liberty Base 22.0.0.4 and 22.0.0.5. The minimum required WebSphere Liberty version to successfully install the fixpack is 22.0.0.3 or later.
Updated OpenSSL libraries
HCL Workload Automation Version 9.5 Fix Pack 6 has been updated with OpenSSL libraries version 1.1.1n (1.1.1.14) 15 Mar 2022.
OpenJ9/OpenJDK Runtime Environment
HCL Workload Automation Version 9.5 Fix Pack 6 has been updated with OpenJ9 version jdk88u332-b09_openj9-0.32.0
GSKit
HCL Workload Automation Version 9.5 Fix Pack 6 has been updated with GSKit version 8.0.55.26.
DB2
HCL Workload Automation Version 9.5 Fix Pack 6 has been tested with DB2 11.5.7 Advanced Workgroup Server Edition
Windows 2022 and AIX 7.3 support
FTA and DA agents now support Windows 2022 and AIX 7.3.
Satisfying Requests for Enhancements (RFEs)

RFEs give customers the opportunity to collaborate directly with the product development team and other users. The team prioritizes and develops new product features based on proposals made by customers. HCL Workload Automation V9.5 Fix Pack 6 delivers the following RFEs:

RFE WAO-348

It is now possible to install the dynamic agent on IBM i connecting to the system with a user different from QSECOFR.

Resolved Common Vulnerabilities and Exposures (CVE)
  • CVE-2022-22369
  • CVE-2021-35586
  • CVE-2021-35578
  • CVE-2021-35564
  • CVE-2021-35559
  • CVE-2021-35565
  • CVE-2021-35588
  • CVE-2021-41035
  • CVE-2022-21365
  • CVE-2022-21360
  • CVE-2022-21349
  • CVE-2022-21341
  • CVE-2022-21340
  • CVE-2022-21305
  • CVE-2022-21294
  • CVE-2022-21293
  • CVE-2022-21291
  • CVE-2022-21248
  • CVE-2021-23450
  • CVE-2021-35550
  • CVE-2022-0778
  • CVE-2022-29208
  • CVE-2022-29216
  • CVE-2022-29191
  • CVE-2022-29192
  • CVE-2022-29193
  • CVE-2022-29194
  • CVE-2022-29195
  • CVE-2022-29213
  • CVE-2022-29212
  • CVE-2022-29211
  • CVE-2022-29209
  • CVE-2022-29207
  • CVE-2022-29206
  • CVE-2022-29205
  • CVE-2022-29204
  • CVE-2022-29203
  • CVE-2022-29202
  • CVE-2022-29201
  • CVE-2022-29200
  • CVE-2022-29199
  • CVE-2022-29198
  • CVE-2022-29197
  • CVE-2022-29196
  • CVE-2017-15095
  • CVE-2018-11307
  • CVE-2018-14718
  • CVE-2018-7489
  • CVE-2019-14540
  • CVE-2019-14893
  • CVE-2019-16335
  • CVE-2019-16942
  • CVE-2019-16943
  • CVE-2019-17267
  • CVE-2019-17531
  • CVE-2019-20330
  • CVE-2018-5968
  • CVE-2020-35490
  • CVE-2020-35491
  • CVE-2020-36518
  • CVE-2018-1000873
  • CVE-2019-17571
  • CVE-2020-9488
  • CVE-2020-13092
  • CVE-2020-28975
  • CVE-2019-16778
  • CVE-2020-15196
  • CVE-2020-15202
  • CVE-2020-15205
  • CVE-2020-15207
  • CVE-2020-15208
  • CVE-2020-15193
  • CVE-2020-15195
  • CVE-2020-15203
  • CVE-2020-15206
  • CVE-2020-15265
  • CVE-2020-15266
  • CVE-2020-26267
  • CVE-2020-5215
  • CVE-2021-29513
  • CVE-2021-29514
  • CVE-2021-29515
  • CVE-2021-29518
  • CVE-2021-29520
  • CVE-2021-29525
  • CVE-2021-29529
  • CVE-2021-29530
  • CVE-2021-29532
  • CVE-2021-29535
  • CVE-2021-29536
  • CVE-2021-29537
  • CVE-2021-29540
  • CVE-2021-29546
  • CVE-2021-29553
  • CVE-2021-29558
  • CVE-2021-29559
  • CVE-2021-29560
  • CVE-2021-29566
  • CVE-2021-29568
  • CVE-2021-29569
  • CVE-2021-29570
  • CVE-2021-29571
  • CVE-2021-29574
  • CVE-2021-29576
  • CVE-2021-29577
  • CVE-2021-29578
  • CVE-2021-29579
  • CVE-2021-29582
  • CVE-2021-29583
  • CVE-2021-29585
  • CVE-2021-29586
  • CVE-2021-29587
  • CVE-2021-29588
  • CVE-2021-29589
  • CVE-2021-29590
  • CVE-2021-29591
  • CVE-2021-29592
  • CVE-2021-29593
  • CVE-2021-29594
  • CVE-2021-29595
  • CVE-2021-29596
  • CVE-2021-29597
  • CVE-2021-29598
  • CVE-2021-29599
  • CVE-2021-29600
  • CVE-2021-29601
  • CVE-2021-29603
  • CVE-2021-29606
  • CVE-2021-29607
  • CVE-2021-29608
  • CVE-2022-23591
  • CVE-2022-23587
  • CVE-2022-23584
  • CVE-2022-23574
  • CVE-2022-23573
  • CVE-2022-23566
  • CVE-2022-23563
  • CVE-2022-23562
  • CVE-2022-23561
  • CVE-2022-23560
  • CVE-2022-23559
  • CVE-2022-21726
  • CVE-2022-21727
  • CVE-2022-21728
  • CVE-2022-23558
  • CVE-2022-21740
  • CVE-2022-21736
  • CVE-2022-21730
  • CVE-2018-15494
  • CVE-2020-5259
  • CVE-2019-10785
  • CVE-2018-1549
  • CVE-2020-4051
  • CVE-2020-5259
  • CVE-2019-10785
  • CVE-2018-15494
  • CVE-2010-2273
  • CVE-2020-5258
  • CVE-2020-4051
  • CVE-2021-41182
  • CVE-2021-41183
  • CVE-2021-41184
  • CVE-2021-41103
  • CVE-2021-41092
  • CVE-2021-21334
  • CVE-2021-32760
  • CVE-2021-43797
  • CVE-2021-44832
  • CVE-2021-45105
  • CVE-2021-23450

Problems fixed in HCL Workload Automation Fix Pack 6 for version 9.5.0

This section lists APARs and internal defects solved by Fix Pack 6.

Table 1. APARs addressed in Fix Pack 6
APAR ABSTRACT
IJ09307 CONDSUCC NOT ACCEPTED IN THE JOB CONDITION NAME FIELD
IJ10726 DELETING ONE "FOLLOWS" DEPENDENCY INCORRECTLY DELETES ALL
IJ12048 HIGH LOAD OF DATASTAGE JOBS (2100+) CAUSES MEMORY LEAK AND JOB FAILURES
IJ21519 TABLES IN PLN SCHEMA CARRYING OVER TOO MANY ROWS - IMPLEMENTATION FOR IDS DB
IJ22106 DEPENDENCIES DISPLAY FIELD DOESN'T UPDATE CONSISTENTLY WHEN DELETING DEPENDENCIES USING DWC
IJ24615 AFTER UPGRADE OF A WINDOWS CLUSTER; THE SERVICES ARE RUNNING BUT THE SCHEDULED JOBS DO NOT START
IJ25454 NETMAN SERVICE NAME NOT UPDATED ON SECONDARY SERVER IN A WINDOWS CLUSTER AFTER UPGRADE
IJ29098 JOB MANAGEMENT PLUGIN JOB FAILED WITH THE ERROR MESSAGE AWKJMJ043E IF ITS MONITORED JOB ABEND
IJ30359 CHANGING A JOB STREAM PRIORITY BY BATCH SELECTION IS VERY SLOW USING THE DWC
IJ30510 IWS POWERCENTER JOBS DO NOT CHANGE STATE FROM ABEND TO EXEC
IJ31864 ON ZCENTRIC JOBLOGS ARE DELETED AT MAXAGE EVEN IF JOBS ARE STILL RUNNING
IJ32279 9.5 FP3 FILETRANSFER PLUGIN HAS BROKEN BACKWARD COMPATIBILITY IN THE WAY JOBS ARE DEFINED
IJ32304 FORECAST PLAN PROBLEM IN JOB STREAM RUN CYCLE GROUP
IJ33333 REST API DOCUMENTATION UPDATE
IJ34871 TWS9.5 FP0004 JOB ABEND WITH ERROR "*/SCRIPT.SH: CANNOT EXECUTE [TEXT FILE BUSY]"
IJ35581 WHEN SENDING EMAILS BY EVENT RULE, JAPANESE EMAIL BODY IS GARBLED
IJ35844 COMPOSER EXTRACT FROM ER=@/@ RETURNS DEFINITIONS WITH MISSING "ACTION" FIELD
IJ36203 RFC_COMMUNICATION_FAILURE, 19 ERROR IN SAP JOBS
IJ36216 TWSSERVERKEYFILE.JKS AND TWSSERVERTRUSTFILE.JKS FILES NEED TO BE PROVIDED WHEN SUPPLYING CUSTOM CERTIFICATES WITH SERVERINST
IJ36425 EVENT 128 IS PRODUCED IN EVENTS.LOG WHEN "WAS" IS RESTARTED THE FIRST TIME AFTER COMPLETING JOBS WITH "CRITICAL" AND "DEADLINE" PARAMETERS
IJ36453 DYNAMIC AGENT (JOBMANAGER PROCESS) NOT ABLE TO HANDLE SPECIAL CHARACTERS
IJ36545 MAGENT PROCESS UNABLE TO READ EVENTS WRITTEN TO MAGENT.P
IJ36844 AFTER UPGRADING FROM IBMI DA TO 95FP5 SOME JOBS DO NOT COMPLETE AND CPU USAGE GOES UP TO 100%
IJ36846 THE WRONG ERROR MESSAGE IS DISPLAYED IF AN INSUFFICIENT NUMBER OF PARAMETERS FOR THE SERVERINST.SH SCRIPT HAS BEEN PROVIDED
IJ36872 CVE-2021-45105 LOGJ42.16 REMOVAL
IJ36892 INCORRECT STATUS OF REMOTE COMMAND JOB IN TWSD AND TWSZ
IJ36977 CONMAN CAUSES HIGH CPU UTILIZATION WHEN THE PARENT PROCESS IS TERMINATED
IJ36980 SQL JOBS - DBMS OUTPUT STATEMENT PROCESSED VALUES NEED TO GET PRINTED IN THE IWA JOB LOGS
IJ36998 LOG4J-1.2.17.REDHAT-3.JAR STILL PRESENT IN DIRECTORY TWS/TDWB_CLI/LIB AFTER INSTALLING IWS 9.5.0.05
IJ37122 REPLYING TO IBM I PROMPT FAILS WITH “UNABLE TO READ THE REPLY COMMAND RC PROPERTIES”
IJ37228 DOCUMENTATION NEEDS TO BE UPDATED FOR INSTALLING IWS MDM AND DWC ON CONTAINER USING OCP V 4.8
IJ37258 THE IWS WINDOWS USER NAME IS NOT CASE SENSITIVE FOR CONMAN, AND ONLY CASE SENSITIVE FOR COMPOSER WHEN THERE IS DUPLICATE NAMES
IJ37269 COMPOSER EXTRACT OPTION FOR USERS/USER DOES NOT WORK CORRECTLY AS DOCUMENTED WHEN USED ALONG WITH "PASSWORD" OPTION IN 9.5 FP5
IJ37306 ZOS AGENT TWSINST -U FOR ITS USAGE OUTPUT DOES NOT MENTION JMPORT AND JMPORTSSL USAGE
IJ37333 INCORRECT POWERCENTER JOB STATUS IN THE TWS POWER CENTER PLUGIN
IJ37338 WHEN USING THE SELF SERVICE UI DASHBOARD ON Z/OS ENVIRONMENTS, THE OPTION TO FILTER BY WORKSTATION JOB IS GREYED OUT
IJ37349 ISERIES AGENT WITH IWS95FP5 GETTING "NET_REQUEST_NEWTHREAD: SSL ERROR: ERROR:FFFFFFFFFFFFFFFF:LIB(255):FUNC(4095):REASON(4095)" IN ITA TRACES
IJ37364 JDBC POOL EXHAUSTION BECAUSE CONNECTIONS ARE NOT RELEASED
IJ37477 AFTER PRIORITY IS CHANGED THROUGH DWC, THE JOB STREAM STARTS RUNNING IMMEDIATELY EVEN IF NOT SCHEDULED TO RUN YET
IJ37626 WHEN BROKER IS IN SSL FEATURE ACTIVE BROKER CAN UNLINK ALL THE AGENTS RANDOMLY WHEN MFT JOBS ARE EXECUTED
IJ37701 KERBEROS AUTHENTICATION DID NOT WORK WITH PASSWORD WITH = CHARACTER
IJ37740 THE GCP COULDSTORAGE PLUGIN DOES NEEDS BOTH "STORAGE ADMIN" AND "STORAGE OBJECT ADMIN" RIGHTS - TOO RISKY FOR SECURITY
IJ37774 4-5 MINS DELAY WHEN USING SSH PROTOCOL FOR REMOTE COMMAND JOB TO WINDOWS SERVER WITH SSH
IJ37881 JOB LOG ARBITRARY FILE CREATION
IJ38164 IWS AGENT UNLINKS WHEN A VERY LONG DOMAIN NAME RETURNS FROM CITSCAN.UNABLE_TO_CREATE_ENTITY LOGGED AT MDM
IJ38201 THE LICENSE TYPE OF EXTENDED AGENT <X-AGENT> IS DIFFERENT FROM HOST WORKSTATION <FTA>
IJ38340 CUSTOMER HAS APPLIED FP5 TO IWS9.5 FP3 ON AIX. THEY RAN THE COMPOSER COMMANDS AND IT STARTED A NEW LINE AT PORT NUMBER LINE
IJ38346 JOBMANAGER PROCESS AUTO-RESTARTS EVERY FEW SECONDS
IJ38348 TWSD 9.5 NEED TO ADD USE TO THE SECURITY FILE FOR CPU CLASSES
IJ38495 THE LAST CHARACTERS FROM OUTPUT OF REPTR COMMAND ARE GETTING TRUNCATED
IJ38758 9.5 MDM CRASHES WITH JAVACORE DUE TO SYM_CLOSE FUNCTION WHEN TRYING TO RETRIEVE WORKLOAD
IJ38774 DATABASE JOBS FAILING WITH "NULL EXECUTION: ERROR" AFTER DEPLOYING THE DATABASE PLUGIN FIX JAR
IJ38809 AFTER SETTING UP SSL BETWEEN MASTER, DWC AND DB2 INSTANCES, THE TEST CONNECTION FOR REPORTING DISPLAYS A DB ERROR FROM DWC
IJ38854 AWKJDB801E AN INTERNAL ERROR WHEN ACCESSING DB. THE INTERNAL ERROR IS: "EXCEPTION OCCURRED DURING BIGDECIMAL CONVERSION"
IJ38859 JOB PRIORITY IS AUTOMATICALLY CHANGED TO ZERO (0) AFTER JNEXTPLAN
IJ38960 UPDATE OPENSSL
IJ38962 UPDATE JRE
IJ38996 UNABLE TO LOAD THE PLANS IN DWC WHEN THERE ARE MORE THAN 250 FILES INTO SCHEDLOG
IJ39134 MANAGE FILE TRANSFER RECEIVES JOB ISSUE IN THE ABSOLUTE PATH RESOLUTION USING A "LOCAL USER" DIFFERENT BY TWS USER
IJ39156 MANAGE FILE TRANSFER - ISSUE CONNECTING TO REMOTE SERVER VIA KEYSTORE THAT DOES NOT NEED PASSWORD
IJ39387 JOB STREAM IS SUBMITTED TWICE IN THE PLAN
IJ39558 CONMAN SHOW JOBS ON A SPECIFIC JOB ENDS WITH A SEGMENTATION FAULT
IJ39791 SEVERAL DYNAMIC JOBS REMAIN IN INTRO STATUS WHEN SUBMITTED DURING A DB FAILOVER, SWITCHMGR OPERATION OR LIBERTY RESTART
IJ39955 SLOWNESS IN CONMAN COMMANDS RELATED TO JOBS WHEN STREAM NAME IS MENTIONED AS "@" IN MASTER
IJ40246 CENTRALIZED UPDATE IWA 9.5.0.05 FAILED ON WINDOWS SERVER
IJ40326 WAT NULL POINTER EXCEPTION UPDATING A JOB STREAM
KB0095518 IMPROPER TRANSFER OF GDG FILE FROM Z/OS AGENT
KB0096483 MFT FAILS TO RETRIEVE MORE THAN 10000 FILES (SEARCH COMMAND)
Table 2. Defects fixed in Fix Pack 6
DEFECT ABSTRACT
WA-101554 JNEXTPLAN (OR FORECAST) FAILS IN CASE OF COM.IBM.TWS.RUNCYCLE.DSTIMPROVEDEVALUATION = TRUE THE LAST DAY OF THE MONTH
WA-101847 "CHECK USER" FAILS WITH CYBERARK ENABLED WHEN USER IS ON A DOMAIN
WA-103470 DWC CHECK PREREQ ON SLES 15.2 MISMATCH
WA-103592 EVENT RULE AND CENTRALIZED AGENT UPDATE DOESN'T PROPERLY WORK BETWEEN MDM 10.1 AND DA 9.5 FP5
WA-103820 BROKER (SSL) UNLINKS WHEN SUBMITTING MANAGE FILE TRANSFER JOBS
WA-103952 SAAS AGENT 9.5 FP5 USEROPTS PASSWORD IS WRONGLY ENCRYPTED
WA-104729 AVOID THAT THE DYNAMIC AGENT GOES OFFLINE WHEN WSCANHW EXCEEDS 2 MINUTES.
WA-104986 LINUX PPC PROBLEM ON CONMAN: ERROR WHILE LOADING SHARED LIBRARIES: LIBNSL.SO.1
WA-105127 RESTORE FAILS ON DA 9.5 FP6 IBMI

Backward compatibility

This fix pack delivers support for scheduling objects in folders, including workstations. When monitoring workstations from a back-level agent workstation, the output displays the workstation unique identifier and not the workstation name for those workstations that were defined in folders different from the root folder. To identify the corresponding workstation name, run the conman command using the showid filter, showcpu ;showid, from an updated agent workstation.

Known limitations and workarounds

The following are software limitations and workarounds that affect HCL Workload Automation version 9.5.0 Fix Pack 6.

WebSphere Liberty minimum required version
the minimum required WebSphere Liberty version to successfully install the fixpack is 22.0.0.3.
APAR IJ39106
When installing using the keystore and truststore files, customers are required to manually configure these files prior the installation setup. If providing custom .jks files, it is the customers responsibility to provide such .jks files equipped with all the CA certificates they need in the truststore. For more information see Installing the master domain manager and backup master domain manager.

Fix pack structure

This section describes the structure of the images contained in this Fix Pack.

Fix Pack files available for HCL Workload Automation using HCL License Portal

This is the structure of the Fix Pack for the engine on HCL License Portal:
Table 3. Readme file and WebSphere Liberty package
Name Description
HWA_9506_ReadmeFirst Readme file with download instructions
HWA_9506_WEBSPHERE_LIBERTY WebSphere Liberty application server

Table 4. AIX components
Name Description
HWA_9506_AIX_BatchReportCli HCL Workload Automation 9.5.0.6 Batch Reports Command Lines
HWA_9506_AIX_AGENT

HCL Workload Automation Agent 9.5.0.6,

Remote CLI and Workload Automation for Applications for AIX
Table 5. IBM i components
Name Description
HWA_9506_IBM_I_AGENT HCL Workload Automation Agent 9.5.0.6 for IBM i

Table 6. Linux components
Name Description
HCL Workload Automation 9.5 LINUX LINUX distribution
HWA_9506_MDM_LINUX_X86_64 Workload Automation 9.5.0.6 FOR LINUX
HWA_9506_LINUX390_BatchReportCli HCL Workload Automation 9.5.0.6 Batch Reports Command Lines
HWA_9506_LINUX_X86_64_BatchReportCli HCL Workload Automation 9.5.0.6 Batch Reports Command Lines
HWA_9506_LNX_PPC64LE_AGENT HCL Workload Automation Agent 9.5.0.6, Remote CLI and Workload Automation for Applications for Linux on POWER (little endian)
HWA_9506_LNX_S390_AGENT HCL Workload Automation Agent 9.5.0.6, Remote CLI and Workload Automation for Applications for Linux on System z9 and System z
HWA_9506_LNX_X86_64_AGENT Workload Automation Agent 9.5.0.6, Remote CLI and Workload Automation for Applications for Linux on x86-64

Table 7. Linux components on Docker
Name Description
HCL Workload Automation 9.5 LINUX LINUX distribution
HWA_9506_DOCKER_MDM_LINUX_X86_64 Workload Automation 9.5.0.6 FOR LINUX on Docker
HWA_9506_DOCKER_LNX_X86_64_AGENT Workload Automation Agent 9.5.0.6, Remote CLI and Workload Automation for Applications for Linux on x86-64 on Docker

Table 8. Windows™ components
Name Description
HCL Workload Automation 9.5 WINDOWS WINDOWS distribution
HWA_9506_MDM_WINDOWS_X86_64 Workload Automation 9.5.0.6 FOR WINDOWS
HWA_9506_WINDOWS_X86_64_BatchReportCli HCL Workload Automation 9.5.0.6 Batch Reports Command Lines
HWA_9506_WIN_X86_64_AGENT HCL Workload Automation Agent 9.5.0.6, Remote CLI and Workload Automation for Applications for Windows x64

Table 9. zOS components
Name Description
HWA_9506_Zsystem_BatchReportCli HCL Workload Automation 9.5.0.6 Batch Reports Command Lines

Table 10. OpenShift components
Name Description
HWA_9506_OpenShift_Agent.zip Workload Automation for Openshift 9.5.0.6 - agent only
HWA_9506_OpenShift_Server_UI_Agent.zip Workload Automation for Openshift 9.5.0.6 - Server, UI and agent

Installing the Fix Pack

This section describes how to apply Fix Pack 6 to HCL Workload Automation.

The section is divided into the following subsections:

Installation notes

When installing the HCL Workload Automation Fix Pack, follow these recommendations:

  • On AIX 7.1, install the latest version of libz.a (packed in zlib-1.2.13), which is necessary; if not already installed, install the following rpm:

    https://public.dhe.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/zlib/zlib-1.2.13-1.aix7.1.ppc.rpm

  • Before installing the Fix Pack, ensure you have installed the required prerequisite software. To obtain the latest information about software requirements for HCL Workload Automation, see Product Requirements.
  • The minimum required WebSphere Liberty version to successfully install the fixpack is 22.0.0.3 or later.
  • Before installing this Fix Pack on AIX® V7.1 operating systems, you must apply the patch for APAR IZ99634. For more information, see: APAR IZ99634.
  • On UNIX™ operating systems, before installing the HCL Workload Automation Fix Pack, ensure that your umask is set to 022. To verify that umask is set to the correct value, from a command prompt, run the umask command. If the value is different from 022, modify it by running the command: 
    umask 022
  • On UNIX operating systems, the database administrator must have read and run privileges for the HCL Workload Automation installation path; otherwise the installation fails. (54367)
After the Fix Pack installation completes, verify the following information:
  • This Fix Pack installs a new version of the file tws_env.sh (tws_env.cmd) and also creates a backup file named, tws_env.sh.bk (tws_env.cmd.bk), which are both saved to the TWA_HOME/TWS directory, where TWA_HOME is the HCL Workload Automation installation directory. After installing the Fix Pack, if you have modified the original version, merge the content of the new version with the content of the original version to carry your customized content into the new version.
  • Only on Windows operating systems, to correctly display double-byte character set (DBCS) characters, you must perform the following actions:
    • Set the LANG environment variable to the DBCS language code you want to use, for example, set LANG=zh_CN.
    • Set the TWS_TISDIR environment variable to the HCL Workload Automation home directory, for example, set TWS_TISDIR=C:\FTA\TWS.
    • Open the Control Panel window and click Clock, Language, and Region.
    • Click Region and Language.
    • In the Format tab, choose from the Format drop-down list the language you want to use.
    • In the Keyboards and Languages tab, under Display Language, click install and follow the steps to install the DBCS language pack you want to use.
    • In the Administrative tab, click Change system locale and, from the drop-down list, choose the language (system locale) you want to use.
    Note that all the settings must be coherent, that is they must refer to the same DBCS language setting. After you have completed these changes, reboot your workstation to have the changes take effect.
  • When installing a dynamic agent or a fault-tolerant agent, ensure that the agent name does not start with a number. If the name of the dynamic agent starts with a number, use the -displayname parameter at installation time to specify a different name. If the name of the fault-tolerant agent starts with a number, use the --thiscpu parameter at installation time to specify a different name.

Interoperability notes

HCL Workload Automation version 9.5.0 Fix Pack 6 supports all product versions indicated in the version 9.5 Release Notes which can be accessed at the following link: Release Notes for HCL Workload Automation.

Disk space requirements

For the most up-to-date information about disk space and memory requirements, see the hardware requirements at the following URL: Hardware Requirements

Before starting the Fix Pack installation, ensure that you have the necessary disk space available on the file system. Consider that the disk space check calculated by the installation considers the entire space occupied by the TWA_HOME directory. The space required by the backup is the sum of the following directories: 
TWA_HOME/TWS + TWA_HOME/TDWB + TWA_HOME/wastools + TWA_HOME/properties
In addition to the disk space in the following table, the installation requires an additional 600 MB on the file system where the IMShared directory is located.
Table 11. Disk space requirements for installing a master domain manager or a backup master Fix Pack
Operating System Installation directory Temporary directory
AIX 2,5 GB 1,5 GB
Microsoft® Windows 2 GB 1 GB
Linux® 1,5 GB 800 MB
Table 12. Disk space requirements for installing the Fix Pack for HCL Workload Automation fault-tolerant agents
Operating System Installation directory Temporary directory
AIX 900 MB 400 MB
Microsoft Windows 700 MB 350 MB
Linux 720 MB 350 MB
Table 13. Disk space requirements for installing the Fix Pack for HCL Workload Automation dynamic agents and z/OS agents
Operating System Installation directory Temporary directory
AIX 600 MB 250 MB
Microsoft Windows 800 MB 400 MB
Linux 600 MB 250 MB

Installation methods

You can install the Fix Pack using one of the following methods:
For master domain manager or its backup:
see Updating the master domain manager and its backup
For dynamic domain manager or its backup:
see Updating the dynamic domain manager
For fault-tolerant agent, dynamic agent or domain manager:
see Updating agents

If necessary, you can also return to a previous product version level, as described in Returning to a previous product version levelin Planning and Installation Guide.

Note: When upgrading to V9.5 FP5 or later, it is required to manually import the certificates of all the required root CAs into the trustore of the dynamic agent.

Configuring your master domain manager and broker in SSL mode

If you plan to install your master domain manager, Version 9.5 Fix Pack 5 in SSL mode or plan to upgrade to Version 9.5 Fix Pack 5 and set up your master domain manager and broker in SSL mode, perform the following steps:
  1. Install the master domain manager or upgrade your current master domain manager to version 9.5.0.5
  2. Replace the values of the following parameters in the localopts file with the following values:
    • nm SSL full port = 31113
    • SSL key =TWA_home/TWS/ssl/OpenSSL/TWSClient.key
    • SSL certificate = TWA_home/TWS/ssl/OpenSSL/TWSClient.cer
    • SSL key pwd = TWA_home/TWS/ssl/OpenSSL/password.sth
    • SSL CA certificate = TWA_home/TWS/ssl/OpenSSL/TWSTrustCertificates.cer
    • SSL random seed =TWA_home/TWS/ssl/OpenSSL/TWS.rnd
    • SSL Encryption Cipher = TLSv1.2
    For more information about the localopts file, see Setting local options
  3. Modify the master domain manager and broker using the composer mod command, as follows:
    CCPUNAME your_master_domain_manager_workstation

  DESCRIPTION "MANAGER CPU"

  OS UNIX

  NODE localhost TCPADDR 31111

  SECUREADDR 31113

  DOMAIN MASTERDM

  FOR MAESTRO

    TYPE MANAGER

    AUTOLINK ON

    BEHINDFIREWALL OFF

    SECURITYLEVEL FORCE_ENABLED

    FULLSTATUS ON

END
    CPUNAME your_broker_workstation

  DESCRIPTION "This workstation was automatically created."

  OS OTHER

  NODE localhost TCPADDR 41114

  SECUREADDR 41114

  DOMAIN MASTERDM

  FOR MAESTRO

    TYPE BROKER

    AUTOLINK ON

    BEHINDFIREWALL OFF

    SECURITYLEVEL FORCE_ENABLED

    FULLSTATUS OFF

END
  4. Modify the Broker.Workstation.PortSSL parameter in the BrokerWorkstation.properties file from false to true.

    The Broker.Workstation.PortSSL parameter specifies the port used by the broker server to listen to the incoming traffic (equivalent to the Netman port) in SSL mode. It is first assigned at installation time. This port number must always be the same for all the broker servers that you define in your HCL Workload Automation network (one with the master domain manager and one with every backup master domain manager you install) to ensure consistency when you switch masters.

  5. Stop and start WebSphere Application Server Liberty Base, as described in Application server - starting and stopping.
  6. Stop and start all HCL Workload Automation processes.
  7. Run 
    Jnextplan -for 0000

Before Installing

Before installing the Fix Pack using any of the methods described in the following sections, perform the following actions:
  1. If you have jobs scheduled to run on the instance you are upgrading, make sure that they have completed otherwise some processes, such as jobmon or joblnch, might still be active.
  2. Download the appropriate ZIP files for the operating system from HCL License Portal .
  3. Extract the content of the ZIP files into a directory, using one of the extraction tools available on your system or downloadable from the Internet. The tool you use must be able to keep the file permissions on the extracted files, for example, infozip.
    Note:
    • If you want to install the Fix Pack on IBM i, to untar the eImages, see Extract the eImages for the Z Agent and Dynamic Agent on IBM i operating systems.
    • To extract the .zip file onto a Windows 64-bit system, ensure that the eImage is not located on the desktop because the Windows operating system extract tool has a problem. Choose another directory into which to extract the Fix Pack eImage.

Creating or updating the HCL Workload Automation database schema

Before launching any of the installation methods, create or update the database schema.

Before applying the Fix Pack, create the database schema by following the procedure described in the Creating and updating the database tables chapter in the HCL Workload Automation guide.

If the database already exists, update the database by running the following command:
On Windows operating systems
cscript configureDb.vbs --rdbmstype db_type --dbhostname db_hostname 
--dbport db_port --dbname db_name --dbuser db_user 
--dbpassword db_password --dbadminuser db_administrator 
--dbadminuserpw db_administrator_password
On UNIX operating systems
./configureDb.sh --rdbmstype db_type --dbhostname db_hostname 
--dbport db_port --dbname db_name --dbuser db_user 
--dbpassword db_password --dbadminuser db_administrator 
--dbadminuserpw db_administrator_password

If a new version of the database is available, update to it by following the procedure described in the Upgrading the database schema chapter in the HCL Workload Automation guide.

Extract the Images for the Agent and Dynamic Agent on IBM i operating systems

The following package is available with this Fix Pack:
  • HWA95_FP6IBM_I_AGENT.zip: The dynamic agent on IBM i image. This package also contains an extraction tool executable that can be copied to the IBM i workstation.

To untar or unzip the Fix Pack eImages, you can use the PASE shell or the AIXterm.

Using PASE shell:
  1. Open the PASE shell.
  2. Run the command: 
    "CALL QP2TERM"
  3. Locate the folder where you downloaded the Fix Pack eImage and run the command:
    Dynamic agent
    "unzip HWA95_FP2_IBM_I_AGENT.zip"
  4. Exit from the PASE shell.
Using AIXterm:
  1. Start the Xserver on your desktop.
  2. On the iSeries machine, open a QSH shell and export the display.
  3. In QSH shell, go to the directory /QopenSys and run the command: 
    "aixterm -sb"
  4. A pop-up window is displayed on your desktop. Using this pop-up window, unzip the HWA95_FP2_IBM_I_AGENT.zip file, or untar the HWA95_FP2_IBM_I_AGENT.zip.

Rolling back an applied fix pack

This topic describes how to roll back an applied fix pack to a previous version.

You can revert back to an earlier version of an installed Fix Pack or release by using one of the following methods:
For master domain manager or its backup:
see Rolling back the master domain manager and its backup
For dynamic domain manager or its backup:
see Rolling back the dynamic domain manager

Documentation updates for HCL Workload Automation Fix Pack 6 for version 9.5.0

Any additions or changes to the documentation as a result of this Fix Pack have been integrated into the online product documentation available in HCL Workload Automation documentation.

Contacting HCL Software Support

Refer to the HCL Workload Automation Support page: Software Support

Notices

This information was developed for products and services offered in the US. This material might be available from HCL in other languages. However, you may be required to own a copy of the product or product version in that language in order to access it.

HCL may not offer the products, services, or features discussed in this document in other countries. Consult your local HCL representative for information on the products and services currently available in your area. Any reference to an HCL product, program, or service is not intended to state or imply that only that HCL product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any HCL intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-HCL product, program, or service.

HCL may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

For license inquiries regarding double-byte character set (DBCS) information, contact the HCL Intellectual Property Department in your country or send inquiries, in writing, to:

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

HCL TECHNOLOGIES LTD. PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. HCL may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-HCL websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this HCL product and use of those websites is at your own risk.

HCL may use or distribute any of the information you provide in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by HCL under terms of the HCL Customer Agreement, HCL International Program License Agreement or any equivalent agreement between us.

The performance data discussed herein is presented as derived under specific operating conditions. Actual results may vary.

Information concerning non-HCL products was obtained from the suppliers of those products, their published announcements or other publicly available sources. HCL has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-HCL products. Questions on the capabilities of non-HCL products should be addressed to the suppliers of those products.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to actual people or business enterprises is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to HCL, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. HCL, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. HCL shall not be liable for any damages arising out of your use of the sample programs.

© (HCL Ltd.) (2022).
Portions of this code are derived from HCL Ltd. Sample Programs.
© Copyright HCL Ltd. _2022_.

Trademarks

HCL, and other HCL graphics, logos, and service names including "hcltech.com" are trademarks of HCL. Except as specifically permitted herein, these Trademarks may not be used without the prior written permission from HCL. All other trademarks not owned by HCL that appear on this website are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by HCL.

Adobe™, the Adobe logo, PostScript™, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

IT Infrastructure Library™ is a Registered Trade Mark of AXELOS Limited.

Linear Tape-Open™, LTO™, the LTO Logo, Ultrium™, and the Ultrium logo are trademarks of HP, IBM® Corp. and Quantum in the U.S. and other countries.

Intel™, Intel logo, Intel Inside™, Intel Inside logo, Intel Centrino™, Intel Centrino logo, Celeron™, Intel Xeon™, Intel SpeedStep™, Itanium™, and Pentium™ are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT™, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.


Java Logo
 Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Cell Broadband Engine™ is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.

ITIL™ is a Registered Trade Mark of AXELOS Limited.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Terms and conditions for product documentation

Permissions for the use of these publications are granted subject to the following terms and conditions.

Applicability

These terms and conditions are in addition to any terms of use for the HCL website.

Personal use

You may reproduce these publications for your personal, noncommercial use provided that all proprietary notices are preserved. You may not distribute, display or make derivative work of these publications, or any portion thereof, without the express consent of HCL.

Commercial use

You may reproduce, distribute and display these publications solely within your enterprise provided that all proprietary notices are preserved. You may not make derivative works of these publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of HCL.

Rights

Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the publications or any information, data, software or other intellectual property contained therein.

HCL reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by HCL, the above instructions are not being properly followed.

You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations.

HCL MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

Trademarks

HCL, the HCL logo, and ibm.com are trademarks or registered trademarks of HCL Technologies Ltd. in the United States, other countries, or both. If these and other HCL trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by HCL at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.



 Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.