Instalando e gerenciando agentes
O Print Tracker utiliza agentes de coleta de dados -- aplicativos de software leves instalados em redes de clientes -- para descobrir e coletar dados de seus dispositivos. Os agentes estão disponíveis para sistemas operacionais Windows, Mac e Linux e podem ser instalados usando uma variedade de métodos, incluindo e-mail, download direto e linha de comando.
Código Datalink
Quando um agente é instalado dentro da rede de seus clientes, ele precisa saber como enviar esses dados para você. O Print Tracker conecta os dados coletados da rede do seu cliente à sua conta usando um identificador exclusivo chamado Datalink Code. Esse código é um identificador exclusivo gerado para cada conta em sua conta.
Você pode obter o código datalink para uma conta:
- Navegue até a conta para a qual você gostaria de obter o código de link de dados
- Usando a barra lateral, clique em Instalações > Implantar nova instalação
- Copie o código do datalink do campo Datalink code
Estratégias de Implantação
Há várias maneiras diferentes de implantar o agente de coleta de dados do Print Tracker, dependendo de sua necessidade. Por exemplo, se você estiver no cliente, poderá optar por baixar o agente diretamente no computador do cliente e instalá-lo manualmente. Ou, se você estiver trabalhando remotamente, você pode optar por enviar o agente para o cliente por e-mail e fazer com que ele mesmo o instale. Você pode até ter acesso de administração remota a um conjunto de computadores, caso em que você pode implantar o agente usando linha de comando.
Uma vez instalado, o agente também precisa ser registrado. O processo conecta este agente à sua conta para que você possa gerenciar e coletar dados dele.
Email de implantação
A estratégia de e-mail de implantação permite que você envie facilmente um link para o instalador diretamente para o cliente, juntamente com instruções sobre como registro o agente.
Para enviar um email de implantação:
- Selecione a conta à qual você deseja que a instalação seja associada.
- Usando a barra lateral, clique em Instalações > Implantar nova instalação
- Clique em Enviar e-mail de instalação
- Digite o endereço de e-mail do contato do seu cliente no local
- Clique em Enviar e-mail.
Seu cliente receberá instruções sobre como baixar e registro o agente
Baixar e instalar
Você pode optar por baixar o agente diretamente para o computador em que está trabalhando no momento. Você pode encontrar todos os downloads do Print Tracker navegando até printtrackerpro.com/download ou escolhendo o download apropriado para seu sistema operacional abaixo.
Linha de comando
Em alguns casos, pode ser mais fácil implantar o agente usando a linha de comando. Isso é especialmente verdadeiro se você tiver acesso de administração remota a uma frota de computadores que precisam ser instalados com o agente. Atualmente, apenas o Windows e o Linux oferecem suporte à instalação de linha de comando.
Se você quiser instalar e registro o agente no mesmo comando, pule para Registro Automático.
Instalação
- Windows
- Linux
:::Aviso de cautela Você deve executar a janela do Powershell como administrador para instalar o agente. Se você não fizer isso, a instalação falhará silenciosamente. :::
- Abra uma janela do Powershell como administrador
- Copie e cole o seguinte comando na janela do Powershell e pressione enter
- Este comando irá baixar a versão mais recente do Print Tracker e instalá-lo
- Quando a instalação estiver concluída, abra localhost:1301 para registro o agente com seu datalink code
$webClient = New-Object System.Net.WebClient; $version = $webClient.DownloadString('https://www.cdn.printtrackerpro.com/modules/dca/current_major_version').Trim(); $url = "https://www.cdn.printtrackerpro.com/modules/dca/$version/PrintTrackerProOfflineSetup.msi"; Write-Host "Version: $version"; Write-Host "Download URL: $url"; $output = Join-Path -Path $([System.IO.Path]::GetTempPath()) -ChildPath 'PrintTrackerProOfflineSetup.msi'; Write-Host "Download Path: $output" $webClient.DownloadFile($url, $output); Start-Process 'msiexec' -ArgumentList @('/qn', '/i', "`"$output`"") -Wait;
Você deve ter acesso sudo para instalar o agente. Se você não fizer isso, a instalação falhará.
- Abra uma janela do terminal
- Execute o seguinte comando para baixar e instalar o agente
- Quando a instalação estiver concluída, abra localhost:1301 para registro o agente com seu datalink code
source <(curl -fsSL https://www.cdn.printtrackerpro.com/modules/dca/install.sh)
Registro Automático
Além de instalar o agente usando a linha de comando, você também pode usar a linha de comando para registro o agente.
- Windows
- Linux
Você deve executar a janela do Powershell como administrador para instalar o agente. Se você não fizer isso, a instalação falhará silenciosamente.
- Abra uma janela do Powershell como administrador
- Copie o seguinte comando
- Substitua '<SEU CÓDIGO DATALINK>' pelo seu código datalink
- Execute o comando para baixar e instalar o agente
$webClient = New-Object System.Net.WebClient; $version = $webClient.DownloadString('https://www.cdn.printtrackerpro.com/modules/dca/current_major_version').Trim(); $url = "https://www.cdn.printtrackerpro.com/modules/dca/$version/PrintTrackerProOfflineSetup.msi"; Write-Host "Version: $version"; Write-Host "Download URL: $url"; $output = Join-Path -Path $([System.IO.Path]::GetTempPath()) -ChildPath 'PrintTrackerProOfflineSetup.msi'; Write-Host "Download Path: $output" $webClient.DownloadFile($url, $output); Start-Process 'msiexec' -ArgumentList @('/qn', '/i', "`"$output`"", 'DATALINK_CODE=<YOUR DATALINK CODE>') -Wait;
Você deve ter acesso sudo para instalar o agente. Se você não fizer isso, a instalação falhará.
- Abra uma janela do terminal
- Copie o seguinte comando
- Substitua '<SEU CÓDIGO DATALINK>' pelo seu código datalink
- Execute o comando para baixar e instalar o agente
datalink_code='<YOUR DATALINK CODE>'; source <(curl -fsSL https://www.cdn.printtrackerpro.com/modules/dca/install.sh)
Instalação
Depois que o agente tiver sido baixado e instalado, a última etapa é o registro, que conecta sua conta do Print Tracker ao agente instalado na rede do seu cliente. Um agente que não esteja registrado em sua conta não aparecerá no Print Tracker.
Cadastro
Para cadastrar um agente, verifique se o agente foi baixado e instalado usando uma das estratégias de implantação. Uma vez instalado o agente:
- Abra localhost:1301 no navegador da Web do computador em que o agente está instalado
- Digite seu datalink code
- Clique em Register
Clustering e Redundância
Clustering é a ideia de instalar vários agentes na mesma rede para que, se um agente ficar inativo, outro agente possa assumir o controle. O Print Tracker agrupa automaticamente os agentes registrados usando o mesmo datalink code. Isso significa que, se você tiver vários agentes instalados na mesma conta, eles se agruparão automaticamente sem exigir nenhuma configuração adicional de você.
Quando vários agentes são instalados na mesma rede, dispositivos, medidores e todos os outros dados coletados duplicados são eliminados automaticamente, não havendo duplicidade.
Atualizando manualmente
Por padrão, as instalações são atualizadas automaticamente dentro de 24 a 48 horas após uma nova versão. Você também pode atualizar manualmente uma instalação para a versão mais recente a qualquer momento.
Para atualizar manualmente uma instalação:
- Usando a barra lateral, clique em Instalações > Ver instalações
- Encontre a instalação que você deseja atualizar
- Clique no ícone do menu de três pontos na última coluna do lado direito da tabela
- Clique em Atualizar instalação
Dentro de alguns minutos, a instalação será atualizada para a versão mais recente. Se a instalação não puder ser atualizada, verifique a seção solução de problemas para obter mais informações.
Agentes obsoletos
Um agente obsoleto é um agente que não está mais conectado ao Print Tracker. As instalações geralmente fazem check-in a cada 30 minutos, no entanto, algumas instalações podem não fazer check-in por períodos mais longos se o computador for desligado ou entrar no modo de suspensão. Instalações que estão offline por longos períodos de tempo (vários dias) podem ser problemáticas. Por exemplo, o agente asn que está offline por um longo período de tempo pode ter perdido alertas de dispositivo críticos, como uma substituição de suprimento. Quando um agente obsoleto volta a ficar online é importante rever todos os seus dispositivos para se certificar de que não perdeu nenhum evento crítico.
Desativando/Reativando
Você pode desativar um agente a qualquer momento. A desativação de um agente ocultará o agente da sua conta. A desativação de um agente não desinstalará o agente do computador em que ele está instalado. Se você quiser desinstalar o agente, deverá fazê-lo manualmente.
Os agentes desativados param de fazer check-in no Print Tracker regularmente e, em vez disso, fazem check-in apenas na reinicialização do sistema. Isso significa que, se você reativar uma instalação desativada, ela pode não voltar a ficar online até que o computador seja reiniciado.
Você só deve desativar os agentes que não planeja usar novamente. Se você planeja usar um agente novamente no futuro, você deve deixá-lo ativado.
Desativando
Para desativar um agente:
- Usando a barra lateral, clique em Instalações > Exibir instalações
- Encontre a instalação que você deseja desativar
- Clique no ícone Checkbox no lado esquerdo da tabela
- Na parte superior da tabela, clique na seta para baixo ao lado do ícone da caixa de seleção da tabela
- Clique em Desativar selecionado
Reativando
Para reativar um agente:
- Usando a barra lateral, clique em Instalações > Exibir instalações
- Certifique-se de que o filtro Excluir inativo está desativado
- Encontre a instalação que você deseja reativar
- Clique no ícone da caixa de seleção no lado esquerdo da tabela
- Na parte superior da tabela, clique na seta para baixo ao lado do ícone da caixa de seleção da tabela
- Clique em Ativar selecionado
Desinstalando
A desinstalação do Print Tracker deve ser feita diretamente no computador onde o Print Tracker está instalado. Esse processo varia de acordo com o sistema operacional.
- Windows
- macOS
- Linux
- Abra o Windows Menu Iniciar
- Pesquise "Adicionar ou remover programas" e abra-o
- Procure por "Print Tracker Pro"
- Clique no ícone de menu de três pontos ao lado de "Print Tracker Pro"
- Clique em Desinstalar
- Siga as instruções para concluir a desinstalação
- Abra uma janela do terminal
- Copie e execute o seguinte comando
- Siga as instruções para concluir a desinstalação
sudo bash /Library/PrintTracker/DataCollectionAgent/uninstall.sh
- Abra uma janela do terminal
- Copie e execute o seguinte comando
source <(curl -fsSL https://www.cdn.printtrackerpro.com/modules/dca/uninstall.sh)
Sistemas operacionais suportados
As instalações do Print Tracker são projetadas para serem compatíveis com todas as versões atualmente suportadas do Windows, macOS e Linux. Não há garantia de fornecimento de solução de problemas e suporte para instalações executadas em sistemas operacionais mais antigos. Consulte os requisitos do sistema para obter mais detalhes.
Encontrando Sistemas Operacionais Não Suportados
É importante revisar periodicamente sua frota de instalações para garantir que você não esteja executando nenhum sistema operacional sem suporte. Você pode encontrar sistemas operacionais não suportados:
- Usando a barra lateral, clique em Início
- Clique na guia Instalação.
- Na seção Instalações por sistema operacional
- Clique em qualquer linha do gráfico que diz Unsupported
- Revise a tabela Instalações abaixo do gráfico para ver quais instalações e clientes estão executando sistemas operacionais não suportados.
Solução de problemas
Para obter mais detalhes sobre como solucionar problemas com seus agentes, consulte Solução de problemas.
Pacotes do instalador do macOS
Alguns dispositivos macOS podem exibir um aviso indicando que o .pkg não pode ser aberto. Isso ocorre porque o Print Tracker não é registrado pela Apple e disponibilizado através da Apple App Store.
Para ignorar este aviso:
- Clique com o botão direito do mouse no arquivo na janela do Finder.
- Clique em Abrir
- Clique em Abrir novamente
- Siga as instruções de instalação.