.. _upgrade:

upgrade
=======

Upgrade System


upgrade Specification
---------------------

	===================================== ================================================
	===================================== ================================================
	 **Type**                              *operational*

	 **Element Name**                      upgrade

	 **Element URI**                       /axapi/v3/upgrade

	 **Element Attributes**                upgrade_attributes

	 **Schema**                             :download:`upgrade schema <upgrade/upgrade.txt>`
	===================================== ================================================





	**Operations Allowed:**




.. raw:: html

   <script type="text/javascript">
 function showExample(a,b) { document.getElementById(a+'_div').style.display = 'block'; document.getElementById(a+'_cl').style.display = 'block'; document.getElementById(a+'_eg').style.display = 'none';}
   function closeExample(a,b) { document.getElementById(a+'_div').style.display = 'none'; document.getElementById(a+'_cl').style.display = 'none'; document.getElementById(a+'_eg').style.display = 'block';}
 </script>
   <table width='90%' style='margin-left:5%'>



.. raw:: html

   <tr style='border-bottom: thin solid; border-top: thin solid'><th width=15%>Operation</th><th width=10%>Method</th><th>URI</th><th width=15%>Payload</th><th width=10%></th></tr>




.. raw:: html

   <tr  style='border-bottom: thin solid;'><td valign = 'top'>


EXECUTE Object



.. raw:: html

   </td><td valign = 'top'>


POST



.. raw:: html

   </td><td valign = 'top'>


/axapi/v3/upgrade



.. raw:: html

   </td><td valign = 'top'>


:ref:`1942_upgrade_attributes`



.. raw:: html

   </td><td></td></tr>




.. raw:: html

   </table>

.. _1942_upgrade_attributes:

upgrade attributes
------------------

    **cf**

        **Description:** cf is a **JSON Block**.  Please see below for :ref:`1942_cf` 

        **Type:** Object

        **Reference Object:** :doc:`/axapi/v3/upgrade/cf <upgrade_cf>`

    **gui**

        **Description:** gui is a **JSON Block**.  Please see below for :ref:`1942_gui` 

        **Type:** Object

        **Reference Object:** :doc:`/axapi/v3/upgrade/gui <upgrade_gui>`

    **hd**

        **Description:** hd is a **JSON Block**.  Please see below for :ref:`1942_hd` 

        **Type:** Object

        **Reference Object:** :doc:`/axapi/v3/upgrade/hd <upgrade_hd>`

.. _1942_gui:

gui
^^^
	=============================== ===================================================
	**Specification**
	=============================== ===================================================
	 **Type**                        *object*

	=============================== ===================================================

    **delete**

        **Description** Delete one local GUI image

        **Type:** string

        **Maximum Length:** 128 characters

        **Maximum Length:** 1 characters

    **file-url**

        **Description** File URL

        **Type:** string

        **Format:** url

        **Mutual Exclusion**: file-url is mutually exclusive with local, rollback,  file-url and image-file 

    **gui-upload**

        **Description** 

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **image**

        **Description** 'pri': Primary image; 'sec': Secondary image; 

        **Type:** string

        **Supported Values:** pri, sec

    **image-file**

        **Description** 

        **Type:** string

        **Format:** string-rlx

        **Mutual Exclusion**: image-file is mutually exclusive with local,  rollback and file-url 

    **local**

        **Description** Local GUI image name

        **Type:** string

        **Maximum Length:** 128 characters

        **Maximum Length:** 1 characters

        **Mutual Exclusion**: local is mutually exclusive with  file-url and image-file 

    **remote-url**

        **Description** 

        **Type:** string

        **Format:** string-rlx

        **Maximum Length:** 128 characters

        **Maximum Length:** 1 characters

    **rollback**

        **Description** Rollback to a specific local GUI image

        **Type:** string

        **Maximum Length:** 128 characters

        **Maximum Length:** 1 characters

        **Mutual Exclusion**: rollback is mutually exclusive with use-mgmt-port, source-ip-address, show-percentage, save-gui, upload,  file-url and image-file 

    **source-ip-address**

        **Description** Source IP address

        **Type:** string

        **Format:** ipv4-address

        **Mutual Exclusion**: source-ip-address is mutually exclusive with  rollback and use-mgmt-port 

    **upload**

        **Description** Upload GUI image from remote

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

        **Mutual Exclusion**:upload and rollback are mutually exclusive

    **use-mgmt-port**

        **Description** Use management port as source port

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

        **Mutual Exclusion**: use-mgmt-port is mutually exclusive with  rollback and source-ip-address 

