✎ Instalação e Configuração - RH3 API [RH3 Wiki

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
{{:bk_cab_rh3software.png?200|}}

\\
\\

======RH3 API======
----

=====Informações iniciais=====
----

###
Este manual foi desenvolvido com base na versão 7.5 do IIS e sistema operacional windows 7, apenas para fins explicativos.
###

###
Para efetuar a correta configuração do IIS e ISAPI dll, o usuário deverá efetuar os seguintes passos (caso se faça necessário, clique nas imagens para aumenta-las).
###

###
**Nota:** Este guia foi elaborado para ser usado como base tanto nas instalações em servidores locais como no RH3Cloud. 
###

=====Pré-requisitos=====
----

  - A instalação do IIS deve ter sido efetuada. Seguem abaixo alguns links úteis:\\ \\ 
    * Instalando o IIS 7 no Windows Server 2008 (http://social.technet.microsoft.com/wiki/contents/articles/2417.aspx); \\ \\
    * Instalando o IIS 7.5 no Windows 7 Home Premium, Home Basic ou Home Starter (http://technet.microsoft.com/pt-br/library/cc731911.aspx); \\ \\
    * Instalando o IIS 7.5 no Windows Server 2008 R2 (http://technet.microsoft.com/pt-br/library/cc771209.aspx). \\ \\
  - A porta TCP selecionada (padrão 80) deve estar acessível para a rede onde o RH3 API irá operar e receber conexões.

=====Configurações do IIS=====
----

  - Certifique-se que as opções de "Serviços de Informações da Internet" abaixo, estão selecionadas:  \\ \\ {{ :instalacao_configuracao:portal:config_iis_ativa_desativa_recurso_selecao.png?350 |}}  \\ \\
    * Painel de controle; \\ \\
    * Programas e Recursos; \\ \\
    * Ativar ou desativar recursos do Windows. \\ \\ 
      * Ferramentas de Gerenciamento da Web; \\ \\
      * Serviços da Word Wide Web. \\ \\
  - Na opção de "Ferramenta de Gerenciamento da WEB", certifique-se que apenas as seguintes opções estão selecionadas: \\ \\
    * Console de Gerenciamento do IIS; \\ \\
    * Script e Ferramentas de Gerenciamento do IIS; \\ \\
    * Serviço de gerenciamento do IIS. \\ \\
  - Na opção de "Serviços da Word Wide Web", certifique-se que apenas as seguintes opções estão selecionadas: \\ \\
    * Recursos de Desenvolvimento de Aplicativos; \\ \\
    * Recursos HTTP Comuns. \\ \\
  - Na opção "Recursos de Desenvolvimento de Aplicativos", certifique-se que a opção Extensões ISAPI está selecionada; \\ \\
  - Na opção "Recursos HTTP Comuns", certifique-se que as seguintes opções estão selecionadas: \\ \\
    * Conteúdo Estático; \\ \\
    * Documento Padrão; \\ \\
    * Publicação WebDAV; \\ \\
    * Redirecionamento de HTTP. \\ \\
  - Clicar em "OK" para instalar as opções selecionadas (caso tenha sido necessário alterar alguma configuração); \\ \\

=====Cópia dos arquivos do RH3 API=====
----

  - Abrir a pasta compartilhada do IIS para colocar os arquivos do RH3 API no diretório: "c:\inetpub\wwwroot"; \\ \\ {{ :instalacao_configuracao:rh3api:config_rh3api_abertura_pasta_compartilhada.png?700 |}} \\ \\
  - Ainda dentro de "c:\inetpub\wwwroot", criar uma nova pasta para colocar os arquivos do RH3 API. Chamar a  pasta de rh3api. O nome desta pasta será o nome utilizado na URL. Exemplo: http://localhost/rh3api/;  \\ \\
  - O usuário deverá entrar em contato com a RH3 Software, para ter acesso aos arquivos de configuração a serem colocados neste diretório criado; \\ \\ 
  - O diretório deverá conter agora os seguintes arquivos e pastas: \\ \\ 
    * css (pasta); \\ \\
    * images (pasta); \\ \\
    * js (pasta); \\ \\
    * templates (pasta); \\ \\
    * RH3APIV2.dll. \\ \\ 


=====Configuração das permissões de acesso=====
----

###
Para que a RH3 API funcione corretamente, é necessário dar permissão de acesso ao diretório **"C:\inetpub\wwwroot\rh3api"**. Abaixo segue o passo a passo de como dar acesso a um diretório:
###

  - Através do Windows Explorer, selecionar a localização do diretório a ser dada a permissão (ex: C:\inetpub\wwwroot); \\ \\
  - Com o botão direito do mouse, clique no diretório que deseja dar as permissões (ex: rh3api) e escolha a opção "Propriedades"; \\ \\ 
  - Selecionando o usuário IIS_IUSRS, clique no botão "Avançadas"; \\ \\ {{ :instalacao_configuracao:portal:config_iis_permissoes_portal_1.png?350 |}} \\ \\
  - Clique no botão "Alterar permissões"; \\ \\ {{ :instalacao_configuracao:portal:config_iis_permissoes_portal_2.png?350 |}} \\ \\
  - Clique no botão "editar", selecione "Controle total" e clique em "OK"; \\ \\ {{ :instalacao_configuracao:portal:config_iis_permissoes_portal_3.png?350 |}} \\ \\
  - Para as próximas telas, clique em "Aplicar", "OK" e "OK"; \\ \\ {{ :instalacao_configuracao:portal:config_iis_permissoes_portal_4.png?350 |}} \\ \\
  - Volte ao Windows Explorer, selecione novamente o diretório "rh3api", clique com o botão direito em propriedades e certifique-se que o mesmo está com a seguinte configuração; \\ \\ {{ :instalacao_configuracao:portal:config_iis_permissoes_portal_5.png?350 |}} \\ \\

=====Configuração da DLL ISAPI=====
----

  - Abrir o gerenciador do IIS para configurar; \\ \\ {{ :instalacao_configuracao:portal:config_iis_gerenciador_iis.png?700 |}} \\ \\
    * Painel de Controle; \\ \\
    * Ferramentas Administrativas; \\ \\
    * Gerenciador do Serviços de Informações da Internet (IIS); \\ \\
    * Seleciona: Máquina (localizado no item conexões) \ Sites \ Default Web Site \ rh3api. \\ \\
  - Para converter a pasta onde estão os arquivos do rh3api para aplicativo; \\ \\ {{ :instalacao_configuracao:rh3api:config_iis_gerenciador_iis_selecao_maquina.png?700 |}} \\ \\ 
    * Clicar com o botão direito do mouse em "rh3api"; \\ \\
    * Converter para Aplicativo; \\ \\
    * O alias deverá estar "rh3api"; \\ \\
    * Clicar em "OK". \\ \\
  - Defina a dll como documento padrão, ou seja, ao acessar a URL (http://localhost/rh3api/), ele vai buscar a dll; \\ \\ {{ :instalacao_configuracao:rh3api:config_iis_gerenciador_iis_documento_padrao.png?700 |}} \\ \\
    * Duplo clique em "Documento Padrão"; \\ \\
    * Clique com o botão direito do mouse para adicionar o documento padrão; \\ \\
    * Clique em "Adicionar"; \\ \\
    * No campo "nome" informe "RH3APIV2.dll"; \\ \\
    * Clique em "OK". \\ \\
  - Ative o mapeamento para utilizar arquivos dll para execução; \\ \\ {{ :instalacao_configuracao:rh3api:config_iis_gerenciador_iis_mapeamento_manipulador.png?700 |}} \\ \\
    * Clique no nome da máquina para voltar a tela inicial de configuração; \\ \\
    * Duplo clique em "Mapeamentos de Manipulador";  \\ \\
    * Clique com o botão direito do mouse em ISAPI-dll; \\ \\
    * Escolha a opção "Editar permissões de Recursos"; \\ \\
    * Marque as opções: Leitura, Script e Executar; \\ \\
    * Clique em "OK". \\ \\
  - Você deve dar permissão para que a dll do rh3api possa ser executada; \\ \\ {{ :instalacao_configuracao:rh3api:config_iis_gerenciador_iis_restricao_isapi.png?700 |}} \\ \\
    * Clique no nome da máquina para voltar a tela inicial de configuração; \\ \\
    * Duplo clique em "Restrições ISAPI e CGI"; \\ \\
    * Clique com o botão direito do mouse em "WebDAV"; \\ \\
    * Selecione a opção "Adicionar"; \\ \\
    * Em "Caminho ISAPI ou CGI" preencha com: "c:\inetpub\wwwroot\rh3api\RH3APIV2.dll"; \\ \\
    * Em "Descrição" preencha com: "rh3api"; \\ \\
    * Marque a opção "Permitir que o caminho da extensão seja executado"; \\ \\
    * Clique em "OK". \\ \\
  - **ATENÇÃO:** Quando a máquina for 64 bits, o usuário deverá executar o seguinte: \\ \\
    * Para verificar se a máquina é 64 bits: \\ \\
      * Clicar no botão iniciar; \\ \\
      * Botão direito em "Computador"; \\ \\
      * Clicar em "Propriedades"; \\ \\
      * Neste ponto, estará exibindo se o sistema operacional é 32 ou 64 bits. \\ \\ 
    * Clique no nome da máquina para voltar a tela inicial de configuração; \\ \\
    * Selecionar a opção "Pool de aplicativos". \\ \\ 
    * Clicar com o botão direito do mouse para criar um novo pool de aplicativos para que não fiquem várias aplicações utilizando o mesmo pool (ex: rh3api, portal web,...). \\ \\ {{ :instalacao_configuracao:rh3api:config_iis_gerenciador_iis_novo_pool_aplicativos.png?700 |}} \\ \\
    * Criar com o nome rh3api. \\ \\ {{ :instalacao_configuracao:rh3api:config_iis_gerenciador_iis_novo_pool_aplicativos_2.png?500 |}} \\ \\  {{ :instalacao_configuracao:rh3api:config_iis_gerenciador_iis_novo_pool_aplicativos_3.png?700 |}} \\ \\
    * Clicar em "rh3api"; \\ \\
    * Clicar em "Configurações Avançadas"; \\ \\
    * Na aba "Geral", colocar "True" na opção "Habilitar aplicativos de 32 bits". esta opção só aparecerá se seu sistema operacional for realmente de 64 bits. \\ \\  {{ :instalacao_configuracao:rh3api:config_iis_gerenciador_iis_novo_pool_aplicativos_4.png?500 |}} \\ \\
  - Alterando as credenciais de autenticação do rh3api; \\ \\
    * Selecione o rh3api e dê um duplo clique em autenticação; \\ \\ {{ :instalacao_configuracao:rh3api:config_iis_alterando_credencial_1.png?700 |}} \\ \\ 
    * Clique com o botão direito do mouse no item "Autenticação anônima" e clique em "Editar" \\ \\ {{ :instalacao_configuracao:rh3api:config_iis_alterando_credencial_2.png?700 |}} \\ \\ 
    * Selecione a opção "Identidade do pool de aplicativos" e clique em "OK". \\ \\ {{ :instalacao_configuracao:rh3api:config_iis_alterando_credencial_3.png?350 |}} \\ \\ 
 


=====Configurando a Filtragem de solicitações=====
----

  - Seleciona rh3api e dá um duplo clique em "Filtragem de solicitações". \\ \\ {{ :instalacao_configuracao:rh3api:conf_filtragem_solicitacoes.png?700 |}} \\ \\ 
  - Clique com o botão direito no arquivo e clique em "Editar configurações e recursos" \\ \\ {{ :instalacao_configuracao:rh3api:conf_filtragem_solicitacoes_1.png?700 |}} \\ \\ 
  - Configure a tela conforme imagem abaixo. \\ \\ {{ :instalacao_configuracao:rh3api:conf_filtragem_solicitacoes_2.png?300 |}} \\ \\ 
  - Copiar o arquivo "Config.ini" da pasta "C:\RH3" para "C:\inetpub\wwwroot\rh3api". \\ \\ 
  - O arquivo "config.ini" deverá ter o conteúdo conforme exemplo abaixo. 

  [NOMECLIENTE]
  schema=
  usuario=nomecliente
  senha=jRvPjGrNKugQRNC
  maxConexoesDB = 5
  maxConexoesTrans = 2
  maxObjWorkflow = 100
  timeoutConexaoDB = 5
  timeoutObjWorkflow = 120
  tempoEsperaConexaoDB = 5
  ;debug = W, C 
  

  - Execute a opção "Reiniciar Servidor"; \\ \\
  - Acesse a URL (http://localhost/rh3api/) no browser; \\ \\
  - O sistema deverá funcionar a partir deste momento. \\ \\