Processo de execução de receitas de instalação, atualização e ou comandos avulsos em seu servidor associado ao RPilot.
Nessa roteiro iremos aprender o processo de solicitar a execução de uma ação dentro do nosso servidor usando o RPilot. Nosso foco aqui será a instalação do IDP da CAFe então esse processo será direcionado para isso não dando ênfase em outros pontos. Caso tenha interesse em saber mais sobre a ferramenta RPilot acesse o manual do usuário através desse Link.
Esse é o painel de execuação. Nele podemos executar a receita de instalação do IDP da CAFe.
Repare que nele podemos confirmar o nosso servidor através das informações do servidor como Nome , Chave de registro , ID do Registro único, Domínio, Hostname e IP.
Também pode verificar o Status do agente RPilot instalado no seu servidor, confirme se ele está com o Status em verde com a informação "Agente Instalado".
Passos para execução:
Escolher o tipo de execução
Escoher a opção "Executar Receita"
Clicar no botão "Próximo"
Será mostrada uma tela para que você possa escolher seu "Produto" e abaixo você deve escolher qual "Receita" deseja executar:
Escolha o produto CAFe e a receita de Instalação do IDPvX.X.X conforme figura acima.
Essa página é aonde podemos acompanhar o processo das execuções feitas em nosso servidor pelo RPilot, todas as receitas executadas serão apresentadas aqui nesse painel.
Você será apresentado em uma painel com um formato em tabela, sendo ele dividio da seguinte forma:
6 colunas
Nome do Servidor -> Servidor no qual foi executado aquela receita.
Tipo de execução -> Se foi executado uma Receita, um Comando Avulso ou uma Geração de Certificado.
Data da Solicitação -> Data e hora da solicitação, início.
Data da execução -> Data e hora da execução, término.
Status -> Executando, Sucesso ou Erro.
Ações -> Log
Após a execução terminar, seja com Sucesso ou Erro você pode clicar emcima da linha ou ir em Ações nas 3 bolinhas e clicar em Log para verificar o log de execução da Receita.
Essa página ira apresentar e orientar o usuário do sistema RPilot em como executar uma receita do produto CAFe.
Para executar as receitas do produto desejado você deve acessar o dashbord do seu servidor
Para acessar o dashboard do seu servidor dentro do RPilot você precisa acessar a opção "Servidores" no menu de funcionalidades lateral esquerdo. Figura abaixo:
Se você já realizou a instalação do agente do RPliot em seu servidor ele será mostrado conforme a figura acima, caso ainda não tenha feito essa etapa, acesse o procedimento neste Link
Para acessar o dashboard do seu servidor você pode ou clicar em cima da linha referente ao seu servidor, ele é clicável, ou clicar no ícone das 3 bolinhas dentro da coluna "Ações", Figura abaixo:
Após acessar o painel do dashboard será apresentado um pequeno painel de monitoramento e gerenciamento. Será nesse painel que você irá encontrar o caminho para as solicitações de execução das receitas dos seus produtos vinculados, conforme figura abaixo:
No canto superior esquerdo o indicativo do nome do servidor que está aberto, todas as suas ações dentro desse painel será para esse servidor.
No canto inferior esquerdo é possível ver o status do agente para esse servidor.
No canto superior direito temos o botão para solicitar a execução de uma ação em seu servidor.
Nesse conteúdo vamos aprender um pouco de como funciona a estrutura de receitas do RPilot e como trabalhar com as variáveis de instalação de uma receita.
Para que a receita possa funcionar de acordo com as informações da sua instituição, por exemplo, dados e informações necessárias e exclusivas da usa rede e infraestrutura, o RPilot fornece uma opção de inserção de variáveis específicas que a receita entende como sendo os parâmetros da instalação.
No caso do IDP da CAFe existem 26 variáveis necessárias para a instalação correta do IDP. Que podemos dividir em 3 subclasses:
Informações para certificado Shibboleth e metadado
Informação para conexão e configuração com base de diretório
Informações para configuração de um <virtualhost> Apache
ORGANIZATION -> Nome da Instituição por extenso. Exemplo: Rede Nacional de Ensino e Pesquisa
INITIALS -> A sigla da instituição. Exemplo: RNP
CITY -> Cidade da instituição. Exemplo: Brasília
STATE -> Unidade Federativa da instituição. Exemplo: DF
URL -> Endereço da página institucional. Exemplo: https://www.rnp.com
OU -> Sigla do setor técnico. Exemplo: DTI
CONTACTGIVEN -> Nome do responsável técnico. Exemplo: João Silva
CONTACTMAIL -> Endereço de email do contato. Exemplo: joao.silva@rnp.br
CONTACTSUR -> Sobrenome do contato apenas. Exemplo: Silva
LDAPATTR -> Atributo para autenticação na CAFe. Exemplo: uid, mail ou sAMAccountName
LDAPDN -> DN onde consulta os usuários na base LDAP. Exemplo: ou=pessoas,dc=rnp,dc=local
LDAPFORM -> Formato para construção das consultas na base LDAP. Exemplo: uid=%s,dc=rnp,dc=local
LDAPPWD -> Senha do usuário de BIND da base LDAP.
LDAPSERVER -> Endereço do servidor LDAP. Exemplo: 192.168.1.20
LDAPSERVERPORT -> Porta usada para conexão LDAP. Exemplo: 389 ou 636
LDAPSERVERPROTO -> Protocolo de comunicação LDAP. Exemplo: ldap:// ou ldaps://
LDAPSERVERSSL -> Valor 0 para SEM SSL e valor 1 para COM SSL.
LDAPSUBTREESEARCH -> Permitir consulta vertical abaixo do DN LDAP informado, por padrão essa opção deve estar 'true'. Exemplo: true
LDAPUSER -> Usuário de BIND para consulta no LDAP. Exemplo: uid=leitor-shib,ou=pessoas,dc=rnp,dc=local
DOMAIN -> Apenas o domínio da instituição. Exemplo: rnp.br
HN -> Apenas o nome do servidor, sem domínio. Exemplo: idp
HN_DOMAIN -> Apenas o domínio. Exemplo: cafe.rnp.br
INTERFACE -> Digitar o valor da Interface de rede do servidor. Exemplo: eth2, ens160, eth0, etc...
IP -> Digitar o IP do servidor IDP. Se estiver usando NAT digitar o IP NAT.
Ao terminar de preencher todos os campos clicar no botão "Próximo" ao final do rodapé.
Após seguir para o próximo passo de execução uma tela de revisão dos parâmetros será apresentado para que você possa verificar se as informações passadas para a receita de instalação estão corretas.
Se algo estiver incorreto você pode clicar no botão "Voltar" para corrigir. Se tudo estiver correto você pode então confirmar a execução da receita de instalação do IDP.
