Manual Instalação Web Services Client Web.NewHotel

Transcrição

1 Web.NewHotel Versão: Rev Versão de WSServer: Versão de WSClient: Versão de NewHotel: Av. Almirante Gago Coutinho, Lisboa PORTUGAL Tel marketing@newhotel.com helpdesk@newhotel.com Copyright NewHotel Software. Todos os direitos reservados

2 Histórico da Revisão Data Versão Descrição Autor 10/07/ Elaboração e Desenvolvimento João Infante 16/07/ Alteração da versão de Newhotel suportada e no conteúdo do web.config João Infante 17/07/ Informação sobre ODP.Net João Infante 22/07/ Configuração IIS João Infante 18/09/ /09/ /09/ /11/ Mais detalhe sobre o ODP.Net e sobre Web Services Extensions no IIS Informação sobre o ODP.Net em Windows 2000 Inclusão de capítulo sobre Actualização de Versões Informação sobre permissões para o Framework 2.0 João Infante João Infante João Infante João Infante 04/12/ Informação sobre Oracle Client João Infante Copyright NewHotel Software. Todos os direitos reservados

3 Índice Pré-Requisitos... 4 Versão do NewHotel... 4 Características do Servidor... 4 Instalação do Oracle ODP.Net... 5 Requisitos do IIS... 6 Instalação... 9 Teste...15 Actualização de versões...17 Copyright NewHotel Software. Todos os direitos reservados Página No. 3/17

4 Pré-Requisitos Considerações prévias que devem ser confirmadas antes da instalação do Web.Newhotel Client. Versão do NewHotel A primeira questão a considerar é que a versão do NewHotel deve no mínimo ser a que está indicada na capa deste Manual. Características do Servidor O Web Service Client vai comunicar com o Web Service Server, instalado no servidor do Web.Newhotel através da VPN existente com o hotel. O servidor onde se vai fazer a instalação deve ser aqueler onde está a base de dados do Newhotel (que deve estar acessível através da VPN), ou então numa máquina que esteja na rede local (para evitar comunicações com a base de dados através de redes remotas). Os requisitos necessários no servidor é que tenha o IIS instalado, com a framework.net 2.0 e o Oracle Data Provider para.net (ODP.Net). O endereço IP do servidor tem que estar de acordo com o endereçamento de rede definido pela VPN, ou então a rede interna, normalmente através do router, tem que conseguir enviar esse endereço para a VPN. É obrigatório que na VPN consiga passar o tráfego http, pois o acesso a partir do Web Service Server é feito por chamadas http ao Web Services Client. Se este tráfego não estiver aberto na VPN o Web.NewHotel não vai funcionar. No caso de utilizar um servidor que não seja aquele onde está instalada a base de dados do NewHotel, deve-se ter em atenção que é obrigatório instalar o Oracle Client. Sem o Oracle Client não se vai poder comunicar com a base de dados do NewHotel. Copyright NewHotel Software. Todos os direitos reservados Página No. 4/17

5 Instalação do Oracle ODP.Net O ODP.Net vem de base com o Oracle 10g, para as versões Oracle 9i existe um pacote da Oracle que pode ser instalado (este pacote está disponível na Área Técnica Comum do Site na pasta Tools). Para todas as instalações deve-se ir buscar o dll necessário para o Oracle funcionar. Este ficheiro - Oracle.DataAccess.dll está disponível no directório oracle\product\10.2.0\db_1\odp.net\bin\1.x ou oracle\product\10.2.0\db_1\bin do Oracle e deve-se copiá-lo para o directório bin da Web Service Client. Para se confirmar que o ODP.Net foi correctamente instalado deve-se aceder ao directório Windows ou Winnt, dependendo da versão do sistema operativo, que se está a utilizar e verificar se o directório assembly contém os ficheiros: Oracle.DataAccess Policy.10.2.Oracle.DataAccess Policy.9.2.Oracle.DataAccess Numa instalação com Oracle 9i o ficheiro Policy.10.2.Oracle.DataAccess, não deve existir. Em servidores com Windows 2000, verificou-se que apesar do Oracle ter instalado o ODP.Net, que neste directório não existiam os ficheiros mencionados. Nesta circunstância deve-se re-instalar o ODP.Net, através do instalador da Oracle, o que vai actualizar o directório assembly com os ficheiros indicados. Copyright NewHotel Software. Todos os direitos reservados Página No. 5/17

6 Se neste directório não existirem os ficheiros mencionados o Web.Newhotel Client não vai funcionar. Requisitos do IIS / Framework.Net O IIS deve ser instalado antes da Framework, para se garantir que existem as permissões necessárias. Caso contrário será necessário utilizar a ferramenta aspnet_regiis.exe, do Framework em questão com a opção i. Deve-se verificar se o IIS está a permitir executar ASP.NET v2.0, em Web Service Extensions. Se não estiver deve-se dar essas permissões. Pode acontecer que, se a instalação da framework 2.0 for posterior à instalação do IIS que não exista a extensão. Nesse caso deve-se criar a extensão que deve apontar para o ficheiro: C:\WINDOWS\Microsoft.NET\Framework\v \aspnet_isapi.dll Copyright NewHotel Software. Todos os direitos reservados Página No. 6/17

