Routing Director 업그레이드
Paragon Shell에서 제공하는 업그레이드 기능을 사용하면 Routing Director 설치 및 여기에서 실행되는 모든 애플리케이션을 현재 릴리스로 업그레이드할 수 있습니다.
다음 릴리스에서 최신 Juniper Routing Director 릴리스 2.5.0으로 업그레이드할 수 있습니다.
-
릴리스 2.4.1 및 2.4.0
-
릴리스 2.3.0
2.0.0을 이후 Juniper Routing Director 릴리스로 업그레이드하는 것은 지원되지 않습니다. 릴리스 2.1.0 및 2.2.0에서 릴리스 2.5.0으로의 직접 업그레이드는 지원되지 않습니다. 릴리스 2.1.0이 설치되어 있는 경우 먼저 릴리스 2.2.0으로 업그레이드한 다음 2.4.1로 업그레이드한 다음 이 항목에 설명된 프로세스를 사용하여 이후 릴리스 2.5.0으로 업그레이드합니다. 릴리스 2.2.0이 설치되어 있는 경우 릴리스 2.4.1로 업그레이드한 후 이 항목에 설명된 프로세스를 사용하여 이후 릴리스 2.5.0으로 업그레이드합니다.
업그레이드 프로세스는 일련의 Paragon Shell 명령에 의해 자동화되며 필요한 시스템 검사를 수행하고, 업그레이드 패키지를 검색하고, 클러스터 노드에서 업그레이드 프로세스를 실행합니다. 기본 노드에서 로컬로 다운로드하거나 웹 페이지에서 직접 다운로드한 파일을 사용하여 업그레이드할 수 있습니다.
업그레이드 중에는 디바이스 온보딩, 서비스 프로비저닝 또는 기타 구성 변경을 포함한 변경 작업이 시스템에서 수행되지 않는 것이 중요합니다. 업그레이드하면 모든 구성 요소가 자동으로 재부팅되며 이 기간 동안 잠시 사용할 수 없게 됩니다. 업그레이드 프로세스는 네트워크를 통한 트래픽에 영향을 미치지 않으며, 업그레이드가 완료되면 디바이스와 서비스는 재구성되지 않습니다.
업그레이드하기 전에 구성을 백업하는 것이 좋습니다. 현재 구성 백업에 대한 자세한 내용은 Routing Director 구성 백업을 참조하십시오.
Routing Director 릴리스 2.5.0으로 업그레이드하려면 다음 단계를 수행하십시오.
업그레이드 전제 조건 - 모든 업그레이드 전제 조건이 충족되는지 확인합니다
Routing Director 클러스터 업그레이드—로컬 파일명을 사용한 업그레이드 옵션 또는 원격 URL 옵션을 사용하여 클러스터를 업그레이드합니다
Paragon Shell 및 OVA 시스템 파일 업그레이드—모든 클러스터 노드에서 Paragon Shell 및 OVA 시스템 파일 업그레이드
클러스터 업그레이드 작업 후 - 모든 클러스터 업그레이드 후 작업을 수행하여 업그레이드 프로세스를 완료합니다.
업그레이드 사전 요구 사항
Routing Director 클러스터를 업그레이드하기 전에 다음을 확인하십시오.
-
Paragon Shell은 액세스 및 작동이 가능합니다.
-
권장 시스템 요구 사항에 맞게 VM 디스크 크기가 증가합니다. VM 디스크 크기 늘리기에 설명된 단계를 수행합니다.
-
클러스터 노드에는 다음과 같은 사용 가능한 디스크 공간이 있습니다.
-
클러스터가 배포된 기본 노드에는 총 디스크 공간의 15% + 업그레이드 파일 크기의 3배의 여유 공간이 있어야 합니다.
-
다른 두 개의 기본 및 작업자 노드에는 총 디스크 공간의 15% + 업그레이드 파일 크기와 동일한 여유 공간이 있어야 합니다.
-
작업자 노드에는 총 디스크 공간의 15%가 있어야 합니다.
-
-
이전 OpenSearch 백업 파일을 비활성화하고 삭제하여 공간을 확보합니다.
OpenSearch 백업을 비활성화합니다.
root@primary1# kubectl patch cronjob opensearch-backup-cron -n common -p '{"spec": {"suspend": true}}'주기적 백업 작업을 삭제합니다.
root@primary1# kubectl delete job -n common -l app=opensearch-backup-cron
기존의 모든 OpenSearch 백업 파일을 삭제합니다.
root@primary1# kubectl exec -i -n common -c opensearch-backup $(kubectl get po -n common -l app=opensearch-backup -o jsonpath={.items[0].metadata.name}) -- bash -c 'rm -rf /opt/paragon/opensearch-backup/*'
-
(선택 사항) 명령을 사용하여 Paragon Shell에서 기존 릴리스의 현재 빌드 및 OVA 버전을 확인합니다.
show paragon version
Routing Director 클러스터 업그레이드
Paragon Automaton 릴리스 2.3.0 및 2.4.X를 현재 2.5.0 릴리스로 업그레이드하려면 다음 단계를 수행합니다.
다음 두 가지 옵션 중 하나를 사용하여 설치 및 설치에서 실행되는 모든 응용 프로그램을 업그레이드할 수 있습니다.
옵션을 사용하여 local filename 업그레이드
Routing Director 설치가 인터넷에 액세스할 수 없는 에어갭 환경에 이 옵션을 사용합니다. 그러나 upgrade_paragon-release-build-id.tgz 및 upgrade_paragon-release-build-id.tgz.psig 파일을 기본 노드에 복사할 수 있어야 합니다.
릴리스 2.3.0 및 2.4.X에서 릴리스 2.5.0으로 업그레이드하려면 다음 단계를 수행합니다.
현재 클러스터가 설치된 기본 노드에 루트 사용자로 로그인합니다. Paragon Shell에 로그인했습니다.
Paragon Shell에서 Linux 루트 셸로 종료하려면 입력합니다
exit.업그레이드하려는 버전의 upgrade_paragon-release-build-id.tgz 및 upgrade_paragon-release-build-id.tgz.psig 파일을 /root/epic/temp 폴더에 복사합니다.
upgrade_paragon-release-build-id.tgz 및 upgrade_paragon-release-build-id.tgz.psig 파일을 기본 노드로 복사하기 전에 주니퍼 소프트웨어 다운로드 사이트에서 로컬 컴퓨터로 다운로드해야 할 수 있습니다.
(선택 사항) 명령을 사용하여
gpg --verify업그레이드 파일의 디지털 서명의 유효성을 검사합니다. 예를 들어:root@primary1:~/epic/temp# gpg --verify upgrade_paragon-release-2.5.0.8952.gbef82aec6b.tgz.psig upgrade_paragon-release-2.5.0.8952.gbef82aec6b.tgz gpg: Signature made Sat Mar 01 01:00:09 2024 UTC gpg: using RSA key 4B7B22C9C4FE32CF gpg: Good signature from "Northstar Paragon Automation 2024 ca@juniper.net" [ultimate]
다음은
primary1설치 관리자 기본 노드입니다. 유효성 검사를 완료하는 데 몇 분 정도 걸립니다.Paragon Shell을 입력하려면 입력합니다
cli.다음 명령을 사용하여 Routing Director 클러스터를 업그레이드합니다.
request paragon cluster upgrade local filename upgrade_paragon-release-build-id.tgz예를 들어:
root@primary1> request paragon cluster upgrade local filename upgrade_paragon-release-2.5.0.8952.gbef82aec6b.tgz Upgrade is in progress ... Updated to build: paragon-release-2.5.0.8952.gbef82aec6b Paragon Cluster upgrade is successful! Run 'request paragon health-check' command to check current system health with upgraded Paragon cluster. Please continue to primary host node to upgrade Paragon-shell and update OVA system files by: /root/epic/upgrade_paragon-shell_ova-system.sh
다음은
primary1설치 관리자 기본 노드입니다. 업그레이드 명령은 업그레이드하기 전에 클러스터의 상태를 확인합니다. 클러스터 상태 점검이 상태를 반환GREEN하면 추가 입력이 필요 없이 클러스터가 업그레이드됩니다. 클러스터 상태 점검이 상태를 반환RED하면 클러스터가 업그레이드되지 않습니다. 클러스터 상태 점검에서 상태가 반환되면AMBER업그레이드를 계속할지 또는 중지할지 선택하라는 메시지가 표시됩니다.추가 업그레이드 명령 옵션:
업그레이드하는 동안 업그레이드 명령과 함께 다음 명령 옵션 중 하나 이상을 사용할 수도 있습니다.
no-confirm—사용 예:request paragon cluster upgrade local filename upgrade_paragon-release-build-id.tgz no-confirm옵션을 사용하여
no-confirm상태를 무시AMBER하고 프롬프트 없이 업그레이드를 계속합니다. 그러나 이no-confirm옵션은 상태를 무시하지RED않습니다.detach-process—사용 예:request paragon cluster upgrade local filename upgrade_paragon-release-build-id.tgz detach-process업그레이드 프로세스를 완료하는 데 한 시간 이상이 걸리므로 업그레이드를 백그라운드에서 실행하고 다른 작업을 위해 CLI 화면을 확보할 수 있습니다. 이 명령은 초기 상태 검사를 실행한 다음 업그레이드를 진행합니다. 업그레이드 프로세스가 시작되면 프로세스가 분리되어 백그라운드로 이동되며 명령 프롬프트로 돌아갑니다. 업그레이드 출력은 /epic/temp/upgrade.log 파일에 기록됩니다. 업그레이드 프로세스의 상태를 모니터링하고 출력을 화면에 인쇄하려면 명령을 사용합니다.
monitor start /epic/temp/upgrade.log업그레이드 프로세스가 완료되면 모든 클러스터 노드에 다음과 유사한 성공 메시지가 표시됩니다.Paragon Cluster upgrade is successful! - Run 'request paragon health-check' command to check current system health with upgraded Paragon cluster. - Please continue to primary host node to upgrade Paragon-shell and update OVA system files by: /root/epic/upgrade_paragon-shell_ova-system.sh
업그레이드 프로세스 중에 VM과의 연결이 끊어지면 업그레이드 로그 파일에서 업그레이드 상태를 주기적으로 확인할 수 있습니다.
input—사용 예:request paragon cluster upgrade local filename upgrade_paragon-release-build-id.tgz input input-string옵션을 사용하여
input업그레이드 명령에 추가 Ansible 입력 매개 변수를 전달합니다. 예를 들어 업그레이드 중에 자세한 정보 로깅을 사용하도록 설정하려면 이-v옵션을 사용합니다.request paragon cluster upgrade local filename upgrade_paragon-release-build-id.tgz input "-v"
Routing Director 설치 및 여기에서 실행되는 모든 애플리케이션이 업그레이드됩니다.
업그레이드 프로세스를 완료하는 데 한 시간 이상 걸립니다. 업그레이드 프로세스 중에 VM과의 연결이 끊어진 경우 다음과 유사한 출력이 표시될 때까지 업그레이드 로그 파일을 주기적으로 확인할 수 있습니다.
root@primary1:~# cat /root/upgrade/upgrade.log <output snipped> … PLAY RECAP ********************************************************************* 10.1.2.3 : ok=1819 changed=430 unreachable=0 failed=0 rescued=0 ignored=2 10.1.2.4 : ok=185 changed=26 unreachable=0 failed=0 rescued=0 ignored=0 10.1.2.5 : ok=185 changed=26 unreachable=0 failed=0 rescued=0 ignored=0 10.1.2.6 : ok=177 changed=25 unreachable=0 failed=0 rescued=0 ignored=0 Saturday 01 June 2025 09:41:53 +0000 (0:00:00.665) 1:26:57.926 ******* =============================================================================== user-registry : Push Docker Images from local registry to paragon registry - 532.34s jcloud/airflow2 : Install Helm Chart ---------------------------------- 278.28s Install Helm Chart ---------------------------------------------------- 147.88s delete existing install config-map - if any --------------------------- 111.87s Save installer config to configmap ------------------------------------- 98.15s jcloud/papi : Install Helm Chart --------------------------------------- 97.77s Create Kafka Topics ---------------------------------------------------- 79.97s user-registry : Push Helm Charts to paragon registry ------------------- 78.70s systemd ---------------------------------------------------------------- 67.23s kubernetes/addons/helper-commands : Install Pathfinder Utility scripts -- 44.65s kubernetes/addons/helper-commands : Copy profiler to /opt/paragon/bin -- 39.79s registry : Copy nginx image on 10.1.2.4 -------------------------------- 37.46s registry : Copy nginx image on 10.1.2.5 -------------------------------- 37.04s registry : Copy nginx image on 10.1.2.6 -------------------------------- 36.80s registry : Copy nginx image on 10.1.2.3 -------------------------------- 36.03s Install Helm Chart ----------------------------------------------------- 34.49s registry : Copy zot image on 10.1.2.4 ---------------------------------- 33.29s registry : Copy zot image on 10.1.2.5 ---------------------------------- 32.46s registry : Copy zot image on 10.1.2.6 ---------------------------------- 31.67s registry : Copy zot image on 10.1.2.3 ---------------------------------- 30.25s Playbook run took 0 days, 1 hours, 26 minutes, 57 seconds registry-14272 Application Cluster upgraded to version build: paragon-release-2.5.0.8952.gbef82aec6b!!!
명령을 실행
request paragon health-check하여 업그레이드된 클러스터가 정상이고 작동하는지 확인합니다.반드시
Overall Cluster Status.GREENParagon Shell 및 OVA 시스템 파일을 업그레이드합니다.
Paragon Shell 및 OVA 시스템 파일 업그레이드로 이동합니다.
옵션을 사용하여 remote url 업그레이드
Routing Director 설치가 인터넷에 액세스할 수 있고 업그레이드 파일이 원격 위치에 있는 경우 이 옵션을 사용합니다.
릴리스 2.3.0 및 2.4.X에서 릴리스 2.5.0으로 업그레이드하려면 다음 단계를 수행합니다.
기존 클러스터가 설치된 기본 노드에 루트 사용자로 로그인합니다. Paragon Shell에 로그인했습니다.
다음 명령을 사용하여 Routing Director 클러스터를 업그레이드합니다.
request paragon cluster upgrade remote url "https://juniper.software.download.site/upgrade_paragon-release-build-id.tgz?query_string"예를 들어:
root@primary1> request paragon cluster upgrade remote url "https://cdn.juniper.net/software/paragon-images/upgrade_paragon-release-2.5.0.8952.gbef82aec6b.tgz?query_string" Checking paragon cluster system health before proceeding with cluster upgrade. This will take a minute... ... <output snipped> ... ======================================================= Overall cluster status ======================================================= GREEN ======================================================= Paragon cluster is healthy. Proceed with Paragon cluster upgrade. Upgrading paragon cluster from https://cdn.juniper.net/software/paragon-images Downloading tarball file upgrade_paragon-release-2.5.0.8952.gbef82aec6b Download file size: 28,831,677,064 bytes Current disk Usage: Total: 263,622,004,736 bytes Used: 106,109,399,040 bytes Available: 145,685,159,936 bytes Please wait for current download to finish... (File is large. It may take a while.) Upgrade tarball file is downloaded. Upgrade is in progress ... Updated to build: eop-release-2.5.0.8952.gbef82aec6b Paragon Cluster upgrade is successful! Run 'request paragon health-check' command to check current system health with upgraded Paragon cluster. Please continue to primary host node to upgrade Paragon-shell and update OVA system files by: /root/epic/upgrade_paragon-shell_ova-system.sh다음은
primary1설치 관리자 기본 노드입니다. 업그레이드 명령은 업그레이드하기 전에 클러스터의 상태를 확인합니다. 클러스터 상태 점검이 상태를 반환GREEN하면 추가 입력이 필요 없이 클러스터가 업그레이드됩니다. 클러스터 상태 점검이 상태를 반환RED하면 클러스터가 업그레이드되지 않습니다. 클러스터 상태 점검에서 상태가 반환되면AMBER업그레이드를 계속할지 또는 중지할지 선택하라는 메시지가 표시됩니다.추가 업그레이드 명령 옵션:
업그레이드하는 동안 업그레이드 명령과 함께 다음 명령 옵션 중 하나 이상을 사용할 수도 있습니다.
no-confirm—사용 예:request paragon cluster upgrade remote url "https://juniper.software.download.site/upgrade_paragon-release-build-id.tgz?query_string" no-confirm옵션을 사용하여
no-confirm상태를 무시AMBER하고 프롬프트 없이 업그레이드를 계속합니다. 그러나 이no-confirm옵션은 상태를 무시하지RED않습니다.detach-process—사용 예:request paragon cluster upgrade remote url "https://juniper.software.download.site/upgrade_paragon-release-build-id.tgz?query_string" detach-process업그레이드 프로세스를 완료하는 데 한 시간 이상이 걸리므로 업그레이드를 백그라운드에서 실행하고 다른 작업을 위해 CLI 화면을 확보할 수 있습니다. 이 명령은 초기 상태 검사를 실행한 다음 업그레이드를 진행합니다. 업그레이드 프로세스가 시작되면 프로세스가 분리되어 백그라운드로 이동되며 명령 프롬프트로 돌아갑니다. 업그레이드 출력은 /epic/temp/upgrade.log 파일에 기록됩니다. 업그레이드 프로세스의 상태를 모니터링하고 출력을 화면에 인쇄하려면 명령을 사용합니다.
monitor start /epic/temp/upgrade.log업그레이드 프로세스가 완료되면 모든 클러스터 노드에 다음과 유사한 성공 메시지가 표시됩니다.Paragon Cluster upgrade is successful! - Run 'request paragon health-check' command to check current system health with upgraded Paragon cluster. - Please continue to primary host node to upgrade Paragon-shell and update OVA system files by: /root/epic/upgrade_paragon-shell_ova-system.sh
disk-saving—사용 예:request paragon cluster upgrade remote url "https://juniper.software.download.site/upgrade_paragon-release-build-id.tgz?query_string" disk-saving이 옵션을 사용하면 upgrade_paragon-release-build-id.tgz 파일이 기본 노드에서 압축을 푸는 즉시 삭제됩니다. 업그레이드 명령은 원격 위치에서 업그레이드 파일을 다운로드하고 업그레이드 프로세스를 시작할 때 파일의 내용을 추출합니다. 이 옵션은 다운로드한 파일의 압축을 푸는 즉시 삭제하여 기본 노드의 공간을 확보합니다.
이 옵션을 사용하면 업그레이드 프로세스에 필요한 여유 공간이 적다는 장점이 있습니다. 필요한 기본 최소 여유 공간은 총 디스크 공간의 15% + 업그레이드 파일 크기의 3배입니다. 이 옵션을 사용하려면 총 디스크 공간의 15% + 업그레이드 파일 크기의 2배에 해당하는 최소 여유 공간이 필요합니다.
input—사용 예:request paragon cluster upgrade remote url "https://juniper.software.download.site/upgrade_paragon-release-build-id.tgz?query_string" input input-string옵션을 사용하여
input업그레이드 명령에 추가 Ansible 입력 매개 변수를 전달합니다. 예를 들어 업그레이드 중에 자세한 정보 로깅을 사용하도록 설정하려면 옵션을-v사용합니다.request paragon cluster upgrade remote url "https://juniper.software.download.site/upgrade_paragon-release-build-id.tgz?query_string" input "-v"
Routing Director 설치 및 여기에서 실행되는 모든 애플리케이션이 업그레이드됩니다.
업그레이드 프로세스를 완료하는 데 한 시간이 조금 넘게 걸립니다. 업그레이드 프로세스 중에 VM과의 연결이 끊어진 경우 다음과 유사한 출력이 표시될 때까지 업그레이드 로그 파일을 주기적으로 확인할 수 있습니다.
root@primary1:~# cat /root/upgrade/upgrade.log <output snipped> … PLAY RECAP ********************************************************************* 10.1.2.3 : ok=1819 changed=430 unreachable=0 failed=0 rescued=0 ignored=2 10.1.2.4 : ok=185 changed=26 unreachable=0 failed=0 rescued=0 ignored=0 10.1.2.5 : ok=185 changed=26 unreachable=0 failed=0 rescued=0 ignored=0 10.1.2.6 : ok=177 changed=25 unreachable=0 failed=0 rescued=0 ignored=0 Saturday 01 June 2025 09:41:53 +0000 (0:00:00.665) 1:26:57.926 ******* =============================================================================== user-registry : Push Docker Images from local registry to paragon registry - 532.34s jcloud/airflow2 : Install Helm Chart ---------------------------------- 278.28s Install Helm Chart ---------------------------------------------------- 147.88s delete existing install config-map - if any --------------------------- 111.87s Save installer config to configmap ------------------------------------- 98.15s jcloud/papi : Install Helm Chart --------------------------------------- 97.77s Create Kafka Topics ---------------------------------------------------- 79.97s user-registry : Push Helm Charts to paragon registry ------------------- 78.70s systemd ---------------------------------------------------------------- 67.23s kubernetes/addons/helper-commands : Install Pathfinder Utility scripts -- 44.65s kubernetes/addons/helper-commands : Copy profiler to /opt/paragon/bin -- 39.79s registry : Copy nginx image on 10.1.2.4 -------------------------------- 37.46s registry : Copy nginx image on 10.1.2.5 -------------------------------- 37.04s registry : Copy nginx image on 10.1.2.6 -------------------------------- 36.80s registry : Copy nginx image on 10.1.2.3 -------------------------------- 36.03s Install Helm Chart ----------------------------------------------------- 34.49s registry : Copy zot image on 10.1.2.4 ---------------------------------- 33.29s registry : Copy zot image on 10.1.2.5 ---------------------------------- 32.46s registry : Copy zot image on 10.1.2.6 ---------------------------------- 31.67s registry : Copy zot image on 10.1.2.3 ---------------------------------- 30.25s Playbook run took 0 days, 1 hours, 26 minutes, 57 seconds registry-14272 Application Cluster upgraded to version build: paragon-release-2.5.0.8952.gbef82aec6b!!!
명령을 실행
request paragon health-check하여 업그레이드된 클러스터가 정상이고 작동하는지 확인합니다.반드시
Overall Cluster Status.GREENParagon Shell 및 OVA 시스템 파일을 업그레이드합니다.
Paragon Shell 및 OVA 시스템 파일 업그레이드로 이동합니다.
Paragon Shell 및 OVA 시스템 파일 업그레이드
Routing Director 설치 및 여기에서 실행되는 모든 애플리케이션이 성공적으로 업그레이드되면 Paragon Shell 및 OVA 시스템 파일을 업그레이드해야 합니다.
를 입력하여 설치 프로그램 기본 노드 Paragon Shell에서 Linux 루트 셸로 종료합니다.
exitParagon Shell 업그레이드 셸 스크립트를 실행합니다.
root@primary1:~# bash /root/epic/upgrade_paragon-shell_ova-system.sh Upgrading paragon-shell... Updating paragon-shell for primary1...... Container paragon-shell Stopping Container paragon-shell Stopped Container paragon-shell Removing Container paragon-shell Removed paragon-shell Pulling .... <output snipped> .... primaryname update-status primary1 ok primary3 ok primary2 ok primary4 ok paragon-shell upgrade successful! Updating OVA system files... OVA system files update successful!
Paragon Shell 및 OVA 시스템 파일이 업그레이드되었습니다.
(선택 사항) Paragon Shell에서 업그레이드된 클러스터의 빌드 및 OVA 버전을 확인합니다.
root@primary> show paragon version ova: 20250301_1117_ova ova-patch: 20250301_0349 build: eop-2.5.0.8952.gbef82aec6b Client Version: v1.29.6 Kustomize Version: v5.0.4-0.20230601165947-6ce0bf390ce3 Server Version: v1.32.2+rke2r1
클러스터 업그레이드 후 작업을 계속 수행합니다. 클러스터 업그레이드 후 작업을 참조하십시오.