<commit_before><?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
%BOOK_ENTITIES;
]>

<!-- Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at
    
    http://www.apache.org/licenses/LICENSE-2.0
    
    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.
-->
<section id="vr-upgrade">
  <title>Enhanced Upgrade for Virtual Routers</title>
  <para>Upgrading VR is made flexible. The &PRODUCT; administrators will be able to control the
    sequence of the VR upgrades. The sequencing is based on Infrastructure hierarchy, such as by
    Cluster, Pod, or Zone, and Administrative (Account) hierarchy, such as by Tenant or Domain. As
    an administrator, you can also determine when a particular customer service, such as VR, is
    upgraded within a specified upgrade interval. During the entire duration of the upgrade, users
    can launch new services or make changes to an existing service. Upgrade operation is enhanced to
    increase the upgrade speed by allowing as many upgrade operations in parallel as
    possible.</para>
  <para>Additionally, using multiple versions of VRs in a single instance is supported. In the
    Details tab of a VR, you can view the version and whether it requires upgrade. During the
    Management Server upgrade, &PRODUCT; checks whether VR is at the latest version before
    performing any operation on the VR. To support this, a new global parameter,
      <parameter>router.version.check</parameter>, has been added. If set to true, minimum required
    version of VR is checked before performing any operation. No operation is performed if the VR is
    not at the required version. Services of the older version VR continue to be available, but no
    further operations can be performed on the VR until it is upgraded to the latest version. This
    will be a transient state until the VR is upgraded. This will ensure that the availability of VR
    services and VR state is not impacted due to the Management Server upgrade. </para>
  <para>The following service will be available even if the VR is not upgraded. However, no changes
    for any of the services can be sent to the VR, until it is upgraded:</para>
  <itemizedlist>
    <listitem>
      <para>SecurityGroup </para>
    </listitem>
    <listitem>
      <para>UserData</para>
    </listitem>
    <listitem>
      <para>DHCP</para>
    </listitem>
    <listitem>
      <para>DNS</para>
    </listitem>
    <listitem>
      <para> LB </para>
    </listitem>
    <listitem>
      <para>Port Forwarding </para>
    </listitem>
    <listitem>
      <para>VPN </para>
    </listitem>
    <listitem>
      <para>Static NAT </para>
    </listitem>
    <listitem><commit_msg>CLOUDSTACK-5288 review comments<commit_after><?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
%BOOK_ENTITIES;
]>

<!-- Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at
    
    http://www.apache.org/licenses/LICENSE-2.0
    
    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.
-->
<section id="vr-upgrade">
  <title>Enhanced Upgrade for Virtual Routers</title>
  <para>Upgrading VR is made flexible. The &PRODUCT; administrators will be able to control the
    sequence of the VR upgrades. The sequencing is based on Infrastructure hierarchy, such as by
    Cluster, Pod, or Zone, and Administrative (Account) hierarchy, such as by Tenant or Domain. As
    an administrator, you can also determine when a particular customer service, such as VR, is
    upgraded within a specified upgrade interval.  Upgrade operation is enhanced to increase the
    upgrade speed by allowing as many upgrade operations in parallel as possible. </para>
  <para>During the entire duration of the upgrade, users cannot launch new services or make changes
    to an existing service.</para>
  <para>Additionally, using multiple versions of VRs in a single instance is supported. In the
    Details tab of a VR, you can view the version and whether it requires upgrade. During the
    Management Server upgrade, &PRODUCT; checks whether VR is at the latest version before
    performing any operation on the VR. To support this, a new global parameter,
      <parameter>router.version.check</parameter>, has been added.  This parameter is set to true by
    default, which implies minimum required version is checked before performing any operation. No
    operation is performed if the VR is not at the required version. Services of the older version
    VR continue to be available, but no further operations can be performed on the VR until it is
    upgraded to the latest version. This will be a transient state until the VR is upgraded. This
    will ensure that the availability of VR services and VR state is not impacted due to the
    Management Server upgrade. </para>
  <para>The following service will be available even if the VR is not upgraded. However, no changes
    for any of the services can be sent to the VR, until it is upgraded:</para>
  <itemizedlist>
    <listitem>
      <para>SecurityGroup </para>
    </listitem>
    <listitem>
      <para>UserData</para>
    </listitem>
    <listitem>
      <para>DHCP</para>
    </listitem>
    <listitem>
      <para>DNS</para>
    </listitem>
    <listitem>
      <para> LB </para>
    </listitem>
    <listitem>
      <para>Port Forwarding </para>
    </listitem>
    <listitem>
      <para>VPN </para>
    </listitem>
    <listitem>
      <para>Static NAT </para>
    </listitem>
    <listitem>
{'fraction_non_alphanumeric': 0.07097232079488999, 'fraction_numerical': 0.0036905606813342796, 'mean_word_length': 3.360148514851485, 'pattern_counts': {'":': 0, '<': 103, '<?xml version=': 2, '>': 103, 'https://': 0, 'lorem ipsum': 0, 'www.': 4, 'xml': 4}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2716611', 'n_tokens_mistral': 1914, 'n_tokens_neox': 1830, 'n_words': 913}