Managing Java packages on agents in bulk

You can manage the Java distribution on your numerous agents by using Bulk Actions.

Important:
  • The agents support Java 11 and later versions.
  • The compatible file extensions are .zip, .tar, .tar.gz, .tgz, .tar.bz2, and .tbz2.
  • The procedure in this section is applicable only for the operating systems that have compact agents. Agents on operating systems like z/OS and AIX cannot be updated with this procedure.

When you have multiple agents running in your production environment, it can become difficult to apply Java patches regularly. Using Bulk Actions, you can manage Java packages on your agents with just a few clicks.

To manage Java package on several agents in bulk:

  1. Upload the required Java package.
    1. Click Settings > System > Manage Java Packages.
    2. Click Add Package to upload a Java package.
    3. Enter a name for the Java package to upload.
      Note: When you try to upload Java packages, any invalid package names, which include spaces or special characters, display an error message: Invalid package name.
    4. Click Choose File, select the Java package to upload, and then click Submit.
      The Java package is uploaded into the system.
      Note:

      Incompatible file formats display displays will display a an error message:

      Cannot recognize package.
  2. Set the Java package as preferred for the OS and CPU type from the menu option.
    Typically, you must set at least one Java package as preferred for each OS and CPU type.
  3. Go to the Agents page and select the agents for which you want to update the Java.
  4. Install the preferred Java package by clicking Bulk Actions > Install Preferred Java Package and confirming the action.
    A message window opens, indicating that the Java installation has started. The installation might take some time. You can close the message window while the installation runs in the background.
  5. Verify that the Java is installed for the agents by checking the Version column.
  6. Set the JAVA_HOME on the agents by clicking Bulk Actions > Set Java Home to Preferred Java Package and confirming the action.
    A message window opens, indicating that the Java update request was sent. This step might take some time. You can close the message window while the JAVA_HOME is updated in the background.
  7. Verify that the Java home is updated for the agents.
  8. Restart the agents by clicking Bulk Actions > Restart.
    Agents restart and run with the new Java version. You can refresh the Agents page to check if the agents are online.
  9. Remove unused Java package versions by clicking Bulk Actions > Remove Unused Java Packages.
    A message displays indicating the number of removed Java packages.