search cancel

Automic Workload Automation Pre-Upgrade Review Call Questions

book

Article ID: 222239

calendar_today

Updated On:

Products

CA Automic One Automation CA Automic Workload Automation - Automation Engine

Issue/Introduction

Here is a list of best practice questions to answer in an upgrade plan that Support can review with you.  A couple weeks ahead of an upgrade, please open a case with Support.  You'll be asked for an upgrade plan and this article can be used as a basis for your upgrade plan.  This is based on upgrade plans Support has seen in the past that have the most success.  An upgrade plan is typically a couple of pages long, but sometimes can be detailed down to the smallest detail so that nothing is missed and Support knows what's happening if something goes wrong and troubleshooting is needed.

 

Please take advantage of our Broadcom Enterprise Software Academy courses that are made available to our customers at no additional cost:

Automic Automation: Upgrading to Version 21

This course helps Automic Automation administrators plan, prepare and execute the upgrade process of their systems. It also describes the steps that are necessary to manually execute the upgrade of all Automic Automation components from 12.3 to version 21.
At the end of this course you will be able to:

  • Define a strategy for the upgrade
  • Prepare thoroughly for the upgrade
  • Execute the upgrade minimizing downtime and avoiding errors
  • At the end of each module, this course provides a checklist of the tasks involved in the process that has been described. You can copy and paste these checklists elsewhere.

Course title: Automic Automation: Upgrading to Version 21

 

Additional titles on BROADCOM'S ENTERPRISE SOFTWARE ACADEMY for v21 PREPARATION

Course title: Automic Automation TLS and Certificates

Course title: Automic Automation Kubernetes Edition (AAKE)

Plus many more including administration guides.

Resolution

Pre-work:

Testing

    • Did you test this in non-production first?
    • Is production the exact same as non-production?  If not, what is difference between the two?
    • Did you run into problems with the non-prod upgrade?  If so, what sorts of problems did you run into?  The workarounds/solutions should be noted.

Backup plan

    • What will you be backing up prior to upgrade?
    • When will you take the backup?

Backout/rollback plan

    • When will you make the decision to back out in case something goes wrong?
    • What steps will be taken to back out of the upgrade?
    • Do you have a workaround in the meantime?


Timeline should include

  • When does the installation or upgrade begin (date and time)?
  • What date/time will you stop components that need to be stopped?
  • For each component:
    • What date/time will do you plan on updating each component?  
    • How long will these take?  
    • When do you expect to be finished with each component?  
    • How long will testing take to be sure it upgraded correctly?
  • When will you make the decision to back out in case something goes wrong?
  • When do you plan on having the upgrade end (date and time)?

Technical

Sizing Requirements

TLS/SSL

    • Are you upgrading to 21.0?  If so, have you fully reviewed the TLS requirements?  Do you have the certificates and keystore files needed already from your security team?
    • In addition, note the following documentation for TLS/SSL Troubleshooting of common certificate errors.

Components

    • What components are being upgraded?
      • Core components
        • AE
        • Utilities
        • Initialdata
        • AWI
        • ServiceManager
        • Service Manager Dialog
        • Are you using the Zero Downtime Upgrade or a manual upgrade?  
          • Please note - do not use ZDU from version 12.2.6 or lower as there are a lot of known issues
      • Agents
        • (which type of agents - OS, RA, etc...)
        • Are you upgrading agents?  From what version/service pack to what version/service pack?
          • Are you using the centralized agent upgrade?  Or manual upgrade?
          • Has each type of agent upgrade been tested?
      • other
        • Are there any 3rd party components being upgrade?  Examples:
          • Java (from, to versions?)
          • Database (from, to type and versions?)
          • OS patches (from, to flavor and versions?)
          • OS in general (from, to flavor and versions?)
    • What steps/commands are you using to upgrade each component?
    • Are you copying a database?  
      • If so, is there enough space on the target server?
    • Is this an upgrade of a current system?  
    • Are you migrating data from one system to another?
    • Is there any pre-work to be done on the system before stopping to upgrade?  (for example are you stopping clients or queues?)
    • In what order will you be stopping running components?
    • In what order will you be starting components back up?
      • What commands will you use to start them up?
      • What user and environment settings are normally used to bring up the processes?  What will be used during and after the upgrade?

Version 21.0 "musts"

Are you updating to version 21.0?  If so, please note the below:

    • Any component upgraded to 21.x MUST use the ini file for that version; the old ini file will not work - there is no automatic update of ini files from 12.x to 21.x
    • As a best practice, upgrade java to the latest build - there are some problems with older builds and certificates (specifically with Java 11, be on 11.0.14 or later).
    • 21.0 Java agents (DB_Service, RA agents, PeopleSoft, SAP, etc...) may require two steps for TLS - the cacerts must have the certificate imported; trustedCertFolder= setting must be updated
    • Analytics must also be updated at the same time as the core components
    • If you are upgrading 12.x to 21.0 and use servicemanager to start components, you must create a new entry for the JCP.  The 12.x entry with the flag -rest will start the REST component; -cp is needed for the 21.0 JCP
    • Plugin Manager is no longer needed in 21.0; it is automatically included
    • AWI and TLS-enabled Agents (most 21.0 agents) must point to the WS.PORT and not the CP.PORTS entries
    • Non-TLS-enabled Agents (some 21.0 agents and all 12.x components) must point to the CP.PORTS and not the WS.PORT entries
    • Always try to upgrade to the latest servicepack and hotfix - we are constantly improving the software and a lot of high urgency/impact issues are fixed in the latest
    • Agent versions that are out of support are not supported with 21.0

If something goes wrong

  • What is an acceptable situation/workaround if something does go wrong?  How long can it stay like that?
  • What is your backout plan for each component?
  • Who from your team needs to be available for troubleshooting?
  • Do you have the support number to call in case something goes wrong?  Severity 1 cases cannot be raised from the website.  Use a new case when running into a new issue.