Treinamento de Infraestrutura para Implantadores.

Siglas utilizadas............................................................................................................................3

Event Viewer................................................................................................................................3

Listar Processos em execução......................................................................................................7

Task Manager...........................................................................................................................7

QPROCESS................................................................................................................................9

Process Explorer...........................................................................................................................9

Process Monitor.........................................................................................................................13

IIS...............................................................................................................................................20

Instalando o IIS.......................................................................................................................20

Application Pool.....................................................................................................................26

Sites........................................................................................................................................29

Services......................................................................................................................................30

Performance Monitor................................................................................................................32

DrLockAPI.DLL............................................................................................................................35

Registry ou Registro do Windows..............................................................................................38

Aplicações da ATTPS...............................................................................................................38

Oracle.....................................................................................................................................40

Run As Administrator.................................................................................................................42

Windows 2003.......................................................................................................................42

Windows 2008 e 2012............................................................................................................43

Client Oracle...............................................................................................................................43

DLLs do PowerBuilder................................................................................................................43

Siglas utilizadas -> Tecla Windows do teclado

Event ViewerO event viewer é um componente do Windows para visualizar logs gerados pelo Windows ou por aplicativos na máquina local ou em máquinas remotas.

Para acessá-lo deve-se executar o seguinte comando: eventvwr.msc

Exemplo: + R + eventvwr.msc

Na instalação dos produtos da ATTPS sempre é solicitada a criação de uma pasta para armazenamentos dos logs das nossas aplicações, sejam serviços, web ou relatórios.Windows 2003Esta pasta pode ser encontrada logo abaixo da pasta raiz:

Windows 2008 ou 2012 Esta pasta está localizada sob a pasta Applications and Services Logs:

Nesta pasta são gravadas exclusivamente informações das aplicações da ATTPS.Quando um problema ocorrer no ambiente do cliente deve-se exportar TODO o conteúdo desta pasta para que o produto ou a GTA possam analisar estar informações, para isso faça os seguintes passos:Windows 2003Clique com o botão direito sobre a pasta da Att e selecione “Save Log File As...”

Na janela que se segue escolha um local e dê um nome para o arquivo que será salvo.

O arquivo .evt gerado deve ser enviado para a equipe responsável para que o mesmo possa ser analisado.

Windows 2008 ou 2012Clique com o botão direito sobre a pasta da Att e selecione “Save Events As...”

Na janela que se segue escolha um local e dê um nome para o arquivo que será salvo.

O arquivo .evtx gerado deve ser enviado para a equipe responsável para que o mesmo possa ser analisado.

Obs: Em alguns casos específicos, erros do Crystal ou do .NET Framework, pode ser necessário o envio do log Application do Windows, este log encontra-se abaixo da pasta raiz do Windows 2003, para o Windows 2008 ele encontra-se abaixo da pasta “Windows Logs”.

O processo de salvar esta pasta é o mesmo da pasta Att.

Listar Processos em execuçãoMuitas vezes será necessário listar os processos em execução no Windows, como forma de verificar se determinado serviço está em execução para isso existem diversas formas, mostraremos duas delas.

Task ManagerA primeira forma é via Task Manager, para abri-lo pressione as seguinte teclas juntas:

Ctrl + Shift + Esc

Windows 2003 ou 2008Selecione a aba Processes

Caso estejam sendo listados somente os processos do usuário logado e do SYSTEM, marque o select box “Show processes from all users” que encontra-se abaixo da lista dos processos.

Algumas vezes será necessário listar outras colunas dos processos, para isso selecione no menu a opção View -> Select Columns...

Na janela que se segue selecione as colunas desejadas, por padrão sempre marque as colunas PID, CPU Usage, Memory Usage ou Memory - Private Working Set, User Name e quando disponível Command Line.

Windows 2012Selecione a aba Details

Algumas vezes será necessário listar outras colunas dos processos, para isso clique com o botão direito sobre a barra de título e selecione a opção Select columns.

Na janela que se segue selecione as colunas desejadas, por padrão sempre marque as colunas PID, CPU Usage, Memory (private working set), User Name e Command Line.

O Task Manager não permite que estes dados sejam exportados para um arquivo, sendo assim caso necessário envie para a equipe responsável printscreens desta janela.

