.. _update-server-sensor:

정책서버 및 네트워크센서 업데이트
=========================================

WebUI와 CLI를 통해 정책서버 및 네트워크센서를 업데이트할 수 있습니다.

.. warning::
    무분별한 업데이트는 ZTNA 시스템의 치명적인 오류의 원인이 될 수 있습니다. 파트너 엔지니어에게 문의 바랍니다.

------------------

업데이트 이미지 파일 준비하기
------------------------------

파트너 엔지니어에게 문의하여 소프트웨어 이미지 파일을 다운받습니다.

#. .iso 파일의 내용을 추출합니다.
#. .iso의 /images 디렉터리에서 원하는 소프트웨어 버전을 선택하십시오. 
    
    * **정책서버** 의 경우 **ZTNA-CT** 로 시작하는 파일 (*네트워크센서 파일 포함*)
    * **네트워크센서** 의 경우 **ZTNA-SS** 로 시작하는 파일을 선택하십시오.

WEBUI를 통한 업데이트
----------------------

#. 상단의 **시스템** 으로 이동하십시오.
#. 좌측 **업데이트 관리** 에서 **소프트웨어** 를 클릭하십시오.
#. 소프트웨어 창에서 **수동 업로드** 버튼을 클릭하십시오.
#. 업로드 창에서 **파일선택** 을 클릭하십시오.
#. 원하는 파일을 더블 클릭하십시오.
#. **업로드** 를 클릭하십시오.
#. 좌측의 **시스템 > 시스템관리** 로 이동하십시오.
#. 시스템 목록에서 **정책서버 / 네트워크센서** 를 찾습니다. **체크박스** 를 클릭하십시오.
#. **작업선택** 을 클릭하십시오.
#. **이미지선택 업그레이드** 를 클릭하십시오.
#. **이미지선택** 목록에서 이미지를 선택하고 **업그레이드** 를 클릭하십시오.
#. 자동으로 시스템 업데이트 및 재부팅이 진행됩니다.

------------------

CLI (Command Line Interface)를 통한 업데이트 
---------------------------------------------

CLI를 통해 정책서버 및 네트워크센서를 업데이트할 수 있습니다. 
파트너 엔지니어에게 문의하여 소프트웨어 이미지 파일을 다운받습니다.

아래와 같은 경우는 CLI를 통한 업그레이드를 권장합니다.
    - 정책서버 또는 DB서버와 같이 주요 서버를 업그레이드 하는 경우
    - HA 구성으로 되어있는 경우

**CLI update 명령어** : ``geniup``

**명령어 옵션**
    - ``-h`` : help
    - ``-f [image filename]`` : 업데이트 파일 지정
    - ``-u [URL]`` : 업데이트파일 URL 지정
    - ``-d`` : 다운그레이드 수행 옵션
    - ``-c`` : 이미지 종류를 체크하지 않는 옵션

#. Zmodem을 지원하는 터미널프로그램(secureCRT 등)으로 SSH접속을 합니다.
#. 쉘모드에서 ``rz`` 명령어를 사용하여 이미지 파일을 장비에 업로드 합니다.

    .. code-block:: bash
        
        Genians$ cd /tmp
        Genians$ rz

#. ``geniup`` 명령어와 옵션을 사용하여 이미지 업그레이드를 진행합니다.
    
    .. code-block:: bash
        
        Genians$ geniup -cf [image filename]
        System software upgrade from 
        Current Version : 
        Target Version  : 
        Do you want to upgrade this target version ? (y/N):
        #해당 버전으로 업그레이드 여부 확인
        Do you want to backup current database ? (Y/n): 
        #DB를 백업 여부 확인
        Do you want to restart system after upgrade ? (Y/n): 
        #업그레이드 후 자동 재부팅 여부 확인


자세한 내용은 다음을 참조하세요. :doc:`/system/cli`

.. warning::
    geniup 명령어를 사용하여 정책서버 및 DB서버를 업그레이드하는 경우 백업을 수행하는 것을 권장합니다.

------------------

구성별 업그레이드 방법
------------------------

정책서버/네트워크센서 구성 업그레이드 방법
--------------------------------------------
정책서버와 네트워크센서의 버전이 다른 경우 비정상 동작하는 경우가 많습니다. 
두 버전을 동일 버전으로 맞추어 업그레이드 진행하시기바랍니다.

#. 쉘모드 진입 
#. 정책서버 서비스 중지

    .. code-block:: bash
        
        Genians$ alder stop

#. 정책서버 업그레이드 (재부팅 하지 않음)
#. 네트워크센서 업그레이드
#. 정책서버 재부팅

------------------

정책서버/DB서버 분리구성 시 업그레이드 방법
--------------------------------------------
정책서버 업그레이드 중, DB서버 업그레이드가 되지 않도록 주의해야 합니다.

#. 쉘모드 진입 
#. 정책서버 서비스 중지

    .. code-block:: bash
        
        Genians$ alder stop

#. DB서버 업그레이드
#. DB서버 재부팅 후, 정상 동작 확인
#. 정책서버 업그레이드

.. note:: | 정책서버와 DB서버는 반드시 동일버전일 필요는 없습니다. 릴리즈 노트를 참조하여 DB서버 수정사항을 확인 후 업그레이드 진행해주시기 바랍니다.

------------------

HA구성 시 업그레이드 방법
--------------------------
업그레이드 과정에서 Master 시스템이 변경되지 않도록 주의해야 합니다.

#. Slave서버 업그레이드 (재부팅 하지 않음)
#. Slave서버 서비스 중지

    .. code-block:: bash
        
        Genians$ alder stop

#. Master서버 업그레이드
#. Master서버 재부팅 후, 정상 동작 확인
#. Slave서버 재부팅 후, 정상 동작 확인