Instalando o MultiCamadas na plataforma Win2008 Server x64 com FireBird 2.x (32 e 64 Bits)

O foco principal deste documento é orientar sobre alguns pontos observados durante testes de instalação do sistema MultiCamadas em servidores rodando Windows 2008 Server 64 bits, contudo a maioria dos pontos abordados aqui também são válidos para a versão 32 bits deste sistema operacional e algumas também são válidas para instalações MultiCamadas em geral.

Deste ponto em diante toda a referência a "FireBird 2.x" deve ser entendida como uma versão final do FireBird 2.1 ou superior.

Instalação e configuração do FireBird 2.x - 32 bits

Sistemas 64 bits possuem duas pastas padrão para instalação de softwares: A tradicional "Arquivos de Programas" e a "Arquivos de Programas (x86)". A primeira é a default para instalação de softwares 64 bits e a segunda é a padrão para Instalações 32 bits. Sendo assim, com o FireBird 2.x 32 Bits a pasta padrão de Instalação será "Arquivos de Programas (x86)".

Instalação do IBExpert e teste de conexão ao FireBird

Lembrar que o IBExpert usado atualmente na Tek-System é 32 bits, portanto sua instalação padrão também será feita em "Arquivos de Programas (x86)".

Conversão da base de dados MultiCamadas do FireBird 2.0 para FireBird 2.x Método padrão. Basta seguir a rotina normal já documentada sobre este procedimento.

Instalação do BSS

O BSS 10.0.2151.25345, Delphi 2007, instala como serviço normalmente, starta normalmente após reiniciar o OS e também fica disponível no snap-in de serviços do Windows onde pode ser parado e reiniciado sem qualquer problema. O único ponto a ser observado é o fato de que, quando startado como serviço, mesmo estando em execução o ícone do BSS não aparece no systray do Windows. Isso obriga o usuário a parar o serviço via snap-in e executar o BSS manualmente, caso necessite alterar as configurações do BSS (porta, interceptador, etc.).

Versões mais recentes do BSS que já estão disponíveis para atualização também têm comportamento similar quanto à instalação, no entanto apresentam graves problemas de lentidão durante o acesso. Por este motivo, versões do BSS superiores a 10.0.2151.25345 não devem ser instaladas como serviço no Win2008. Neste caso o BSS deve ser usado apenas como aplicação e a recomendação é de que se utilize o inicializar ou o agendador de tarefas do Windows para iniciar automaticamente o BSS, simulando assim o comportamento de um serviço. Ao instalar servidores Win2008 ou Win7, 32 ou 64 bits, recomendamos colocar os executáveis servidores de aplicação em modo de compatibilidade com 'Windows XP Service Pack III' antes de efetuar seu registro via linha de comando. Esta medida simples previne mensagens de erro estranhas e pouco intuitivas que costumam acontecer durante o processo de registro.

Instalação do TekProtVMC

Já faz algum tempo, os campos necessários ao funcionamento TekProt foram incorporados à base de dados do próprio sistema MultiCamadas visando elevar a confiabilidade e o nível de segurança na validação das licenças. A orientação do desenvolvimento é de que os consultores não mais façam uso do antigo arquivo “autorization.tkp”, por este motivo não será, em primeira instância, disponibilizado um arquivo de proteção compatível com o FireBird 2.x. Sendo assim, o programa TekProt Config, em suas configurações de "Servidor de Dados", deverá apontar para a base de dados do sistema (DadosMC.fdb) e não mais para o arquivo de licenças(autorization.tkp). Os demais procedimentos de conexão com o BSS, identificação de hardware, reset e validação da licença funcionam normalmente.

Instalação do sistema MultiCamadas

Instalação padrão, nada a ser observado.

Execução do MultiCamadas e TekProtVMC usando DLL de interceptação

É necessário atualizar o executável do TekProt Config para a versão 10.06.22.15.41ou superior. Foi encontrado um problema relacionado à interceptação neste programa que já foi resolvido.

Instalação e configuração do FireBird 2.x 64 bits

Nada a ser observado quanto à instalação e configuração do FireBird em si. O sistema funciona perfeitamente com o FireBird 2.x 64 bits, no entanto há uma ressalva: todos os sistemas da Tek-System são 32 bits. Por este motivo deve-se tomar muito cuidado para que não se tenha a DLL FBClient 64 bits na pasta dos executáveis da Tek-System ou nas pastas de sistema. Executáveis 32 bits não funcionam com bibliotecas e outros recursos compilados para 64 bits e vice versa.

