Contedo

1 Guia de instalao 1.1 Verso 1.2 Informaes de contato 1.2.1 Suporte Tcnico Crivo 1.3 Requisitos para instalao do Crivo 1.3.1 Resumo dos requisitos 1.3.2 Diferentes possibilidades de instalao 1.3.3 Requisitos mnimos de hardware 1.3.3.1 Crivo e base de dados em servidores diferentes - Servidor Crivo 1.3.3.2 Crivo e base de dados em servidores diferentes - Servidor de base de dados 1.3.3.3 Crivo e base de dados no mesmo servidor 1.3.3.4 Servidor de licenas 1.3.4 Requisitos mnimos de software 1.3.4.1 Servidor de base de dados 1.3.4.2 Servidor Crivo 1.3.4.3 Servidor de licenas 1.3.4.4 Mquinas client para uso do Crivo por browser 1.3.4.5 Mquinas client para uso do Crivo por Administrador do Crivo 1.3.5 Requisitos recomendados de hardware 1.3.5.1 Crivo e base de dados em servidores diferentes 1.3.5.2 Crivo e base de dados no mesmo servidor 1.3.6 Requisitos recomendados de software 1.3.6.1 Servidor de base de dados 1.3.6.2 Servidor Crivo 1.4 Configurao dos pr-requisitos 1.4.1 Sistemas operacionais 1.4.2 Acesso remoto ao servidor durante a instalao 1.4.3 Principais programas necessrios a instalao do Crivo 1.4.3.1 Instalando o IIS 1.4.3.2 Instalando o ASP.NET 1.4.3.3 Habilitando o web service extension do ASP.NET 1.4.4 Configuraes de acesso a Internet 1.4.5 Permisses e direitos 1.4.6 Configurao do acesso s bases de dados 1.4.6.1 Configurao do acesso s bases de dados no Microsoft SQL Server 1.4.6.2 Configurao do acesso s bases de dados no Oracle 1.4.7 Criao das bases de dados 1.4.7.1 Criao das bases de dados no Microsoft SQL server 1.4.7.2 Criao das bases de dados no Oracle

1/107

 1.4.8 Chave HASP HL 1.4.8.1 Virtualizao e portas USB 1.4.8.2 Alternativas portas USB fsicas ou virtualizadas 1.4.8.3 Instalando um servidor de licenas 1.4.8.4 Programas necessrios ao uso da chave HASP HL 1.4.8.5 Instalando o HASP Run-time 1.4.8.6 Instalando o driver da chave HASP 1.5 2. Instalao do Crivo 1.5.1 Resumo 1.5.2 Passos da instalao 1.5.2.1 Passo 1 1.5.2.2 Passo 2: Crivo detectado 1.5.2.3 Passo 3: Diretrio de Instalao 1.5.2.4 Passo 4: Gerenciador de Banco de Dados 1.5.2.5 Passo 5: Forma de conexo ao SQL Server 1.5.2.6 Passo 6: Usurio e senha do Oracle 1.5.2.7 Passo 7: Usurio e senha do Oracle para a base CrivoOpt 1.5.2.8 Passo 8: Usurio e senha do Crivo 1.5.2.9 Passo 9: Usurio e senha do 'application pool' do Crivo 1.5.2.10 Passo 10: Seleo da configurao do servidor LDAP 1.5.2.11 Passo 11: Configurao do servidor LDAP 1.5.2.12 Passo 12: Arquivos de instalao adicionais 1.5.2.13 Passo 13: Pr-requisitos para a instalao do Crivo 1.5.2.14 Passo 14: Teste de conexo Internet 1.5.2.15 Passo 15a: Configurando o IIS atravs do instalador 1.5.2.16 Passo 15b: Habilitao do boto 'Next >' 1.5.2.17 Passo 15c: Limitaes da configurao automtica do IIS 1.5.2.18 Passo 15d: Parada e remoo de sites 1.5.2.19 Passo 15e: Configurao manual do IIS 1.5.2.20 Passo 16: Finalizando a instalao 1.5.3 Passos da remoo 1.5.3.1 Passo 1 1.5.3.2 Passo 2 1.5.3.3 Passo 3 1.5.3.4 Passo 4 1.5.3.5 Passo 5 1.5.3.6 Passo 6 1.6 Logs de instalao 1.7 Histrico de alteraes do manual 1.7.1 Verso 1.05 1.7.2 Verso 1.04 1.7.3 Verso 1.03

2/107

 1.7.4 Verso 1.02 1.7.5 Verso 1.01

Guia de instalao
Verso
Verso do Crivo: 3.5 Verso do Manual: 1.05 Data: 24/08/2007

Informaes de contato
Suporte Tcnico Crivo
Atendimento: segunda a sexta-feira, das 8h s 18h E-mail: suporte@crivo.com.br Telefone: (11) 5575-1332 Fax: (11) 5575-1332 Planto de atendimento: (11) 5575-1332 opo 6 - SUPORTE

Requisitos para instalao do Crivo

Resumo dos requisitos
O Crivo 3.5 um sistema de anlise de crdito e risco que funciona sob Microsoft Windows em um servidor web Internet Information Services, utilizando ASP.NET e Microsoft .NET Framework 2.0, acessa uma base de dados Microsoft SQL Server ou Oracle e necessita da chave proteo via hardware HASP HL da Alladin que utiliza uma porta USB.

Diferentes possibilidades de instalao

Os requisitos dependem de como se escolhe instalar o Crivo. Existem as seguintes possibilidades: Com o Crivo e base de dados em servidores diferentes, ou com o Crivo e base de dados no mesmo servidor. Podemos ainda instalar a chave HASP em um servidor separado daquele do Crivo. Isso pode ser necessrio quando se usa VMware ou quando se deseja liberdade de mudana de servidor sem necessidade de mudar a chave fisicamente a cada vez. Para maiores detalhes veja a seo Instalando um servidor de licenas.

Guia de instalao

3/107

Requisitos mnimos de hardware

Crivo e base de dados em servidores diferentes - Servidor Crivo Processador: Pentium 4 2.8 GHz ou equivalente. Memria RAM: 1 GByte Espao em disco: Servidor Crivo: 100 MBytes Dispositivo de backup Drive CD-ROM Conector externo USB para a chave HASP Mouse ou dispositivo apontador equivalente Monitor de vdeo ou dispositivo equivalente Acesso ao servidor e Internet

Crivo e base de dados em servidores diferentes - Servidor de base de dados Memria RAM: 1 GByte Espao em disco: Base de dados: 4 GBytes

Crivo e base de dados no mesmo servidor Processador: Intel Xeon 3.0 GHz ou equivalente Memria RAM: 2 GBytes Espao em disco: Servidor Crivo: 100 MBytes Base de dados: 4 GBytes Dispositivo de backup Drive CD-ROM Conector externo USB para a chave HASP Mouse ou dispositivo apontador equivalente Monitor de vdeo ou dispositivo equivalente Acesso ao servidor e Internet

Servidor de licenas O servidor de licenas usado no cado de se optar por colocar a chave HASP em uma mquina separada. Ele deve conter: Uma porta USB livre para a chave HASP A chave HASP HL na porta USB (fornecida pela Crivo)

Guia de instalao

4/107

Requisitos mnimos de software

Servidor de base de dados Microsoft SQL Server 2000 Standard Edition com Service Pack 3 (SP3) ou superior, ou Oracle 9.2 Enterprise Edition ou superior

Servidor Crivo Microsoft Windows 2000 Server com Service Pack 4, em ingls Internet Information Services 5.0 (IIS 5.0), com as seguintes opes: Common Files World Wide Web Server Internet Information Services Snap-In Microsoft Internet Explorer 6.0 ou superior Client Network Utility (componente do Microsoft SQL Server, se o sistema operacional for o Windows Server 2003 ele estar disponvel em %SystemDirectory%\cliconfg.exe) MDAC 2.8 (j disponvel se o sistema operacional for o Windows Server 2003) Microsoft .NET Framework 2.0 Aladdin HASP HL Device Driver 5.22 ou Hasp SRM run-time

Servidor de licenas O servidor de licenas usado no cado de se optar por colocar a chave HASP em uma mquina separada. Ele deve conter: Aladdin HASP HL Device Driver 5.22 ou Hasp SRM run-time HASP License Manager

Mquinas client para uso do Crivo por browser Microsoft Internet Explorer 6.0 ou superior. Outros browsers como Mozilla, Firefox e Opera no so suportados. Acesso via rede interna ao servidor do Crivo

Mquinas client para uso do Crivo por Administrador do Crivo Microsoft .NET Framework 2.0 Acesso via rede interna ao servidor do Crivo

Requisitos recomendados de hardware

O servidor adequado s necessidades da empresa deve ser dimensionado com base no volume de operaes previsto.