.. _1942_cf:

cf
^^
	=============================== ===================================================
	**Specification**
	=============================== ===================================================
	 **Type**                        *object*

	=============================== ===================================================

    **Device**

        **Description** 

        **Type:** number

    **file-url**

        **Description** File URL

        **Type:** string

        **Format:** url

        **Mutual Exclusion**: file-url is mutually exclusive with  local and image-file 

    **image**

        **Description** 'pri': Primary image; 

        **Type:** string

        **Supported Values:** pri

    **image-file**

        **Description** 

        **Type:** string

        **Format:** string-rlx

        **Mutual Exclusion**: image-file is mutually exclusive with  local and file-url 

    **local**

        **Description** Use image from local VCS image repository (Specify an image name, format: aximage_XX_XX_XX_XX.tar.gz)

        **Type:** string

        **Maximum Length:** 128 characters

        **Maximum Length:** 1 characters

        **Mutual Exclusion**: local is mutually exclusive with use-mgmt-port, show-percentage,  file-url and image-file 

    **reboot-after-upgrade**

        **Description** reboot system after upgrade is done

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **staggered-upgrade-mode**

        **Description** in staggered upgrade mode

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **use-mgmt-port**

        **Description** Use management port as source port

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

        **Mutual Exclusion**:use-mgmt-port and local are mutually exclusive

.. _1942_hd:

hd
^^
	=============================== ===================================================
	**Specification**
	=============================== ===================================================
	 **Type**                        *object*

	=============================== ===================================================

    **Device**

        **Description** 

        **Type:** number

    **file-url**

        **Description** File URL

        **Type:** string

        **Format:** url

        **Mutual Exclusion**: file-url is mutually exclusive with local,  rollback and image-file 

    **image**

        **Description** 'pri': Primary image; 'sec': Secondary image; 

        **Type:** string

        **Supported Values:** pri, sec

    **image-file**

        **Description** 

        **Type:** string

        **Format:** string-rlx

        **Mutual Exclusion**: image-file is mutually exclusive with local,  rollback and file-url 

    **local**

        **Description** Use image from local VCS image repository (Specify an image name, format: aximage_XX_XX_XX_XX.tar.gz)

        **Type:** string

        **Maximum Length:** 128 characters

        **Maximum Length:** 1 characters

        **Mutual Exclusion**: local is mutually exclusive with use-mgmt-port, source-ip-address, show-percentage,  file-url and image-file 

    **reboot-after-upgrade**

        **Description** reboot system after upgrade is done

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **rollback**

        **Description** 

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

        **Mutual Exclusion**: rollback is mutually exclusive with use-mgmt-port, source-ip-address, show-percentage,  file-url and image-file 

    **source-ip-address**

        **Description** Source ip address

        **Type:** string

        **Format:** ipv4-address

        **Mutual Exclusion**: source-ip-address is mutually exclusive with local,  rollback and use-mgmt-port 

    **staggered-upgrade-mode**

        **Description** in staggered upgrade mode

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

    **use-mgmt-port**

        **Description** Use management port as source port

        **Type:** boolean

        **Supported Values:** true, false, 1, 0

        **Default:** 0

        **Mutual Exclusion**: use-mgmt-port is mutually exclusive with local,  rollback and source-ip-address