Nota:
Este é um documento em tempo real que será atualizado conforme necessário. Nota:
O script Automatizado do IIS está disponível aqui.
Este tópico descreve a configuração para o Microsoft Internet Information Services (IIS) para suportar o IBM Cognos Analytics. Quando concluída, o IIS estará configurado para entregar conteúdo estático (como .js, .html, .css) diretamente do IIS enquanto envia REST e outras solicitações do servidor aos servidores backend do Cognos Analytics.
Procedimento
1. Instale a extensão Application Request Routing do IIS.
a. Instale a extensão de Roteamento de solicitação de aplicativo para o IIS, acessando a seguinte URL: http://www.iis.net/downloads/microsoft/ application-request-routing
b. Ao ser apresentada a Página da Web da Microsoft, clique no botão verde “Instalar esta extensão”. Siga as instruções para fazer o download e executar a extensão ARR.
c. Para garantir que a extensão ARR tenha sido instalada com êxito, ative o IIS Manager no menu Iniciar\Ferramentas Administrativas\ do Windows. Assim que o IIS Manager é ativado, clique no nome do servidor na lateral superior esquerda da tela para exibir os recursos disponíveis. Na área de janela central do IIS, o recurso Regravação de URL agora deve estar visível; ele é instalado quando o ARR é instalado.
2. Crie um novo conjunto de aplicativos dedicado. Por exemplo, chamado CAPool.
a. Clique com o botão direito em Conjuntos de Aplicativos. Clique em Incluir Conjuntos de Aplicativos.
3. Como opção, crie um server farm para fornecer balanceamento de carga e failover para solicitações de serviço do Cognos Analytics. Inclua todos os servidores Cognos Analytics que tiverem os componentes do servidor de aplicativos instalados e configurados.
a. Clique com o botão direito em Server Farms na árvore à esquerda e selecione Criar Server Farm.
b. Nomeie o novo server farm. Por exemplo, ca_servers.
c. Para cada servidor Cognos Analytics, execute as seguintes etapas: v Insira o endereço do servidor. Por exemplo, ca-host1.
v Clique em Configurações avançadas e expanda
applicationRequestRouting. Configure o httpPort ou o httpsPort (se estiver usando HTTPS). Por exemplo, 9300.
d. Clique em Concluir.
e. Clique em Não quando perguntado se quer permitir que o IIS Manager crie uma regra de regravação.
f. Selecione o server farm na árvore à esquerda e clique duas vezes em Afinidade do Servidor.
g. Selecione a caixa de seleção Afinidade do Cliente.
h. Clique em Aplicar.
i. Selecione o server farm na árvore à esquerda e clique duas vezes em Armazenamento em Cache.
j. Mude Suporte de Sequência de Consultas para Incluir Sequência de Consultas.
k. Clique em Aplicar.
l. Selecione o server farm na árvore à esquerda e clique duas vezes em Teste de Funcionamento.
m. Na seção Teste de URL, insira a URL: http://ca_servers/bi/v1/ping
n. Clique em Aplicar.
o. Selecione seu servidor na árvore esquerda e clique duas vezes em Proxy.
p. No campo Tempo limite (segundos), mude o valor para 120.
q. Clique em Aplicar.
4. Clique com o botão direito em Website padrão e, em seguida, clique em Incluir aplicativo.
v O alias é ibmcognos.
v O conjunto de aplicativos é aquele criado na etapa 1. v O caminho físico é install_location\webcontent
a. Ative a validade do Conteúdo da Web
1) Selecione ibmcognos e dê um clique duplo em Cabeçalhos de Resposta de HTTP.
2) Clique em Configurar Cabeçalhos Comuns.
3) Verifique Expirar Conteúdo da Web e configure uma validação que seja melhor para você.
b. Selecione ibmcognos e dê um clique duplo em Tipos MIME.
Importante: Inclua os seguintes tipos MIME em sua configuração do IIS, caso ainda não estejam presentes.
v .svg : image/svg+xml v .woff : application/x-font-woff v .json : application/json v .woff2 : font/woff2 v .template : text/html v .txt : text/plain
5. Se você estiver configurando a conexão única entre o IIS e o Cognos, clique com o botão direito em ibmcognos e clique em Incluir aplicativo.
v Aliaspara sso.
v Conjunto de aplicativosé aquele criado na etapa 1. v Caminho físicoé install_location\cgi-bin
a. Selecione sso e dê um clique duplo em Mapeamentos do manipulador.
b. Clique em Incluir mapeamento de módulo na área de janela Ações à direita.
v O caminho da solicitação é cisapi. v O módulo é IsapiModule.
v O executável é install_location\cgi-bin\cognosisapi.dll v O nome é Conexão única do Cognos.
v Clique em Restrições de solicitação e certifique-se de que Chamar o manipuladoresteja desmarcado.
v Dê um clique duplo em OK.
v No diálogo Editar Mapa do Script, clique em Sim.
v Selecione sso e clique duas vezes em Módulos. Se o WebDAVModule aparecer na lista, remova-o.
6. Crie regras de regravação para mapear solicitações para os manipuladores corretos.
a. Clique no diretório bi em ibmcognos.
b. Clique duas vezes em Regravação de URL.
c. Inclua uma variável do servidor para identificar o local do Cognos Analytics clicando em Visualizar Variáveis do Servidor.
v Clique em Incluir.
v Nomeie a variável como HTTP_X_BI_PATH. v Clique em Voltar para regras.
v Clique em Incluir.
v Nomeie a variável HTTP_X_WEBCONTENTROOT v Clique em Voltar para regras.
v Clique em Incluir.
v Nomeie a variável HTTP_X_FORWARDED_HOST. v Clique em Voltar para regras.
d. Inclua uma regra para passar o local do Cognos Analytics para as máquinas ca-hostclicando em Incluir regras > Regras de entrada > Regra em
branco.
v O nome é Cabeçalhos. v O padrão é (.*) v O tipo de ação é none.
v Expanda Variáveis do servidor e
– Clique em Incluir. Selecione HTTP_X_BI_PATH e configure o valor para /ibmcognos/bi/v1.
– Clique em Incluir. Selecione HTTP_X_FORWARDED_HOST e configure o valor para {HTTP_HOST}.
– Clique em Incluir. Selecione HTTP_X_WEBCONTENTROOT e configure o valor para /ibmcognos.
v Desmarque Parar processamento de regras subsequentes. v Clique em Aplicar e Voltar para regras.
e. Se você configurou o aplicativo SSO em uma etapa anterior, inclua regras para mapear solicitações de login e de serviço da UI anterior para o manipulador de SSO.
1) Clique em Incluir regras > Regras de entrada > Regra em branco. v O nome é Login de conexão única.
v O padrão é v1/login$ v O tipo de ação é Regravar.
v A URL de regravação é /ibmcognos/sso/cisapi/bi/v1/login v Marque Parar processamento de regras subsequentes. v Clique em Aplicar e Voltar para regras.
v O nome é Conexão única anterior. v O padrão é (v1/disp(/.*)?) v O tipo de ação é Regravar
v A URL de regravação é /ibmcognos/sso/cisapi/bi/{R:1} v Marque Parar processamento de regras subsequentes. v Clique em Aplicar e Voltar para regras.
f. Inclua uma regra para mapear as solicitações de serviço REST do Cognos Analytics para os servidores backend do Cognos Analytics.
1) Clique em Incluir regras > Regras de entrada e de saída > Proxy reverso.
v Se os proxies ainda não estiverem ativados, será solicitado que ative. Clique em OK.
v O nome do servidor é ca-host:9300/bi
ou se você configurou um server farm, http://ca_servers/bi Selecione a regra recém-criada e clique em Editar.
v O padrão é (^$)|(^v1(/.*)?)|(^[^/]+\.jsp) v O tipo de ação é Regravar.
v A URL de regravação é http://ca-host:9300/bi/{R:0}
ou se você configurou um server farm, http://ca_servers/bi/{R:0} v Marque Parar processamento de regras subsequentes.
v Clique em Aplicar e Voltar para regras.
2) Clique em Incluir regras > Regras de entrada > Regra em branco. v O nome é Event Studio.
v O padrão é ^(ags|cr1|prompting|ccl|common|skins|ps)/(.*) v Abra a seção Condições.
v Mude o Agrupamento local para Corresponder qualquer um v Clique em Incluir.
– A entrada de condição é {HTTP_REFERER}
– Verifique se a sequência de entrada é Corresponde ao Padrão – O padrão é v1/disp
– Verifique Ignorar maiúsculas e minúsculas. v Clique em Incluir
– A entrada de condição é {HTTP_REFERER}
– Verifique se a sequência de entrada é Corresponde ao Padrão – O padrão é (ags|cr1|prompting|ccl|common|skins|ps)/(.*)\.css – Verifique Ignorar maiúsculas e minúsculas.
v Clique em Incluir.
– A entrada de condição é {HTTP_REFERER}
– Verifique se a sequência de entrada é Corresponde ao Padrão – O padrão é pat/rsapp.htm
– Verifique Ignorar maiúsculas e minúsculas. v O tipo de ação é Regravar
v A URL de regravação é /ibmcognos/{R:0}
v Marque Parar processamento de regras subsequentes. v Clique em Aplicar e Voltar para regras.
3) Clique em Incluir regras > Regras de entrada > Regra em branco v O nome é Visualizador de Relatório
v O padrão é ^rv/(.*) v O tipo de ação é Regravar
v A URL de regravação é /ibmcognos/{R:0}
v Marque Parar processamento de regras subsequentes. v Clique em Aplicar e Voltar para regras.
7. Ajustar limites de tamanho solicitado.
a. Selecione o diretório bi no aplicativo ibmcognos criado anteriormente.
b. Clique duas vezes em Filtro de solicitação.
c. Clique em Configurações do recurso de edição... no painel direito. v Configure o Comprimento máximo de URL (bytes) para 8192. v Configure a Sequência máxima de consultas (bytes) para 8192. v Clique em OK.
d. Clique duas vezes em Filtro de solicitação.
e. Selecione a guia Cabeçalhos e clique em Incluir cabeçalho.
f. Na Xaixa de cabeçalho, digite o nome do campo de cabeçalho como Referente.
g. Na caixa Limite de tamanho, digite 8192.
h. Clique em OK.
i. Repita o processo para um nome de campo de cabeçalho chamado Cookie com o Limite de tamanho de 4096.
j. Clique em OK.
k. Clique no diretório virtual ibmcognos.
l. Na visualização Início, na seção Gerenciamento, clique em Editor de configuração.
m. Na lista suspensa Seção, expanda system.webe selecione httpRuntime.
n. Configure a propriedade maxQueryStringLength para 8192.
o. Aplique a mudança na configuração.
8. Configure o IIS para permitir que passe por erros 441 customizados que são usados para exceções recuperáveis do CAM. Caso contrário, o IIS pode bloquear esses erros e o cliente vê o erro "Resposta de logon inválida" quando tentar efetuar logon.
a. Clique no diretório virtual ibmcognos.
b. Na visualização Início, seção Gerenciamento, dê um clique duplo em Editor de configuração.
c. Na lista suspensa Seção, expanda system.webServer e selecione httpErrors.
d. Configure a propriedade existingResponse como PassThrough.
e. Aplique a mudança na configuração.
9. Se você configurou o aplicativo SSO em etapas anteriores, ative Autenticação do Windows.
a. Selecione o aplicativo de SSO. Para o navegador Microsoft Edge, selecione o aplicativo ibmcognos.
b. Dê um clique duplo em Autenticação. Desative Autenticação anônima e ative Autenticação do Windows.
O Cognos Analytics deve agora estar disponível em: http://iis-host/ ibmcognos.
Nota: Se você configurou uma pasta de diretório virtual de vários níveis acima do aplicativo ibmcognos, ou seja, Website padrão > MyVirtualDirectoryFolder > ibmcognos, use /MyVirtualDirectoryFolder/ibmcognos em vez de /ibmcognos nas regras de reescrita de URL que você criou na etapa 6.