> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/device-software/upgrading-multiple-controllers.md).

# Upgrading Multiple Controllers

### Introduction

Using the Controller Upgrade feature to upgrade firmware on multiple Controllers simplifies the upgrade process and reduces the risk of errors.

The upgrade process involves downloading the software to the Controller, replacing the software on the Controller, and then rebooting the Controller.

### Prerequisites

Before performing this procedure, ensure:

* A Command Centre version upgrade has already been completed, and the workstation performing this Controller upgrade has already had a workstation Click-Once client upgrade.
* The Controller’s new software version and customisations (if any) have been created in the Device Software List Window. Refer to [Adding a new version of Device Software](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/device-software/adding-a-new-version-of-device-software.md) for the procedure.

  **Note:** Customisations do NOT need to be uninstalled before an upgrade.

### Procedure

1. Click **Manage** from the menu bar, then **Controller Upgrade**.

   The **Controller Upgrade** Window opens (in [grid view](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/list-windows/grid-view.md)).

   All Controllers in the system are listed, and by default are sorted by 'Name'.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-def461be2fa7629b6d264c777ee60a4685c53842%2Fcontrollerupgradewindow_noneselected.png?alt=media)

   **Notes:**

   * The Column Headers can be resized and/or repositioned, and the information in the columns can be resorted. See [Grid View](https://help.security.gallagher.com/knowledge-hub/configuration-client/introduction-to-command-centre/knowing-your-way-around/list-windows/grid-view.md) for further detail.
   * The properties of a Controller in the list can be opened by either double-clicking on it, or right-clicking and selecting **Properties**. The Controller properties open on the **Status and Overrides** tab.
2. The filtering options at the top of this window allow you to sort and group Controllers, and determine which versions of firmware they are currently running.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-d7826455e6e33975a78ff41d9a4c17702e45d99b%2Ffilteringoptions.png?alt=media)

   Set the appropriate search criteria from the filtering options, as follows:

   <table><thead><tr><th width="148">Filtering Option</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>This option allows you to type a name in the Search field. This may be useful if your site has implemented a naming convention for Controllers.</td></tr><tr><td>Description</td><td>This option allows you to type in the Search field. This may be useful if your site includes descriptions for Controllers, (e.g. notes about what the Controller is connected to or where it is located).</td></tr><tr><td>Division</td><td>Upgrades are typically done by building or area. If your site has specified Divisions for building or areas, this may be the preferred method of sorting and grouping the Controllers.</td></tr><tr><td>Upgrade Status</td><td>This option allows you to filter based on the current upgrade status of the controller. The status options are shown below:<br><img src="https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-19a411ce94d8555c6662b750e75c2025073f6562%2Fupgradestatus_filteringoptions.png?alt=media" alt=""></td></tr><tr><td>Software Installed</td><td>This option allows you to select a software version from a drop-down list, which will then display the Controllers that are currently running that software.</td></tr><tr><td>Software Not Installed</td><td>This option allows you to select a software version from a drop-down list, which will then display the Controllers that are NOT running that software.</td></tr><tr><td>Customisations Installed</td><td>This option allows you to select a customisation from a drop-down list, which will then display the Controllers that are currently running that customisation.</td></tr><tr><td>Customisations Not Installed</td><td>This option allows you to select a customisation from a drop-down list, which will then display the Controllers that are NOT running that customisation.</td></tr><tr><td>Dipswitch2 may be on</td><td>Selecting this option will list any Controllers with Dipswitch2 on, and any other Controllers that are not online at the moment, (e.g. offline or not fully configured Controllers).</td></tr><tr><td>Downloading Device Software</td><td>Selecting this option will list any Controllers with any connected HBUS devices that currently have software downloading to them.</td></tr></tbody></table>
3. Select the Controller(s) you want to upgrade the firmware for, (i.e. click on an individual Controller, or for multiple Controllers hold the < **Ctrl** > key down while clicking on each Controller).

   The buttons across the top of the window become enabled.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-e483abb92c8477efb8c3d3a7fa66a41e7af8fe9b%2Fcontrollerupgradewindow.png?alt=media)
4. Click the **Software Version** button.

   The Select Controller Version dialog displays.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-9bbd1096a06fc6b688c38788846d8db299b7f3de%2Fselectcontrollerversion.png?alt=media)
5. Click on the **Upgrade to** drop-down list and select the required Controller version.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-8da74e244536946b541fe9a214bf166ec97f784e%2Fselectcontrollerversion_dropdown.png?alt=media)

   **Notes:**

   * The drop-down list shows the latest controller device software created in system with the label '(latest)'.
   * If you selected multiple Controllers with different software or customisations configured, the software version fields will display **-- Multiple Selected --**.

     Any changes are then applied to all selected Controllers.

     ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-73cd5002bef740935d4d09958752031ca7f97f6a%2Fswversion_multipleselected.png?alt=media)