7 Na eventualidade do servidor do Newhotel não suportar o IIS com estas características, pode-se instalar numa outra máquina, da rede local do hotel, que suporte IIS. Em servidores com Windows 2000 não é necessário criar estas extensões. Outro eventual problema que pode acontecer está relacionado com a falta de permissões do utilizador NETWORK SERVICE, que pode não possuir permissão de leitura e escrita na pasta de temporários do Framework.NET, que se encontra em C:\WINDOWS\Microsoft.NET\Framework\v \Temporary ASP.NET Files. Copyright NewHotel Software. Todos os direitos reservados Página No. 7/17

8 Neste caso deve ser dada as permissões para que o utilizador NETWORK SERVICE fique com permissões de Full Control sobre a referida pasta: Copyright NewHotel Software. Todos os direitos reservados Página No. 8/17

9 Instalação O WSNewHotelClient está disponível na área de downloads do na pasta WebServices Newhotel/WSNewHotelClient. Deve-se sempre instalar a última versão que esteja disponível. Essa versão não possui o ficheiro web.config nem o ficheiro Oracle.DataAccess.dll, pois estes ficheiros são diferentes de instalação para instalação. O ficheiro web.config pode-se ir buscar ao directório WebServices Newhotel/Installer/InstallationWSNewHotelClient, ao ficheiro Web.rar, e alterá-lo como indicado mais abaixo. A instalação deve seguir os seguintes procedimentos: No servidor onde se vai instalar o WSNewHotelClient deve-se criar o directório C:\Inetpub\wwwroot\WSNewHotelClient e copiar para lá o conteúdo do ficheiro WSNewHotelClient.rar. Não esquecer de copiar o ficheiro Oracle.DataAccess.dll para o directório bin existente em WSNewHotelClient (como referenciado no ponto Instalação do Oracle ODP.Net do capítulo anterior). Copyright NewHotel Software. Todos os direitos reservados Página No. 9/17

10 No IIS Manager deve-se navegar até ao Defaul Web Site e com o botão direito do rato escolher a opção de New / Virtual Directory: Copyright NewHotel Software. Todos os direitos reservados Página No. 10/17

11 De seguida deve-se executar o wizard de acordo com as seguintes indicações: Deve-se respeitar este nome, pois o acesso ao Web.Newhotel Client faz-se através de um endereço http, e se não se respeitar o nome aqui indicado vai-se ter complicações no acesso ao Client. Copyright NewHotel Software. Todos os direitos reservados Página No. 11/17

14 Depois de terminada a instalação do Directório Virtual, com o botão direito do rato deve-se escolher Propriedades e verificar, no separador ASP.NET, se a versão do ASP.NET é a 2.0. Se não for deve-se seleccionar esta versão e fazer OK. Para concluir a instalação tem que se editar o ficheiro web.config (no directório anteriormente criado) e alterar a linha session-factory para os detalhes da instalação Oracle do hotel: <nhibernatesettings> <session-factories> <clear-factories /> <session-factory name="código_hotel_web.newhotel" provider="oracle" datasource="orcl" user="rmc" password="rmc" /> </session-factories> </nhibernatesettings> O campo name deve indicar o código do hotel que foi criado no Web.Newhotel, o que deve ser confirmado com o administrador do Web.Newhotel. Copyright NewHotel Software. Todos os direitos reservados Página No. 14/17

15 Teste Para confirmar que o cliente ficou bem instalado deve-se seguir os seguintes procedimentos: No IIS Manager seleccionar o directório virtual (criado anteriormente) WSNewHotelClient; Depois deve-se escolher o WSNewHotelClient.asmx e com o botão direito do rato escolher Propriedades e depois Browse; Copyright NewHotel Software. Todos os direitos reservados Página No. 15/17

16 De seguida abre-se o Internet Explorer (ou o browser existente) e o que deve aparecer é o seguinte ecrã: Para concluir o processo de teste deve-se ir para o último método listado, TesteConnection, e executá-lo: Copyright NewHotel Software. Todos os direitos reservados Página No. 16/17

17 O valor a indicar no campo hotelcode é o código do hotel inserido no ficheiro web.config. Depois de se seleccionar o botão Invoke, o resultado final terá que ser Successfully, numa janela idêntica à que se mostra de seguida: Esta resposta significa que o Web.Newhotel Client foi instalado correctamente, caso contrário será necessário rever a instalação feita. Actualização de versões Sempre que existir uma actualização de versão será enviado uma comunicação para todos os clientes, bem como para todas as áreas técnicas da Software NewHotel, informando dessa actualização e avisando da eventual necessidade de se proceder, previamente, à actualização do NewHotel Front-Office. No entanto essas novas versões vão prever que o WSNewHotelServer que actualize o WSNewHotelClient. Esse processo de actualização será despoletado de uma forma automática pelo WSNewHotelServer, não sendo necessário nenhuma intervenção manual da área técnica para se fazer a actualização do WSNewHotelClient. Copyright NewHotel Software. Todos os direitos reservados Página No. 17/17