====== Update Client Agent ======
----

In the current version of **Xcalibur W**, the client update command is available using the built-in [[library:upload|Library]] or using an external FTP server, which acts as a repository for client update instructions. **The preferred method is the Library**, as it enables easy updates and provides security via the HTTPS protocol.

===== Update Using Library =====
----

Updating clients using the Library is a simple process. From the //Command Groups// tab, navigate to **Agent Administration > Agent update**. Click **Select a file...** to display a list of the available agents previously loaded into the Library.

{{ update_client:update_client_agent.png }}

As with other commands, you may want to use the [[commands_glossary:commands_to_multiple_devices#maintenance|Maintenance]] Mode in order to allow updates on a device protected by a **Write Filter**. The screenshot below shows a typical Command Queue with Maintenance commands.

{{ update_client:maintenance.png }}

===== Update using FTP Server =====
----

The external FTP server acts as a **repository** for client agent update instructions. The repository should contain at least the XML infoversion file, which specifies the target version and the path to the new client agent. The new client agent binary can be stored on the same FTP server, or on a remote server (SMB, HTTP, FTP, etc.).

The update process using FTP server is //totally disconnected// from **Xcalibur W**. The client agent contacts the specified FTP server, gets the instructions, and executes the update. **Xcalibur W**:
  * **Specifies** the FTP server address; and
  * **Instructs** the agent to get the update from the FTP Server

==== Things to Know ====
----

__**When the Device is not enrolled:**__

  * If there is **no Write Filter** activated, then the update of WPDA is done silently for the user without any reboot.
  * If protected by a **FBWF Write Filter**, then a message pops up informing the user that the device will automatically enter **Maintenance Mode** to start the update, and will reboot after updating.

|{{:warning.png |}} Due to Write Filter protection, Agent Update will not work on a device that has EWF activated.|


__**When the Device is enrolled:**__
 
  * If there is **no Write Filter** activated, then the update of WPDA is done silently for the user without any reboot.
  * If protected by **EWF or FBWF Write Filter**, then the device will be put into [[commands_glossary:commands_to_multiple_devices#maintenance|Maintenance Mode]].


==== Preparing FTP Server ====
----

The FTP Server should contain the infoversion.xml file. The file should be written as shown below:

<code xml><?xml version="1.0" encoding="UTF-8"?>
  <Info>
    <Imaging>
      <Version>0.0.0</Version>
      <Path>image15032011</Path>
    </Imaging>
    <Profil>
      <Version>0.0</Version>
      <Path>Profil0.2.txt</Path>
    </Profil>
    <Agent>
      <Version>1.3.6.572</Version>
      <Path>ftp://anonymous:test@192.168.1.10/valid/XcaliburWDeviceAgent_2.12.0.2074.exe</Path>
    </Agent>
  </Info></code>

^  ^  ^
|**Version**| Specifies the new Client Agent version. If installed version is newer than the specified one, then the update will not be executed|
|**Path**| Specifies the exact path to the new Client Agent|

==== Preparing the Device Agent ====
----

The device Agent must be configured with the FTP server address and credentials. This can be done either by manually entering the settings or using the DHCP Scope options.

=== FTP Server Settings Provided by DHCP ===
----

FTP Server settings can be provided using DHCP Scope Option 230. For more information about the DCHP Option, refer to the [[advanced:dhcp_scope_options|DHCP Scope Options]] section.

In **Xcalibur W** Agent, navigate to **Administration > Agent Configuration** to enable the DHCP Scope Option by ticking the corresponding checkbox.

{{ update_client:2.png }}


=== FTP Server Settings Provided Manually ===
----

Manual settings are entered from the **Administration > Agent Update** section. Additionally, **Enable automatic FTP updates at startup** can be selected to check for Agent updates at each startup.

{{ update_client:1.png }}


==== Starting the Update ====
----

Start the update using the **[[commands_glossary:commands_to_multiple_devices#agent_updatecommand|Agent Update]]** command.

{{ update_client:capture_execute_update.png }}

When executing the update on Write Filter protected devices, **activate Maintenance Mode prior to executing the update** as shown in the Task Template below.

{{ update_client:capture_agent_update.png }}