6. Expand the **Customisations** pane by clicking on the ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-0228eb1f1a92de1338a29064ed448bb7c5a3b486%2Fexpandbutton.png?alt=media) button.
7. Click on the **Available** drop-down list and select the required customisation.

   **Note:** The drop-down will be empty if there are no Controller customisations in the system.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-dcbc4d9fab2365ad428154d20943d59a760f9a80%2Fselectcustomisation.png?alt=media)

   The selected customisation will display in the **Selected** grid.

   **Note:** If you wish to remove a customisation from the **Selected** grid, highlight the customisation, right-click and select **Remove from List**.
8. Click the **OK** button.

   The Select Controller Version dialog closes.
9. Do you want to upgrade the Controllers now or schedule the upgrade for later?

   If **now**, go to Step 10.

   If **later**, go to Step 12.
10. Click the **Upgrade Now** button.

    The Run Controller Upgrade dialog displays.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-f78d480c99229a0f6c06aad9aa13a9d6d0062a02%2Fruncontrollerupgrade.png?alt=media)

    **Note:** Upgrades require Controllers to be online and Dipswitch 2 to be OFF. A warning message will display in the lower part of this dialog if any of the Controllers are offline OR Dipswitch 2 is ON:

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-2a30fecd2ddaeca37cd17cba5cae1a808970a87d%2Fdipswitch2_warning.png?alt=media)
11. Click the **Upgrade Now** button.

    The Run Controller Upgrade dialog closes and the upgrade begins.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-58e7d3791d25b56eb205725724b6810ff3aa9325%2Fupgradestatus.png?alt=media)

    You can view the progress of the upgrade for each Controller in the **Upgrade Status** column, and the global progress bar at the bottom of the window displays the aggregated progress of all current upgrade activity.

    **Notes:**

    * If a user attempts to upgrade a Controller that already has an upgrade scheduled, the following message displays:

      ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-240ac84de57d2aceed2c19c15330011517c42d36%2Fscheduledcontrollersselectedmessage.png?alt=media)
    * With a large number of Controllers selected it can take a while for the upgrade to be initiated. In this case, a progress dialog will display:

      ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-f074045a197afd426f1dfdcf9dd27b66f47e2942%2Finitiatingupgrade.png?alt=media)

    The various states reflect what point the upgrade is at, as follows:

    <table><thead><tr><th width="148">Upgrade State</th><th>Description</th></tr></thead><tbody><tr><td>Error</td><td>There is a problem with the upgrade.</td></tr><tr><td>Manual upgrade with USB required</td><td>The Controller is running the installed software but not running the download software. A manual upgrade with USB is required because the Controller has the <strong>Perform upgrades via USB</strong> option selected (on the <strong>Software</strong> tab of the Controller properties).</td></tr><tr><td>Performing Upgrade</td><td>The Controller is currently downloading software or will start downloading as soon as possible.</td></tr><tr><td>Unknown</td><td>The Controller has not reported the software version to Command Centre yet. This can happen if the Controller has not come online even once or insome cases, the Controller has come online but the package version cannot be verified (in this case upgrading or re-applying the latest version of the Controller software onto the Controller may rectify this issue).</td></tr><tr><td>Upgrade Available &#x3C;version></td><td>There is new Controller software available. The Controller is running the installed software but not running the download software.</td></tr><tr><td>Upgrade Scheduled &#x3C;date/time>&#x3C;version></td><td>The upgrade is scheduled for a future date/time, (i.e. the Controller is running the installed software but not running the download software. The Controller will start downloading software at the scheduled time).</td></tr><tr><td>Up to date</td><td>The Controller is up to date. There is no new Controller software, (i.e. the download software is the same as the installed software).</td></tr></tbody></table>
12. Click the **Schedule Upgrade** button.

    The Schedule Controller Upgrade dialog displays.

    ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-a31ff3a7dba5db31e92bbad50ecceac47095c8b9%2Fschedulecontrollerupgrade.png?alt=media)
13. Specify a suitable time for the Controller upgrade to occur by entering the required **Date** and **Time**.

    **Note:** The Date and Time display according to the time zone of the operator. The **Local Time** column will be updated with the Controller’s local time according to it’s configured time zone, (i.e. where it is physically located).
14. Click the **Schedule Upgrade** button.

    The Schedule Controller Upgrade dialog closes and the date and time that the upgrade is scheduled for displays against each of the Controllers in the **Upgrade Scheduled** column.

    **Notes:**

    * With a large number of Controllers selected it can take a while for the upgrade to be scheduled. In this case, a progress dialog will display:

      ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-1d5e8fb19a638f1c7facdb247de894edd4acc099%2Fscheduleupgrade.png?alt=media)
    * If for some reason you want to cancel the scheduled upgrade for a Controller, select the Controller and click on the ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-9b9cd230b939aa68d1263ea8e8d871a2ca7aa4c9%2Fcrosstocancelscheduledupgrade.png?alt=media) that displays beside the date and time in the **Upgrade Scheduled** column.

      ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-aa98e569d9c2e3a90eaefaa9afcaed88455e6fb9%2Fcancelscheduledupgrade.png?alt=media)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/device-software/upgrading-multiple-controllers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