QPROCESSUma outra forma de listar os processos em execução é com o utilitário de linha de comando qprocess para executa-lo abra u utilitário de linha de comando do Windows

+ R + cmd

Na linha de comando digite o comando:Qprocess * > %temp%\processos.txt

O arquivo processos.txt será criado na pasta %temp%. Para abrir esta pasta execute o comando %temp%.

+ R + %temp%

Será aberta a pasta temporária do usuário logado, nela encontra-se o arquivo processos.txt, envie este arquivo para a equipe responsável analisar.

Process ExplorerO Process Explorer é uma ferramenta disponibilizada pela Microsoft para exibir informações detalhadas a respeito dos processos em execução na máquina, ele faz parte do pacote de utilitários SysInternals.Baixe o Process Explorer diretamente do site da Microsoft: http://download.sysinternals.com/files/ProcessExplorer.zip

Após o download descompacte o zip em uma pasta e abra o executável procexp.exe.

Ao abrir o Process Explorer pela primeira vez será exibida a janela abaixo:

Basta clicar no botão Agree para abrir a aplicação.

Geralmente utilizamos o Process Explorer para visualizar as DLLs carregadas por determinada aplicação. Neste documento exemplificaremos utilizando o PowerBuilder.

Dentro do Process Explorer selecione a aplicação desejada, no nosso caso Pb100.exe

Pressione Ctrl + D dentro do Process Explorer, e serão exibidas as DLLs carregadas pela aplicação na parte debaixo da janela, clique na coluna “Company Name” para ordenar por esta coluna.

Para exportar estas informações pressione Ctrl + A dentro do Process Explorer e escolha um local para salvar o arquivo txt indicado.

Após salvar o arquivo feche o Process Explorer e envie este arquivo para a equipe responsável analisar.

Process MonitorO Process Monitor é uma ferramenta disponibilizada pela Microsoft para monitorar detalhadamente todos os processos em execução na máquina, ele também faz parte do pacote de utilitários SysInternals.Baixe o Process Monitor diretamente do site da Microsoft: http://download.sysinternals.com/files/ProcessMonitor.zip

Após o download descompacte o zip em uma pasta e abra o executável Procmon.exe.

Ao abrir o Process Monitor pela primeira vez será exibida a janela abaixo:

Basta clicar no botão Agree para abrir a aplicação.

Após a abertura o Process Monitor captura tudo que estiver acontecendo na máquina, seja com relação a disco, registro do Windows ou rede.

Para abrir a janela de filtro pressione Ctrl + L.

Para filtrarmos por determinada aplicação precisamos saber o nome do executável dele.No primeiro selectbox escolha “Process Name”, no terceiro campo (um combobox) selecione a aplicação que vc deseja monitorar, no nosso exemplo utilizaremos o serviço de relatório (BNTCpsSerGerRel.exe) e clique em OK e depois em Yes.

O filtro será aplicado e serão exibidas todas as atividades da aplicação no computador DESDE A ABERTURA DO PROCESS MONITOR.

Para exibirmos mais colunas devemos clicar com o botão direito no título de qualquer coluna e selecionarmos a opção “Select Columns...”

Selecione as colunas de acordo com o print abaixo:

Para exportar as informações exibidas pressione Ctrl + S.Selecione um local pra salvar o arquivo clicando no botão “...”.

Envie o arquivo LogFile.PML gerado para a equipe responsável analisar.

IISInstalando o IISWindows 2008• Abra o Server Manager (Start -> Administrative Tools -> Server Manager) e selecione a opção

Roles no canto esquerdo da tela. Serão apresentadas as listas de papéis assumidos pelo servidor. Para adicionar um novo papel, deve-se clicar em Add Roles;

• A tela de instruções é apresentada, clique em Next.

• Em seguida, deve-se selecionar o(s) papel(is) que serão associados ao servidor. Como nosso objetivo é adicionar o IIS, deve-se selecionar Web Server (IIS).

• A tela de confirmação será apresentada. Ela contém a lista de funcionalidades que precisam ser ativadas por papel que está sendo adicionado ao servidor. Clique em Add Required Features para que essas funcionalidades sejam ativadas e o papel atribuído ao servidor.

• A tela com o papel selecionado anteriormente será apresentada, clique em Next.

