PROCEDIMENTOExecutor: Derney Grotti RamosData: 23/10/2013Sistema: SARPRVersão:

Instalação SARPR

1. WEBSERVER1.1. Pré-Requisitos da instalação

Computador com Windows XP, ou superior. Preferência por Windows Server 2003 R2 ou superior. (Windows XP, 7 e 8 são consideradas versões desktop e possuem limitação de 10 conexões simultâneas no IIS)

Internet Information Service (IIS) 6.0, ou superior; Framework .Net 2.0 ou superior; Driver ODBC do DBF (VFPOdbc); Liberação de acesso externo (DNS/Firewall/Hospedagem) Liberação do modulo SARPR no SARWIN; Pasta do SARPR;

o PASTA BIN SARPRWS.dll SARPRWS.dll.config SARPRWS.pdb

o default.aspo default.htmo SARPR.asmxo Web.config

T1.2. Matriz de Responsabilidade

Evento Responsável

Aquisição do Computador/Servidor Cliente

Aquisição, instalação e atualização do Sistema Operacional Cliente

Instalação do IIS Cliente

Configuração do DNS/Firewall + Definição de porta TCP do site Cliente

Instalação/Atualização do .NET Framework Cliente

Instalação e configuração do VFPODBC HKNOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 1 de 22

PROCEDIMENTO

Configuração do IIS (SITE) HK

Direitos de acesso à pasta DBFS e SARPR Cliente

Configuração do WEB.CONFIG HK

Testes de instalação SARPR HK

Liberação de conexão remota Terminal Service/Team Viewer – (Usado para configuração do IIS e testes de funcionamento da aplicação)

Cliente

1.3. Procedimento de instalação1.3.1. Criar pasta no inetpub

Criar uma pasta chamada SARPR no endereço C:\inetpub\wwwroot do servidor e copiar os arquivos do programa para esse local. (Ver lista acima, nos pré-requisitos)

1.3.2. Instalar Driver ODBC - VFPODBC

Instalar VFPODBC – Driver ODBC dos dbfs do VisualFoxpro.

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 2 de 22

PROCEDIMENTO

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 3 de 22

PROCEDIMENTO

Abrir o arquivo odbcad32.exe.

Se a máquina for 64 Bits esse arquivo estará no endereço C:\Windows\SysWOW64. (se a máquina for 64 Bits não dá pra usar o atalho que fica no painel de controle).

Se a máquina for 32 Bits esse arquivo estará no endereço C:\Windows\System32

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 4 de 22

PROCEDIMENTO

Selecionar a aba DSN de Sistema e clicar em Adicionar.

Selecionar o driver Microsoft Visual FoxPro Driver e clicar em Concluir.

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 5 de 22

PROCEDIMENTO

Digitar o Data Source Name como SARWIN, selecionar o Database type como Free Table directory e clicar em OK.

Será adicionada uma nova linha na lista de fontes de dados do sistema com o nome SARWIN.

1.3.3. Instalar IIS (Esse procedimento pode ser diferente de acordo com a versão do Windows)Abrir o Painel de Controle e clicar na opção Programas e Recursos.

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 6 de 22

PROCEDIMENTO

Clicar na opção Ativar ou desativar recursos do Windows

Selecionar os recursos .Net Framework 3.5 e Serviços de Informações da Internet (IIS).

O IIS possui configurações de ativação ASP que não são selecionadas por padrão. Será necessário fazer isso manualmente clicando em Serviços de Informações da Internet >> Serviços World Wide Web >> Recursos de Desenvolvimento de Aplicativos >> ASP, ASP.NET 3.5, ASP.NET 4.5, CGI, Extensibilidade .NET 3.5, Extensibilidade .NET 4.5.

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 7 de 22

PROCEDIMENTO

1.3.4. Configurar IIS 8 (Varia de acordo com a versão)

Abrir o Gerenciador do IIS.

Verificar versão do .Net que está rodando padrão no IIS

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 8 de 22

PROCEDIMENTO

Selecionar versão 2.0, ou superior. É preferível que seja usado a última versão.

