.. _upgrade-info:

업그레이드 가이드
==================

주의사항
-----------

- 업그레이드를 하기 전 반드시 업그레이드 가이드, 업그레이드 주의사항, 릴리즈노트를 충분히 읽어보신 뒤 문제되는 사항이 없는지를 확인하신 후 진행하시기 바랍니다. 
- 업그레이드 시 모든 데이터는 자동적으로 새로운 버전에 맞게 재수정 됩니다. 하지만 다운그레이드를 하면 제품이 오동작 할 수 있습니다.
- **다운그레이드는** 반드시 데이터 초기화를 한 뒤 **백업데이터로 복구** 하시기 바랍니다.
- 정책서버 및 DB 업그레이드를 하는 경우 *geniup* 수행시 반드시 백업을 수행하는것을 권장합니다. 
- 기본버전과 업그레이드 버전간의 버전차이가 큰 경우 다수의 DB테이블 구조변경으로 인한 Migration으로 인해서 업그레이드가 장시간 소용될 수 있습니다. 이때 CLI에 접속하거나 관리콘솔에 접속하면 DB migration중임을 알리는 메시지가 표시됩니다. 이때는 절대로 서비스를 중지하거나 장비를 재부팅해서는 안됩니다. 
- 3.0, 4.0 구버전에서 업그레이드 진행시 장비의 CLI 설정정보를 검토 한 후 누락된 사항이 없는지 확인하시기바랍니다.
- 커스터마이징 설정이 존재하는지 사전 검토바랍니다.

.. toctree::
    :maxdepth: 1

    upgrade-5.0-info


업그레이드 진행
--------------------

WEBUI를 이용한 진행
^^^^^^^^^^^^^^^^^^^

    - 센서와 같이 대량으로 업그레이드를 해야하는 경우 WEBUI를 사용한 업그레이드를 권장합니다. 

CLI를 이용한 진행
^^^^^^^^^^^^^^^^^^^^

    - 정책서버 또는 DB서버와 같이 주요한 서버를 업그레이드 할 경우 CLI를 통한 업그레이드를 추천합니다. 



정책서버/센서 구성시 업그레이드 방법
---------------------------------------

둘간의 버전이 다른경우 비정상동작하는 경우가 많습니다. 따라서 반드시 두 버전을 동일버전으로 맞추어 줍니다. 정책서버와 센서가 서로다른 버전인 상태로 동작하지 않도록 하기위해 다음과 같은 절차를 통하여 업그레이드 합니다. 

    - 정책서버 서비스 중지
    - 정책서버 업그레이드 (재부팅하지 않음)
    - 센서 업그레이드
    - 정책서버 재부팅

정책서버/DB서버 분리구성시 업그레이드 방법
------------------------------------------

정책서버 업그레이드 과정중에 DB서버가 업그레이드 되지 않도록 주의해야 합니다. 그를 위해 다음과 같은 절차로 업그레이드를 수행합니다. 

    - 정책서버 동작중지
    - DB서버 업그레이드- DB서버 재부팅 후 정상동작 확인
    - 정책서버 업그레이드

.. _upgrade-info-ha:

이중화 구성시 업그레이드 방법
-------------------------------

업그레이드 과정에서 MASTER시스템이 변경되지 않도록 하는것이 불필요한 문제를 줄이는 방법입니다. 그를 위해서 다음과 같은절차로 업그레이드를 수행합니다. 
  
    - SLAVE시스템의 서비스를 중지 합니다.
    - SLAVE시스템을 업그레이드 합니다. 단, 자동재부팅 되지 않도록 합니다. 
    - MASTER시스템의 서비스를 중지 합니다.
    - MASTER시스템을 업그레이드 합니다. 단, 자동재부팅 되지 않도록 합니다. 
    - MASTER시스템을 재부팅하고 서비스를 체크합니다. 
    - SLAVE시스템을 재부팅하고 서비스를 체크합니다. 
    - 만일 DB서버도 업그레이드 하는 경우 정책서버의 서비스를 중지하고 DB서버를 업그레이드 한 뒤 DB서버 정상동작을 확인하고 정책서버를 업그레이드 합니다.