Pardus에 LIDER AHENK를 배포하고 첫 고객을 등록하세요

버전 참고: 공식 LIDER AHENK 서버 설치 지침에서는 현재 Pardus 25.1을 언급하고 있지만, Pardus는 이미 Pardus 25.2를 출시했습니다. 문서화된 기준선으로 사용하려면 프로젝트에서 설명하는 25.1 조합을 사용하십시오. 25.2를 프로덕션 환경에 배포하기 전에 유지 관리자에게 호환성을 확인하거나 스테이징 환경에서 검증하십시오. 기본 설정은 Lider 관리 서버를 설치한 다음 각 Pardus 엔드포인트를 Ahenk 에이전트에 등록하는 것입니다.

LIDER AHENK는 중앙 관리 시스템입니다. Lider는 서버와 관리 인터페이스를 제공하고, Ahenk는 관리 대상 컴퓨터 각각에서 실행되는 권한 있는 에이전트입니다. LDAP는 디렉터리 데이터를 저장하고, XMPP는 시스템 통신을 담당합니다.

1. 서버 및 네트워크 계획

설치하기 전에 파일럿 환경인지 프로덕션 환경인지 결정하십시오. 현재 공식 요구 사항 페이지에 따르면 프로덕션 환경 설치를 위해 CPU 코어 4개, 메모리 8GB, 디스크 50GB가 필요하며, 클라이언트 수가 증가함에 따라 리소스도 늘려야 합니다. 개발 또는 테스트 환경의 경우 CPU 코어 2개, 메모리 4GB, 디스크 20GB가 필요합니다. 이러한 사양은 시작점으로 활용하고, 클라이언트 수가 늘어남에 따라 필요한 리소스를 확장하십시오.

요구 사항 페이지에는 포트 8080, 22, 5222, 5280, 3306 및 389가 나열되어 있습니다. 이러한 포트를 공개적으로 노출하지 마십시오. 해당 페이지에는 모든 포트가 모든 배포 흐름에 매핑되어 있지 않으므로 방화벽을 변경하기 전에 토폴로지에 대한 소스 및 대상 규칙을 확인하십시오.

설치 프로그램은 올인원 서버 또는 개별 구성 요소 호스트를 지원합니다. 파일럿 테스트에는 서버 한 대를 사용하고, 대규모 배포에는 분산 구성을 계획하십시오. 안정적인 호스트 이름과 주소를 설정하고, DNS 및 시간 동기화를 확인하고, 설치 가이드에 따라 서버 운영 체제 언어를 영어로 설정하십시오.

2. 서버를 설치하고 설치 워크스테이션을 준비합니다.

최신 서버 설치 페이지에는 Pardus 25.1 서버가 명시되어 있으며, 공식 다운로드 디렉터리에도 Pardus 25.2 서버 이미지가 등록되어 있습니다. 버전 차이는 중요한 문제입니다. 해당 페이지는 설치 프로그램 워크플로가 25.2 버전에서 검증되었는지 여부를 확인해 주지 않습니다. 정확한 재현을 위해서는 공식 문서에 명시된 버전을 사용하거나, 실제 장치를 등록하기 전에 비프로덕션 서버에서 최신 버전을 테스트하십시오.

그래픽 설치 프로그램은 별도의 Pardus GNOME 또는 Xfce 워크스테이션에서 실행되며 SSH를 통해 대상 서버에 연결합니다. 설치 프로그램에 필요한 시스템 종속성 및 SSH 클라이언트와 Python 가상 환경 패키지를 설치하십시오.

sudo apt update
sudo apt install python3-paramiko python3-pyqt5 python3-pip python3-psutil python3-venv xterm git openssh-client

현재 설치 프로그램 페이지에서는 사용자에게 Python EXTERNALLY-MANAGED마커를 제거하고 `pip install Python` 명령어를 사용하여 Python 라이브러리를 전역적으로 설치하라고 안내 pip합니다. 하지만 해당 마커를 삭제하지 마십시오. 이 마커는 운영 체제에서 관리하는 Python 환경을 보호하며, Pardus 25.2 릴리스 노트에는 Python 3.13이 명시되어 있음에도 불구하고 안내에서는 Python 3.11 경로를 사용하고 있습니다. 대신 격리된 가상 환경을 사용한 다음, 실제 운영 환경에서 사용하기 전에 설치 프로그램을 테스트하십시오.

python3 -m venv --system-site-packages ~/.venvs/lider-installer
~/.venvs/lider-installer/bin/python -m pip install mysql-connector-python argon2-cffi
git clone https://github.com/Pardus-LiderAhenk/lider-ahenk-installer.git
cd lider-ahenk-installer
~/.venvs/lider-installer/bin/python src/app.py

가상 환경은 PyPI 라이브러리를 격리하면서 apt로 설치된 GUI 라이브러리는 노출합니다. 이러한 보안 강화 조치는 프로젝트 공식 문서에 명시되어 있지 않으므로, 실제 환경에서 검증해 보시기 바랍니다. 워크스테이션과 서버 모두 SSH 접속이 필요하며, 호스트 키를 확인하고 관리자 권한 계정을 사용해야 합니다.

