CA Tuesday Tip: WAAE R11.3 SP1 Upgrade step-by-step by Stacey Ruggiero Sr. Support Engineer 11/13/2012
https://support.ca.com/irj/portal/solncdndtls?aparNo=RI48705&os=ANY&fc=2&actionID=3
Published Document:
RI48705
TITLE: ALL-CA WAAE R11.3 SP1 UPGRADE/REINSTALL REFERENCE
***** Product Documentation Change *****
This document is intended to assist AE R11.3
users who are planning/implementing upgrade to
the latest AE R11.3 SP1 release as recommended
by the CA WA Dist Support team. This document
will provide a step-by-step approach of all the
portions of this effort, which have been
verified by a walk-through within the AE Level 2
support area.
Please make sure you review and understand these
various sections and their associated steps.
If you have any questions, please contact the CA
Workload Automation AE level 1 team by opening a
Support ticket by using the CA Support Site WEB
page link selection from the left side labeled:
Open a Case
HYPER: NO
DISTRIBUTION CODE: A (A=Available, I=Internal)
DOWNLOAD INFORMATION:
NODE: ftp.ca.com
PATH: /CAproducts/unicenter/autosys/all/RI48705
FILES: RI48705.CRZ________ ___________________ ___________________
___________________ ___________________ ___________________
PROBLEM RESOLUTION: Follow the instructions below:
---------------------------------------------------------------------
This is a "How to" document guide for installation/upgrade to CA
Workload Automation AutoSys Edition (CA WAAE) R11.3 SP1 product
release.
This document is intended to assist AE R11.3 users who are
planning or implementing upgrade to the latest CA WAAE R11.3 SP1
release as recommended by the CA WA Dist Support team.
To Download the required CA WAAE 11.3 SP1:
------------------------------------------
Use the CA Support Site WEB page link selection from the left side
labeled: "Download Center"
Within this page "Product" selection: "CA Workload Automation AE
Server 1 - 2 CPUs MULTIPLATFORM"
Within the "Select a Release" menu choose: "R11.3"
Within the "Select a Gen Level" menu choose: "SP1"
You will now see a list of ISO files for the AE R11.3 SP1 product
release that will need to be downloaded in order to perform the
first step of this procedure. The details for this are listed below
based on Platform and Component.
To Download the required WCC 11.3 SP1 release:
----------------------------------------------
Use the CA Support Site WEB page link selection from the left
side labeled: Download Center
Within this page "Product" selection: "CA Workload Control Center
- MULTI-PLATFORM"
Within the "Select a Release" menu choose: "R11.3"
Within the "Select a Gen Level" menu choose: "SP1"
You will now see a list of ISO files for the WCC R11.3 SP1 product
release that will need to be downloaded in order to perform the first
step of this procedure. The details for this are listed below based
on Platform and Component.
Planning: Basic safety consideration and High level architecture:
-----------------------------------------------------------------
First obtain current system and database backups/snapshots
Recommendations:
----------------
It is recommended that all components be upgraded, and running at
the same version. Mixing versions of UWCC, EEM, AutoSys Scheduler/
Agent/Client components can cause unknown behavior.
It is recommended to follow the order mentioned below while
performing installation or upgrade.
Installation:-
- CA Common Components (CCC) r11.3 SP1
- CA Workload Automation AE (WAAE) r11.3 SP1
- CA Workload Control Center (WCC) r11.3 SP1
Upgrade:-
- CA Workload Automation AE (WAAE) r11.3 SP1
- CA Common Components (CCC) r11.3 SP1
- CA Workload Control Center (WCC) r11.3 SP1
Note: EEM 8.4 SP4 CR11 and CA CCS 11.2 SP2 are available in CA
Common Components (CCC) r11.3 SP1 DVD.
CA Workload Automation AE r11.3 SP1 UNIX/Linux:
-----------------------------------------------
Note:
- CA WAAE may startup after install if autostart is chosen with
original install.
- It is strongly recommend to take the backup of $AUTOSYS,
$AUTOUSER, /etc/auto.profile and /etc/auto.$AUTOSERV
- If command sponsor is selected for installation on machine where
ipv6 is not enabled, check the /etc/hosts file and confirm that
it does not have an entry for ipv6 loopback. Comment the entry if
present (i.e. #::1)
- CA recommends unique Agent names. For more information, please
refer to RI45635.
- It is recommended to run the below commands and collect the
output before upgrade:
a. env (to be run as the user performing the upgrade)
b. $AUTOSYS/bin/autoflags -a
c. $AUTOSYS/bin/as_info
- Media Distribution: DVD03143415E.iso
1. Stop CA WAAE Services as follows:
Login as the owner of CA WAAE executable and execute the following
a. $CASHCOMP/bin/unisrvcntr stop waae_agent-<AGENT_NAME>
waae_sched.$AUTOSERV waae_server.$AUTOSERV
b. Take the backup of current CA WAAE file system (i.e.
/opt/CA/WorkloadAutomationAE).
2. Execute wa_setup.sh from 11.3 SP DVD image
a. ./wa_setup.sh
b. It opens up WA AE r11.3 maintenance wizard showing the update
options "Modify", "Update/Reinstall", "Remove"
3. Select "Update/Reinstall" and Click Next to continue.
Review Settings dialog appears, listing the components that will
be updated.
4. Upon clicking Next in "Review Settings dialog" the actual SP
upgrade begins.
a. The Monitor Progress dialog appears, showing the elapsed time
and Overall Progress.
b. It takes a while to complete the upgrade. Once it reaches 100%,
the Setup Complete dialog appears, listing errors, if any.
c. Log will be created at /opt/CA/installer/log/
CAWorkloadAutomationAE.reinstall.<YYYYMMDDHHMMSS>.log
5. For Server installation only, one need to do the following post
upgrade task against each Database of all AE instances.
a. This post upgrade task information will be shown in the "Update
Complete" dialog that appears after the completion of upgrade.
b. Change to $AUTOSYS\dbobj\<ORA or SYB or MSQ> and execute
RefreshAEDB.pl against each Event Server (in DUAL Server Mode)
and follow the instructions that RefreshAEDB.pl asks for.
i. cd $AUTOSYS\dbobj\<DB>
ii. perl RefreshAEDB.pl
Important Notes:
a. This step must be done for each WA AE Server instance. It is
not required for Client only, Agent only or SDK only
installs.
b. This step must be done twice in case of DUAL Server mode
once using Primary database and 2nd time using secondary
database.
6. Verify that the upgrade is complete by running the following:
a. Output of CA WAAE autoflags -a
147 ANY 11.3 SP1 xxxxxxxx hostname
b. Output of the SQL query "select str_val from ujo_alamode where
type='AEDB_VERSION'" should report "11.3.1"
7. Apply WA AE 11.3 SP1 HOT fix that resolves the critical issues.
HOT fix is mandatory to be applied on WA SE Server and optional on
AE Clients and not required to be applied on Agents/SDK machines.
CA Support URL for 11.3 SP1 HOT fix is:
https://support.ca.com/irj/portal/anonymous/phpsupcontent?
contentID={F82B1E8D-F135-4B3B-B4E6-631B49BF699F}.
8. Start CA WAAE Services as follows (if not using Scheduler High
Availability or DUAL Databases (HADS).
Login as the owner of WAAE executable and execute the following:
$CASHCOMP/bin/unisrvcntr start waae_agent-<AGENT_NAME>
waae_sched.$AUTOSERV waae_server.$AUTOSERV
9. Synchronize the databases.
Note: Synchronize database after applying WAAE 11.3 SP1 HOT fix.
autobcp may return error without the HOT fix.
a. cd to appropriate dbobj dir
(i.e. cd $AUTOSYS\dbobj\<ORA or SYB or MSQ>)
b. Run the autobcp "perl ./autobcp<ORA/SYB/MSQ>.pl"
c. Please note ORACLE_HOME should be set for oracle database
before running autobcp.
d. Provide the following details:
i. source db (or current db to be copied)
ii. destination db (usually secondary db)
iii. source user id/password
iv. destination user id/password
v. dump name
e. Confirm if it is ok to delete data in secondary db.
10. For Scheduler High availability.
a. AE may startup after install/upgrade if autostart is chosen.
It may be necessary to disable services to prevent startup.
b. Always start Primary scheduler, then Shadow, and Tiebreaker
(if applicable), in that order, after the upgrades are
completed.
CA Common Components r11.3 SP1 UNIX/Linux:
------------------------------------------
Note:
- EEM 8.4 SP4 CR11 is available in 11.3 SP1 CCC.
- CA CCS 11.2 SP2 is available with 11.3 SP1 CCC.
- If Workload Control Center (WCC) , EEM , CA Event Management,
Event Agent and CA Common Communication Interface (CCI) are not
used, this section can be skipped.
- It is recommended to run the below commands and collect the
information before upgrade:
a. set (to be run as the user performing the upgrade)
b. $CASHCOMP/bin/univer
c. $CASHCOMP/bin/ca_version
d. Log into EEM GUI and locate "About" link to right.
Collect the version information.
- Media Distribution: DVD03151649E.iso
1. Login as root.
2. Locate and mount media.
3. Check if environment is setup. If not, source /etc/profile.CA
4. cd to media location.
5. ./ccc_setup.sh # Execute install script
6. Choose "Update/Reinstall"
7. Installer will stop services if they are running. Choose "Next"
accepting that.
8. Choose "Next".
9. Once the install completes choose "Finish".
10. If EEM is selected for upgrade, check version of EEM after
upgrade
a. grep Version $IGW_LOC/iPoz.conf #should say 8.4.411
b. Log into EEM GUI and locate "About" link to right - should
say 8.4.411
CA Workload Control Center(WCC) r11.3 SP1 Linux/UNIX:
------------------------------------------------------
Note:
- It is strongly recommended to take back-up of conf files of all
components present in WCC Install Location.
- wrapper.conf file for each component gets overwritten when WCC is
upgraded. Then all the existing values will change to Default.
Once upgrade is done, wrapper.conf has to be manually replaced
with the backed up file.
- Install script UnixInstaller.sh supports -console and -graphical
command line arguments. Choose whatever is convenient.
- Before upgrading AE SDK (step#4 and #5 in WCC Install/Upgrade
procedure below), one should determine if SDK upgrade is
necessary. Please follow the procedure show below to check if
one can skip step# 4 & #5 below.
a. Login to the WCC server root.
b. export LD_LIBRARY_PATH as shown below:
# export LD_LIBRARY_PATH=/opt/CA/WorkloadAutomationAE/
autosys/lib:$LD_LIBRARY_PATH
Note: Above path should be exported accordingly. In the above
path it was assumed that SDK was installed at default
location.
c. Check the build number using autoflags -i
# /opt/CA/WorkloadAutomationAE/autosys/bin/autoflags -i
If the output from above command is greater than or equal to 147
then skip step#4 & #5 below as AE SDK was already upgraded to SP1.
- Media Distribution:
- AIX and HP-UX platforms are not available
- DVD04074755E.iso (Sun Solaris)
- DVD04074856E.iso (Linux)
1. Login as root.
2. Locate and mount the appropriate media.
3. set|more # make sure $CA_WCC_INSTALL_LOCATION is set. If not,
source /etc/profile.CA
4. ./UnixInstaller.sh -console # execute installer
5. Install CA Workload Automation AE SDK r11.3 SP1 by choosing
Option 1 in installer.
6. To Upgrade SDK to R11.3 SP1 choose the default selection -
"Update/Reinstall" and proceed next with default selections.
7. Allow the installer to run to completion.
8. Then choose option 2 - Install "Workload Control Center R11.3 SP1"
9. Enter to read/scroll EULA text.
10. Enter 'Y' to accept the EULA.
11. Choose Next to proceed with Reinstall. This option is required to
upgrade WCC R11.3 to SP1. Existing installation will not be lost.
12. Proceed next through the rest of the install observing defaults.
13. Provide EEM Server's password.
14. Leave default for keeping current policies in case same EEM
server is used; do not overwrite existing unless you wish to.
Change EEM server if required.
15. Allow the installer to run to completion.
16. Select 0 to exit when the install completes.
17. Check version
$CA_WCC_INSTALL_LOCATION/uejmver.sh
Level: 11.3
Service Pack: 1
Build Number: 64
CA Workload Automation AE r11.3 SP1 Windows:
--------------------------------------------
Note:
- It is strongly recommended to take the backup of %AUTOSYS% and
%AUTOUSER% directories.
- Agent names should be unique. For more information, please
refer to RI45635.
- It is recommended to run the below commands and collect the
output before upgrade:
a. set (to be run as the user performing the upgrade)
b. %AUTOSYS%/bin/autoflags -a
c. %AUTOSYS%/bin/as_info
- Media Distribution: DVD03141626E.iso
1. Stop the CA Workload Automation AE (WAAE) services.
a. Start the CA Workload Automation AE Administrator GUI.
b. Click the "Services" button on the toolbar.
c. Select the "CA Workload Automation AE Scheduler".
d. Click the "Stop Service" button.
e. Select the "CA Workload Automation AE Agent".
f. Click the "Stop Service" button.
g. Select the "CA Workload Automation AE Application Server".
h. Click the "Stop Service" button.
Note: Right-click on the service and select "Stop" from pull-down
menu to stop the services.
2. Take the backup of current CA WAAE file system (i.e.
<Drive>:\Program Files\CA\Workload Automation AE).
3. Execute DVD\EWA\setup.exe from 11.3 SP DVD image.
4. It opens up WAAE r11.3 "Welcome" dialog showing the update options
"Modify", "Repair","Remove".
5. Select "Repair" and Click Next to continue.
6. "Review Settings" dialog appears listing the components that will
be updated.
7. Upon clicking Next in "Review Settings dialog" the actual SP
upgrade begins.
8. The Setup Status" dialog appears, showing the Overall Progress.
9. It takes a while to complete the upgrade. Once it reaches 100%,
then it shows "Installation Complete" dialog. Log will be created
at %TEMP%\WAAE_Install.log .
10. For Server installation only, one need to do the following post
upgrade task. This post upgrade task information will be shown in
the above "Installation Complete" dialog that appears after the
completion of upgrade.
Change to %AUTOSYS%\dbobj\<ORA or SYB or MSQ> and execute
RefreshAEDB.pl against each Event Server (in DUAL Server Mode)
and follow the instructions that RefreshAEDB.pl asks for.
a. Open CA WAAE Command Prompt.
b. cd %AUTOSYS%\dbobj\<DB>
c. perl RefreshAEDB.pl
Important Notes:
- This step must be done for each WA AE Server instance. It is
not required for Client only, Agent only or SDK only installs
- This step must be done twice in case of DUAL Server mode once
using Primary database and 2nd time using secondary database.
11. Verify that the upgrade is complete by running the following:
a. Output of CA WAAE autoflags -a
147 Windows_NT ANY 11.3 SP1 0 hostname
b. Output of the SQL query "select str_val from ujo_alamode where
type='AEDB_VERSION'" should report "11.3.1"
12. Apply WA AE 11.3 SP1 HOT fix that resolves the critical issues.
HOT fix is mandatory to be applied on WA SE Server and optional
on AE Clients and not required to be applied on Agents/SDK
machines. CA Support URL for 11.3 SP1 HOT fix is:
https://support.ca.com/irj/portal/anonymous/phpsupcontent?
contentID={F82B1E8D-F135-4B3B-B4E6-631B49BF699F}.
13. Start the CA WAAE services if you are not using High Availability
or DUAL Server.
a. Start the CA Workload Automation AE Administrator GUI.
b. Click the "Services" button on the toolbar.
c. Select the "CA Workload Automation AE Scheduler".
d. Click the "Start/Resume Service" button.
e. Select the "CA Workload Automation AE Agent".
f. Click the "Start/Resume Service" button.
g. Select the "CA Workload Automation AE Application Server".
h. Click the "Start/Resume Service" button.
Note: Right-click on the service and select "Start" from
pull-down menu to start the services.
14. Synchronize the databases
Note: Synchronize database after applying WA AE 11.3 SP1 HOT fix.
autobcp may return error without the HOT fix.
a. cd to appropriate dbobj dir (i.e. cd %AUTOSYS%\dbobj\<ORA or
SYB or MSQ>).
b. Run the autobcp "perl ./autobcp<ORA/SYB/MSQ>.pl".
c. Please note ORACLE_HOME should be set for oracle database
before running autobcp.
d. Provide the following details:
i. source db (or current db to be copied).
ii. destination db, usually secondary db.
iii. source user id/password.
iv. destination user id/password.
v. dump name.
e. Confirm if it is ok to delete data in secondary db
15. For Scheduler High availability
a. AE may startup after install/upgrade if autostart is chosen.
It may be necessary to disable services to prevent startup.
b. Always start Primary scheduler, then Shadow, and Tiebreaker
(if applicable), in that order, after the upgrades are
completed.
CA Common Components r11.3 SP1 Windows:
---------------------------------------
Note:
- EEM 8.4.411 is available in 11.3 SP1 CCC. If EEM has to be
upgraded, it is recommended to follow the procedure mentioned
in EEM Product documentation and take required back-up.
- CA CCS 11.2 SP2 is available in 11.3 SP1 CCC.
- If Workload Control Center (WCC) , EEM , CA Event Management,
Event Agent and CA Common Communication Interface (CCI) are not
used, this section can be skipped.
- It is recommended to run the below commands and collect the
information before upgrade:
a. set (to be run as the user performing the upgrade)
b. %CASHCOMP%/bin/univer
c. %CASHCOMP%/bin/ca_version
d. Log into EEM GUI and locate "About" link to right.
Collect the version information.
- Media Distribution: DVD03151508E.iso
1. Login as administrator and mount the media.
2. Select "CA Common Components".
3. Click "Install".
4. Click "Add/Modify", then click "Next".
5. Read/Accept EULA, then click "Next".
6. Applicable Components should be selected, click "Next".
7. If EEM is selected for upgrade, installer prompts for EiamAdmin
"EEM" password, provide details and click "Next".
8. Click "Install".
9. Click "Done" when it completes.
10. If EEM is selected for upgrade, check the version after upgrade.
Log into EEM GUI and locate "about" link to right - should say
8.4.411
CA Workload Control Center r11.3 SP1 Windows:
---------------------------------------------
Note:
- It is strongly recommended to take backup of conf files of all
components present in WCC Install Location.
- wrapper.conf file for each component gets overwritten when WCC is
upgraded. Then all the existing values will change to Default.
Once upgrade is done, wrapper.conf has to be manually replaced
with the backed up file.
- Media Distribution: DVD04074655E.iso
1. Login as administrator and mount media.
2. Run the PE_i386.EXE installer.
3. Select "Install CA Workload Automation AE SDK".
4. To Upgrade SDK to R11.3 SP1, proceed Next with default selections.
5. Allow the installer to run to completion. Reboot the server.
6. Run the PE_i386.EXE installer.
7. Select "CA Workload Control Center" and click Install.
8. Click "NEXT" on Welcome screen.
9. Scroll through the License agreement. Agree to the EULA and click
"Next".
10. Click "Next" on "Reinstalling CA Workload Control Center" popup.
This option is required to upgrade WCC R11.3 to SP1.
11. Proceed through the install accepting defaults.
12. Select Keep Policies in case same EEM server is used; do not
overwrite existing policies unless you wish to overwrite. Change
EEM server, if required.
13. Click Install and allow the installer to run to completion.
14. Exit the installer and reboot server.
15. After Server Restart, check the version.
cd %CA_WCC_INSTALL_LOCATION%
.\uejmver.bat
- Version should be
Level: 11.3
Service Pack: 1
Build Number: 64
Thank you for your continued support of CA and its products. If you
have any questions about this Product Documentation Change or any other
questions about this product, please contact your local CA Technical
Support organization.
PRODUCT(S) AFFECTED: AutoSys Base RELEASE 11.3