Guia de instalao

5/107

Crivo e base de dados em servidores diferentes Processador: Intel Xeon 3.0 GHz Memria RAM: 1 GByte RAID 1, RAID 5 ou RAID 10 Espao em disco: Servidor Crivo: 100 MBytes Base de dados: 10 GBytes Dispositivo de backup Drive CD-ROM Conector externo USB para a chave HASP Mouse ou dispositivo apontador equivalente Monitor de vdeo ou dispositivo equivalente Acesso ao servidor e Internet

Crivo e base de dados no mesmo servidor Processador: Dual-Core Intel Xeon 3.4 GHz Memria RAM: 2 GBytes RAID 1, RAID 5 ou RAID 10 Espao em disco: Servidor Crivo: 100 MBytes Base de dados: 10 GBytes Dispositivo de backup Drive CD-ROM Conector externo USB para a chave HASP Mouse ou dispositivo apontador equivalente Monitor de vdeo ou dispositivo equivalente Acesso ao servidor e Internet

Requisitos recomendados de software

Servidor de base de dados Microsoft SQL Server 2000 Standard Edition com Service Pack 3 (SP3), ou Oracle 10g

Servidor Crivo Microsoft Windows 2003 com Service Pack 1 (SP1), em ingls Internet Information Services 6.0 (IIS 6.0), com as seguintes opes:

Guia de instalao

6/107

Common Files World Wide Web Server Internet Information Services Snap-In Microsoft Internet Explorer 6.0 ou superior Client Network Utility (componente do Microsoft SQL Server, se o sistema operacional for o Windows Server 2003 ele estar disponvel em %SystemDirectory%\cliconfg.exe) MDAC 2.8 (j disponvel se o sistema operacional for o Windows Server 2003) Microsoft .NET Framework 2.0 Aladdin HASP HL Device Driver 5.22 ou Hasp SRM run-time

Configurao dos pr-requisitos

