transferencia.grupohk.com.brtransferencia.grupohk.com.br/sarpr/procedimento de inst… · web...
TRANSCRIPT
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,
 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: '11/13/2012 07:00' 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ão encontrado e nenhum driver padrã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ão foi possível localizar uma parte do caminho 'C:\Inetpub\wwwroot\SARPR\log.txt'. 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 'C:\inetpub\wwwroot\SARPR' 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