3. Lider 설치 프로그램을 구성하고 실행합니다.

설치 프로그램 창에서 대상 서버 액세스 정보를 입력하십시오. 간단한 파일럿 테스트를 위해 모든 구성 요소를 하나의 서버에 배치하는 옵션을 선택하거나, 분산 토폴로지를 계획 중인 경우 각 구성 요소를 서버에 개별적으로 할당하십시오. 진행하기 전에 연결 확인 기능을 사용하십시오. 연결에 실패하면 추측된 설정으로 계속 진행하지 말고 SSH, 라우팅, 방화벽 또는 계정 권한을 확인하십시오.

다음으로 Lider 패키지 저장소를 선택하십시오. 프로젝트 문서에는 안정적인 패키지를 위한 기본 저장소와 테스트 저장소가 구분되어 있습니다. 프로덕션 환경에 배포할 때는 안정적인 저장소를 사용하십시오. 조직에서 패키지를 내부적으로 미러링하는 경우, 공개 저장소와 내부 저장소를 혼합하여 입력하는 대신 미러 주소와 해당 저장소 키 파일을 입력하십시오.

LDAP 기본 DN, 시스템 관리자 암호, Lider 인터페이스 사용자 이름 및 암호, 인터페이스 사용자 이메일을 입력하십시오. 기본 DN은 LDAP 항목의 루트 명명 경로입니다. 조직의 명명 규칙을 따르십시오. 강력한 암호를 각각 사용하고 승인된 저장소에 보관하십시오. 설치를 시작하기 전에 호스트 및 저장소를 검토하십시오. 설치 과정에서 여러 서비스가 구성되므로 시간이 걸릴 수 있습니다.

4. 콘솔을 열고 Ahenk 클라이언트를 등록합니다.

서버 설치가 완료되면 설치 가이드에 나와 있는 대로 서버 주소와 8080 포트를 사용하여 Lider 인터페이스를 엽니다. 배포 환경에 맞게 구성된 스키마를 사용하고, 콘솔은 신뢰할 수 있는 네트워크 내부 또는 승인된 보안 액세스 계층 뒤에 유지하십시오. 생성한 인터페이스 계정으로 로그인하십시오.

Pardus 엔드포인트에서 먼저 Ahenk 저장소가 이미 구성되어 있는지 확인하십시오. 프로젝트의 클라이언트 가이드에 따르면 저장소는 Pardus 컴퓨터에 정의되어 있습니다. 패키지를 사용할 수 있는 경우 설치하고 등록하십시오.

sudo apt update
apt-cache policy ahenk
sudo apt install ahenk
sudo ahenk-register

패키지 후보가 나타나지 않으면 공식 클라이언트 가이드의 저장소 설정 절차를 따르십시오. 해당 가이드에는 저장소 서명 키와 안정적인 패키지 소스가 제공됩니다. 중복된 소스 줄을 추가하지 마십시오. 저장소는 한 번만 추가하고 실행하기 전에 키와 소스 주소를 확인하십시오 apt update. 등록 프롬프트가 나타나면 작업을 확인하고 마법사가 요청하는 Lider 서버 및 등록 정보를 입력하십시오. 가이드에 따르면 등록은 컴퓨터를 재시작해야 완료되므로 재부팅이 가능한 시간에 등록을 진행하십시오.

Ahenk는 높은 권한으로 실행됩니다. 먼저 파일럿 그룹을 등록하고 정책 범위를 검토하십시오. 모든 클라이언트에서 소프트웨어 제거, 계정, USB, 방화벽 또는 스크립트 작업을 한 번에 테스트하지 마십시오.

5. 파일럿 프로젝트를 확장하기 전에 검증하십시오.

엔드포인트가 재시작되면 Lider 콘솔에서 해당 엔드포인트를 찾아 상태 또는 인벤토리가 최신 상태인지 확인하십시오. 영향이 적은 작업을 전송하고 결과를 검토하십시오. 인터페이스 레이블은 Lider 버전에 따라 다르므로 해당 설명서를 참조하십시오.

클라이언트가 나타나지 않으면 먼저 네트워크 연결 가능성과 Ahenk 등록 결과를 확인하십시오. 서버에 필요한 방화벽 경로가 의도한 호스트 간에만 열려 있는지 확인하고, 선택한 저장소와 LDAP 기본 DN을 검증하십시오. 웹 로그인 성공은 콘솔에 연결 가능하다는 것을 의미하지만, 에이전트가 등록되었거나 작업이 완료되었다는 것을 의미하지는 않습니다. 클라이언트 기록과 작업 완료 결과가 모두 표시된 후에만 배포를 확장하십시오.

출처: Lider 서버 설치 지침 , Lider 시스템 요구 사항 , Ahenk 클라이언트 설치 , Pardus 25.2 릴리스 노트 및 외부 관리 환경용 Python 사양 .