O Crivo necessita de uma srie de pr-requisitos para para poder funcionar. Alguns deles se referem a programas que tem de estar instalados no servidor (como o IIS e o ASP.NET por exemplo), outros se referem a permisses e direitos que os vrios usurios devem ter, e outras ainda se referem a aes que tem de ser tomadas antes da instao (como insero e configurao da chave HASP e criao das bases de dados que o Crivo ir utilizar. Alguns pr-requisitos so necessrios ao funcionamento do Crivo propriamente dito e outros apenas ao funcionamento do instalador. A remoo de pr-requisitos aps a instalao do Crivo ir comprometer o funcionamento deste. Quais pr-requisitos so necessrios depender de vrias coisas, como qual sua verso do sistema operacional e qual servidor de base de dados utilizado.

Sistemas operacionais
O Crivo pode operar nos seguintes sistemas operacionais: Windows 2000 server Windows server 2003 Windows server 2003 x64 Edition O Windows server 2003 x64 Edition exige uma verso 64-bit de Crivo. O instalador no permitir a instalao de uma verso 32-bit de Crivo em um sistema operacional 32-bit. Ter a verso do sistema operacional que suporte o Crivo no o suficiente, preciso ainda ter: Se o sistema operacional for o Windows 2000 server tem de estar com o Service Pack 1 (SP1). Recomenda-se fortemente ter as atualizaes do Windows via Windows Update

Acesso remoto ao servidor durante a instalao

comum o acesso a servidores pelo Terminal Services. Se o seu servidor for o Windows Server 2003 voc deve ter o cuidado de faz-lo atravs de sesso console administrativo do Terminal Services com o comando: mstsc.exe /v:<servidor> /console

Guia de instalao

7/107

Importante O Windows 2000 Server no suporta o /console, apenas a sesso remota do Terminal Services, o que inviabiliza o reconhecimento da chave HASP no momento da instalao. O Windows 2000 Server no suporta esta opo do Terminal Services, mas existem as seguintes alternativas: Se seu servidor for uma mquina virtual, acesse a mquina com o console do VMWare ou Virtual Server; se seu servidor for uma mquina fsica, apenas acessando a mquina via um console fsico (teclado e monitor concetados fisicamente ao servidor, ser possvel fazer a instalao.

Principais programas necessrios a instalao do Crivo

O Crivo um sistema web baseado no ASP.NET e escrito para rodar sob o .NET Framework 2.0 , assim temos alguns pr-requsitos para comear: Internet Information Services (IIS) .NET Framework 2.0 ASP.NET do .NET Framework 2.0 ASP.NET web service extension

Instalando o IIS Caso no se tenha o IIS instalado deve-se instala-lo. Antes de mais nada tenha em mos o CD do Windows. A instalao pode ser feita utlizando-se o Manage Your Server em Start\Control Panel\Administrative Tools:

Guia de instalao

8/107

A tela obtida ser essa:

Guia de instalao

9/107

Clique em Add or remove a role e ser aberta uma nova tela:

Guia de instalao

10/107

Aperte o boto Next > ser feita uma deteco da configurao atual, assim

aps esta deteco ser apresentada a configurao atual:

Guia de instalao

11/107

Se no tem Application Server (IIS), a coluna Configured estiver como Yes, voc j tem o papel de Application server configurado e no precisa prosseguir. Se estiver No, selecione este tem e clique em Next >, neste ponto ser mostrada uma tela mostrando o que ser instalado:

Guia de instalao

12/107

Clique em Next > e aguarde enquanto o IIS instalado e configurado:

Guia de instalao

13/107

Aguarde mais um pouco a configurao dos componentes:

Guia de instalao

14/107

Se neste ponto o CD do Windows no estiver disponvel ser exibida uma caixa de dilogo pedindo a insero do CD:

Se for apertado o boto Ok sem a insero do CD ser exibida a seguinte tela:

Guia de instalao

15/107

Caso o CD do Windows esteja disponvel ser feita a instalao:

Aperte o boto Finish e a instalao est terminada.

Guia de instalao

16/107

Instalando o ASP.NET A instalao do IIS no instala o ASP.NET, deve-se instala-lo aps a instalao do IIS. Isso feito via linha de comando por um programa chamado aspnet_regiis.exe. Este programa se encontra no diretrio do .NET Framework, que se localiza normalmente em %WinDir%\microsoft.net\Framework\v2.0.50727 em um sistema operacional 32-bit e em %WinDir%\microsoft.net\Framework64\v2.0.50727 em uma mquina 64-bit. O aspnet_regiis.exe precisa ser chamado passando algumas opes. Se o comando for aspnet_regiis.exe -i ser instalado o ASP.NET e todos os scriptmaps a partir da raiz do metabase do IIS so atualizados para que as pginas .aspx utilizem esta verso de ASP.NET. Se j houver um ASP.NET 1.1 todas as aplicaes ASP.NET existentes passaro a ser executadas pela nova verso do ASP.NET. Isto pode prejudicar o funcionamento de aplicaes ASP.NET de outros sistemas que j estavam instalador no servidor. Para evitar isto se j existirem sistemas utilizando o ASP.NET 1.1 no servidor utilize o comando aspnet_regiis.exe -ir que instalar a nova verso do ASP.NET sem registrar os scriptmasps, ou seja as pginas .aspx continuaro a ser eecutadas pelo ASP.NET 1.1. O instalador do Crivo alterar os scriptmaps para que apenas as pginas do Crivo utilizem o ASP.NET 2.0 (desde que seja escolhida a opo Configurar 'web site' do Crivo atravs deste assistente) Se voc estiver em um sistema operacional 64-bitexistiro apenas aplicaes que usem o ASP.NET do .NET framework 2.0 para 64-bit. Assim este problema no existir.

Importante Se existirem no servidor aplicaes que se utilizam do ASP.NET do .NET framework 1.1 utilize o aspnet_regiis.exe -ir. Neste caso, no instalador do Crivo selecione a opo Configurar 'web site' do Crivo atravs deste assistente, pois para o Crivo funcionar ele precisar atualizar os scriptmaps do Crivo para o ASP.NET' 2.0, o que s ocorre caso esta opo seja posicionada ou o processo seja feito manualmente.

Importante Cada aspnet_regiis.exe especfico da sua verso. Normalmente em um sistema operacional 32-bit voc tem o da verso 1.1.4322 e o da verso 2.0.50727. Em um sistema operacional 64-bit voc tem a verso 2.0.50727 tanto para 32-bit quanto para 64-bit. O Crivo utiliza o .NET Framework 2.0 assim voc deve utilizar o aspnet_regiis.exe da verso 2.0.50727. O instalador do 'Crivo s permite instalar uma verso 64-bit do Crivo em um sistema operacional 64-bit. Assim, em uma edio 64-bit do sistema operacional voc deve utilizar o aspnet_regiis.exe da verso 2.0.50727 para 64-bit. Se voc tentar utilizar o aspnet_regiis.exe para 32-bit com o IIS de 64-bit obter um erro.

Guia de instalao

17/107

Habilitando o web service extension do ASP.NET Para o Crivo funcionar preciso que a web service extension do ASP.NET esteja habilitada. Isso tem de ser feito manualmente, pois apenas instalar o ASP.NET no habilita a web service extension. Para fazer isso voce deve abrir o Internet Information Services Manager localizado em Start\Control Panel\Administrative Tools:

A tela obtida ser essa:

Guia de instalao

18/107

Selecione a web service extension do ASP.NET 2.0 e aperte o boto Allow para habilitar esta web service extension. A configurao dos pr-requisitos referentes ao IIS est pronta.

Configuraes de acesso a Internet

Os drivers do Crivo acessam vrias fontes de dados externas via Internet (Serasa, Equifax, Secretaria da Receita Federal, Sintegra, Previdncia Social, entre muitas outras), assim sendo o Crivo precisa poder navegar na Internet. Conforme j dissemos o Crivo escrito para rodar sob o .NET Framework 2.0, isso acrescido ao requisito anterior de navegar na Internet nos leva a um outro. O .NET Framework utiliza as configuraes de Internet (proxy) do Internet Explorer, mas ele no le estas configuraes a todo momento. Ele apenas as copia para uso do .NET Framework quando se utiliza o programa proxycfg (fornecido com o Windows) dando o comando proxycfg -u. O instalador do Crivo far isso para voc mas isso nos leva a mais alguns pr-requisitos para o servidor onde estar o Crivo: Internet Explorer instalado. Internet Explorer com as opes de proxy em Tools\Insternet Options\Connections\LAN Settings\Proxy Server ajustadas para a configurao que se deseja que o Crivo use para navegar. Permisso na firewall para acesso as fontes de dados necessrias. Consulte a Crivo a respeito.

Permisses e direitos
O usurio do instalador (e consequentemente o usurio de servios do Crivo) precisa das seguintes permisses: Ter as seguintes permisses:

Guia de instalao

19/107

 full control no diretrio temporrio do ASP.NET full control no diretrio temporrio do Windows permisso de execuo no aspnet_regiis.exe Pertencer aos grupos: Administrators local IIS_WPG (este gupo s existe se o IIS estiver instalado) Ter os direitos de logon: Allow log on locally Logon as a service Access this computer from network Ter os privilgios: Adjust memory quotas for process Impersonate a client after athentication Replace process-level token Generate security audits Aqui cabe uma explicao: as permisses afetam um ou mais objetos, os direitos permitem uma operao no computador todo. Existem dois tipos de direitos, os direitos de logon que controlam as vrias maneiras queum usurio tem acesso ao computador, e os privilgios que controlam o acesso aos vrios recuross do computador. Os direitos de logon podem ser explicitamente negados (por exemplo Logon as a service e Deny logon as a service) e mesmo que o usurio tenha este direito, se ele ou seu grupo tambm tiver este direito negado o usurio no ter o direito. No Windows 2000 quando se modifica um direito, muitas vezes necessrio dar boot na mquina para se ter a permisso efetiva, o que nem sempre possvel. Por isso a configurao de sistema operacional reecomendada Windows server 2003. Caso os pr-requisitos no satisfeitos sejam privilgios ou direitos de logon, utilize o Local Security Policy em Start\Control Panel\Administrative Tools para as configuraes necessrias.

Guia de instalao

20/107

As permisses solicitadas podem ser encontradas em User Rights Assignment, no caminho Security Settings\Local Policies.

Guia de instalao

21/107

Configurao do acesso s bases de dados

O Crivo suporta dois tipos de servidores de bases de dados, o Microsoft SQL server e o Oracle

Configurao do acesso s bases de dados no Microsoft SQL Server preciso configurar um alias para acesso a base de dados, para isso pode-se utilizar o Client Network Utility . Se o sistema operacional for o Windows Server 2003 esta aplicao j fornecida (localizada em %SystemDirectory%\cliconfg.exe), se o sistema operacional for o Windows 2000 Server ela tem de ser instalada, instalando-se o client tools do Microsft SQL Server (ou o Configuration Tools do Microsoft SQL Server 2005). Se a edio do sistema operacional for 64-bit, existiro dois Client Network Utility que tm a interface idntica, um 32-bit no %SystemDirectory%\cliconfg.exe e outro 64-bit no %WinDir%\SysWOW64, ambas com o mesmo nome (cliconfg.exe). Um alias configurado no cliconfg.exe 32-bit s ser visto por aplicaes 32-bit e um alias configurado pelo cliconfg.exe 64-bit s ser visto por aplicaes 64-bit. O instalador da verso 32-bit Crivo no permite que ele seja instalado em uma edio 64-bit de um sistema operacional, pois existe uma verso 64-bit do Crivo. O Crivo e seu instalador so aplicaes 64-bit reais, e no aplicaes 32-bit que rodam em 64-bit atravs do Windows on Windows (WoW), assim, em 64-bit eles precisam de um alias criado com o Client Network Utility 64-bit.

Guia de instalao

22/107

Ao abrir o Client Netork Utility selecione a aba Alias, e ver a seguinte tela:

aperte o boto Add... e obter a seguinte caixa de dilogo:

o nome do alias tem de ser SQLCRIVO, nas opes Network libraries escolha TCP/IP e nas opes de Connection parameters coloque no Server name o nome do seu servidor de base de dados. Aperte OK para fechar a caixa de dilogo e

Guia de instalao

23/107

vai ver o alias criado assim:

agora aperte OK para fechar o Client Network Utility o alias estar criado.

Configurao do acesso s bases de dados no Oracle Para acesso ao Oracle so necessrias dois requisitos: Um OLEDB provider, e um cliente Oracle. O cliente do Oracle 10g pode ser encontrado em: http://download.oracle.com/otn/nt/oracle10g/10201/10201_client_win32.zip para a edies 32-bit do Windows e http://download.oracle.com/otn/nt/oracle10g/10201/102010_win64_x64_client.zip para edies 64-bit do Windows. Para baixar os clientes da Oracle necessrio se cadastrar, mas eles so de distribuio livre.

Importante No se deve instalar mais de um cliente Oracle no mesmo servidor, pois isso interfere na instalao do Crivo (devido s configuraes do TNS e alias). De acordo com a Microsoft (em http://support.microsoft.com/default.aspx?scid=kb;EN-US;259959) no devem existir mltiplas verses do SQL*Netm client em uma mesma mquina.

Guia de instalao

24/107

Importante Voc deve usar o client Oracle e no o Instant client. O Instant client apesar de muito menor em tamanho, s serve para aplicaes C usando Oracle Call Interface (ICI), aplicaes C++ usando Oracle C++ Call Interface (OCCI), aplicaes usando ODBC' e aplicaes Java usando JDBC (vide http://www.oracle.com/technology/tech/oci/occi/index.html). Entraremos em detalhes sobre a instalao do cliente Oracle pois existem vrias opes de instao. Abra o arquivo zip do cliente em algum lugar e execute o setup.exe contido nele. Ser exibia a seguinte tela:

aperte o boto Prximo para prosseguir e ser levado para a tela de escolha do diretrio do inventrio do instalador:

Guia de instalao

25/107

aperte o boto Prximo novamente e vo aparecer as opes de tipo de instalao:

Guia de instalao

26/107

escolha Runtime ou Personalizar. Aperte o boto Prximo para prosseguir e vai obter a seguinte tela:

Guia de instalao

27/107

aperte Prximo novamente e se foi escolhido anteriormente Runtime no ser necessrio selecionar quais componentes instalar, mas alguns componentes tero de ser instalados posteriormente (mais especificamente o OLDEDB provider se for uma edio 64-bit do Windows e o SQL*Plus para criar os objetos da base). Se foi escolhido Personalizar aparecer a tela de opes de componentes a serem instalados:

Guia de instalao

28/107

marque a opo SQL*PLus:

Guia de instalao

29/107

expanda as sub-opes do tem Oracle Windows Interfaces clicando no +:

Guia de instalao

30/107

Para habilitar as sub-opes marque a opo Oracle Windows Interfaces:

Guia de instalao

31/107

deixe marcado apenas a opo Oracle Provider for OLE DB e aperte Prximo:

Guia de instalao

32/107

aperte Prximo:

Guia de instalao

33/107

Aperte Instalar e aguarde a instalao terminar:

Guia de instalao

34/107

Quando acabar a instalao vai aparecer a seguinte tela:

Guia de instalao

35/107

Basta apertar o Sair, ele apenas pedir confirmao:

A instalao est terminada. Quanto ao OLEDB provider, ele apenas ser necessrio se voc selecionou Runtime no tipo de instalao do cliente do Oracle. Caso tenha selecionado Personalizar poder ser necessria a instalao do OLEDB provider.

Guia de instalao

36/107

Em edies 32-bit do Windows o Microsoft Oracle OLE DB Provider (MSDAORA) j vem instaldo com o sistema operacional. Em edies 64-bit do sistema operacional a Microsoft no fornece (nem fornecer) o Microsoft Oracle OLE DB Provider . Na verdade este provider j em 32-bit era escrito para Oracle 7 e usava a emulao de Oracle 7 para prover um suporte limitado para o Oracle 8. A Microsoft afirma no ter testado o MSDAORA com Oracle 9, a posio da Microsoft claramente colocada em http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnmdac/html/data_mdacroadmap.asp. Existe no entanto um OLEDB provider fornecido pela Oracle chamado Oracle Provider for OLE DB (OraOLEDB) que est contido em um pacote chamado Oracle Data Access Components (ODAC) disponvel para 64-bit em http://www.oracle.com/technology/software/tech/windows/odpnet/64-bit/index.html Resumindo: se for uma verso 32-bit do sistema operacional no preciso instalar um OLEDB provider; se for uma verso 64-bit deve-se baixar o ODAC 64-bit e instal-lo. Aps a instalao dos programas necessrios, deve-se criar o alias para o acesso a base do Crivo no Oracle Localize, o arquivo TNSNAMES.ORA ou se ele no existir crie (geralmente em C:\oracle\product\10.2.0\client_1\NETWORK\ADMIN dependendo da verso do cliente) e insira nele um alias chamado ORACRIVO, indicando o banco de dados do schema Crivo. Este alias no deve ter nenhuma extenso associada ao nome, apenas a denominao ORACRIVO. Um exemplo tpico do arquivo TNSNAMES.ORA. A parte do arquivo TNSNAMES.ORA referente ao alias do Crivo tipicamente:

ORACRIVO = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = SERVIDOR)(PORT = 1521)) ) (CONNECT_DATA = (SERVICE_NAME = ORCL) ) )