Clicar com o botão direito no nome do servidor e selecionar a opção Adicionar Site...

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 9 de 22

PROCEDIMENTO

Configurar o novo site com as seguintes informações.

Nome do site: SARPR Pool de aplicação: SARPR Caminho físico: C:\inetpub\wwwroot\SARPR (pode ser outro endereço se o

usuário solicitar) Tipo: http Endereço IP: Todos os Não Atribuídos Porta: (Padrão 80, mas deve ser definida pelo usuário.) Nome do host: (definido pelo usuário. Ex. www.sarpr.com.br)

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 10 de 22

PROCEDIMENTOUm novo site será criado com o Nome SARPR e será listado no lado esquerdo da tela.

Configurar Pool de Aplicação SARPR para trabalhar em 32 bits.

Acessar as configurações Avançadas do pool SARPR.

Modificar o parâmetro Habilitar Aplicativos de 32 Bits para “True”

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 11 de 22

PROCEDIMENTO

Complemento de configurações (15/12/2015)

Deve definir o Usuário em “Identify”:

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 12 de 22

PROCEDIMENTO

Usuário e Senha que tenha acesso a base de dados do Sarwin “principalmente se a base de dados estiverem alocado em outro servidor”.

Configurar arquivo web.config

Todas as configurações do arquivo “web.config” serão feitas na sessão <appSettings> da seguinte forma:

Key Valor

SARWINSó deve ser alterado o parâmetro SourceDB com o

endereço do dbfs do sarwin. Ex. “D:\srvhk06\dados\SARWIN\dbfs”

Empresa Código SAREMPRE

Debug 1 = Testes, 0 = funcionamento normal do sistema

DateTimeData hora usada no modo debug. Não utilizado

quando o debug estiver configurado com 0

GravaLog 1= ativado, 0=desativado

LocalLog Endereço do arquivo onde será salvo o log do sistema

TrataSincAparelho Ver com o Paulo

TrataOffLine 1= ativado, 0=desativado

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 13 de 22

PROCEDIMENTO

1.4. Testes da Instalação1.4.1. Teste 1 – testar o IIS

Testar o IIS indo a um Browser no próprio servidor e digitando “localhost” no campo de endereço do site.

1.4.2. Teste 2 – testar site SARPR com páginas html

Testar site SARPR com páginas html digitando no campo de endereço do browser “localhost:[porta escolhida na criação do site]/default.htm”. Ex. localhost:8081/default.htm.

O browser apresentará uma página de testes do SARPR2.

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 14 de 22

PROCEDIMENTO

1.4.3. Teste 3 – testar site SARPR com páginas asp

Testar site SARPR com páginas ASP digitando no campo de endereço do browser “localhost:[porta escolhida na criação do site]/default.asp”. Ex. localhost:8081/default.asp.

O browser apresentará uma página de testes ASP do SARPR2.

1.4.4. Teste 4 – testar aplicação SARPR.asmx

Testar aplicação SARPR.asmx digitando no campo de endereço do browser “localhost:[porta escolhida na criação do site]/sarpr.asmx”. Ex. localhost:8081/ sarpr.asmx.

O browser apresentará a página inicial do SARPR.

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 15 de 22

PROCEDIMENTO1.4.5. Teste 5 – Marcação de ponto de entrada

Entrar na tela de marcação de ponto de entrada e simular a batida de um funcionário do sistema.

Esse procedimento deve retornar uma página com um arquivo XML com o código de resposta do webservice (no Ex. abaixo o código retornado foi 100, que significa Código Empresa Inválida. Tente Novamente).

1.5. Tratamento de Erros1.5.1. Não foi possível carregar arquivo ou assembly 'Borland.dbkasp

Ao rodar o sarpr.asmx o browser apresenta a seguinte mensagem de erro: “Não foi possível carregar arquivo ou assembly 'Borland.dbkasp, Version=10.5.0.0, Culture=neutral, PublicKeyToken=b0524c541232aae7' ou uma de suas dependências. O sistema não pode encontrar o arquivo especificado.”

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 16 de 22