• Os próximos passos permitirão configurar o IIS no servidor. A tela de instruções é apresentada. Clique em Next.

• É necessário definir quais funcionalidades estarão disponíveis no IIS do servidor. Para as configurações básicas, selecione as opções presentes na lista abaixo e em seguida, clique em Next. Para cada funcionalidade selecionada será apresentado uma tela de confirmação, semelhante à apresentada no passo 5.

Common HTTP Features

• Static Content• Default Document• Directory Browsing• HTTP Errors

Application Development• ASP .Net• .Net Extensibility

Security• Basic Authentication• Windows Authentication• Request Filtering

Performance• Static Content Compression

Management Tools• IIS Management Consol• IIS Management Scripts and Tools

• A tela de resumo será apresentada. Clique em Install para que a instalação e configuração do IIS sejam executadas.

• A tela de progresso é exibida. Aguarde a conclusão do processo de instalação e configuração dos recursos.

• Após a conclusão da instalação a tela de resumo dos recursos instalados e erros encontrados é apresentada. Clique em Finish e retorne ao Server Manager.

• O Server Manager passa a listar o papel de servidor WEB. O processo de instalação está concluído e o Server Manager pode ser fechado.

• O atalho para abrir o console de gerenciamento do IIS pode ser encontrado em: Start Administrative Tools Internet Information Services (IIS) Manager.

Application PoolO Application Pool define a forma como uma aplicação asp.net funcionará, dentro dele podemos configurar: versão do Framework, modo de integração ou se a aplicação web rodará como 32bit.Por padrão cada aplicação desenvolvida na AttPS deve ter um Application Pool exclusivo, isso evita que no caso de uma aplicação travar todas as aplicações no mesmo Application Pool travem junto.

Windows 2008 e 2012• Através do IIS, expanda a pasta do servidor e clique com o botão direito em Application Pools.

Escolha “Add Application Pool”;

• Na tela que é aberta, informe um nome para o App Pool, o seu .Net Framework version e o Pipeline mode. Ao final clique em OK;

• Na tela do IIS, selecione o App Pool criado e clique em “Advanced Settings”;

• Todas os Application Pools devem ser executados com a opção “Managed Pipeline Mode” setada para Classic e a opção “Enable 32-bit Applications” (quando disponível) setada para True.

SitesWindows 2008 e 2012• Dentro do IIS expanda a pasta do servidor, a pasta Sites e finalmente a Default Web Site. Clique

com o botão direito em Default Web Site e escolha “Add Application”;

• Na tela que se abre informe o Alias, o Application Pool, para criar um Application Pool veja o Apendice II, e o caminho físico do site;

• Para abrir/navegar um site através do IIS, basta selecionar o site e escolher “Browse”. Ele será aberto através do Internet Explorer ou navegador default;

ServicesO Services é um componente do Windows para visualizar/gerenciar os serviços que estão executando no Windows na máquina local ou em máquinas remotas.

Para acessá-lo deve-se executar o seguinte comando: services.msc

Exemplo: + R + services.msc

Existem algumas aplicações da AttPS (Gerenciador de ConnPool, Relatório, Envio de Email e Gerenciador de Fila) que são instaladas como serviços do Windows, para iniciar, parar, reiniciar ou trocar o usuário que executará estes serviços utilizaremos sempre o Services.Uma vez aberto o Services localize a aplicação desejada, utilizaremos o Serviço de Relatório (BNTCpsSerGerRel0300) como exemplo.

Para abrir as configurações do serviço dê duplo clique sobre o nome do serviço.

Para que o serviço inicie automaticamente quando o Windows for iniciado coloque como Startup Type (Alt + E) a opção Automatic.

O local onde o serviço está instalado pode ser observado abaixo do termo “Path to executable:”, este caminho embora não pareça pode ser selecionado, para isso utilize o mouse.

Para parar o serviço deve-se clicar no botão Stop (Alt + T), essa ação deve ser executada sempre que um dos serviços da AttPS precisar ser atualizado ou quando for necessário executar o corglags.exe no ambiente x64.

Para iniciar o serviço novamente clique no botão Start (Alt + S). Para mudar o usuário que executa o serviço selecione a aba “Log On”. Escolha a opção