Importante No sobreponha este arquivo com este contedo. Ele pode ter outros aliases configurados. Se o arquivo j existir abra o arquivo existente adicione esta seo.

Criao das bases de dados

O instalador do Crivo no cria as bases de dados pois a criao das bases exigiria direitos que permitiriam ao instalador alterar qualquer base de dados no servidor. Isso seria pedir demais.

Guia de instalao

37/107

Assim sendo, a base de dados deve ser criada manualmente.

Criao das bases de dados no Microsoft SQL server Criar duas bases de dados chamadas: Crivo e CrivoOpt O collation das bases deve ser SQL_LATIN1_GENERAL_CP1_CI_AI O usurio do instalador (e consequentemente dos servios do Crivo) deve ter a permisso o db_owner nas duas bases. possvel, mas no necessria a criao dos objetos (tabelas, stored procedures, etc.) na base de dados. O instalador ir cri-las automaticamente.

Criao das bases de dados no Oracle Criar dois table space, uma chamada TSD_CRIVO_01 (dados, tamanho de 2 GB) e TSI_CRIVO_01 (ndices, tamanho de 1 GB). Recomendamos o acompanhamento da taxa de crescimento das table spaces para identificar a necessidade de manutenes necessrias. Criar dois usurios no Oracle (Crivo e CrivoOPT) que sero utilizados pelo Crivo. Nos scripts citados abaixo h exemplos para criao desses usurios. O usurio Crivo (no Oracle) dever ter permisso de select na view ALL_TAB_COLUMNS. Ao contrrio da instalao para Microsoft SQL Server na instalao para Oracle os objetos da base devem sempre ser criados manualmente. Esta diferena de procedimento se deve ao fato de na cultura do Oracle este ser o procedimento comum. Executar o script CriaSchema.sql, localizado no diretrio \OracleScripts do CD de instalao. O script ir criar o esquema Crivo com os objetos do Crivo. Executar os scripts CriaAlerta.sql, CriaAnatel.sql e CriaRNS.sql, localizados no diretrio \OracleScripts do CD de instalao. Os scripts criaro o esquema CrivoOPT com os objetos do Crivo. Para executar os scripts deve-se usar o SQL*PLus, a maneira mais simples via linha de comando, digitando-se sqlplus /nolog o que entrar no SQL*Plus via linha de comando que aguardar comandos com o prompt SQL>. Digite o comando parta se conectar:

SQL> CONN usuario/senha

Este usurio deve ser o do administrador pois o usurio do esquema provavelmente no ter as permisses necessrias. Deve-se ento executar os scripts de criao:

SQL> @"caminho\CriaEsquema.SQL"

As aspas duplas so necessrias caso o caminho contenha espaos. O script requisitar o nome do esquema onde os objetos sero criados com a seguinte mensagem:

Guia de instalao

38/107

Informe o valor para o esquema:

Entre o nome do esquema, aperte Enter e espere o script terminar. Faa o mesmo com os scripts restantes (CriaAlerta.sql, CriaAnatel.sql e CriaRNS.sql), lembrando-se de cri-los no seu respectivo esquema se eles forem diferentes.

Importante Este procedimento para criao dos objetos na base, o que necessrio apenas na primeira instalao do Crivo; em caso de atualizao o procedimento deve ser o que se segue. Quando se faz uma atualizao de verso do Crivo, evidentemente no se precisa criar a base de dados novamente, mas deve-se ter alguma ateno a atualizao da sua estrutura. Nem todas as atualizaes de verso fazem mudanas na estrutura da base de dados; na verdade isso at certo ponto raro. O instalador ir sempre verificar se a verso da estrutura da base de dados a esperada para aquele verso do instalador, caso no seja ele ira parar no pr-requisito Verso do schema Crivo pelo menos n.n.nnnn (assim no preciso se preocupar com isso at que o instalador avise). Caso isso acontea deve-se atualizar a estrutura base. Para identificar qual verso da estrutura da base basta fazer um select usando o SQL*Plus:

select * from Versao;

Sabendo o numero da verso do Crivo onde esta estrutura foi alterada da ltima vez, devem-se executar (como descrito anteriormente) na ordem todos os scripts MigracaoNNNNNN.sql, posteriores a esta verso at o mais recente. Agora pode-se executar o instalador novamente.

Importante No altere os scripts, pois da estrutura correta da base depende o bom funcionamento do Crivo. Mesmo uma alterao aparentemente incua como criar um campo novo, pode pode posteriormente criar problemas, pois se numa verso posterior o script de migrao tentar criar um campo com mesmo nome o script falhar.

Importante A verso do Oracle utilizada deve possuir o recurso Function-Based Index (FBI).

Guia de instalao

39/107

Chave HASP HL
A chave HASP um dispositivo de proteo de software contra uso de cpias no autorizadas, impedindo que sejam utilizadas instalaes do Crivo que no foram previstas em contrato. Ela mostrada na figura abaixo

A chave conectada a uma porta USB, que dever estar disponvel no servidor do Crivo, ou conectada a uma porta USB em um outro servidor que chamamos de Servidor de licenas, conforme a seo Requisitos para instalao do Crivo, neste manual.

Virtualizao e portas USB Caso o Crivo seja instalado em mquinas virtuais no Microsoft Virtual Server ou VMware (linha de produtos server ou workstation), h restries quanto virtualizao da porta USB, recurso necessrio para a chave HASP HL. A seguir mostramos as limitaes dos produtos mencionados:

Microsoft Virtual PC

Microsoft Virtual Server 2005 R2 VMware ESX Server

Em primeiro lugar o Virtual PC no suporta emualo de USB conforme artigo KB824511 do knowledge base. No Em segundo lugar a linha de produtos Virtual PC no roda em edies servidor do Windows (VirtualPC overview na opo Product Specifications). Permite a instalao do HASP HL Device Driver, porm este no detecta a presena do hardware (USB) da chave. Conforme FAQ do site da Microsoft: Virtualization FAQ Q. Do Virtual Server 2005 R2 virtual machines support USB? No A. Virtual Server currently does not support USB hardware such as smart card readers and scanners. However, standard USB input hardware, such as keyboard and pointing devices, are supported. O produto VMware ESX Server no virtualiza portas USB, conforme artigo 1015 da Knowledge No Base da VMware, "USB Devices Not Supported in ESX Server Virtual Machines"

Guia de instalao

40/107

VMware Server VMware Workstation 5.x

Sim Nenhum problema conhecido. Verificar a Knowledge Base da VMware, answer ID 1648: Automatically Connecting USB Sim Devices at Virtual Machine Power On http://kb.vmware.com/