PROCEDIMENTO

Para tratar esse erro será necessário tirar o módulo Borland.dbkasp do arquivo web.config.

Excluir as seguintes linhas do web.config.

<modules>

<add name="DbgConnect" type="Borland.DbkAsp.DbkConnModule,Borland.dbkasp,Version=10.5.0.0,&#xD;&#xA; Culture=neutral, PublicKeyToken=b0524c541232aae7" preCondition="managedHandler" />

</modules>

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 17 de 22

PROCEDIMENTO1.5.2. Erro ao simular ponto de entrada ( ;is not a valid date and time)

Ao fazer o teste de batida de ponto direto na página WEB do SARPR o sistema pode retornar o seguinte erro:

Borland.Delphi.EConvertError: &#39;11/13/2012 07:00&#39; is not a valid date and time em Borland.Vcl.Units.SysUtils.StrToDateTime(String S)em SARPR.TSARPRWS..ctor() na C:\projetos\SARPR\trunk\WebService\SARPR.pas:linha 909

Esse erro acontece porque o web serviçe está configurado com os seguintes parâmetros:

Debug = 1 significa que o SARPR está com o modo debug ativado. Esse modo é utilizado para que o suporte e o desenvolvimento efetue testes usando uma data diferente da data do computador.

DateTime é a variável onde é configurada a data que será usada nos testes.

O Erro está acontecendo porque meu computador está com a data em português e o meu web.config está configurado com uma data no formato americano. “11/13/2012”

1.5.3. Erro ao simular ponto de entrada (Nome da fonte de dados não encontrada ou nenhum driver especificado)

Ao fazer o teste de batida de ponto direto na página WEB do SARPR o sistema pode retornar o seguinte erro:

System.Data.Odbc.OdbcException: ERROR [IM002] [Microsoft][ODBC Driver Manager] Nome da fonte de dados n&#227;o encontrado e nenhum driver padr&#227;o especificado em System.Data.Odbc.OdbcConnection.HandleError(OdbcHandle hrHandle, RetCode retcode)em System.Data.Odbc.OdbcConnectionHandle..ctor(OdbcConnection connection, OdbcConnectionString constr, OdbcEnvironmentHandle environmentHandle)em System.Data.Odbc.OdbcConnectionOpen..ctor(OdbcConnection outerConnection, OdbcConnectionString connectionOptions) em System.Data.Odbc.OdbcConnectionFactory.CreateConnection(DbConnectionOptions options, DbConnectionPoolKey poolKey, Object poolGroupProviderInfo, DbConnectionPool pool, DbConnection owningObject) em System.Data.ProviderBase.DbConnectionFactory.CreateConnection(DbConnectionOptions options, DbConnectionPoolKey poolKey, Object

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 18 de 22

Key Valor

Debug 1

DateTime

"11/13/2012 07:00"

PROCEDIMENTOpoolGroupProviderInfo, DbConnectionPool pool, DbConnection owningConnection, DbConnectionOptions userOptions) em System.Data.ProviderBase.DbConnectionFactory.CreateNonPooledConnection(DbConnection owningConnection, DbConnectionPoolGroup poolGroup, DbConnectionOptions userOptions) em System.Data.ProviderBase.DbConnectionFactory.TryGetConnection(DbConnection owningConnection, TaskCompletionSource`1 retry, DbConnectionOptions userOptions, DbConnectionInternal& connection) em System.Data.ProviderBase.DbConnectionClosed.TryOpenConnection(DbConnection outerConnection, DbConnectionFactory connectionFactory, TaskCompletionSource`1 retry, DbConnectionOptions userOptions)em System.Data.ProviderBase.DbConnectionInternal.OpenConnection(DbConnection outerConnection, DbConnectionFactory connectionFactory)em System.Data.Odbc.OdbcConnection.Open() em UConexao.TConexao.Processa() na C:\projetos\SARPR\trunk\WebService\UConexao.pas:linha 295 em UConexao.TConexaoRE.Processa() na C:\projetos\SARPR\trunk\WebService\UConexao.pas:linha 372 em UConexao.TConfPonto.Processa() na C:\projetos\SARPR\trunk\WebService\UConexao.pas:linha 1051 em uPontoEntrada.TPontoEntrada.Processa() na C:\projetos\SARPR\trunk\WebService\uPontoEntrada.pas:linha 262 em SARPR.TSARPRWS.PontoEntrada(String UID, String ID_APARELHO, String TIPOMARCACAO, String EMPRESA, String RE, String SENHA) na C:\projetos\SARPR\trunk\WebService\SARPR.pas:linha 521

