Configurando Programas Externos
Pontos importantes a serem lembrados ao instalar o produto base ou servidores de aplicativo/secundários e o outro aplicativo:
- Ao instalar o software RICOH ProcessDirector em um sistema Linux ou AIX, o programa de instalação cria o usuário do sistema RICOH ProcessDirector (aiw1 é o padrão). Ao verificar a operação de um programa externo que é executado em um sistema Linux ou AIX, utilize o usuário do sistema RICOH ProcessDirector para fazer o teste de verificação.
- O RICOH ProcessDirector não cria uma conta de usuário do sistema automaticamente para RICOH ProcessDirector em um servidor de aplicativos Windows. O programa de instalação solicita o nome da conta de usuário para utilizar como o usuário do RICOH ProcessDirector. Verifique a operação do programa externo a partir da conta do usuário RICOH ProcessDirector no servidor de aplicativos Windows.
- Quando o computador primário do RICOH ProcessDirector for um sistema Linux ou AIX, certifique-se de que o usuário do sistema RICOH ProcessDirector e o usuário utilizado pelo outro aplicativo tenham as permissões adequadas para os diretórios e sistemas de arquivos que eles utilizam.
- Certifique-se de que o usuário do sistema RICOH ProcessDirector possa localizar e executar o outro aplicativo.
Utilize um dos seguintes métodos:
- Inclua o caminho completo para o aplicativo no comando criado.
- Adicione o aplicativo à variável de ambiente PATH para o usuário do sistema RICOH ProcessDirector.
Essa opção funcionará melhor ser o outro aplicativo for executado no mesmo sistema que o servidor principal. Se o aplicativo for executado em um servidor secundário ou de aplicativos, essa opção só funcionará se você montar o diretório no qual o outro aplicativo está instalado.
- Crie um link simbólico para o outro aplicativo, armazenando o link em
/aiw/aiw1/bin.O armazenamento de um link simbólico nesse diretório oferece benefícios importantes. O RICOH ProcessDirector inclui esse diretório à variável de ambiente PATH quando ele cria o sistema do usuário RICOH ProcessDirector, para que o aplicativo possa ser reconhecido sem a edição de PATH. O diretório não é excluído quando você aplica o serviço, embora alguns de seus arquivos possam ser atualizados. O arquivo de link não deve ser afetado.
Além disso, os servidores de aplicativo e secundários podem acessar esse diretório. Como resultado, eles também podem utilizar o link simbólico para localizar o aplicativo externo, caso ele esteja localizado no sistema de arquivos
/aiw. O aplicativo externo não pode ser executado em um computador primário Linux ou AIX e em um servidor de aplicativos Windows ao mesmo tempo.
Para configurar o programa externo:
- Utilize a documentação para o programa externo e verifique se ele é executado sem erros como um programa autônomo.
- Se você planejar utilizar RunExternalProgram:
- Efetue login no computador em que o aplicativo é executado como o usuário do sistema RICOH ProcessDirector ou como o ID de usuário do Windows sob o qual o servidor de aplicativos é executado.
- Componha o comando que você possa utilizar para invocar o programa a partir da linha
de comando e utilize-o para enviar um arquivo de entrada ao programa.Registre o comando que funcionar corretamente para poder utilizá-lo como o modelo ao configurar seu modelo de etapa.
- Crie um modelo de arquivo de controle a ser utilizado pela etapa.
Se o programa externo ler os valores de propriedade que ele requer de um arquivo de parâmetro que acompanha o arquivo de impressão, a etapa RunExternalProgram poderá criar esse arquivo. Para gerar o arquivo, a etapa utiliza um modelo de arquivo de controle. Para criar o modelo de arquivo de controle:
- Faça uma cópia de um arquivo de parâmetro que o aplicativo possa utilizar.
- Substitua todos os valores de propriedades no arquivo pela representação de notação
simbólica RICOH ProcessDirector da propriedade. Se o valor for o nome de um arquivo da tarefa, substitua-o pela chamada
de método RICOH ProcessDirector adequada para determinar o nome do arquivo.
Durante o processamento, a etapa utiliza o modelo para criar o arquivo de parâmetros resolvendo todas as referências e preenchendo os valores da tarefa atual.
- Copie o modelo de arquivo de controle em um diretório no sistema de arquivo compartilhado
do RICOH ProcessDirector (
/aiw/aiw1/.)Nesse local, todos os servidores que estão conectados ao servidor primário podem acessar o arquivo.Modelos de arquivo de controle de amostra para programas externos são instalados em
/aiw/aiw1/samples/external_programs/. É possível copiar esses arquivos no diretório/aiw/aiw1/control_files/external_programs/e customizá-los ou incluí-los em seus próprios arquivos de controle no diretório/aiw/aiw1/control_files/external_programs/. Anote o local do diretório do seu modelo de arquivo de controle. - Em um sistema Linux ou AIX, verifique se as permissões de arquivo do modelo de arquivo de controle oferecem acesso para a classe other de usuários do sistema. Por exemplo, configure as permissões para o modelo de arquivo de controle como 666.
- Certifique-se de um comando externo passa o arquivo de controle no parâmetro previsto (a opção -o para incluir propriedades de trabalho adicionais, por exemplo).
- Em um sistema Linux ou AIX, crie um link simbólico para o aplicativo no computador
primário:
- Faça login no sistema no qual o produto base RICOH ProcessDirector é executado como o usuário do sistema RICOH ProcessDirector.
- Utilize o comando
stopaiwpara parar o servidor principal. - Utilize este comando para criar o link simbólico:
ln -s application_file /aiw/aiw1/bin/link_fileSubstitua application_file pelo caminho completo até o arquivo executável do aplicativo e substitua link_file pelo nome do arquivo de link simbólico que você deseja criar. O arquivo executável deve estar dentro do sistema de arquivos/aiw. - Utilize o comando
starpaiwpara iniciar o servidor principal.
- Se você planejar utilizar RunHotFolderApplication:
- Efetue logon no computador principal como o usuário do sistema RICOH ProcessDirector.
- Copie ou transfira um arquivo de impressão de amostra na pasta de entrada do aplicativo.
- Verifique se o outro aplicativo é iniciado para processar o arquivo.
- Monitore a pasta de saída quanto ao arquivo resultante. Quando ele chegar, copie-o ou transfira-o para outro diretório e, em seguida, verifique se está correto.
- Navegue para o diretório que contém os arquivos de log do outro aplicativo e verifique se você pode abrir e visualizar os arquivos de log.