Implantação do agente macOS via Jamf Pro

Este artigo aborda a configuração e a implantação do HP Insights macOS Agent usando o Jamf Pro em dispositivos macOS.

Pré-requisitos

1. Obtenha um PIN para toda a empresa na Workforce Experience Platform.

   • No menu à esquerda da plataforma, clique na guia Configurações > Preferências > PIN da empresa.

2. Baixe o aplicativo HP Insights macOS mais recente do https://workforceexperience.hp.com/software.

3. Baixe e instale o Jamf Pro Installer.pkg

4. Copie e salve o(s) script(s) necessário(s) com base nas opções abaixo para configurar o aplicativo no console do Jamf Pro:

   • Se o dispositivo não precisar da opção de ocultar a barra de menus, copie o texto do script Enrollment.shabaixo.

   • Se o dispositivo precisar da opção de ocultar a barra de menus, copie o texto do script Enrollment_Tray.sh abaixo.

   • Se o dispositivo já tiver sido registrado com o HP Insights macOS Agent ou atualizado automaticamente para o macOS versão 2.23.6 e desejar ocultar o ícone da barra de menus, copie os textos do script ShowTray.sh e HideTray.sh abaixo.

Se o dispositivo estiver registrado, consulte a seção de instalação "Dispositivos registrados" abaixo.

Scripts para configurar o aplicativo no Jamf Pro Console

1. Enrollment.sh

• Esse script registrará o dispositivo sem interação do usuário por meio de registro silencioso.

• O CPIN precisará ser atualizado dentro do script.

2. Enrollment_Tray.sh (aplicável a partir da versão 2.23.6 do aplicativo macOS)

• Esse script registrará o dispositivo sem interação do usuário por meio de registro silencioso.

• Isso ocultará a bandeja (barra de menus).

• O CPIN precisará ser atualizado dentro do script.

3. ShowTray.sh (aplicável a partir da versão 2.23.6 do aplicativo macOS)

• Este script mostrará o ícone da bandeja (barra de menus).

• Esse script é necessário para dispositivos que já registraram o agente HP Insights.

4. HideTray.sh (aplicável a partir da versão 2.23.6 do aplicativo macOS)

• Este script ocultará o ícone da bandeja (barra de menus).

• Esse script é necessário para dispositivos que já registraram o agente HP Insights.

Enrollment.sh Script

#!/bin/bash
APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
PIN=#########

if [ -d $APPLICATION_SUPPORT_DIRECTORY ]
then
echo "Directory Exists"
else
echo "Directory Does not exist, creating directory"
mkdir "$APPLICATION_SUPPORT_DIRECTORY"
fi
echo "{\"PIN\":\"$PIN\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"

if [ "$APPLICATION_SUPPORT_DIRECTORY\enrollment.json" ]
then
echo "Successfully stored Data at
$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
cat "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
exit 0
else
echo "Unable to store Data"
exit 1
fi
exit 1

Enrollment_Tray.sh Script

#!/bin/bash
APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
PIN=#########
if [ -d $APPLICATION_SUPPORT_DIRECTORY ]
then
echo "Directory Exists"
else
echo "Directory Does not exist, creating directory"
mkdir "$APPLICATION_SUPPORT_DIRECTORY"
fi
echo "{\"PIN\":\"$PIN\",\"HideTray\":\"true\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
if [ "$APPLICATION_SUPPORT_DIRECTORY\enrollment.json" ]
then
echo "Successfully stored Data at
$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
cat "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
exit 0
else
echo "Unable to store Data"
exit 1
fi
exit 1

ShowTray.sh Script

#!/bin/bash
APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
if [ -d $APPLICATION_SUPPORT_DIRECTORY ]
then
echo "Directory Exists"
else
echo "Directory Does not exist, creating directory"
mkdir "$APPLICATION_SUPPORT_DIRECTORY"
fi
echo "{\"HideTray\":\"false\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
if [ "$APPLICATION_SUPPORT_DIRECTORY\enrollment.json" ]
then
echo "Successfully create enrolment json at
$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
cat "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
exit 0
else
echo "Unable to store PIN"
exit 1
fi
exit 1

HideTray.sh Script

#!/bin/bash
APPLICATION_SUPPORT_DIRECTORY=/etc/APMAgent
if [ -d $APPLICATION_SUPPORT_DIRECTORY ]
then
echo "Directory Exists"
else
echo "Directory Does not exist, creating directory"
mkdir "$APPLICATION_SUPPORT_DIRECTORY"
fi
echo "{\"HideTray\":\"true\"}" > "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
if [ "$APPLICATION_SUPPORT_DIRECTORY\enrollment.json" ]
then
echo "Successfully create enrolment json at
$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
cat "$APPLICATION_SUPPORT_DIRECTORY/enrollment.json"
exit 0
else
echo "Unable to store PIN"
exit 1
fi
exit 1

Carregando e configurando o aplicativo no Jamf Pro Console

A configuração do HP Insights Agent difere dependendo se o dispositivo está registrado ou não registrado no HP Insights Agent. As instruções para ambas as iterações podem ser encontradas abaixo:

Dispositivos não registrados

1. No console do Jamf Pro , clique em > Computadores > Configurações de gerenciamento.

2. Em Gerenciamento do Computador, selecione Pacotes.

3. Na janela Pacotes , clique em Novo para adicionar o pacote de aplicativos HP Insights macOS baixado anteriormente.

   1. Nome de exibição: Insira o nome do pacote

   2. Categoria: Selecione Aplicativos

   3. Nome do arquivo: Carregue o arquivo do pacote de aplicativos HP Insights macOS

4. Clique em Salvar.

5. Na seção Gerenciamento do Computador , selecione Scripts.

6. Na janela Scripts , clique em Novo para adicionar o script de instalação do HP Insights.

   1. Nome de exibição: Insira o nome do script

   2. Categoria: Scripts

7. Clique em Salvar.

8. Clique na guia Script e copie o Script selecionado acima. Verifique se o  script foi substituído pelo PIN real da empresa.

9. Clique na guia Opções .

   1. Em Prioridade, selecione Depois

10. Clique em Salvar.

11. Vá para a guia Computadores e clique em Políticas.

12. Clique em Novo.

    1. Na seção Geral :

       1. Nome de exibição: Insira o nome da política

       2. Verificar ativado

       3. Categoria: Selecione Aplicativos

       4. Gatilho: Verificar inscrição concluída e check-in recorrente

    2. Na seção Pacotes , clique em Configurar.

       1. Selecione o pacote criado anteriormente.

       2. Ponto de distribuição: selecione o ponto de distribuição padrão de cada computador

       3. Ação: Selecione Instalar

    3. Na seção Scripts , clique em Configurar.

       1. Selecione o script criado anteriormente.

       2. Prioridade: Selecionar Depois

       3. Na guia Escopo , direcione os dispositivos de acordo com suas necessidades.

       4. Na guia Autoatendimento , marque Disponibilizar a política no Autoatendimento

       5. Nome de exibição de autoatendimento: insira o nome e uma descrição do pacote

       6. Nome do botão: Você também pode adicionar um ícone

13. Clique em Salvar.

Dispositivos inscritos

Se o dispositivo já tiver o HP Insights macOs Agent instalado e o usuário quiser alternar a ocultação do aplicativo da barra de menus, o usuário poderá continuar executando os ShowTray.sh scripts ou HideTray.sh no console. O processo será o mesmo listado acima com "Dispositivos que não foram registrados"; No entanto, ao inserir os scripts, insira sudo bash ./ShowTray.sh ou sudo bash ./HideTray.sh respectivamente.