Mass Deployment Tool Manual do Usuário BRA Versão K
Direitos autorais © 2022 Brother Industries, Ltd. Todos os direitos reservados. As informações incluídas neste documento estão sujeitas a alterações sem aviso prévio. O software descrito neste documento é fornecido sob um contrato de licença. O software somente pode ser usado ou copiado de acordo com os termos desse contrato. Nenhuma parte desta publicação pode ser reproduzida de qualquer forma ou por qualquer meio sem o consentimento prévio, por escrito, da Brother Industries, Ltd.
Índice 1 Introdução............................................................................................................................................... 1.1 Visão geral ............................................................................................................................... 1.2 Requisitos do sistema .............................................................................................................. 1.3 Preparação......................................................
1 Introdução 1.1 Visão geral A ferramenta Mass Deployment Tool fornece uma interface de configuração para ajudá-lo a gerenciar uma variedade de configurações de dispositivos Brother e permite que os usuários instalem e gerenciem vários dispositivos conectados via USB ou via rede, sem a necessidade de instalar outros aplicativos de software.
1.2 Requisitos do sistema Windows 10 (32 bits e 64 bits) Sistemas operacionais Windows 11 (64 bits) Windows Server 2012 ou mais recente (64 bits) Software adicional .NET Framework 4.8 ou mais recente 1.3 Preparação 1. Faça download da versão mais recente da ferramenta Mass Deployment Tool no site de suporte da Brother (support.brother.com). 2. Copie o conteúdo do arquivo obtido via download na pasta desejada.
2 Principais funções da ferramenta Mass Deployment Tool (GUI) Use a Interface Gráfica de Usuário (GUI) da ferramenta Mass Deployment Tool para: - Preparar e gerenciar perfis de implantação para vários dispositivos Brother. - Implantar configurações ou enviar instruções para vários dispositivos Brother usando perfis de implantação. - Alterar as configurações da ferramenta Mass Deployment Tool. 2.1 Atualização da lista de dispositivos Nenhum dispositivo é exibido durante a inicialização.
As seguintes funções estão disponíveis na janela principal da ferramenta. - Selecionar o arquivo de configurações Selecione um ou mais dispositivos, clique no botão Configurar arquivo e selecione o arquivo desejado. - Digitar uma senha para dispositivos protegidos por senha Selecione um ou mais dispositivos que usam a mesma senha, clique no botão Inserir senha do dispositivo, digite a senha e depois clique em OK.
2.2 Verificar notificações de dispositivos A coluna Notificação da lista de dispositivos informa o resultado da última tarefa executada nos dispositivos listados. As seguintes notificações estão disponíveis: Não encontrado Este dispositivo estava offline quando o perfil de implantação foi importado na ferramenta. Verifique o status de conexão do dispositivo. (Veja informações adicionais na seção 2.3.1 Importar perfis de implantação.) Concluído Este dispositivo concluiu a última tarefa com sucesso.
2.3 Usar perfis de implantação Os perfis de implantação contêm caminhos para arquivos de configurações, tais como arquivos JSON, e permitem que você designe arquivos de configurações específicos para vários dispositivos Brother. Este recurso permite: - Importar perfis de implantação para restaurar arquivos de configurações específicos para determinados dispositivos.
2.3.2 Exportar perfis de implantação Crie e exporte implantações personalizadas e use-as para gerenciar vários dispositivos. 1. Certifique-se de que a lista de dispositivos contenha todos os dispositivos desejados. Se necessário, adicione mais dispositivos. 2. Clique em e selecione Exportar Perfil... ou Exportar perfil (com senha)... Se você selecionar Exportar Perfil...
b c Os detalhes da unidade flash USB são exibidos. Selecione o arquivo "write_xxx.edpk". * Para dispositivos de impressão monocromática: Pressione Iniciar. * Para dispositivos de impressão em cores: Pressione Iniciar Preto ou Iniciar Cor. - Scanners a Selecione Atualiz. Progr. b Os detalhes da unidade flash USB são exibidos. Selecione o arquivo "write_xxx.edpk". 4. Suas configurações selecionadas serão aplicadas ao dispositivo. O arquivo de registro de saída será criado automaticamente. 5.
2.6 Fazer backup das configurações Você pode recuperar as configurações de dispositivos Brother ao fazer uma cópia de segurança (backup); essa cópia pode ser usada posteriormente para aplicar as mesmas configurações a outro dispositivo. 1. Certifique-se de que a lista de dispositivos contenha todos os dispositivos desejados. 2. Selecione Fazer backup das configurações na lista suspensa mostrada no canto superior esquerdo. 3. A janela Fazer backup das configurações é exibida.
- Scanners a Selecione Atualiz. Progr. b Os detalhes da unidade flash USB são exibidos. Selecione o arquivo "read_xxx.edpk". 5. As configurações desejadas serão extraídas do dispositivo e serão salvas em um novo arquivo com o seguinte formato: [nome do arquivo de configurações]_[nome do modelo]_[número de série]_[índice].edpk O arquivo de registro de saída será criado automaticamente. 9. A caixa de diálogo Fazer backup das configurações mostra o progresso do backup.
- Quando o menu Defina uma senha para os dispositivos não configurados é selecionado, o botão Inserir senha do dispositivo e o campo Senha do dispositivo ficam desativados. - Evite utilizar as seguintes senhas como sua senha de administrador: • access • initpass • A senha identificada como "Pwd" localizada na parte traseira do seu equipamento - Esta opção também pode ser usada com dispositivos conectados via USB. 3. A caixa de diálogo Configurações de senha mostra o progresso da configuração da senha.
3 Funções adicionais da ferramenta Mass Deployment Tool (GUI) O aplicativo inclui funções adicionais avançadas para ajudá-lo a gerenciar seus dispositivos. 3.1 Configurações do aplicativo Clique em na barra superior para ajustar as configurações da ferramenta. 3.1.1 Ajustar as configurações de rede Para ajustar as configurações de Rede do dispositivo, execute o seguinte procedimento: 1. Clique em Rede. 2. Clique na guia SNMP. 3. Selecione as configurações desejadas. 4.
3.1.2 Ajustar as configurações de detecção de dispositivos Para detectar os dispositivos de destino desejados, ajuste as configurações de Detecção de dispositivos indicadas a seguir: Para procurar dispositivos em sua rede 1. Selecione Detecção de dispositivos. 2. Selecione a caixa de seleção Transmissão de IP: ou Unicast IP: na guia Rede:. 3. Clique em para adicionar um novo endereço. 4. Quando terminar, clique no botão OK. Para procurar dispositivos em outra rede local 1.
3.2 Ativar soluções Você pode enviar arquivos de licença para ativar soluções de software personalizadas nos dispositivos de destino. Essa tarefa requer um arquivo de licença válido. Um arquivo de licença contém vários códigos de ativação e permite a ativação simultânea de soluções em vários dispositivos. Se não possuir um arquivo de licença, entre em contato com o escritório local da Brother. 1. Certifique-se de que a lista de dispositivos contenha todos os dispositivos desejados. 2.
4 Interface de Linha de Comando (CLI) A Interface de Linha de Comando (CLI) da ferramenta permite a configuração remota de dispositivos por meio do prompt de comando. A interface CLI converte automaticamente os arquivos de configurações para um formato apropriado e envia-os para o dispositivo desejado. Em seguida, a interface recupera os dados de configurações e verifica se as configurações foram aplicadas corretamente. 4.
4.2 Comandos e opções 4.2.1 Comandos Os comandos mostrados a seguir podem ser usados com uma ou mais opções para executar tarefas específicas de configuração de dispositivos. Comando Opções Descrição send "Device identifier"* ou "profile" é necessário.
Comando Opções Descrição (m)apply "Device identifier" ou "profile" é necessário.
Comando Opções Descrição activate "Device identifier" ou "profile" é necessário. 1 ● Device identifier Obrigatório: ● networksettingpath ● activateresult ● licensecode Opcional: ● password ● profile Obrigatório: ● networksettingpath ● activateresult Opcional: ● profilepassword ● csvdelim Disponível em ambos, se necessário: ● dkeypassword ● dkeyfile ● log ● communitynameset ● communitynameget Permite ativar uma solução de software personalizada no dispositivo de destino especificado.
Comando Opções Descrição unpack Obrigatório: ● file ● unpackdir Opcional: ● password ● log Extrai o arquivo de configurações do arquivo de pacote de configurações especificado. Se o arquivo de pacote for protegido por senha, ele é descriptografado com a senha especificada pela opção "--password" e o arquivo de configuração é extraído.
Comando Opções Descrição (m)listactivefunc "Device identifier" ou "profile" é necessário. 1 ● Device identifier ● profile Obrigatório: ● result Opcional: ● profilepassword ● csvdelim Disponível em ambos, se necessário: ● networksettingpath ● log ● communitynameset ● communitynameget Mostra todas as soluções ativadas para o dispositivo especificado. O comando "mlistactivefunc" deve usar "profile". Exemplo: settingcmd.exe listactivefunc --ip IP_address --result your_filename.csv settingcmd.
Comando Opções Descrição exportprofile Obrigatório: ● output Opcional: ● file ● profilepassword ● networksettingpath ● log ● csvdelim Procurar dispositivos de destino e gerar os resultados da descoberta como um perfil de implantação. Os critérios de procura podem ser especificados com um arquivo de configuração do perfil de exportação (TXT).
Comando Opções Descrição applyup Obrigatório: ● profile ● result Opcional: ● networksettingpath ● dkeypassword ● dkeyfile ● log ● communitynameset ● communitynameget ● profilepassword ● csvdelim Permite registrar os dispositivos de destino especificados, utilizando um perfil de implantação para o Microsoft Universal Print (Impressora universal da Microsoft).
Comando Opções Descrição listfilter É necessário "Device identifier" ou "profile". 1 ● Device identifier ● profile Obrigatório: ● result Opcional: ● profilepassword ● csvdelim Disponível em ambos, se necessário: ● networksettingpath ● communitynameset ● communitynameget Permite exibir os nomes dos filtros registrados para o dispositivo especificado. Exemplo: settingcmd.exe listfilter --ip IP_address --networksettingpath (nome do arquivo de configurações de comunicação via rede) settingcmd.
Opções Descrição --password password Especifica a senha de administrador do dispositivo de destino. --newpassword password Especifica a nova senha de administrador para o dispositivo de destino. --schema filename Especifica um arquivo de esquema JSON externo. --pjltable filename Especifica uma tabela de conversão PJL externa. --enumtable filename Especifica uma tabela de conversão Enum externa. --forcepjl Impõe uma configuração baseada em PJL.
Opções Descrição --outputdir Especifica o caminho para os arquivos criados na execução do comando. --devicepassword password Especifica a senha do dispositivo a ser incluído no arquivo DKEY. --edpkpassword password Especifica a senha do arquivo EDPK a ser incluída no arquivo DKEY. --dkeypassword password Especifica a senha de encriptação e decodificação do arquivo DKEY. --dkeyfile filename Especifica o caminho em que o arquivo DKEY será salvo.
4.2.4 Perfil de implantação Um perfil de implantação contém informações sobre dispositivos, arquivos de configurações e o valor exclusivo de configuração para cada dispositivo, se necessário.
Definições do item de implantação: Item Definição Serial Number O número de série do dispositivo. Se o número digitado neste campo não corresponder ao número de série identificado pelo endereço IP ou pelo nome do nó, a mensagem "Serial number mismatch error" será exibida. Interface (USB/ NETWORK_IPV4) Interface de conexão. É gerado pelo comando "exportprofile" e ignorado caso use qualquer outro comando diferente do comando "exportprofile" com um perfil que contém este item.
- Arquivo de configurações Um arquivo JSON localizado na pasta C:\tmp\brother.edpk: - Arquivo intermediário O arquivo 00001_10.1.2.146.json para o dispositivo 10.1.2.146, em que 00001 representa o número da linha no seu arquivo CSV em que o dispositivo de destino está listado, com um subtraído (cinco dígitos, preenchido com zeros): 4.2.
4.2.6 Criação de arquivo ETKN Crie um arquivo ETKN a partir do portal Azure da Microsoft, utilizando o arquivo UniversalPrintTokenGenerator.exe. No seu prompt de comando, execute o arquivo UniversalPrintTokenGenerator.exe na pasta "UniversalPrintTokenGenerator". O arquivo ETKN é criptografado com a senha especificada na opção "--filepass" e salvo no arquivo especificado na opção "--output". Você pode especificar se deseja sair do Portal Azure da Microsoft depois de receber o token.
5 Criação de arquivos de configurações Consulte esta seção para criar arquivos de configurações usados por esta ferramenta. 5.1 Arquivos de configurações Os arquivos de configurações não dependem do modelo do dispositivo. Se um cliente substituir um dispositivo, os arquivos de configurações poderão ser reutilizados, desde que sejam compatíveis com o novo dispositivo.
A estrutura dos arquivos de configurações JSON e a inclusão de entradas de configuração individuais são descritas nos arquivos de esquema JSON. Por exemplo, a configuração "sleep_time" deve estar localizada em $.settings.general.sleep_mode.sleep_time e aceita apenas valores numéricos. Existem três maneiras de criar e editar arquivos de configurações JSON: Método Descrição Uso de editores de texto Edite os arquivos de configurações desejados em um editor de texto.
6 Setting File Editor Use o Setting File Editor para: ● Remover todas as configurações específicas do dispositivo do arquivo de configurações (.json, .dpk, .edpk) de uma vez ou para remover apenas as configurações de dispositivo desnecessárias e salvar o arquivo. ● Criar os arquivos de configurações (.json, .dpk, .edpk) e perfis (.csv) necessários para executar o comando Mapply. - Adicione palavras-chave dinâmicas (Mapply) ao arquivo de configurações (.json, .dpk, .edpk) e salve o arquivo.
4. Execute um destes procedimentos: a) Remova itens da árvore de configurações. Quando o arquivo de configurações for salvo, os itens desmarcados serão excluídos do arquivo e não serão mais exibidos na árvore de configurações. b) Use palavras-chave dinâmicas (Mapply). Altere ou adicione um valor no arquivo de configurações para uma palavra-chave dinâmica (mapply), selecionando Criar referência dinâmica no menu Avançado. Insira a palavra-chave no campo Palavra-chave dinâmica (Mapply).
• Remova todas as configurações específicas do dispositivo de uma vez, selecionando Desmarcar configurações específicas do dispositivo no menu Avançado. • Um arquivo de configurações com as palavras-chave Mapply pode ser usado apenas com o comando "mapply". Veja informações adicionais na seção 4.2 Comandos e opções. • O menu e o botão Exportar… aparecem quando a opção Criar referência dinâmica é selecionada. Veja informações adicionais sobre perfis de implantação na seção 4.2.4 Perfil de implantação.
7 Solução de problemas Se tiver problemas ao usar a ferramenta Mass Deployment Tool, consulte a tabela mostrada a seguir. Se o problema persistir, entre em contato com a equipe de suporte técnico do escritório local da Brother. Erro Solução Conta de administrador bloqueada A senha de administrador do dispositivo de destino foi inserida incorretamente em um número excessivo de tentativas. Aguarde a liberação do bloqueio da senha do dispositivo de destino.
Erro Solução Solução incompatível Certifique-se de que os dispositivos de destino sejam compatíveis com as soluções que deseja implementar. Algumas das soluções implementadas não são compatíveis ou já foram ativadas. Para obter informações adicionais, verifique o arquivo CSV Solução incompatível/já ativada armazenado no caminho especificado em Salvar o arquivo de resultado em: na tela Ativar soluções. O código de licença foi inserido incorretamente em um número excessivo de tentativas.
Apêndice Os códigos de saída fornecidos pela ferramenta Mass Deployment Tool (CLI) permitem identificar erros de implantação. Erros de CLI/GUI Para mais informações e ajuda, consulte a seção 7 Solução de problemas. Interface Gráfica de Usuário (GUI): Erro Interface de Linha de Comandos (CLI): Código de saída Descrição Admin account locked 80009 A senha de administrador do dispositivo de destino foi inserida incorretamente em um número excessivo de tentativas.
Interface Gráfica de Usuário (GUI): Erro Interface de Linha de Comandos (CLI): Código de saída Descrição Universal Print Internal error – Length excess 80205 O tamanho do token excede o limite. Universal Print Internal error – Unready 80201 O dispositivo ainda não está pronto para registro da Microsoft Universal Print (Impressora universal da Microsoft).