Cenário: criar um Site do ASP Clássico no IIS
por Keith Newman e Robert McMurray
Este documento orienta você na instalação do IIS e configuração de um site ASP clássico. O ASP clássico é um ambiente de script do lado do servidor que você pode usar para criar e executar aplicativos Web dinâmicos. Com o ASP, você pode combinar páginas HTML, comandos de script e componentes COM para criar páginas da Web interativas, fáceis de desenvolver e modificar. O ASP clássico é o predecessor do ASP.NET, mas ainda é amplamente usado.
A configuração do servidor ASP clássico adiciona módulos do IIS a extensões ISAPI e do ASP à instalação padrão do IIS.
Pré-requisitos
Para aproveitar ao máximo este tutorial, você deve ter acesso a um computador com um dos seguintes sistemas operacionais:
- Windows Server ® 2012
- Windows® 8
Etapa 1: Instalar o servidor Web do IIS
Você pode executar esse procedimento usando a interface do usuário (UI) do Windows ou de uma linha de comando.
Para instalar o IIS no Windows Server 2012 usando a interface do usuário
Na página Iniciar, clique no bloco do Gerenciador do Servidor e, em seguida, clique em OK.
No Gerenciador de Servidores, selecione Painel, e clique em Adicionar Funções e Recursos.
No assistente Adicionar Funções e Recursos, na página Antes de Começar, clique em Avançar.
Na página Selecionar Tipo de Instalação escolha Instalação Baseada em Função ou Recurso e clique em Avançar
Na página Selecionar Servidor de Destino escolha Selecionar um servidor no pool de servidores, escolha o servidor e clique em Avançar.
Na página Selecionar Funções do Servidor, selecione Servidor Web (IIS) e clique em Avançar.
Na página Selecionar Recursos , observe os recursos pré-selecionados que são instalados por padrão e, em seguida, selecione os seguintes serviços de função adicionais:
- ASP
- Extensões de ISAPI
Clique em Avançar.
Na página Função de Servidor Web (IIS), clique em Avançar.
Na página Selecionar Serviços de Função, observe os serviços de função pré-selecionados instalados por padrão e, em seguida, clique em Avançar. (Observação: você só precisa instalar os serviços de função padrão do IIS 8 para um servidor Web de conteúdo estático.)
Na página Confirmar Seleções de Instalação, confirme suas seleções e clique em Instalar.
Na página Progresso da Instalação, confirme se a sua instalação de função do Servidor Web (IIS) e os serviços de função necessários foram concluídos com êxito e, em seguida, clique em Fechar.
Para verificar se o IIS foi instalado com êxito, digite o seguinte em um navegador da Web:
http://localhostVocê verá a página padrão de boas-vindas do IIS.
Para instalar o IIS no Windows 8 usando a interface do usuário
Na página Inicial , digite Painel de Controle, e, em seguida, clique no ícone do Painel de Controle nos resultados da pesquisa.
Em Painel de Controle, clique em Programas, e, em seguida, clique em Ativar ou desativar recursos do Windows.
Na caixa de diálogo Recursos do Windows , clique em Serviços de Informações da Internet, observe os recursos pré-selecionados instalados por padrão e, em seguida, selecione os seguintes serviços de função adicionais:
- ASP
- Extensões de ISAPI
Clique em OK.
Para verificar se o IIS foi instalado com êxito, digite o seguinte em um navegador da Web:
http://localhostConsulte a página padrão de boas-vindas do IIS.
Para instalar o IIS usando a linha de comando
Digite o seguinte comando em um prompt de comando ou em um script:
Start /w pkgmgr /iu:IIS-WebServerRole;IIS-WebServer;IIS-CommonHttpFeatures;IIS-StaticContent;IIS-DefaultDocument;IIS-DirectoryBrowsing;IIS-HttpErrors;IIS-ApplicationDevelopment;IIS-ASP;IIS-ISAPIExtensions;IIS-HealthAndDiagnostics;IIS-HttpLogging;IIS-LoggingLibraries;IIS-RequestMonitor;IIS-Security;IIS-RequestFiltering;IIS-HttpCompressionStatic;IIS-WebServerManagementTools;IIS-ManagementConsole;WAS-WindowsActivationService;WAS-ProcessModel;WAS-NetFxEnvironment;WAS-ConfigurationAPI
Etapa 2: Adicionar um site ASP clássico
Você pode realizar esse procedimento usando a interface do usuário, executando os comandos Appcmd.exe em uma janela de linha de comando, editando os arquivos de configuração diretamente ou escrevendo scripts WMI.
Para adicionar um site usando a interface do usuário
Abra o Gerenciador do IIS.
- Para o Windows Server 2012, na página Inicial, clique no bloco Gerenciador do Servidor e clique em OK. No Painel do Gerenciador de Servidores, clique no menu Ferramentas e clique em Gerenciador de IIS (Serviços de Informações da Internet).
- Para o Windows 8, na página Iniciar digite Painel de Controle e clique no ícone do Painel de Controle nos resultados da pesquisa. Na tela Painel de Controle , clique em Sistema e Segurança, clique em Ferramentas Administrativas, e, em seguida, clique no Gerenciador do Serviços de Informações da Internet (IIS).
No painel Conexões , clique com o botão direito do mouse no nó Sites na árvore e, em seguida, clique em Adicionar Site.
Na caixa de diálogo Adicionar Site , digite um nome amigável para o seu site na caixa Nome do Site .
Para selecionar um pool de aplicativos diferente do listado na caixa Pool de Aplicativos clique em Selecionar. Na caixa de diálogo Selecionar Pool de Aplicativos , selecione um pool de aplicativo na lista Pool de Aplicativos e, em seguida, clique em OK.
Na caixa Caminho Físico , digite o caminho físico da pasta do site da Web ou clique no botão de procura (...) para navegar no sistema de arquivos e localizar a pasta.
Se o caminho físico inserido na etapa 5 for para um compartilhamento remoto, clique em Conectar como para especificar credenciais que tenham permissão de acesso ao caminho. Se você não usar credenciais específicas, selecione a opção Usuário do aplicativo (autenticação de passagem) na caixa de diálogo Conectar Como .
Selecione o protocolo para o site da Web na lista Tipo .
O valor padrão na caixa Endereço IP é Todos os não Atribuídos. Se você deve especificar um endereço IP estático para o site da Web, digite o endereço IP na caixa Endereço IP .
Digite um número da porta na caixa de texto Porta .
Opcionalmente, digite um nome de cabeçalho de host para o site da Web na caixa Cabeçalho de Host .
Se você não precisar fazer alterações no site da Web e quiser que o site esteja imediatamente disponível, marque a caixa de seleção Iniciar site imediatamente .
Clique em OK.
Para adicionar um site usando a linha de comando
Use a seguinte sintaxe no prompt de comando ou em um script: (observação: para esta sintaxe funcionar, você deve estar no seguinte diretório, ou ter o diretório no caminho: %windir%\system32\inetsrv.)
appcmd add site /name:string /id:uint /physicalPath:string /bindings:string
A variável name:string é o nome e a variável id:uint é o inteiro sem sinal a ser atribuído ao site. As variáveis name:string e id:uint são as únicas variáveis necessárias quando você adiciona um site no Appcmd.exe. (Observação: quando você adiciona um site sem especificar os valores para os atributos bindings e physicalPath, o site não poderá iniciar.)
A variável physicalPath:string é o caminho do conteúdo do site no sistema de arquivos.
A variável bindings:string contém informações que são usadas para acessar o site e devem estar na forma de protocol/IP_address:port:host_header. Por exemplo, uma associação do site da Web é a combinação de protocolo, endereço IP, porta e cabeçalho de host. Uma associação de http/*:85: permite que um site da Web escute solicitações HTTP na porta 85 para todos os endereços IP e nomes de domínio (também conhecidos como cabeçalhos de host ou nomes de host). Por outro lado, uma associação de http/*:85:marketing.contoso.com configura um site para escutar solicitações HTTP na porta 85, para todos os endereços IP e para o nome de domínio marketing.contoso.com.
Para adicionar um site chamado contoso com uma ID igual a 2 que tenha conteúdo em c:\contoso e escute solicitações HTTP na porta 85 para todos os endereços IP e o nome de domínio marketing.contoso.com, digite o seguinte no prompt de comando e, em seguida, pressione ENTER:
appcmd add site /name: contoso /id:2 /physicalPath: c:\contoso /bindings:http/*:85: marketing.contoso.com
Etapa 3: Editar configurações do aplicativo ASP
O IIS 8 fornece configurações padrão para aplicativos ASP, mas você pode alterar essas configurações, conforme necessário. Por exemplo, você pode habilitar depuração do lado do cliente em um servidor de teste para auxiliar na solução de problemas durante uma passagem de teste.
Para editar as configurações do aplicativo ASP usando a interface do usuário
- Abra o Gerenciador do IIS e navegue até o nível a ser gerenciado.
- Em Exibição de Recursos, clique duas vezes em ASP.
- Na página ASP , edite as configurações conforme desejado.
- Quando terminar, clique em Aplicar no painel Ações .
Para editar as configurações do aplicativo ASP usando a linha de comando
Especificar o conjunto de caracteres padrão
Para especificar o conjunto de caracteres padrão definido para um aplicativo, use a seguinte sintaxe:
appcmd set config /section:asp /codePage:integerRange
A variável integerRange é o conjunto de caracteres padrão. Por exemplo, para definir a página de código para um conjunto de caracteres latinos usado em inglês americano e vários alfabetos europeus, digite o seguinte no prompt de comando e pressione Enter:
appcmd set config /section:asp /codePage:1252
Habilitar ou desabilitar buffer
Para habilitar ou desabilitar o buffer de saída do aplicativo ASP, use a seguinte sintaxe:
appcmd set config /section:asp /bufferingOn:true|false
Um valor true habilita o buffer enquanto false o desabilita. O valor padrão é true.
Habilitar ou desabilitar codificação de transferência em partes do HTTP 1.1
Para habilitar a codificação de transferência em partes do HTTP 1.1 para o serviço de publicação World Wide Web, use a seguinte sintaxe:
appcmd set config /section:asp /enableChunkedEncoding:true|false
Um valor true permite a codificação de transferência em partes do HTTP 1.1 enquanto false a desabilita. O valor padrão é true.
Habilitar ou desabilitar fallback de HTML
Para habilitar ou desabilitar fallback de HTML, use a seguinte sintaxe:
appcmd set config /section:asp /enableASPHTMLFallback:true|false
Um valor true faz com que um arquivo .htm que tem o mesmo nome do arquivo. asp solicitado, se existir, seja enviado em vez do arquivo .asp, caso a solicitação seja rejeitada devido a uma fila de solicitação completa. O valor padrão é true.
Habilitar ou desabilitar caminhos pai
Para habilitar ou desabilitar caminhos relativos ao diretório atual ou acima do diretório atual, use a seguinte sintaxe:
appcmd set config /section:asp /enableParentPaths:true|false
Um valor true define páginas ASP para permitir caminhos relativos ao diretório atual ou acima do diretório atual. O valor padrão é true.
Definir intervalo de teste de conexão de cliente
Para definir um intervalo de tempo após o qual o ASP verificará se o cliente ainda está conectado antes de executar uma solicitação, use a seguinte sintaxe:
appcmd set config /section:asp /queueConnectionTestTime:timeSpan
A variável timeSpan define o intervalo de tempo (hh:mm:ss) após o qual o ASP verifica para ver se o cliente ainda está conectado antes de executar uma solicitação. O valor padrão é 00:00:03.
Definir solicitante limite máximo do corpo da entidade solicitante
Para especificar o número máximo de bytes permitidos no corpo da entidade de uma solicitação ASP, use a seguinte sintaxe:
appcmd set config /section:asp /maxRequestEntityAllowed:int
A variável int representa o número máximo de bytes permitidos no corpo de uma solicitação ASP. O valor padrão é 200000 bytes.
Definir o comprimento da fila de solicitações
Para especificar o número máximo de solicitações ASP simultâneas permitidas na fila, use a seguinte sintaxe:
appcmd set config /section:asp /requestQueueMax:int
A variável int representa o número máximo de solicitações ASP simultâneas permitidas na fila de solicitações. O valor padrão é 3000.
Definir tempo limite da fila de solicitação
Para especificar o período em que uma solicitação ASP pode esperar na fila de solicitações, use a seguinte sintaxe:
appcmd set config /section:asp /queueTimeout:timeSpan
A variável timeSpan representa o tempo máximo (hh:mm:ss) que uma solicitação ASP pode esperar na fila de solicitações. O valor padrão é 00:00:00.
Especifique o limite do buffer de resposta
Para controlar o número máximo de bytes que uma página ASP poderá gravar no buffer de resposta antes que ocorra uma liberação, use a seguinte sintaxe:
appcmd set config /section:asp /bufferingLimit:int
A variável int representa o tamanho máximo, em bytes, do buffer do ASP. O valor padrão é 4194304 bytes.
Definir tempo limite de script
Para especificar o período de tempo padrão que páginas ASP permitem que um script seja executado antes de encerrar o script e gravar um evento no Log de eventos do Windows, use a seguinte sintaxe:
appcmd set config /section:asp /scriptTimeout:timeSpan
A variável timeSpan representa o tempo máximo (hh:mm:ss) de execução de uma solicitação ASP antes que um evento seja gravado no Log de eventos do Windows. O valor padrão é 00:01:30.
Especificar threads por limite de processador
Para especificar o número máximo de threads de trabalho por processador que o ASP pode criar, use a seguinte sintaxe:
appcmd set config /section:asp /processorThreadMax:int
A variável int representa o número máximo de threads de trabalho por processador que o ASP pode criar. O valor padrão é 25.
Especificar o identificador de localidade padrão
Para definir como datas, horas e moedas são formatadas para um aplicativo ASP, use a seguinte sintaxe:
appcmd set config /section:asp /lcid:int
A variável int representa o identificador de localidade padrão para um aplicativo ASP. O valor padrão é 0.
Habilitar ou desabilitar reinicialização automática de aplicativo
Para habilitar ou desabilitar a reinicialização automática de aplicativos ASP sempre que uma configuração é alterada, use a seguinte sintaxe:
appcmd set config /section:asp /enableApplicationRestart:true|false
Um valor true permite que aplicativos ASP sejam automaticamente reiniciados sempre que uma configuração é alterada. O valor padrão é true.
Habilitar ou desabilitar cálculo de número de linha
Para habilitar ou desabilitar ASP para calcular e armazenar o número de linha de cada linha de código executada e fornecer o número em um relatório de erro, use a seguinte sintaxe:
appcmd set config /section:asp /calLineNumber:true|false
Um valor true habilita cálculo e armazenamento de número de linha. O valor padrão é true.
Habilitar ou desabilitar trapping de exceção de componente COM
Para habilitar ou desabilitar páginas ASP para capturar exceções geradas por componentes COM, use a seguinte sintaxe:
appcmd set config /section:asp /exceptionCatchEnable:true|false
Um valor true habilita trapping de exceção de componente COM. Se definido como false, a ferramenta Depurador de Scripts da Microsoft não capturará exceções enviadas pelo componente que você está depurando. O valor padrão é true.
Habilitar ou desabilitar depuração no lado do cliente
Para habilitar ou desabilitar depuração no lado do cliente, use a seguinte sintaxe:
appcmd set config /section:asp /appAllowClientDebug:true|false
Um valor true habilita a depuração do lado do cliente. O valor padrão é false.
Habilitar ou desabilitar solicitações de erro do log
Para habilitar ou desabilitar a gravação de erros do ASP na seção de aplicativo do log de eventos do Windows, use a seguinte sintaxe:
appcmd set config /section:asp /logErrorRequests:true|false
Um valor true habilita solicitações de erro de log. Por padrão, erros ASP são gravados no navegador do cliente e nos logs do IIS. O valor padrão é true.
Habilitar ou desabilitar log de eventos do Windows de erros ASP
Para habilitar ou desabilitar a depuração de ASP no servidor, use a seguinte sintaxe:
appcmd set config /section:asp /appAllowDebugging:true|false
Um valor true habilita a depuração do lado do servidor para aplicativos ASP. O valor padrão é false.
Executar funções End anonimamente
Para habilitar ou desabilitar funções globais do ASP SessionOnEnd e ApplicationOnEnd para executar como usuário anônimo, use a seguinte sintaxe:
appcmd set config /section:asp /runOnEndAnonymously:true|false
Um valor true permite que as funções globais do ASP SessionOnEnd e ApplicationOnEnd sejam executadas como usuário anônimo. O valor padrão é true.
Especificar mensagem de erro de script
Para especificar a mensagem de erro para enviar para o navegador caso erros de depuração específicos não sejam enviados ao cliente, use a seguinte sintaxe:
appcmd set config /section:asp /scriptErrorMessage:string
A variável string representa a mensagem de erro enviada ao navegador quando erros de depuração específicos não são enviados ao cliente. O valor padrão é "Ocorreu um erro no servidor ao processar a URL. Entre em contato com o administrador do sistema".
Habilitar ou desabilitar erros de envio para o navegador
Para habilitar ou desabilitar gravação de detalhes da depuração (nome do arquivo, erro, número de linha e descrição) no navegador cliente, além de registrá-la no log de eventos do Windows, use a seguinte sintaxe:
appcmd set config /section:asp /scriptErrorSentToBrowser:true|false
Um valo true habilita a gravação de detalhes da depuração no navegador cliente. O valor padrão é false.
Especificar linguagem de script padrão
Para especificar a linguagem de script padrão para todos os aplicativos ASP executados no servidor Web, use a seguinte sintaxe:
appcmd set config /section:asp /scriptLanguage:string
A variável string representa a linguagem de script padrão. O valor padrão é VBScript.
Especificar caminho do diretório de cache
Para especificar o nome do diretório no qual os repositórios ASP compilaram modelos ASP durante o estouro do cache na memória, use a seguinte sintaxe:
appcmd set config /section:asp /diskTemplateCacheDirectory:string
A variável string representa o caminho do diretório de cache. O valor padrão é %windir%\system32\inetsrv\ASP Compiled Templates.
Habilitar ou desabilitar cache de biblioteca de tipo
Para habilitar ou desabilitar armazenamento em cache das bibliotecas de tipo, use a seguinte sintaxe:
appcmd set config /section:asp /enableTypelibCache:true|false
Um valor true habilita o cache das bibliotecas de tipo. O valor padrão é true.
Definir o número máximo de modelos ASP compilados a armazenar
Para definir o número máximo de modelos ASP compilados que podem ser armazenados, use a seguinte sintaxe:
appcmd set config /section:asp /maxDiskTemplateCacheFiles:int
A variável int representa o número máximo de modelos ASP compilados para armazenar. O valor padrão é 2000.
Definir o número máximo de modelos ASP compilados a armazenar
Para definir o número máximo de arquivos de script pré-compilados para cache, use a seguinte sintaxe:
appcmd set config /section:asp /scriptFileCacheSize:int
A variável int representa o número de arquivos de script pré-compilados para armazenar em cache. Se definido como 0, nenhum arquivo de script será armazenado em cache. Se definido como 4294967295, todos os arquivos de script solicitados serão armazenados em cache. O valor padrão é 500.
Definir o número máximo de mecanismos de script para cache
Para definir o número máximo de mecanismos de script que páginas ASP mantêm em cache na memória, use a seguinte sintaxe:
appcmd set config /section:asp /scriptEngineCacheMax:int
A variável int representa o número máximo de mecanismos de script armazenados em cache. O valor padrão é 250.
Habilitar ou desabilitar assemblies COM+ lado a lado
Para habilitar ou desabilitar assemblies COM+lado a lado, que permitem aos aplicativos ASP especificar qual versão de um sistema DLL ou componente COM clássico usar, use a seguinte sintaxe:
appcmd set config /section:asp /appServiceFlags:true|false
Um valor true habilita assemblies COM+ lado a lado. O valor padrão é false.
Habilitar ou desabilitar o controlador COM+
Para habilitar ou desabilitar o controlador COM+, use a seguinte sintaxe:
appcmd set config /section:asp /enableTypelibCache:true|false
Um valor true habilita o controlador COM+, que permite aos administradores ou desenvolvedores depurar aplicativos ASP. O valor padrão é false.
Habilitar ou desabilitar ambientes multithread
Para habilitar ou desabilitar ASP para ser executado em um ambiente multithreaded, use a seguinte sintaxe:
appcmd set config /section:asp /executeInMta:true|false
Um valor true habilita o ASP para executar em um ambiente multithread. O valor padrão é false.
Habilitar ou desabilitar verificação de modelo de thread
Para habilitar ou desabilitar se o IIS verifica o modelo de threading de qualquer componente criado por seu aplicativo, use a seguinte sintaxe:
appcmd set config /section:asp /trackThreadingModel:true|false
Um valor true habilita a verificação de modelo de thread. O valor padrão é false.
Especificar ID da partição COM+
Para especificar o GUID (Identificador Global Exclusivo) da partição COM+, use a seguinte sintaxe:
appcmd set config /section:asp /partitionID:string
A variável string representa o GUID da partição COM+. O valor padrão é 00000000-0000-0000-0000-000000000000.
Observação
Você também deve definir o sinalizador appServiceFlags como true.
Especificar o aplicativo COM+
Para especificar o nome do aplicativo COM+, use a seguinte sintaxe:
appcmd set config /section:asp /sxsName:string
A variável string representa o nome do aplicativo COM+.
Observação
Você também deve definir o sinalizador appServiceFlags como true.
Habilitar ou desabilitar o particionamento COM+
Para habilitar ou desabilitar o particionamento COM+, use a seguinte sintaxe:
appcmd set config /section:asp /appServiceFlags:true|false
Um valor true habilita o particionamento COM+ que pode ser usado para isolar aplicativos em sua própria partição COM+. O valor padrão é falso.
Observação
Se definido como true, você também deverá definir um valor para a propriedade partitionID.
Habilitar ou desabilitar o estado de sessão
Para habilitar ou desabilitar a persistência de estado de sessão para um aplicativo ASP, use a seguinte sintaxe:
appcmd set config /section:asp /allowSessionState:true|false
Um valor true habilita a persistência de estado de sessão. O valor padrão é true.
Definir o número máximo de sessões simultâneas
Para definir o número máximo de sessões simultâneas que o ASP permite, use a seguinte sintaxe:
appcmd set config /section:asp /max:int
A variável int representa o número máximo de sessões simultâneas. O valor padrão é -1.
Habilitar ou desabilitar ID de sessão segura
Para habilitar ou desabilitar o envio de uma ID de sessão como um cookie seguro se atribuída em um canal de sessão segura, use a seguinte sintaxe:
appcmd set config /section:asp /keepSessionIdSecure:true|false
Um valor true habilita a ID de sessão segura. O valor padrão é true.
Definir tempo limite da sessão
Para especificar o tempo padrão que um objeto de sessão é mantido depois que a última solicitação associada ao objeto é feita, use a seguinte sintaxe:
appcmd set config /section:asp /timeout:timeSpan
A variável timeSpan representa o tempo máximo (hh:mm:ss) que um objeto de sessão é mantido depois que a última solicitação associada ao objeto é feita. O valor padrão é 00:20:00.
Próximas etapas
Teste seu site cuidadosamente para garantir que ele funcione conforme o esperado. Em seguida, é recomendável configurar os seguintes recursos:
- Para ajudá-lo a solucionar problemas ou otimizar o desempenho do seu servidor Web, configure o log do IIS. Para obter instruções, consulte Configure Logging in IIS.
- Para melhorar a segurança do seu servidor Web, configure a filtragem de solicitações. Para obter instruções, consulte Configure Request Filtering in IIS.