Instalação do IIS

O IIS disponível no Win2008 Server é a versão 7.0. O snap-in para instalação de recursos no Win2008 Server é um pouco diferente por isto o processo será descrito aqui em detalhes:

1. Ir até o "Painel de Controle" e acessar a opção "Programas e Recursos".
2. No painel vertical à esquerda selecionar a opção "Ativar ou Desativar Recursos do Windows".
3. No snap-in que se abre selecionar a opção "Funções" (Roles), no treeview à esquerda.
4. Do lado direito do painel de funções que irá se abrir selecionar a opção "Adicionar Funções".
5. A primeira tela exibida no wizard que se abrirá é meramente informativa, basta clicar em avançar.
6. Na segunda tela selecionar a opção "Servidor Web (IIS)". Uma caixa de diálogo se abrirá: selecionar a opção "Adicionar Recursos Necessários" e depois avançar para a próxima tela.
7. Mais uma tela informativa é apresentada. Apenas avançar o wizard.
8. Na tela seguinte é exibida uma treeview com os serviços de função a serem instalados. Manter todas as marcações default e também marcar as opções: Extensões ISAPI e Filtros ISAPI. Depois avançar.
9. A última tela também é meramente informativa, clique em Instalar e depois em Fechar.
10. Após concluir o wizard de instalação a nova função (Servidor Web IIS) passará a ser listada na página de funções e um novo nó irá aparecer no painel vertical à esquerda abaixo da opção "Funções". A partir deste novo nó é possível parar e/ou reiniciar o IIS. Também é a partir dali que se pode, de uma maneira mais fácil, adicionar ou remover recursos do IIS.
11. Para testar o funcionamento do IIS pode-se abrir o navegador web e digitar //localhost, se tudo ocorreu normalmente uma tela default com a logo do IIS será mostrada.

Instalação do Site MultiCamadas

As telas de configuração do IIS 7 são bastante diferentes se comparadas às versões anteriores. No entanto as tarefas a serem realizadas são praticamente as mesmas com a adição de mais algumas configurações. Por isso serão descritas em detalhes a criação dos diretórios virtuais necessários e a configuração do WebService.

1. Descompactar os arquivos do site na pasta apropriada.
2. Ir até o "Painel de Controle", acessar a opção "Ferramentas Administrativas" e depois executar a opção "Gerenciador de Serviços de Informações da Internet (IIS)".
3. No snap-in que se abre, no painel vertical à esquerda expandir os nós da treeview e procurar uma pasta chamada "Default Web Site". Os nomes dos nós desta treeview irão variar de acordo com o nome do servidor na rede e os recursos instalados.
4. Clicar com o botão direito do mouse em "Default Web Site" e criar os diretórios virtuais "teksystemweb" e "tekwebservice" apontando respectivamente para as pastas "aplicação" e "webservice" do path onde os arquivos do site foram descompactados. Apenas informar alias (teksystemweb ou tekwebservice) e o caminho físico (“PASTA DO SITE\aplicacao” ou “PASTA DO SITE\webservice”) na criação dos diretórios virtuais. Não mexer nas outras opções.
5. Para testar as configurações dos diretórios virtuais, abrir o navegador web e digitar: http://localhost/teksystemweb/ ou http://localhost/tekwebservice/. Se tudo foi feito corretamente será mostrada a tela de login ao se acessar teksystemweb, no entanto telas de erro irão aparecer, pois o site ainda não foi devidamente configurado. Ao tentar acessar tekwebservice será exibida uma tela informativa do IIS avisando que não foi configurado um documento padrão para a pasta. Estes erros são normais em instalações feitas do zero, mas já indicam que os diretórios criados estão funcionando.
6. Para finalizar a instalação do SiteMC é preciso instalar a biblioteca do WebService no IIS como um filtro ISAPI. Para isso, seguir os passos:
   1. No painel vertical esquerdo do snap-in de administração do IIS, selecione o nó que tem o nome do servidor, geralmente o segundo da treeview.
   2. No painel central que será exibido dar um duplo clique na opção "Restrições ISAPI e CGI".
   3. O painel central irá mudar para o modo de listagem dos filtros instalados, onde provavelmente não haverá nenhum filtro a ser listado.
   4. No painel vertical à direita selecionar a opção "Adicionar".
   5. Na caixa que se abre, em "Caminho ISAPI ou CGI" selecionar o path completo para o arquivo "TekWebService.dll" da pasta WebService do diretório onde os arquivos do site foram descompactados.
   6. Em "Descrição" informar "TekWebService" e marcar a opção "Permitir que o caminho da extensão seja executado".