“This account:” (Alt + T) e digite o login do usuário que será utilizado para executar o serviço. No caso do Serviço de Relatório este mesmo usuário será utilizado para executar as aplicações iniciadas pelo Serviço de Relatório.No campo Password e Confirm Password deve ser digitada a senha deste usuário.

Performance MonitorO Performance Monitor é um componente do Windows para visualizar os contadores de performance do Windows na máquina local ou em máquinas remotas.

Para acessá-lo deve-se executar o seguinte comando: perfmon.msc

Exemplo: + R + perfmon.msc

Uma vez aberto o Performance Monitor selecione a pasta Performance -> Monitoring Tools -> Performance Tools.

Utilizaremos o Performance Monitor para análise dos discos rígidos de uma determinada máquina.Os contadores de performance de cada disco na máquina que nos interessam são:

% Disk Read Time % Disk Write Time Avg. Disk Read Queue Length Avg. Disk Write Queue Length

Para adicionar estes contadores faça os seguintes passos: Remova todos os contadores: Botão direito sobre o item existente “% Processor Time”

e escolha ”Remove All Counters” e depois clique em OK.

Adicionar os novos contadores: Clique no botão Add

Selecione os contadores: % Disk Read Time, % Disk Write Time, Avg. Disk Read Queue Length e Avg. Disk Write Queue Length dentro do item Physical Disk.

Selecione também os discos separadamente a ideia é analisar os discos separadamente para termos uma visão de qual disco é o gargalo.

Os contadores começarão a ser exibidos no gráfico.

A análise inicial que deve ser feita nesse caso é se algum dos indicadores está acima de 20, caso isto esteja ocorrendo deve ser reportado para a área de Infra do cliente.

DrLockAPI.DLLTodos os sistemas desenvolvidos na Att possibilitam o uso da DrLock, e quando isso ocorre (geralmente), é necessário utilizar o pacote com o Runtme das DLLs da DrLock, são elas:

DrLockAPI.DLL atl71.dll MFC71.dll msvci70.dll msvcp71.dll msvcr70.dll msvcr71.dll Pbsup32.dll xerces-c_2_2_0.dll

Por orientação da Microsoft DLLs que sejam de uso próprio de sistemas não devem ficar armazenadas nas pastas do Sistema Operacional, por exemplo: c:\windows, c:\windows\system32 ou c:\windows\syswow64. Sendo assim as DLLs de Runtime da DrLock deve ser instaladas em uma pasta própria e esta nova pasta deve ser colocada no path da máquina.Para isso siga os seguintes passos:

• Crie uma pasta para armazenamento do pacote de runtime da DrLock, por exemplo: C:\attps\DrLockAPI

• Copie as dlls da DrLock para esta pasta;

Observação: Estas libraries (dlls) devem ser disponibilizadas pela equipe de produto, na versão mais recente disponível.

• Conceda direitos de leitura ao grupo “Authenticated Users”, à esta pasta;

• Execute o seguinte comando: sysdm.cpl

• + R + sysdm.cpl

• Na tela que é aberta, selecione a aba “Advanced”;

• Clique no botão “Environment variables”;

• No grupo “System variables”, selecione a variável “Path” e clique em “Edit”;

• Na tela que é aberta edite a informação “Variable value”, adicionando a pasta criada para armazenamento do pacote de runtime da DrLock no início do path. Após isso clique no botão OK até fechar todas as janelas abertas.

Observação: O separador de pastas é “;” (ponto e vírgula), então digite-o após entrar com a nova pasta.

Neste exemplo foi incluída a informação “C:\attps\DrLockAPI;”

• Caso o servidor em questão seja de aplicações web o Internet Information Server (IIS) deve ser reiniciado através do comando iisreset

• + R + iisreset

Registry ou Registro do WindowsO Registry é um componente do Windows utilizado para visualizar/manter as chaves/valores de registro do Windows na máquina local ou em máquinas remotas.

Não é nossa intenção explicar detalhadamente como funciona o Registry, nem mesmo encorajá-los a editar as informações contidas nele, este tópico passa uma breve explicação a respeito desta componente focando na necessidade de extrair informações que possam ser úteis para as equipes de suporte.

Para acessá-lo deve-se executar o seguinte comando: regedit

Exemplo: + R + regedit

