Skip to main content

Create and install a patch bundle

The patchnotification utility provides an option to create a patch bundle for ArcGIS Enterprise components. These patch bundles can be installed in any environment, but are most useful for disconnected environments that cannot access the patch information directly. For more information about the patchnotification utility, see About the patch notification utility.

To create a patch bundle, the machine on which you run the patchnotification utility must have:

  • One or more ArcGIS Enterprise installed components

  • Internet access

The bundled output can then be installed on the same or a different machine in your environment, for example, one without internet access.

Parameters

The following parameters can be used when creating a patch bundle with the patchnotification utility. Parameters can be used to filter patches by product or ArcGIS Enterprise component and to select which patches to include in the bundled output.

Parameter Description
--plan-create Creates a patch bundle.
--products Filters patches by product or component.
--select Prompts for patch selection.
--output Specifies the output bundle location.

Parameter options

When creating a patch bundle, consider the following parameter options:

  • --products accepts component names such as server and portal.

  • Omit --products to use all installed components.

  • Use --products list to display accepted component names.

  • Omit --select to include all matching patches.

  • Existing output files are not overwritten.

After specifying your desired parameters, the utility will download all relevant patches within a single patch bundle.

View patches in a bundle

To view the patches in a bundle that you've already created without installing them, run the following command:

./patchnotification --plan-install --bundle /transfer/patch-bundle.zip --show

patchnotification.bat --plan-install --bundle /transfer/patch-bundle.zip --show

The utility displays the patches included in the bundle and exits without performing any installation.

Create a patch bundle

You can create a patch bundle that contains all available patches or just those for a specific component. Steps are provided for both workflows.

  1. Sign in to the machine where the ArcGIS Enterprise component is running.

  2. You can launch the patchnotification utility from the installed programs menu or from the command line. For additional information about running the utility, see Use the patch notification utility.

    1. To create a patch bundle that contains only selected patches, specify the component name in your command. For example, if you want to create a bundle for only ArcGIS Server, specify the product as server.

      patchnotification.bat --plan-create --products server --select --output /transfer/patch-bundle.zip

      ./patchnotification --plan-create --products server --select --output /transfer/patch-bundle.zip

    2. To create a bundle to only contain all available patches, run the following command:

      patchnotification.bat --plan-create --output /transfer/patch-bundle.zip

      ./patchnotification --plan-create --output /transfer/patch-bundle.zip

Install a patch bundle

To install the contents of a patch bundle, run the following command:

patchnotification.bat --plan-install --bundle /transfer/patch-bundle.zip

./patchnotification --plan-install --bundle /transfer/patch-bundle.zip

The utility validates the bundle and installs the patches included in the bundle.

Install a patch bundle on a disconnected machine

After you've created a patch bundle, you can install it on a machine that does not have access to patch repositories or the internet. To do so, complete the following steps:

  1. Create a patch bundle on a connected machine.

  2. Transfer the patch bundle to the machine you'd like to apply it to.

  3. Use the following command to install the bundle:

    patchnotification.bat --plan-install --bundle /transfer/patch-bundle.zip

    ./patchnotification --plan-install --bundle /transfer/patch-bundle.zip

Configure download and installation settings

By default, downloaded files are stored in the system temporary directory and patch folders are retained after installation.

You can configure the download and installation settings by specifying a different location for downloaded files and choosing whether to retain or delete patch folders after installation. Use the following parameters with the patchnotification utility:

Change the download location

To change the location where downloaded files are stored, use the graphical interface or specify a download directory from the command line:

patchnotification.bat -d <download_location>

./patchnotification -d <download_location>

Delete patch folders after installation

To automatically remove downloaded patch folders after successful installation, run the following command:

patchnotification.bat -o always

./patchnotification -o always

The default behavior is to retain patch folders after installation. To retain the patch folders, run the following command:

patchnotification.bat -o never

./patchnotification -o never

Additional considerations

  • If your ArcGIS Enterprise deployment includes multiple machines, such as a highly available Portal for ArcGIS deployment or multi-machine ArcGIS Server site, apply the same patch level to all participating machines.

  • Maintain consistent patch levels across all machines in the deployment.