Implante o LIDER AHENK no Pardus e cadastre seus primeiros clientes.

Nota sobre a versão: As instruções oficiais de instalação do servidor LIDER AHENK mencionam atualmente o Pardus 25.1, enquanto a Pardus já lançou o Pardus 25.2. Para uma configuração básica documentada, utilize a combinação 25.1 descrita pelo projeto; antes de implementar a versão 25.2 em produção, confirme a compatibilidade com os mantenedores ou valide-a em um ambiente de teste. A configuração básica consiste em instalar o servidor de gerenciamento Lider e, em seguida, registrar cada endpoint Pardus com o agente Ahenk.

O LIDER AHENK é um sistema de gerenciamento central. O Lider fornece o servidor e a interface de gerenciamento; o Ahenk é o agente privilegiado em cada computador gerenciado. O LDAP armazena os dados do diretório, enquanto o XMPP transporta as comunicações do sistema.

1. Planeje o servidor e a rede.

Antes de instalar, decida se esta é uma implementação piloto ou de produção. A página de requisitos oficiais atual lista 4 núcleos de CPU, 8 GB de memória e 50 GB de disco para uma instalação, com os recursos aumentando conforme o número de clientes cresce. Para desenvolvimento ou teste, lista 2 núcleos de CPU, 4 GB de memória e 20 GB de disco. Considere esses valores como pontos de partida; aumente os recursos conforme o número de clientes crescer.

A página de requisitos lista as portas 8080, 22, 5222, 5280, 3306 e 389. Não as exponha publicamente. Como a página não mapeia todas as portas para cada fluxo de implantação, confirme as regras de origem e destino para sua topologia antes de alterar o firewall.

O instalador suporta um servidor único ou hosts de componentes separados. Para um projeto piloto, use um servidor; para implantações maiores, planeje um layout distribuído. Defina um nome de host e endereço estáveis, confirme a sincronização de DNS e horário e use o inglês para o sistema operacional do servidor, conforme especificado no guia do instalador.

2. Instale o servidor e prepare a estação de trabalho do instalador.

A página de instalação mais recente do servidor especifica o Pardus 25.1 Server, e o diretório de download oficial agora também lista uma imagem do Pardus 25.2 Server. Essa diferença de versão é importante: a página não confirma se o fluxo de trabalho do instalador foi validado com a versão 25.2. Use a versão documentada para uma reprodução rigorosa ou teste a versão mais recente com um servidor de não produção antes de cadastrar dispositivos reais.

O instalador gráfico é executado em uma estação de trabalho Pardus GNOME ou Xfce separada e se conecta ao servidor de destino via SSH. Instale as dependências de sistema documentadas e o cliente SSH, além do pacote de ambiente virtual Python:

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

A página de instalação atual também instrui os usuários a remover um EXTERNALLY-MANAGEDmarcador do Python e instalar as bibliotecas do Python globalmente com `--install` pip. Evite excluir esse marcador: ele protege o ambiente Python gerenciado pelo sistema operacional, e as instruções mencionam um caminho para o Python 3.11, embora as notas de lançamento do Pardus 25.2 listem o Python 3.13. Em vez disso, use um ambiente virtual isolado e teste o instalador antes de usá-lo em produção.

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

O ambiente virtual isola as bibliotecas PyPI, ao mesmo tempo que expõe as bibliotecas GUI instaladas via apt. Essa configuração mais segura não está documentada pelo projeto, portanto, valide-a em um ambiente de laboratório. Tanto a estação de trabalho quanto o servidor precisam de SSH; verifique a chave do host e use uma conta de administrador autorizada.

3. Configure e execute o instalador do Lider.

Na janela do instalador, insira os detalhes de acesso ao servidor de destino. Escolha a opção para colocar todos os componentes em um único servidor para um teste simples ou atribua componentes individuais a servidores se você tiver uma topologia distribuída planejada. Use o controle de verificação de conexão antes de prosseguir; se falhar, resolva as permissões de SSH, roteamento, firewall ou conta em vez de continuar com configurações baseadas em suposições.

Em seguida, selecione o repositório de pacotes Lider. A documentação do projeto distingue o repositório principal para pacotes estáveis ​​do repositório de teste. Use a fonte estável para uma implantação em produção. Se sua organização espelha os pacotes internamente, insira o endereço do espelho e o arquivo de chave de repositório correspondente, em vez de misturar fontes públicas e internas.

Insira o DN base do LDAP, a senha do administrador do sistema, o nome de usuário e a senha da interface do Lider e o e-mail do usuário da interface. Um DN base é o caminho de nomenclatura raiz para entradas LDAP; utilize o plano de nomenclatura da sua organização. Use senhas fortes e separadas e armazene-as em um cofre de senhas aprovado. Revise os hosts e o repositório antes de iniciar a instalação, que configura diversos serviços e pode levar algum tempo.

4. Abra o console e inscreva os clientes Ahenk.

Após a conclusão da instalação do servidor, abra a interface do Lider usando o endereço do servidor na porta 8080, conforme mostrado no guia de instalação. Utilize o esquema configurado para sua implementação e mantenha o console dentro de uma rede confiável ou protegido por uma camada de acesso seguro aprovada. Faça login com a conta da interface que você criou.

Em um endpoint Pardus, verifique primeiro se o repositório Ahenk já está configurado. O guia do cliente do projeto indica que ele está definido em computadores Pardus; se o pacote estiver disponível, instale-o e registre-o:

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

Se nenhum pacote candidato aparecer, siga as instruções de configuração do repositório no guia oficial do cliente. Ele fornece a chave de assinatura do repositório e o código-fonte do pacote estável. Evite adicionar linhas de código-fonte duplicadas; adicione o repositório uma única vez e verifique a chave e o endereço do código-fonte antes de executar o programa apt update. Na tela de registro, confirme a ação e insira o servidor Lider e os detalhes de inscrição solicitados pelo assistente. O guia informa que o registro é concluído reiniciando o computador, portanto, agende a inscrição para um momento em que a reinicialização seja aceitável.

O Ahenk é executado com privilégios elevados. Primeiro, inscreva um grupo piloto e revise o escopo da política; não teste a remoção de software, contas, USB, firewall ou ações de script em todos os clientes simultaneamente.

5. Verifique o piloto antes de dimensionar.

Após a reinicialização do endpoint, localize-o no console do Lider e confirme se o status ou o inventário está atualizado. Envie uma tarefa de baixo impacto e revise o resultado. Os rótulos da interface variam de acordo com a versão do Lider, portanto, consulte o manual correspondente.

Se o cliente não aparecer, verifique primeiro a conectividade da rede e a saída de registro do Ahenk. Confirme se os caminhos de firewall necessários do servidor estão abertos apenas entre os hosts pretendidos e verifique o repositório selecionado e o DN base do LDAP. Um login web bem-sucedido comprova que o console está acessível; não comprova que um agente foi registrado ou concluiu uma tarefa. Expanda a implementação somente depois que o registro do cliente e um resultado de tarefa inofensivo estiverem visíveis.

Fontes: Instruções de instalação do servidor Lider , Requisitos de sistema do Lider , Instalação do cliente Ahenk , Notas de lançamento do Pardus 25.2 e a especificação do Python para ambientes gerenciados externamente .