Aplicações da ATTPSO Registro do Windows é utilizado pelas aplicações da AttPS para armazenar informações de segurança em todas as versões da DrNet e na versão 4 também é utilizado para armazenamento de informações dos WCFs.

Além disso necessitamos de utilizar o Registro do Windows para verificar instancias (HOMEs) do Oracle que estão instaladas.Uma informação importante a respeito do Registro do Windows é que existe uma sutil diferença para o armazenamento de informações de aplicações 32bit e 64bit, isto em arquiteturas x64.Quando o servidor possui arquitetura x64 o Windows armazena as informações das aplicações 64bit abaixo das chaves HKEY_LOCAL_MACHINE\SOFTWARE ou em HKEY_CURRENT_USER\Software.

Porém as aplicações da AttPS, como são 32bit, tem suas informações armazenadas pelo Windows em outro ponto desta árvore, elas ficam todas abaixo das chaves HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node.

Como pode ser visto no print acima as informações das chaves da AttPS aparecem na ramificação Wow6432Node e na ramificação acima dela, porém a ramificação acima é somente um espelho da ramificação da Wow6432Node, essa é a instalação correta para sistemas desenvolvidos pela AttPS, e caso isso não ocorra deve-se apagar todas as chaves existentes e executar os procedimentos para servidores x64 novamente.

OracleOutra utilidade para o Registro do Windows é para verificação de instancias do Oracle instaladas.

Lembrando que caso o servidor em uso seja 64bit, ou x64, deveremos prestar atenção na instalação do Oracle a ser verificada, pois como dito anteriormente as aplicações 32bit, ou x86, sempre recuperarão as informações que estiverem abaixo da ramificação Wow6432Node.

Quando necessário exporte as informações referentes ao Oracle para um arquivo, para isso siga os seguintes passos:Abra a árvore, do Registry, a partir de HKEY_LOCAL_MACHINE\SOFTWARE, até encontrar a pasta do Oracle.

Uma vez encontrada clique com o botão direito sobre o nome ORACLE e selecione a opção Export.

Na janela que se segue escolha um local pra salvar o arquivo .reg deixando marcado o radiobutton “Selected branch”.

Após salvar este arquivo envie-o para a equipe responsável analisar.

Run As AdministratorAplicações do Windows são executadas utilizando direitos/configurações específicas do usuário logado, isso inclui pastas temporárias, registro do windows e etc. Porém em alguns casos será necessário executar um instalador ou uma aplicação com direitos de Administrador local.

Windows 2003Clique com o botão direito sobre a aplicação a ser executada e selecione a opção Run as...

Na janela que será aberta selecione o radiobutton “The following user:”, digite o login e senha de um usuário com direitos de administrador local e clique no botão OK.

Windows 2008 e 2012Clique com o botão direito sobre a aplicação a ser executada e selecione a opção Run as administrator

Caso você seja administrador local sua aplicação será executada com o perfil de administradora, caso contrário será exibida uma janela para que você escolha um usuário administrador local, nesse caso deverá ser digitada uma senha válida.

Client Oracle Pontos importantes com relação ao Oracle: Devido as aplicações da AttPS só poderem ser executadas como 32bit o client do

banco Oracle a ser instalado também deve ser 32bit, caso o client esteja instalado e a aplicação continue a não encontrar os drivers, verifique se o client instalado é 32bit.