Alternativas portas USB fsicas ou virtualizadas Quando se deseja utilizar o Crivo em uma mquina fsica que no tem porta USB, ou em uma mquina virtual que no virtualiza portas USB, existem duas alternativas: o uso do modelo Net da chave HASP HL em um servidor de licenas que tenha a porta USB disponvel. Este procedimento descrito na seo Instalando um servidor de licenas deste guia. o uso do produto AnywhereUSB: http://www.digi.com/products/usb/anywhereusb.jsp

Instalando um servidor de licenas

Importante Esta seo relevante apenas se foi decidido instalar a chave HASP em uma outra mquina que no o servidor Crivo. Se for possvel e caso seja desejado instalar a chave HASP diretamente no servidor do Crivo v direto para a seo Programas necessrios ao uso da chave HASP HL deste guia No servidor de licenas (ou seja a mquina onde a chave HASP vai estar conectada): Instalar uma das duas alternativas de drivers descritas na seo Programas necessrios ao uso da chave HASP HL deste guia; instalar o gerenciador de licenas, disponvel em: ftp://ftp.ealaddin.com/pub/hasp/hl/windows/installed/redistribute/lm/LM_Setup_Installer.zip , instale-o como servio e mantenha os componentes do driver HASP instalados no item anterior deste procedimento, pois eles so a verso mais atualizada que a fornecida com o gerenciador de licenas; conectar a chave HASP HL NET na porta USB deste servidor; copiar o arquivo nhsrv.ini para o diretrio %SystemDirectory%; iniciar o servio HASP Loader. No servidor Crivo: Configurar e adicionar o arquivo NetHASP.ini ao diretrio %SystemDirectory%; para obter um arquivo NetHASP.ini modelo acesse ftp://ftp.ealaddin.com/pub/hasp/hl/nethasp.ini/Standard_Nethasp.zip; instalar uma das duas alternativas de drivers descritas na seo Programas necessrios ao uso da chave HASP HL deste guia.

Guia de instalao

41/107

Programas necessrios ao uso da chave HASP HL

Importante O driver da chave HASP dever ser instalado antes da conexo da chave no servidor.

