You must validate your vRealize Orchestrator deployment before upgrading to a newer product version.

Procedure

  1. Perform the following pre-upgrade validation steps when upgrading from vRealize Orchestrator 8.0-8.5 to vRealize Orchestrator 8.5.1 or later.
    1. Log in to the vRealize Orchestrator Appliance command line as root.
    2. Validate whether VM Hard disk 4 has enough capacity by running the following script:
      vracli cluster exec -- sh -lc "base64 -d <<< 'IyEvYmluL2Jhc2gKCnNldCAtZQp2ZXI9JCh2cmFjbGkgdmVyc2lvbiB8IGhlYWQgLW4gMSB8IGF3ayAne3ByaW50ICQzfScgfCBhd2sgLUYgLiAne3ByaW50ICQxJDIkM30nKQppZiBbICR2ZXIgLWdlIDg1MSBdOyB0aGVuCiAgZWNobyAiVGhpcyBLQiBpcyBhcHBsaWNhYmxlIGZvciB2UtCeIHZlcnNpb25zIGJlbG93IDguNS4xIgogIGV4aXQgMApmaQptdHJGclNwY0tiPSQoZGYgLVAgL21ldHJpY3MgfCBhd2sgJ0VORHtwcmludCAkNH0nKQptdHJUb3RTcGNLYj0kKGRmIC1QIC9tZXRyaWNzIHwgYXdrICdFTkR7cHJpbnQgJDJ9JykKcnRTektiPSQoZHUgLWtzIC9yb290IHwgYXdrICd7cHJpbnQgJDF9JykKbXRyUmVtRnJTcGNLYj0kKCggbXRyRnJTcGNLYi1ydFN6S2IgKSkKbXRyRXhwTWluRnJTcGNLYj0kKCggbXRyVG90U3BjS2IqMS8xMDAgKSkKaWYgWyAkbXRyUmVtRnJTcGNLYiAtbGUgJG10ckV4cE1pbkZyU3BjS2IgXTsgdGhlbgogICAgZGlmZj0kKCggKG10ckV4cE1pbkZyU3BjS2ItbXRyUmVtRnJTcGNLYikvMTAyNC8xMDI0KzEgKSkKICAgIGVjaG8gIlVwZ3JhZGUgcmVxdWlyZXMgYWRkaXRpb25hbCAkZGlmZiBHQiBvZiBkaXNrIHNwYWNlIG9uIFZNIEhhcmQgZGlzayA0IG9mICQoIGN1cnJlbnRfbm9kZSApLiBSZXNpemUgVk0gSGFyZCBkaXNrIDQgYWNjb3JkaW5nbHkgb3IgcmVtb3ZlIG9ic29sZXRlIHVzZXIgZmlsZXMgZnJvbSAvcm9vdCBpbiBvcmRlciB0byBwcm9jZWVkIHdpdGggdGhlIHVwZ3JhZGUuIgogICAgZXhpdCAxCmVsc2UKICAgIGVjaG8gIk5vIGFkZGl0aW9uYWwgZGlzayBzcGFjZSBpcyByZXF1aXJlZCBvbiBub2RlOiAkKCBjdXJyZW50X25vZGUgKSIKZmkK' | sh -"
      If the preceding validation fails with the message Upgrade requires additional X GB of disk space on VM Hard disk 4 for any of the nodes in the cluster, follow the instructions from the script output for each respective node.
  2. Perform the following pre-upgrade validation steps when upgrading from vRealize Orchestrator 8.0-8.5.1 to vRealize Orchestrator 8.6 or later.
    1. Take a virtual machine (VM) snapshot of your vRealize Orchestrator deployment. See Taking a Snapshot.
    2. Log in to the vRealize Orchestrator Appliance command line as root.
    3. Generate a log bundle of your vRealize Orchestrator deployment by running the vracli log-bundle command.
      Note: The log bundle is required and used by VMware support as a reference point in case of upgrade failure or any other post-upgrade issues.
    4. Navigate to the /var/log/ directory and check the size of the cron and auth.log files. If both files are too large, delete them.
    5. Validate whether there is enough available space in the /services-logs directory by running the following script:
      vracli cluster exec -- sh -lc "base64 -d <<< 'IyEvYmluL2Jhc2gKCnNldCAtZQoKdmVyPSQodnJhY2xpIHZlcnNpb24gfCBoZWFkIC1uIDEgfCBhd2sgJ3twcmludCAkM30nIHwgYXdrIC1GIC4gJ3twcmludCAkMSQyJDN9JykKaWYgWyAkdmVyIC1nZSA4NiBdIHx8IFsgJHZlciAtbHQgODYgXTsgdGhlbgogIGVjaG8gIlRoaXMgS0IgaXMgb25seSBhcHBsaWNhYmxlIGZvciB2Uk8gOC42IG1ham9yIHZlcnNpb24uIgogIGV4aXQgMApmaQoKZWNobyAiQ2hlY2tpbmcgYXZhaWxhYmxlIHNwYWNlIGluIC9zZXJ2aWNlcy1sb2dzLi4uIgpzdmNMb2dzRnJlZVNwYWNlS2I9JChkZiAtUCAvc2VydmljZXMtbG9ncyB8IGF3ayAnRU5Ee3ByaW50ICQ0fScpCnN2Y0xvZ3NUb3RhbFNwYWNlS2I9JChkZiAtUCAvc2VydmljZXMtbG9ncy8gfCBhd2sgJ0VORHtwcmludCAkMn0nKQp2YXJMb2dTaXplS2I9JChkdSAta3MgL3Zhci9sb2cgfCBhd2sgJ3twcmludCAkMX0nKQoKZWNobyAiL3Zhci9sb2cgdG90YWwgc2l6ZSAoa2J5dGVzKTogJHZhckxvZ1NpemVLYiIKZWNobyAiQXZhaWxhYmxlIHNwYWNlIG9uIC9zZXJ2aWNlcy1sb2dzIChrYnl0ZXMpOiAkc3ZjTG9nc0ZyZWVTcGFjZUtiIgoKc3ZjTG9nc1JlbWFpbmluZ0ZyZWVTcGFjZUtiPSQoKCBzdmNMb2dzRnJlZVNwYWNlS2ItdmFyTG9nU2l6ZUtiICkpCnN2Y0xvZ3NFeHBlY3RlZE1pbkZyZWVTcGFjZUtiPSQoKCBzdmNMb2dzVG90YWxTcGFjZUtiKjEvMTAwICkpCgppZiBbICRzdmNMb2dzUmVtYWluaW5nRnJlZVNwYWNlS2IgLWxlICRzdmNMb2dzRXhwZWN0ZWRNaW5GcmVlU3BhY2VLYiBdOyB0aGVuCiAgIGRpZmY9JCgoIHN2Y0xvZ3NFeHBlY3RlZE1pbkZyZWVTcGFjZUtiLXN2Y0xvZ3NSZW1haW5pbmdGcmVlU3BhY2VLYiApKQogICBlY2hvICJDb250ZW50IGluc2lkZSAvdmFyL2xvZyBleGNlZWRzIHJlcXVpcmVkIGF2YWlsYWJsZSBzcGFjZSBpbiAvc2VydmljZXMtbG9ncyBieSAkZGlmZiBLQi4gSW5jcmVhc2UgdGhlIHNpemUgb2YgVk0gSGFyZCBkaXNrIDMgYWNjb3JkaW5nbHkuIgogICBleGl0IDEKZmkK' | sh -"
      If the preceding validation fails with the message Content inside /var/log exceeds required available space in /services-logs by X KB, increase the size of VM Hard disk 3 by following the instructions from the script output for each respective node.

What to do next

Upgrade your vRealize Orchestrator deployment.