Outro ponto importante é que o client do Oracle não deve ser instalado dentro de pastas que contenham parênteses “(“, nesse caso está incluida a pasta “c:\Program Files (x86)”

O Oracle Data Provider (ODP) instalado deve ser da mesma versão do client. Versões diferentes causam problemas de incompatibilidade.

DLLs do PowerBuilderTodos os sistemas desenvolvidos na Att em PowerBuilder necessitam utilizar o pacote com o Runtime das DLLs do PowerBuilder, são elas:DLL Função

PBVM100.DLL Maquina virtual do PowerBuilder (necessária para todos os componentes do PowerBuilder)

PBSHR100.DLL Necessário para a PBVM100.DLL

LIBJCC.DLL Necessário para a PBVM100.DLL

LIBJLOG.DLL Necessário para a PBVM100.DLL

PBDWE100.DLL Responsável pelo processamento de datastores

PBRTC100.DLL Responsável pelo componente de RichText

PBODB100.INI Arquivo de inicialização ODBC, necesário para conexão com banco de dados

PBODB100.DLL Responsável pela interface com drivers ODBC

PBXerces100.DLL Suporte a XML

xerces-c_2_1_0.dll Suporte a XML

PBO84100.DLL Responsável pela interface com bancos Oracle 8

PBO90100.DLL Responsável pela interface com bancos Oracle 9

PBOLE100.DLL Responsável pela interface com drivers OleDB, no nosso caso bancos SQLServer

PBSYC100.DLL Responsável pela interface com bancos Sybase

PBTRA100.DLL Necessária para geração do trace de banco nas aplicações PowerBuilder

NTWDBLIB.DLL Embora não faça parte do Runtime do PowerBuilder é necessária para bancos SQLServer

Por orientação da Microsoft DLLs que sejam de uso próprio de sistemas não devem ficar armazenadas nas pastas do Sistema Operacional, por exemplo: c:\windows, c:\windows\system32 ou c:\windows\syswow64. Sendo assim as DLLs de Runtime do PowerBuilder deve ser instaladas em uma pasta própria e esta nova pasta deve ser colocada no path da máquina.Para isso siga os seguintes passos:

• Crie uma pasta para armazenamento do pacote de runtime do PowerBuilder, por exemplo: C:\attps\PBDLL

• Copie as dlls do PowerBuilder para esta pasta;

Observação: Estas libraries (dlls) devem ser disponibilizadas pela equipe de produto, na versão mais recente disponível.

• Conceda direitos de leitura ao grupo “Authenticated Users”, à esta pasta;

• Execute o seguinte comando: sysdm.cpl

• + R + sysdm.cpl

• Na tela que é aberta, selecione a aba “Advanced”;

• Clique no botão “Environment variables”;

• No grupo “System variables”, selecione a variável “Path” e clique em “Edit”;

• Na tela que é aberta edite a informação “Variable value”, adicionando a pasta criada para armazenamento do pacote de runtime do PowerBuilder no início do path. Após isso clique no botão OK até fechar todas as janelas abertas.

Observação: O separador de pastas é “;” (ponto e vírgula), então digite-o após entrar com a nova pasta.

Neste exemplo foi incluída a informação “C:\attps\PBDLL;”

• Caso o servidor em questão seja de aplicações web o Internet Information Server (IIS) deve ser reiniciado através do comando iisreset

• + R + iisreset

Message QueueO Message Queue é um componente do Windows para gerenciamento das filas de mensagens do Windows na máquina local. Ele não vem instalado no Windows por padrão, antes de efetuar a instalação dele avise ao cliente e peça autorização para instalação do mesmo, em alguns casos o cliente efetuará esta instalação.

O Message Queue passou a ser utilizado nos sistemas da AttPS a partir da versão 4 da DrNet.

Instalando o Message Queue

Windows 2008• Abra o Server Manager (Start -> Administrative Tools -> Server Manager) e selecione a opção

Features no canto esquerdo da tela. Serão apresentadas as listas de papéis assumidos pelo servidor. Para adicionar um novo papel, deve-se clicar em Add Features;

Selecione as opções: Message Queuing

o Directory Service Integrationo HTTP Support

Ao marcar a opção “HTTP Support” poderá ser exibida a seguinte janela:

Clique no botão “Add Required Role Services”

Clique no botão “Next >” até que ele fique desabilitado e ao final clique no botão “Install”

Ao final da instalação clique no botão Close.

E feche a janela do Server Manager.

Criando novas Queues (Filas)Todas as filas utilizadas na DrNet 4 precisam ser criadas de forma pública.Abra o Server Manager (Start -> Administrative Tools -> Server Manager) e expanda a opção Features no canto esquerdo da tela.

Selecione o item Public Queues para certificar-se que a fila a ser criada já não existe.

Clique com o botão direito sobre o item Public Queue e selecione a opção New -> Public Queue

Na janela que se segue sigite o nome da fila a ser criada e clique em OK:

Abra as propriedades da fila clicando com o botão direito do mouse

Selecione a aba Security e marque o grupo “Authenticated Users”No box abaixo marque o checkbox “Full Control” e clique em OK.

Os passos acima devem ser executados para cada fila criada.