Importante Caso se tenha optado por usar um servidor de licenas o procedimento de instalao dos drivers ou do run-time deve ser repetido tanto no servidor Crivo como no servidor de licenas. Existem duas alternativas possveis: O driver da chave HASP: Utilizado pelo Crivo 32-bit. O HASP Run-time: Utilizado tanto pelo Crivo 32-bit como pelo 64-bit. Estes programas foram elaborados pela Aladdin Knowledge Systems (http://www.aladdin.com) e permitiro a comunicao entre o Crivo e a chave HASP.

Instalando o HASP Run-time Existem dois instaladores possveis para o HASP Run-time: Caso seja prefervel um instalador de linha de comando (ele tem vantagem de poder fornecer mais informaes sobre drivers instalados) utilize o programa haspdinst.exe que pode ser obtido no site do fabricante: ftp://ftp.aladdin.com/pub/hasp/srm/Runtime_%28Drivers%29/HASP_SRM_Runtime_cmd_line.zip Basta na linha de comando chamar o programa com um dos seguintes switches:

-i ou -install -r ou -remove -fr ou -fremove -info -h ou -help

Instala o driver HASP SRM. Remove o HASP SRM Run-time (no funciona se tiver drivers do Hardlock ou HASP4). Remove o HASP SRM Run-time (os drivers do Hardlock ou HASP4 no so desinstalados mas no podero ser mais usados). Exibe as verses dos drivers instalados e as verses contidas no instalador. Exibe a tela de ajuda.

Caso seja prefervel um instalador com interface grfica utilize o programa HASPUserSetup.exe que pode ser obtido no site do fabricante:

Guia de instalao

42/107

ftp://ftp.aladdin.com/pub/hasp/srm/Runtime_%28Drivers%29/HASP_SRM_Runtime_setup.zip Executando o programa ser exibida a seguinte tela:

Clique em Next > para prosseguir a instalao e ser exibido o prximo passo:

Guia de instalao

43/107

Clique em Next > novamente para prosseguir a instalao e aguarde enquanto ela prossegue:

Guia de instalao

44/107

Quando a instalao for completada ser exibida a tela seguinte, clique em Finish para sair:

Guia de instalao

45/107

Instalando o driver da chave HASP O instalador do driver, HASPUserSetup.exe (o executvel tem o mesmo nome do instalador do Hasp Run-time mas no o mesmo arquivo), pode ser encontrado na pasta Accessories\Aladdin\HASP_HL_Driver_setup\HASP_HL_Driver_setup, junto aos arquivos de instalao do Crivo, ou tambm pode ser obtido no site do fabricante: ftp://ftp.ealaddin.com/pub/hasp/hl/windows/installed/redistribute/drivers/HASP_HL_driver_setup.zip

A chave HASP dever estar conectada ao servidor antes da instalao do driver, e assim dever ficar aps a instalao do Crivo. A remoo da chave HASP, aps a instalao do Crivo, implicar na interrupo do sistema Crivo at que a mesma seja reconectada. Execute o programa HASPUserSetup.exe; ser apresentada a tela a seguir, solicitando a linguagem a ser utilizada no decorrer da instalao do driver:

Guia de instalao

46/107

Clique em Next > para prosseguir a instalao.

Guia de instalao

47/107

Aceite o termo de licena e clique em Install para avanar.

Guia de instalao

48/107

Aps a instalao, clique em Finish para encerrar a instalao.

Na ocorrncia de erros na instalao do HASP HL, consulte a tabela abaixo para auxiliar a identificao da causa do problema. Caso o cdigo no esteja na tabela, consulte :

Cd. 7 27 31 500 525 698

Descrio The HASP HL key is no longer available. Program is running remotely on a Terminal Server. The requested feature is no longer available. Object not initialized correctly. Error related to incorrect use of system or platform. The requested type of feature is not implemented.

Guia de instalao

49/107

2. Instalao do Crivo
Resumo
O programa setup.exe do Crivo permite: Instalar o Crivo (caso no seja detectado uma verso do Crivo j instalada) Atualizar o Crivo (se for detectada uma verso igual ou anterior do Crivo instalada) Remover o Crivo (tambm se for detectada uma verso igual ou anterior do Crivo instalada)

Passos da instalao

Importante Antes da execuo do setup.exe aconselhvel o backup do sistema, alm do fechamento dos applets Services, Add or Remove Programs e Event Viewer. Passo 1 Execute o aplicativo setup.exe a partir do local onde esto os arquivos de instalao do Crivo (CD ou pasta). Na tela de apresentao so feitas algumas recomendaes e informada a verso e release do Crivo que ser instalada.

Guia de instalao

50/107

Clique no boto Next > para continuar. O instalador verifica a presena de uma instalao prvia e, se encontrar alguma, ele vai para o Passo 2, caso no encontre uma instalao prvia vai para o Passo 3

Passo 2: Crivo detectado Quando o instalador identifica a presena de uma instalao prvia ele pergunta se deseja ser feita uma atualizao, reconfigurao ou remoo do Crivo:

Guia de instalao

51/107

Basta escolher a opo desejada e aperte o boto Next >.

Passo 3: Diretrio de Instalao Neste ponto o instalador solicita o local de instalao dos componentes do Crivo:

Guia de instalao

52/107

O caminho padro C:\Program Files\Crivo (seja em verses 32-bit ou em verses 64-bit, pois o instalador no permite instalar uma verso 32-bit do Crivo em uma edio 64-bit de Windows, assim ele nunca mostra como padro o caminho C:\Program Files (x86)\Crivo). Para alterar o caminho basta digitar diretamente na caixa Diretrio, ou utilize o boto Procurar.... Aps a instalao, a alterao do caminho indicado somente poder ser feita com a remoo do Crivo e execuo de nova instalao. Aps informar o local de instalao, aperte o boto Next >. O Crivo suporta as bases de dados Microsoft SQL Server (pelo menos a verso Microsoft SQL Server 2000) e Oracle (no mnimo o Oracle 9.2); o instalador busca pela verso cliente de acesso a estes gerenciadores, caso sejam identificados os dois tipos instalados, o instalador vai para o Passo 4. Caso no seja encontrado cliente Oracle o instalador mostrar a tela do Passo 8.

Passo 4: Gerenciador de Banco de Dados Caso sejam identificados os dois tipos instalados, ser apresentada uma tela para escolha de qual ser utilizado com o Crivo.

Guia de instalao

53/107

Selecione a opo adequada e clique Next >.

Passo 5: Forma de conexo ao SQL Server Se for escolhido, ou identificado apenas o cliente do Microsoft SQL Server ser mostrada a tela solicitando a escolha de qual forma de conexo ser utilizada, Windows authentication ou string de conexo:

Guia de instalao

54/107

Selecione a opo desejada e ento aperte o boto Next >.

Passo 6: Usurio e senha do Oracle Caso seja escolhido no Passo 4 o Oracle como o servidor de bases de dados, ser pedida a senha para a base Crivo no Oracle.

Guia de instalao

55/107

Aperte o boto Next >. Ser feito um teste de acesso a base Crivo do Oracle:

Guia de instalao

56/107

Se tudo der certo o instalador vai para o Passo 8. Se a conexo com a base falhar voc receber uma mensagem de erro (seguem dois exemplos): Caso a autenticao do usurio falhe:

Guia de instalao

57/107

Caso o servidor configurado no arquivo TNSNAMES.ORA no tenha um servio ORACLE, ou este tenha cado, ou esteja configurado na porta errada:

Guia de instalao

58/107

(em ingls)

Guia de instalao

59/107

(em portugus) Caso a mquina configurada como servidor no arquivo TNSNAMES.ORA no exista ou tenha cado:

Guia de instalao

60/107

(em ingls)

Guia de instalao

61/107

(em portugus)

Caso no exista o alias ORACRIVO configurado no arquivo TNSNAMES.ORA ou caso o prprio arquivo TNSNAMES.ORA no exista, ou o nome do arquivo TNSNAMES no esteja definido no arquivo SQLNET.ORA na entrada NAMES.DIRECTORY_PATH; ou ainda o arquivo SQLNET.ORA tenha a entrada NAMES.DEFAULT_DOMAIN configurada erradamente:

Guia de instalao

62/107

(em ingls)

Guia de instalao

63/107

(em portugs) Caso o nome do servio do Oracle definido no arquivo TNSNAMES.ORA na enntrada SERVICE_NAME, no exista no servidor:

Guia de instalao

64/107

(em ingls)

Guia de instalao

65/107

(em portugus) O instalador no permitir que voc prossiga at resolver este problema.

Importante Uma das causas comuns de erros nesta parte (alm da senha ou usurio errados) ter mais de uma verso do cliente Oracle deve estar instalada no servidor Crivo.

Importante Outra fonte comum de erros no ter configurado corretamente o arquivo TSNAMES.ORA, como descrito na seo Configurao do acesso s bases de dados no Oracle. Passo 7: Usurio e senha do Oracle para a base CrivoOpt Em seguida sero pedidos o usurio e senha do esquema CrivoOpt:

Guia de instalao

66/107

Preencha os dados e aperte o boto Next >.

Passo 8: Usurio e senha do Crivo O instalador identificar e usar o usurio de logon sob o qual ele est sendo executado, preenchendo o campo Usurio, solicitando apenas a senha. Este usurio ser utilizado na inicializao dos servios do Crivo e no acesso via Integrated Authentication do SQL Server (se for este o DBMS escolhido), devendo possuir as permisses definidas em Criao da profile do usurio, caso deseje trocar o usurio, ser necessrio interromper a instalao e efetuar logon com o usurio desejado. Para prosseguir aperte o boto Next >.

Guia de instalao

67/107

Caso no Passo 4 tenha sido escolhido como servidor de bases de dados o Oracle, o instalador prossegue para o Passo 9. Caso no Passo 4 tenha sido escolhido como servidor de bases de dados o Microsoft SQL Server, ento, aps a validao do usurio e senha para os servios do Crivo, ser feito o teste de conexo ao banco de dados:

Guia de instalao

68/107

Ocorrendo erro ser apresentada uma mensagem indicando a causa da falha (seguem trs exemplos): No caso de uma falha de autenticao:

Guia de instalao

69/107

No caso de uma configurao errada do cliente apontando para uma mquina sem o servidor de bases de dados, ou de um servidor de base de dados fora do ar:

Guia de instalao

70/107

No caso de uma configurao errada do cliente apontando para uma mquina inexistente ou uma mquina fora do ar:

Guia de instalao

71/107

Caso ocorram erros o boto Next > ficar desabilitado impedindo o prosseguimento da instalao at que o problema seja resolvido.

Passo 9: Usurio e senha do 'application pool' do Crivo Sendo bem sucedida a conexo ao banco de dados, ser solicitado o usurio e senha para uso do Application Pool (no caso de instalao no Windows Server 2003), caso a conta de usurio seja a mesma dos servios do Crivo, basta selecionar Usar usurio de servios e o nome do usurio ser automaticamente preenchido, mas a senha dever ser digitada novamente.

Guia de instalao

72/107

Passo 10: Seleo da configurao do servidor LDAP O Crivo suporta a autenticao dos seus usurios atravs de LDAP (ou AD). Nesta tela perguntado se desejado utilizar o LDAP na autenticao dos usurios do Crivo (os usurios de acesso ao Crivo e no os usurios das bases de dados ou dos servios do Crivo). Quando se usa LDAP, ao se criar um usurio no Crivo no se precisa administrar os usurio, suas senhas e suas expiraes ou invalidaes atravs do Crivo, diminuindo o trabalho do administrador.

Guia de instalao

73/107

Caso sua rede utilize autenticao de usurios LDAP' e essa opo seja desejada, selecione a caixa Configurar acesso ao servidor LDAP, e clique Next >. Caso no seja necessria essa opo, clique somente Next >.

Passo 11: Configurao do servidor LDAP Se no Passo 10 foi marcada a opo Configurar acesso ao servidor LDAP ser mostrada a tela para preencher os dados de acesso ao servidor LDAP:

Guia de instalao

74/107

Preencha os dados necessrios, isso exigir algum conhecimento do funcionamento do seu servidor LDAP (ou AD) e aperte o noto Next > para prosseguir, aps isso estes dados sero validados junto ao seu servidor LDAP:

Guia de instalao

75/107

Caso tudo esteja correto o instalador prosseguir para o Passo 12. Caso ocorra um erro na validao dos dados junto ao sevidor LDAP ser exibida uma mensagem de erro (seguem trs exemplos): Caso os dados do servidor LDAP (Servidor LDAP, Porta, Seguro, BaseDN, Usurio DN ou Senha DN) contenham um erro:

Guia de instalao

76/107

Caso os dados para a obteno do usurio de teste (Atributo busca ou Usurio teste) contenham um erro:

Guia de instalao

77/107

Caso a autenticao do usurio de teste no funcione (por exemplo pela senha errada):

Guia de instalao

78/107

Passo 12: Arquivos de instalao adicionais Aps isso ser mostrada uma lista de adicionais que podem ser instalados. Estes adicionais so drivers, ou seja, mecanismos de acesso a fontes de informao (muitas vezes exclusivas para cada cliente). Para que estes drivers sejam mostrados nesta janela os arquivos relacionados devero estar, antes da execuo do instalador, na pasta "Adicional" do local de origem da instalao.

Guia de instalao

79/107

Se for uma atualizao j viro marcados os instalados anteriormente (e estes estaro desabilitados pois se foram instalados tem obrigatoriamente de ser atualizados e s podem ser removidos desinstalando-se o Crivo). Deve-se selecionar quais adicionais sero instalados, clique no boto Next > para prosseguir a instalao. Neste ponto o instalador faz uma grande srie de testes e verifica permisses requeridos para os usurios fornecidos, alm dos pr-requisitos de software do Crivo. Caso algum destes pr-requisitos no seja atendido ser mostrada a tela do Passo 13, caso todos estes pr-requisitos sejam atendidos ser mostrada a tela do Passo 14.

Passo 13: Pr-requisitos para a instalao do Crivo Se algum dos p-requisitos de ambiente necessrios ao funcionamento do Crivo no for atendido ser mostrada a tela de prrequisitos:

Guia de instalao

80/107

A caixa vazia esquerda do item () indica pr-requisito no satisfeito, e enquanto essa pendncia no for resolvida, o boto Next > no ser habilitado, impedindo que o processo de instalao continue. As permisses e direitos de usurio para o Windows Server 2003 e para o Windows 2000 Server so diferentes, porm os requisitos de software so equivalentes. Aps serem executadas as alteraes solicitadas clique no boto < Back e ento no boto Next > para a revalidao dos pr-requisitos.

Passo 14: Teste de conexo Internet Outra validao realizada o acesso ao site da Crivo ( http://www.crivo.com.br ); este acesso fundamental para a prorrogao peridica da licena de uso do servio.

Guia de instalao

81/107

Caso ocorra algum problema ser mostrada uma mensagem de erro:

Guia de instalao

82/107

Passo 15a: Configurando o IIS atravs do instalador Agora ser perguntado se se deseja configurar o IIS atravs do instalador:

Guia de instalao

83/107

O objetivo desta tela simplificar a criao e/ou configurao do web site do Crivo no IIS, epecialmente por usurios no habituados a isso. Valores default A tela tem valores default dependendo da situao, estes valores default so escolhidos de modo a no interferir com o funcionamento do Crivo (se j instalado) ou de outros sites. Os valores default dependem da situao do servidor: Se NO houver Crivo anteriormente instalado: Se J houver um site no virtual web server default (IIS://localhost/W3SVC/1/root):

Guia de instalao

84/107

Neste caso o instalador ir criar um virtual web server novo, para no interferir no funcionamento do web site default.

Guia de instalao

85/107

 Se NO houver um site no virtual web server default (IIS://localhost/W3SVC/1/root):

Guia de instalao

86/107

Neste caso o default ser o mesmo, de modo a no interferir no funcionamento de nenhum site j em funcionamento, mas o site sempre ser criado no web site default (IIS://localhost/W3SVC/1/root). Se J houver Crivo anteriormente instalado: E o Crivo estiver instalado em um virtual web server (IIS://localhost/W3SVC/nnnn/root)

Guia de instalao

87/107

O instalador vai escolher o site do Crivo anteriormente instalado como site de instalao (onde quer que ele se encontre):

Guia de instalao

88/107

 E o Crivo estiver instalado em um diretrio virtual de um virtual web server (IIS://localhost/W3SVC/nnnn/root/Crivo) e este diretrio virtual se chamar 'Crivo':

Guia de instalao

89/107

Neste caso o instalador vai escolher o site do Crivo anteriormente instalado e vai marcar a opo 'Criar diretrio virtual dentro do web site', de modo a instalar o web site do Crivo novamente no mesmo lugar.

Guia de instalao

90/107

 E o Crivo estiver instalado em um diretrio virtual de um virtual web server (IIS://localhost/W3SVC/nnnn/root/xxxx) e este diretrio virtual NO se chamar Crivo:

Guia de instalao

91/107

Este o caso de uma configurao do IIS que no pode ser criada com o instalador, ela apenas pode ser criada manualmente. Assim o instalador no toma como default o lugar onde o Crivo j est instalado (que seria impossvel de criar pelo instalador). O default neste caso no selecionar nenhum site, deixando o boto Next > desabilitado.

Guia de instalao

92/107

Passo 15b: Habilitao do boto 'Next >' Existem casos em que as escolhas do usurio para a configurao do web site do Crivo no podem ser permitidas. Isso far com que o boto Next > seja desabilitado de modo que o usurio no possa prosseguir sem mudar as opes. Estes casos so os seguintes: Se o combo 'Escolha o web site da mquina local onde instalar as pginas do Crivo' estiver habilitado e nenhuma opo estiver selecionada, s se poder prosseguir caso seja escolhido um web site existente ou seja selecionada a opo 'Criar novo web site'. Veja abaixo esta situao:

Guia de instalao

93/107

 Caso se tente instalar o Crivo em um diretrio virtual dentro de um web site onde j esteja instalado o Crivo. Isso uma situao extremamente patolgica, pois para que o Crivo funcione no pode haver dois web sites (em diretrio virtual ou no) apontando para ele, de modo que o web site do Crivo deveria ser removido, mas como se est querendo criar o diretrio virtual est dentro deste mesmo web site ele no pode ser removido. Se poderia argumentar que bastaria deixar o site vazio e criar o diretrio virtual, mas que sentido teria isso? S faz sentido ter diretrios virtuais quando se tem mais de uma aplicao no web site.

Guia de instalao

94/107

Passo 15c: Limitaes da configurao automtica do IIS Hoje este processo tem algumas limitaes, algumas intencionais e outras no. Se o Crivo for instalado em um diretrio virtual de um web site j existente ele criar o diretrio com o nome 'Crivo'. Isso proposital para facilitar a localizao do Crivo e para evitar que o usurio tenha de entrar o nome do diretrio virtual (o que permitiria usar nomes com caracteres complicados ou com espaos, o que causaria problemas). Os sites so sempre criados em todos os IPs, sem host header e na porta 80. No existe como escolher os server bindings. O instalador no testa conflito de server bindings, assim, se j houver um site naquele IP e porta ele apenas no ir subir, sem mensagem alguma. Os servios CTCentura e CTServer usam o web service do Crivo para atender a seus clientes. O instalador ainda no reconfigura estes servios de modo que eles sempre vo buscar o web service no web site default da mquina onde foi instalado o Crivo. Se o Crivo for configurado em outro lugar que no o web site default estes servios iro buscar a nova localizao automaticamente, mas apenas no momento da inicializao, ou seja eles tem de ser parados e reiniciados. Se feito pelo instalador isso acontece automaticamente pois estes servios so parados e iniciados, mas a configurao do 'web site se for feita manualmente isso tambm deve ser feito manualmente.

Guia de instalao

95/107

Passo 15d: Parada e remoo de sites Se o Crivo estava anteriormente instalado e com um web site (ou diretrio virtual de um web site) configurado para ele e na reconfigurao do Crivo esta localizao (que vem como valor default) for modificada, haver duas conseqncias: O web site anterior (onde o Crivo estava instalado anteriormente) ser parado no incio da instalao. No final da instalao ser removido este web site (ou diretrio virtual) de modo que no possa haver dois web site (ou diretrio virtual) apontados para o Crivo.

Passo 15e: Configurao manual do IIS Caso seja desejado, ou alguma das limitaes obrigue. Pode-se configurar o IIS manualmente, embora no recomendemos devido as suas sutilizas e o conhecimento exigido.

Importante Caso uma configurao manual se faa realmente necessria aconselhamos fazer uma automtica e depois mudar apenas o que for necessrio. Assim menos trabalhoso e menos sujeito a erros, principalmente se houver outras aplicaes no IIS. Por exemplo, instalador chega at a corrigir scriptmaps para o ASP.NET 2 caso seja necessrio (apenas para o ramo do metabase do Crivo para no afetar outras aplicaes). Coisa que facilmente pode passar despercebida numa instalao manual. Crie e configure manualmente um web site para o Crivo com as seguintes configuraes:

IIS 6.0

Home Directory Local path: local_de_instalao_do_Crivo\web\ Home Directory Read: True Home Directory Write: False Home Directory Directory browsing: False Home Directory Index this resource: False Home Directory Application settings Application pool: definido_em_ Home Directory Application settings Application name: Crivo Home Directory Configuration Options Enable session state: True Home Directory Configuration Options Session timeout: 60 Home Directory Configuration Options ASP script timeout: 900 Documents Enable default content page Crivo.aspx Directory Security Authentication and access control Edit Enable anonymous access: True Directory Security Authentication and access control Edit User name: IUSR_nomedoservidor

Guia de instalao

96/107

 Directory Security Authentication and access Basic authentication (password is sent in clear text): True Directory Security Integrated Windows authentication: True Em uma instalao em Windows 2000 Server, caso haja outras aplicaes .Net em produo na mesma mquina, o instalador permite que as alteraes no MACHINE.CONFIG sejam feitas manualmente aps a instalao do Crivo. A modificao do MACHINE.CONFIG feita com o programa aspnet_setreg.exe da seguinte maneira : 1. Inicie um Command Prompt. 2. Execute o comando: aspnet_setreg.exe -k:SOFTWARE\Crivo\Crivo\Identity -u:"DOMINIO\USUARIO" -p:"SENHA" (Substitua DOMINIO\USUARIO e SENHA pelos dados do usurio) 3. Modifique, no arquivo MACHINE.CONFIG, o trecho abaixo:

<processModel ... userName="registry:HKLM\SOFTWARE\Crivo\Crivo\Identity\ASPNET_SETREG,userName" password="registry:HKLM\SOFTWARE\Crivo\Crivo\Identity\ASPNET_SETREG,password" ... O programa aspenet_setreg ir cifrar os dados e armazen-los na chave do registry indicada no processo de criptografia e leitura no MACHINE.CONFIG. Para obteno do aspnet_setreg.exe, acesse o seguinte endereo:

http://download.microsoft.com/download/2/9/8/29829651-e0f0-412e-92d0-e79da46fd7a5/aspnet_setreg.exe

Se a opo for pelo modo "automtico", ser feito um backup do arquivo MACHINE.CONFIG. Recomendamos que o backup deste arquivo seja tambm feito quando optar pelo modo "manual".

Guia de instalao

97/107

Em um Windows Server 2003 no realizada nenhuma modificao no arquivo MACHINE.CONFIG, no sendo nem ao menos mostrado a opo de reconfigurao, como ocorre para o Default Web Site do IIS, devido ao recurso Application Pool. O Crivo utilizar para configurao do web site o W3SVC1, devendo este estar presente no Internet Information Services, esta configurao poder ser alterada aps o trmino da instalao do Crivo caso seja necessrio. Clique no boto Next > para continuar o processo de instalao.

Importante Durante a instalao o Crivo poder ser associado ao Default Web Site ou deslocado para um Virtual Directory, caso a segunda opo seja a escolhida, ser necessrio a criao dos arquivos DLLHost.exe.config dentro da pasta System32 e do ctserver.exe.config dentro da pasta ../crivo/web/bin especificando a nova localizao do site Crivo. Exemplo de configurao do arquivo DLLHost.exe.config: <configuration> <appSettings> <add key="URLCRIVO" value="http://localhost/Crivo/" /> </appSettings> </configuration> Aps isto dar "Shut down" via Component Services na aplicao CreditTalk Exemplo de configurao do arquivo ctserver.exe.config:

Guia de instalao

98/107

Acrescentar a linha abaixo no arquivo existente: <add key="URLCRIVO" value="http://localhost/Crivo/" /> Na ltima tela antes do incio da instalao sero mostradas informaes sobre o processo a ser realizado, havendo alguma discrepncia basta clicar no boto Back, caso contrrio clique no boto Finish para iniciar a instalao. As informaes mostradas: Caminho escolhido para a instalao. Banco de dados escolhido para as bases de dados Crivo e CrivoOpt. Usurio dos servios e de acesso autenticado ao banco quando Microsoft SQL Server 2000. Usurio do Application Pool em Windows 2003 Server. Verso e release a ser instalada. Tarefas adicionais a serem ou no realizadas. No Windows Server 2003 aparecer a caixa para a "Configurao do arquivo MACHINE.CONFIG" indicando que o mesmo no ser alterado. No Windows 2000 Server este item estar marcado, caso o usurio tenha delegado ao instalador as modificaes necessrias.

Passo 16: Finalizando a instalao Neste ponto ser exibido um resumo das escolhas efetuadas:

Guia de instalao

99/107

Agora a o boto Finish estar habilitado e ao ser apertado a instalao comear. At agora nada tinha foi alterado no servidor e apertar Cancel nada far. Aps apertar Finish a instalao vai comear. O processo de instalao apresenta uma barra de progresso crescente (da esquerda para direita).

Aps a concluso com sucesso ser mostrada a mensagem "Instalao concluda com sucesso". Caso aparea outra mensagem, entre em contato com o suporte da Crivo.

Passos da remoo
Importante O instalador usado para remover o Crivo deve ser o da mesma verso que o utilizado para instal-la. O instalador no verifica verses ao remover o Crivo Se voc tiver apenas o instalador da verso mais recente dever primeiro atualiz-la e s ento proceder a remoo.

Passo 1 Este passo da remoo do Crivo exatamente o mesmo que o Passo 1 da instalao/atualizao, pois o instalador s pergunta se ser feita a remoo no Passo 2 da instalao/atualizao (que dependendo da escolha se torna remoo).

Passo 2 Este passo da remoo do Crivo exatamente o mesmo que o Passo 2 da instalao/atualizao, pois neste passo que o instalador pergunta se ser feita a remoo. Neste ponto se for escolhida a opo Remover o Crivo e apertado o boto Next > ele prosseguira para o Passo 3

Guia de instalao

100/107

Passo 3 Neste passo pedida a confirmao da remoo pela seguinte tela:

Somente ao se selecionar a opo Sim, quero remover o Crivo que o boto Next > ser habilitado:

Guia de instalao

101/107

Ento, ao se apertar o boto Next > se vai incondicionalmente para o Passo 4.

Passo 4 Neste passo so mostrados todos os adicionais instalados. Esta uma tela apenas informativa, j que todos os adicionais vm marcados para a remoo e desabilitados de modo a no poderem ser desmarcados.

Guia de instalao

102/107

Ao se apertar Next > se vai incondicionalmente para o Passo 5.

Passo 5 Neste passo mostrado apenas uma mensagem avisando do comeo da remoo e pedindo para prosseguir, pois at aqui nenhuma alterao foi feita e ao apertar o boto Finish a remoo comear:

Guia de instalao

103/107

Basta apertar o boto Finish e o instalador ir para o Passo 6.

Passo 6 Aqui comea a remoo propriamente dita:

A barra de progresso ir regredir em vez de avanar indicando o progresso da remoo. Aguarde o seu trmino quando ento ser mostrada a mensagem:

Guia de instalao

104/107

Neste ponto o Crivo foi removido. Lembre-se que a base de dados no foi tocada neste processo permitindo a instalao em outro servidor.

Logs de instalao
No processo de instalao, atualizao ou remoo, gerado um log de instalao em duas localizaes possveis: O Log da instalao bem-sucedida criado no diretrio onde o Crivo foi instalado. Caso o instalador tenha um erro fatal antes do momento em que ele cria o diretrio de instalao do Crivo o arquivo de log criado em um subdiretrio Crivo dentro do diretrio Temp do perfil do usurio (na varivel de ambiente %TEMP% ou %TMP%, normalmente algo do tipo C:\Documents and Settings\<usurio>\Local Settings\Temp\Crivo\), no mesmo formato de nome de arquivo. O diretrio Temp usado pois o nico que se pode garantir que o usurio tenha permisso de escrita, e o erro pode ter sido exatamente este. O mesmo feito no caso de uma desinstalao, pois como o diretrio de instalao do Crivo removido, no haveria onde colocar os logs. gerado um arquivo para cada instalao, atualizao ou desinstalao, com um nome no formato: setupAAAAMMDDhhmmss.log (onde AAAAMMDDhhmms representam o ano, ms, dia, hora, minuto e segundo em que o arquivo foi criado). Estes arquivos podem ser solicitados pelo suporte tcnico da Crivo para anlise de problemas.

Histrico de alteraes do manual

Verso 1.05
Alterao das referncias cruzadas dos nomes de sees como links de modo a facilitar a navegao no documento. Incluso da seo Passos da remoo Atualizao da informao sobre o comportamento de achar automaticamente a localizao do Crivo no web server pelos servios CTServer e o CTCentura na seo Limitaes da configurao automtica do IIS. Agora os servios procuram a localizao do Crivo no web server automaticamente na sua inicializao. Mudana do nome da subseo Microsoft SQL Server na seo Criao das bases de dados para Criao das bases de dados no Microsoft SQL Server Mudana do nome da subseo Oracle na seo Criao das bases de dados para Criao das bases de dados no Oracle

Guia de instalao

105/107

 Mudana do nome da seo Configurao do cliente de acesso s bases de dados para Configurao do acesso s bases de dados Mudana do nome da subseo Microsoft SQL Server na seo Configurao do acesso s bases de dados para Configurao do acesso s bases de dados no Microsoft SQL Server Mudana do nome da subseo Oracle na seo Configurao do acesso s bases de dados para Configurao do acesso s bases de dados no Oracle Separao da seo Histrico de alteraes do manual em subsees

Verso 1.04
Diviso da seo Passos da instalao em subsees por passo de modo a facilitar explicao do fluxo dos passos para cada caso possvel. Correo de algumas imagens na seo Passos da instalao. Incluso na seo Passos da instalao das telas referentes as senhas da base Oracle. Incluso na seo Passos da instalao da subseo Passo 11: Configurao do servidor LDAP Incluso na seo Passos da instalao de mais telas mostrando vrias situaes de erro comuns.

Verso 1.03
Corrigindo parmetro de linha de comando do programa haspdinst.exe de -i ou -info para '-info' (pois -i se refere a install e no a info na seo Instalando o HASP Run-time Corrigindo o endereo para baixar o HASPUserSetup.exe.

Verso 1.02
Adicionando um aviso Importante na seo Criao das bases de dados - Oracle Correo da verso do nmero do manual na seo Histrico de alteraes do manual de 1.0 para 1.01 Alterando tamanho de algumas imagens na seo Permisses e direitos

Verso 1.01
Mudana de ttulo do guia para: Guia de instalao do Crivo Insero de nmero de verso do Guia de instalao do Crivo Agrupamento em um mesmo local de tpicos tratando de assuntos correlatos Remoo de redundncias e procedimentos repetidos Atualizao de imagens do instalador Maior detalhamento dos pr-requisitos Informaes sobre instalaes em edies 64-bit do Windows Insero da seo Histrico de alteraes do manual Descrio da instalao do cliente Oracle Insero do pr-requisito Hasp SRM run-time como opo ao Aladdin HASP HL Device Driver 5.22 Insero da descrio do procedimento de instalao do Hasp SRM run-time Descrio da instalao de um servidor de licenas da chave HASP Remoo do pr-requisito Visual J# redistributable Remoo da descrio do procedimento de instalao do Visual J# redistributable Insero de seo Mquinas client para uso do Crivo por browser.

Guia de instalao

106/107

 Insero de seo Mquinas client para uso do Crivo pelo Administrador do Crivo Insero da seo Configurando o IIS atravs do instalador Alterao das informaes sobre logs de instalao

Guia de instalao

107/107