7. Para finalizar a instalação do ISAPI:
   1. Voltar às opções de configuração do servidor selecionando novamente o nó que tem o nome do servidor no painel vertical esquerdo do snap-in e a seguir dar e dar um duplo clique na opção "Mapeamentos de Manipulador" no painel central.
   2. O painel central irá mudar para o modo de listagem dos "Mapeamentos de Manipulador" e no painel vertical direito irão aparecer novas opções.
   3. Selecionar a opção “Editar permissões de recurso" no painel vertical direito.
   4. Na caixa que se abre deixar marcadas todas as opções, inclusive "Executar".
8. Para que o WebService funcione e preciso mudar o modo de pipeline gerenciado do IIS 7. Para isto, seguir os passos:
   1. No snap-in de administração do IIS, encontre no painel vertical à esquerda a opção "Pools de Aplicativos", novamente na treeview.
   2. No painel central onde são listados os serviços.
   3. Dar um duplo clique no serviço "DefaultAppPool". Na caixa que irá se abrir alterar apenas a opção "Modo de pipeline gerenciado" para "Clássico" e clicar em Ok.
9. O WebService é um serviço 32 bits, para que rode em servidores 64 bits é necessário configurar o IIS para rodar em modo 32 bits. Para isto, seguir os passos:
   1. Ainda com o serviço "DefaultAppPool" selecionado, observar um painel vertical à direita para configuração.
   2. Nele escolher a opção "Configurações Avançadas".
   3. Será mostrada uma caixa que permite alterar as configurações do serviço.
   4. Encontrar a opção "Habilitar Aplicativos de 32 bits" e mudá-la para True, depois clicar em Ok para confirmar e fechar as configurações.
10. Para testar se o WebService está corretamente instalado abrir o navegador web e digitar: http://localhost/tekwebservice/TekWebService.dll. Se tudo estiver correto, deverá ser exibida a tela com a lista de módulos WSDL disponíveis. Após configurar os diretórios virtuais, instalar o filtro ISAPI e efetuar as configurações no IIS 7, restam ainda as configurações do site e do WebService. Feitas respectivamente através dos arquivos "PASTA DO SITE\aplicacao\xmls\XMLConsts.xml" e "PASTA DO SITE\webservice\TWSConfig.ini". O padrão para o arquivo XMLConsts.xml é deixar todas as tags em branco. Já no arquivo TWSConfig.ini devem ser informados os dados para conexão com a base de dados do sistema MultiCamadas e conexão com o servidor de aplicação TekServer.

Para testar se tudo foi configurado corretamente, abrir o navegador web e digitar: http://localhost/teksystemweb/. Desta vez deverá ser apresentada a tela de login sem qualquer mensagem ou aviso de erro. Digitar um login e senha válidos para entrada no sistema e testar as funcionalidades.

Pode ser necessário copiar algumas DLLs para as pastas de sistema para que o WebService funcione corretamente. Se isto ocorrer durante o login ou abertura do site elas serão solicitadas. Todas as DLLs necessárias estão disponíveis na pasta "PASTA DO SITE\webservice\".

Ainda em relação a DLLs e recursos, há um detalhe importante: a exemplo do que ocorre com a pasta padrão de instalação, sistemas 64 bits também possuem duas pastas de sistema: a "System32" e a "SysWOW64". Lembrando que o Windows permite a execução de programas em modo de compatibilidade, dependendo do tipo de aplicativo (32 ou 64 bits) e das configurações dos arquivos o OS irá procurar as DLLs e demais recursos necessários em uma ou outra pasta. Sendo assim, no caso do WebService a dica é tentar copiar o recurso necessário para "System32", se mesmo assim não for encontrado, movê-lo para "SysWOW64".

Por Anderson Silveira

Revisado em 21/07/2011