Esse erro acontece porque o caminho do DBFS está errado ou sem direito. Ao acertar o caminho do DBFS na variável SARWIN do WEB.CONFIG.

Esse erro pode acontecer também por falta do driver ODBC. Para corrigir isso será necessário instalar o Driver VFPODBC e criar um DSN com o nome SARWIN. (Ver procedimento de instalação, item 1.2 desse manual).

Uma terceira hipótese é que o Pool de Aplicação SARPR não esteja configurado para trabalhar como 32 Bits (Ver procedimento de instalação, item 1.2 desse manual).

1.5.4. Erro ao simular ponto de entrada (não foi possível localizar uma parte do caminho c:\inetpub\sarpr\log.txt)

Ao fazer o teste de batida de ponto direto na página WEB do SARPR o sistema pode retornar o seguinte erro:

System.IO.DirectoryNotFoundException: N&#227;o foi poss&#237;vel localizar uma parte do caminho &#39;C:\Inetpub\wwwroot\SARPR\log.txt&#39;. em System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath) em System.IO.FileStream.Init(String path, FileMode mode, FileAccess access, Int32 rights, Boolean useRights, FileShare share, Int32 bufferSize, FileOptions options, SECURITY_ATTRIBUTES secAttrs, String msgPath, Boolean bFromProxy, Boolean useLongPath, Boolean checkHost) em System.IO.FileStream..ctor(String path, FileMode mode, FileAccess access, FileShare share, Int32 bufferSize, FileOptions options, String msgPath, Boolean bFromProxy, Boolean useLongPath, Boolean checkHost) em System.IO.StreamWriter.CreateFile(String path, Boolean append, Boolean checkHost) em System.IO.StreamWriter..ctor(String path, Boolean append, Encoding encoding, Int32 bufferSize, Boolean checkHost) em System.IO.StreamWriter..ctor(String path, Boolean append) em Borland.Delphi.TDefaultTextFactory$System.Open(Text t, UInt16 Mode) em Borland.Delphi.Units.System.OpenText(Text t, UInt16 Mode) em UGravaLog.TLog.AbrirArquivo() na C:\projetos\SARPR\trunk\WebService\UGravaLog.pas:linha 43 em UGravaLog.TLog.Reg(String Texto) na C:\projetos\SARPR\trunk\WebService\UGravaLog.pas:linha 71 em SARPR.TSARPRWS.PontoEntrada(String UID, String ID_APARELHO, String TIPOMARCACAO, String EMPRESA, String RE, String SENHA) na C:\projetos\SARPR\trunk\WebService\SARPR.pas:linha 529

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 19 de 22

PROCEDIMENTOEsse erro acontece porque não existe o arquivo de log especificado no WEB.CONFIG. No caso do exemplo é só criar um arquivo LOG.TXT no endereço C:\Inetpub\wwwroot\SARPR\ ou acertar a variável LocalLog do arquivo WEB.CONFIG para o local onde o arquivo de log foi salvo ou modificar a variável GravaLog do arquivo WEB.CONFIG para 0, pois esse erro só acontece se o WEB.CONFIG estiver com a variável GravaLog estiver com o valor = 1, ou seja, se o sistema estiver com a configuração de gravação de log ativada.

1.5.5. Erro ao simular ponto de entrada (não foi possível localizar uma parte do caminho c:\inetpub\sarpr\log.txt)

Ao fazer o teste de batida de ponto direto na página WEB do SARPR o sistema pode retornar o seguinte erro:

System.UnauthorizedAccessException: O acesso ao caminho &#39;C:\inetpub\wwwroot\SARPR&#39; foi negado. em System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath) em System.IO.FileStream.Init(String path, FileMode mode, FileAccess access, Int32 rights, Boolean useRights, FileShare share, Int32 bufferSize, FileOptions options, SECURITY_ATTRIBUTES secAttrs, String msgPath, Boolean bFromProxy, Boolean useLongPath, Boolean checkHost)em System.IO.FileStream..ctor(String path, FileMode mode, FileAccess access, FileShare share, Int32 bufferSize, FileOptions options, String msgPath, Boolean bFromProxy, Boolean useLongPath, Boolean checkHost) em System.IO.StreamWriter.CreateFile(String path, Boolean append, Boolean checkHost) em System.IO.StreamWriter..ctor(String path, Boolean append, Encoding encoding, Int32 bufferSize, Boolean checkHost) em System.IO.StreamWriter..ctor(String path, Boolean append)em Borland.Delphi.TDefaultTextFactory$System.Open(Text t, UInt16 Mode)em Borland.Delphi.Units.System.OpenText(Text t, UInt16 Mode)em UGravaLog.TLog.AbrirArquivo() na C:\projetos\SARPR\trunk\WebService\UGravaLog.pas:linha 43 em UGravaLog.TLog.Reg(String Texto) na C:\projetos\SARPR\trunk\WebService\UGravaLog.pas:linha 71 em SARPR.TSARPRWS.PontoEntrada(String UID, String ID_APARELHO, String TIPOMARCACAO, String EMPRESA, String RE, String SENHA) na C:\projetos\SARPR\trunk\WebService\SARPR.pas:linha 529

1.6. Tabela de Códigos de Retorno do Web Service

Código Titulo Mensagem

100 Mensagem Erro Código Empresa Inválido: Tente Novamente

101 Mensagem Erro Código RE Inválido: Tente Novamente

102 Mensagem Erro Erro Alocação: Entrar Contato Base

103 Mensagem Erro Erro Situação: Entrar Contato Base

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 20 de 22

PROCEDIMENTO

104 Mensagem Erro Erro Escala: Entrar Contato Base

105 Mensagem Erro Erro Marcação: Escolher Nova Opção Ponto

106 Mensagem Erro Refazer Marcação Após: HH:MM

107 Mensagem Erro Ponto Bloqueado: Confirmar Marcação Base

108 Mensagem Erro Ponto Bloqueado:Local Sem Intervalo Almoço

109 Mensagem Erro Erro RE Cobertura: Entrar Contato Base

110 Mensagem Erro Erro RE Efetivo: Entrar Contato Base

111 Mensagem Erro Erro Alocação Cobertura: Entrar Contato Base

112 Mensagem Erro Erro: Sistema Desatualizado

113 Mensagem Erro Erro: Funcionário Cobertura

200 Mensagem Confirmação Ponto Registrado: HH:MM

201 Mensagem Confirmação Ponto Registrado (Extra): HH:MM

202 Mensagem Confirmação Ponto Registrado (Atraso): HH:MM

203 Mensagem Confirmação Ponto Registrado: HH:MM Retorno HH:MM

204 Mensagem Confirmação Ponto Registrado HH:MM Saída HH:MM

206 Mensagem Confirmação Cobertura Confirmada

207 Mensagem Confirmação Emergência Confirmada

208 Mensagem Confirmação Digital Registrada BD

209 Mensagem Confirmação Pronto Atendimento Registrado

300 Hora Extra (MENU)

400 Saída Antecipada (MENU)

800 Mensagem Confirmação Digital Cadastrada com sucesso

998 Mensagem Erro Erro WS: Tente Novamente

999 Somente retorno de conexão

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 21 de 22

PROCEDIMENTOoffline

NOTA: Esta informação é CONFIDENCIAL e deve ser utilizada exclusivamente para a operação de programas as HK ENGENHARIA. É expressamente proibida sua cópia, reprodução e publicação sem a autorização do mesmo.

Página 22 de 22