Página 1 de 17

Configuração do Protheus ISAPI no IIS 6

Revisão: 10/07/2003

Abrangência

Versão 7.10

Os passos abaixo guiaram a forma de configurar o AP7 para ser executado através de uma
ISAPI DLL no Internet Information Services Manager (IIS) 6.0, esse caminho só é valido para o
IIS incluído no Windows 2003.

1 – Abra o IIS Manager.

2 – Selecione o Node “Web Service Extensions”.

Nessa parte será criado uma nova “Web Service Extension”.

3- Com o botão direito do mouse, clique em “Add new Web service extension...”

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 2 de 17

4 – Preencha o “Extension name” com o nome da extensão que sera adicionada, no caso
Protheus ISAPI e adicione a DLL “ap7isapi.dll” que se encontra dentro do diretório do server do
Protheus. Marque o CheckBox “Set extension status to Allowed” e clique em OK.

Sera adicionado uma nova extensão para o Protheus ISAPI.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 3 de 17

5 – Agora clique com o botão direito do mouse em “Application Pools”, “New” e “Application
Pool...”

Preencha o “Application pool ID” com o nome da sua nova Application Pool, no caso “Protheus
ISAPI Pool” e clique em OK.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 4 de 17

Será Adicionado uma nova “Application Pool” com o nome que foi dado anteriormente, clique
com o botão direito do mouse nela e clique em “Properties”.

Nessa tela devemos desabilitar todos os controles de “Worker Processes”.

Worker Processes são similares as Working Threads do Protheus e que agora foram criadas no
IIS. Como no Protheus esse controle já existe, não se pode habilitar nada nessa sessão. Se for
configurado para o IIS iniciar 2 Worker Processes, isso significa que ele ira iniciar 2 servidores
Protheus !

Em “Performance”, como na anterior, desabilite todos os controles de Worker Processes e

preencha o “Maximum number of worker processes” com o número 1 (um). Assim asseguramos
que será iniciado apenas uma Worker Processes e consequente apenas um servidor Protheus.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 5 de 17

Em “Health” como na anterior desabilite todos os controles de Worker Processes e em “Worker

processes must startup within (time in seconds)” coloque um número de segundos suficiente
para que o servidor Protheus possa ser iniciado e em “Worker processes must shutdown within
(time in seconds)”, coloque um tempo suficiente para que o servidor Protheus seja fechado.
Esses tempos dependem da máquina e da quantidade de sites que estão armazenados na
mesma.

Em “Identity’ deve ser configurado uma conta para este Application Pool. Em “Predefined”
selecione “Local System”.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 6 de 17

Clique em OK e irá abrir uma mensagem, perguntando se você tem certeza que quer configurar
o Application Pool como Local System, dizendo que isso ira resultar em acesso completo no
sistema. Clique em “Yes”.

6 – Agora deve-se criar um novo Site, para isso clique com o botão direito do mouse em “Web
Sites”, “New” e “Web Site...”

Será aberto um assistente para a criação do mesmo.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 7 de 17

Clique em “Next”.

Na próxima tela, em “Description”, preencha o nome do Site que será criado e clique em
“Next”.

Na próxima tela, configure da maneira que for preciso e clique em “Next”.

No caso de utilização do IIS para mais de um site , especifique em 'Host header' o nome do
host que irá atender às requisições deste site.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 8 de 17

Na próxima tela, preencha o caminho (path) de onde o site esta armazenado no servidor e
clique em “Next”.

Na próxima tela, configure da maneira que for necessario e clique em “Next”.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 9 de 17

Clique em “Finish” e o site será criado.

7 – Agora clique com o botão direito do mouse no seu novo site em entre em “Properties”.

Vá ate a aba “Home Directory” em “Application name”, preencha com o nome da nova
aplicação no caso “Protheus ISAPI” . Em “Execute permissions”, selecione “Scripts and
Executables” e, em “Application Pool”, selecione o Application Pool criado anteriormente,
“Protheus ISAPI Pool”.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 10 de 17

Agora clique em “Configuration...”

Clique em “Add” para adicionar as extensões que o Protheus ISAPI ira responder (APL e APW).
Em “Executable” coloque a DLL ISAPI do servidor Protheus(ap7isapi.dll) que se encontra no
diretório do servidor em “Extension” preencha com a primeira extensão a ser respondida pelo
servidor Protheus , em letras minúsculas , a extensão .APL. Desmarque o CheckBox “Verify that
file exists”. Clique em OK

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 11 de 17

Clique novamente em “Add” e repita os passos acima, mas em “Extension” preencham com a
segunda extensão a ser respondida pelo servidor Protheus ( extensão .APW). Desmarque o
CheckBox “Verify that file exists”, e clique no botão OK.

Você verá as extensões adicionadas. Clique em OK.

Clique em OK novamente na tela de “Properties”.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 12 de 17

Ao voltar na tela acima , clique no botão OK.

Ao retornar para a tela do IIS Manager , inicie o site, clicando com o botão direito do mouse
sobre ele e acionando a opção 'Start'.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 13 de 17

Note que para o serviço do seu site ser iniciado, não pode existir outro site na mesma porta.
Assim nesse caso foi parado o serviço do site “Default Web Site”. Se houver um site na mesma
porta que o seu, essa mensagem ira acontecer.

8 – Agora que temos o nosso IIS configurado, temos que configurar o Windows. Entre em
“Services” que esta em “Administrative Tools”. Va ate “World Wide Web Publishing Service”
clique com o botão direito do mouse e va em “Properties”.

Em “Startup type” selecione “Automatic” e clique em OK.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 14 de 17

Agora, para que o Protheus ISAPI rode no IIS 6.0, é preciso que o usuario que esteja rodando o
serviço tenha direito de gravação em todos os arquivos manipulados pelo servidor Protheus,
para isso abra o “Windows Explorer” clique com o botão direito do mouse no diretório em que
se encontram os arquivos que o servidor Protheus ira manipular clique em “Properties”, clique
na aba “Security”, em “Group or user names” selecione “User (NOME_DA_MAQUINA\User)” e
em “Permissions for User” marque o CheckBox “Write”.

Agora em “System” que esta em “Control Panel” clique na aba “Advanced” e clique no botão
“Environment Variables”.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 15 de 17

Em “System variables” selecione “Path” e clique em “Edit”.

No final do texto escrito em “Variable value” adicione “;c:\ap7\bin\server” sem as aspas. No

caso esse é o caminho para o diretório que estão os arquivos do servidor Protheus e clique em
OK.

Clique em OK novamente agora na tela de “Environment Variables”.

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 16 de 17

Novamente clique em OK, agora na tela “System Properties”.

9 – Para as configurações do “Environment Variables” terem efeito o computador deve ser

reiniciado.

Pronto ! O Servidor esta pronto para utilizar ISAPI do servidor

Protheus.

Grupos Relacionados
Principal / Guias de Referência / Configuração do Server ISAPI

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004
 Página 17 de 17

Veja também
Principal / Guias de Referência / Configuração do Server ISAPI / Configuração do Protheus
ISAPI no IIS 5

Topo da Página

http://dem.microsiga.com.br/w_wEx011.apw?Cod=025108 24/8/2004