Criando seu próprio pacote de instalação dos agentes¶

Você pode fazer seu próprio pacote dos agentes NxClient, NxUpdate, NxMapper, NxLogon, etc.

Já o NxLogon, que é uma aplicação simples sem instalador você só precisa substituir vários arquivos do arquivo zip original e fazer seu próprio arquivo zip. Você pode alterar o nome dele também, mas quando fizer essa alteração é indicado mudar também o conteúdo dos arquivos batch mas isso será visto a frente.

Contudo esse processo é um pouco diferente para o NxClient, NxUpdate e NxMapper uma vez que estes requerem que sejam feitos instaladores para Windows e Mac OS.

Criando sua própria instalação Windows¶

Para fazer os instaladores do Windows foi utilizado o Inno Setup [1] . Quando NxClient, NxUpdate e NxMapper é instalando, eles criam seus próprios diretórios dentro de ‘C:/Program Files (x86)’ e registrado como um serviço Windows.

Por exemplo, quando é executado o instalador NxClient todos os arquivos necessários são copiados para ‘C:/Program Files (x86)/nxclient’ e então é executado ‘bin/instsvc.bat’ para registrá-lo como serviço Windows e então é executado o arquivo ‘bin/setup.bat’ ao término do processo de instalação para rodar seu programa de configuração.

Nota

Se você se tornar nosso parceiro comercial podemos disponibilizar nosso script Inno Setup.
Os arquivos zip usados para criar nossos pacotes de instaladores estão em um pacote antigo na nossa página de download.
Quanto o sistema é removido, é executado o batch ‘bin/unstsvc.bat’ para remover o registro do serviço do Windows.

Criando seu instalador para o Mac OS¶

É usado o programa Packages [2] para construir nosso instalador Mac OS. Quando o instalador é executado ele criará seus diretórios em ‘/Library’ e o arquivo ‘conf/plist.default’ é copiado para dentro de ‘/Library/LaunchDaemons’ com um novo nome como ‘org.nxfilter.nxclient.plist’ para ser executado como um daemon. E então ele roda o script ‘setup-mac.sh’ localizado no diretório de instalação para iniciar o programa de configuraçãoi.

Para remover o programa você precisa rodar o script ‘uninstall-mac.sh’, que está dentro do diretório de instalação.

Nota

Podemos disponibilizar nosso script do Packages se for nosso parceiro comercial.
Os arquivos zip usados para criar nossos pacotes de instaladores estão em um pacote antigo na nossa página de download.

Mudando o nome da aplicação¶

Quando você personalizar nossos agentes, uma das coisas que pode desejar é mudar os nomes dos nossos agentes. Altere o arquivo ‘conf/appname’, localizado no diretório de instalação. Quando o nome é alterado, ele aparecerá no programa de instalação dos nossos agentes.

Replacing icon file and default setup value Substituindo/Alterando ícones ——————————

Para usar seu próprio ícone, o arquivo é ‘’nxd.ico’’ localizado no diretório de instalação e é um arquivo que contém ícones com as dimensões 16x16, 32x32 e 48x48. No momento só é usado para o Instalador Windows e programa de configuração.

Nota

A versão do NxClient e NxUpdate baseado em Java precisa que seja adicionado mais um ícone cujo nome seria ‘nxd16.png’. É um arquivo PNG de 16x16 para a GUI de configuração.

Também é possível mudar os valores padrão na conexão com o servidor. Você pode modificar os valores padrão de ‘Server IP’ e ‘Login Token’ do programa de configuração alterando o arquivo ‘conf/cfg.default’.

O arquivo ‘conf/cfg.default’ será copiado por cima do arquivo ‘conf/cfg.properties’ quando você executa o programa de configuração pela primeira vez ou durante o processo de instalação.

Escrevendo seu programa de configuração¶

É possível construir seu próprio pacote, para fazê-lo e incluir seu programa de configuração. Em nossos programas de configuração existem alguns controles e botões. Para controle, nós lemos os paramêtros no arquivo ‘conf/cfg.properties’.

E quando você clicar nos botões que são ‘SAVE’, ‘TEST’, ‘START’, ‘STOP’ as ações são feitas relendo/alterando o arquivo de configuração.

O botão ‘SAVE’ grava os valores definidos na tela em ‘conf/cfg.properties’.

Os botões ‘START’ e ‘STOP’, se forem usados no Windows chamam os comandos ‘net start’ e ‘net stop’ considerando que o agente foi instalado como serviço. Já no Mac OS, é executado o programa ‘/bin/launchstl’ com o arquivo Plist gravado no diretório ‘/Library/LaunchDaemons’.

Então - reafirmando - ao fazer seu programa de configuração para o NxClient no Windows, quando for clicando em ‘START’ e ‘STOP’ você precisa executar os comandos,

net start NxClient

net stop NxClient

Quando for no Mac OS,

/bin/launchctl load -w /Library/LaunchDaemons/org.nxfilter.nxclient.plist

/bin/launchctl unload -w /Library/LaunchDaemons/org.nxfilter.nxclient.plist

O botão ‘TEST’ executa o batch ‘bin/test.bat’ ou o script ‘bin/test.sh’. Antes de executar seu próprio script de testes você precisa gravar primeiro os valores de configuração.

Após você executar o script de teste você pode receber algumas mensagens com os seguintes códigos de saída.

0 = Sucesso

-1 = Valores incorretos na configuração

-2 = Erro de conexão

-3 = Erro de login

Nota

Para o NxMapper, ao invés de ‘bin/test.bat’ é usado o aplicativo ‘test.exe’.

Para o NxMapper não há code de erro do login já que não existe processo de login.

Personalizando o NxRelay¶

Não é disponibilizado um instalador ou programa de configuração do NxRelay por não ser um sistema para um usuário comum do Windows. Mas sua estrutura é a mesma do NxFilter. Nos tópicos anteriores é explicado como criar um pacote de instalação, siga o mesmo procedimento.

Limitação¶

Preparando seu próprio instalador e modificando os nomes dos agentes geralmente atende a maioria das necessidades. Mas há algo que não pode ser mudado. Internamente, no sistema, há uma codificação contendo a assinatura ‘nxfilter’. É importante mantê-la para que tenhamos uma unica assinatura e possamos diferenciar os sinais recebidos dos agentes.

E também não é permitido remove a licença ou qualquer das licenças de terceiro sob pena de caracterizar uma violação na licença base. Você pode ter seu próprio arquivo de licença mas a licença base precisa ser mantida. Sào permitidas muitas caracterizações e alterações, então é inevitável não ter alguma limitação.

[1]	http://www.jrsoftware.org

[2]	http://s.sudre.free.fr