-
Não é possível usar os módulos Apache com a versão do Apache Server 2.2 que é fornecida com o Red Hat Enterprise Linux versão 5.3 e posterior.
Antes de Iniciar
Este tópico presume que tenha instalado um componente de gateway opcional, que tenha um Servidor HTTP Apache instalado e em execução e que possa administrar ambientes Linux e UNIX.
Ao usar o Servidor HTTP Apache, fique atento aos seguintes recursos que estão disponíveis nas diferentes versões.
Variável Apache 2.2 Apache 2.4
Balanceamento de Carga Não suportado Sim
Módulo Gateway Sim Não
Proxy Sim Sim
Configure o Apache HTTP Server para aceitar um novo arquivo de configuração que manterá todas as configurações necessárias para o IBM Cognos Analytics.
Apache 2.2
Procedimento
1. Edite o arquivo cognos.conf e inclua as seguintes linhas: LoadModule headers_module modules/mod_headers.so
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule cognos_module "<gateway_location>/cgi-bin/mod2_2_cognos.<xx>" <Location /<alias>/bi>
RequestHeader set X-BI-PATH /alias/bi/v1 ProxyPass http(s)://<app_server:port>/bi ProxyPassReverse http(s)://<app_server:port>/bi ProxyPassReverseCookieDomain "." "<domain>" </Local>
# Aliases for the CA web content
ScriptAlias /<alias>/cgi-bin "<gateway_location>/cgi-bin" <Directory "<gateway_location>/cgi-bin">
AllowOverride None Options None Order allow,deny Allow from all </Directory>
Alias /<alias> "<gateway_location>/webcontent" <Directory "<gateway_location>/webcontent">
Options Indexes MultiViews AllowOverride None
Order allow,deny Allow from all
</Directory>
<Location /<alias>/cgi-bin/mod2_2_cognos.<xx>> SetHandler cognos-handler
CGIBinDir "<gateway_location>/cgi-bin/" Order allow,deny
Allow from all </Location>
2. Na seção acima que foi incluída, substitua os itens temporários pelos valores apropriados:
v <alias> - forneça um nome para o alias da web. Por exemplo, ibmcognos
v <app_server:port> - especifique o nome e o número da porta de um servidor
Cognos Analytics Application. Por exemplo, appserver.ibm.com:9300
v <domain> - especifique o domínio no qual os servidores estão localizados. Por
exemplo, ibm.com
v <gateway_location> - especifique o local físico do Gateway do Cognos
Analytics que foi instalado. Por exemplo, /opt/ibm/cognos/analytics v <xx> - forneça o sufixo da extensão dependendo do sistema operacional no
qual o Apache está instalado. Por exemplo, Windows = dll, Unix/Linux = so
3. Salve o arquivo cognos.conf.
4. Se você tiver configurado a conexão única para o IBM Cognos Analytics, chame-a usando a URL a seguir:
http://ICA_Web_Server:80/ibmcognos/cgi-bin/mod2_2_cognos.so? b_action=xts.run&m=portal/main.xts&m_redirect=/ibmcognos/bi/
Apache 2.4
Procedimento
1. Edite o arquivo cognos.conf e inclua o seguinte: LoadModule headers_module modules/mod_headers.so LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so LoadModule slotmem_plain_module modules/mod_slotmem_plain.so LoadModule slotmem_shm_module modules/mod_slotmem_shm.so LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule lbmethod_byrequests_module modules/mod_lbmethod_byrequests.so # Header to add a cookie for sticky sessions
Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED
# Send everything which goes to BI Services through balanced proxy #
# Add/Remove the number of BalanceMember lines depending on the server in your # environment
<Proxy balancer://mycluster>
BalancerMember http://<app_server_x:port> route=1 BalancerMember http://<app_server_x:port> route=2 ProxySet stickysession=ROUTEID
</Proxy>
<LocationMatch ^/<alias>/bi/(.*)$>
RequestHeader set X-BI-PATH /<alias>/bi/v1 ProxyPass balancer://mycluster/bi/$1 ProxyPassReverseCookieDomain "." "<domain>" </LocationMatch>
ProxyRequests off
# Aliases for the CA web content
ScriptAlias /<alias>/cgi-bin "<gateway_location>/cgi-bin" <Directory "<gateway_location>/webcontent/cgi-bin">
AllowOverride None Options None
Requerer todos concedidos </Directory>
Alias /<alias> "<gateway_location>/webcontent" <Directory "<gateway_location>/webcontent">
Options Indexes MultiViews AllowOverride None
Requerer todos concedidos </Directory>
2. Mude os seguintes itens para refletir o ambiente:
v <alias> - forneça um nome para o alias da web. Por exemplo, ibmcognos
v <app_server_x:port> - especifique o nome e o número da porta de um servidor
de aplicativos do ICA. Por exemplo, appserver.ibm.com:9300
v <domain> - especifique o domínio no qual os servidores estão localizados. Por
exemplo, ibm.com
v <gateway_location> - especifique o local físico em que o Gateway do ICA foi
instalado. Por exemplo, /opt/ibm/cognos/analytics
3. Para incluir ou remover servidores da camada do aplicativo da configuração de proxy, ajuste o número de linhas BalancerMember de forma apropriada na seção Proxy.
Por exemplo, se tiver um servidor de aplicativos, então deverá haver somente uma entrada.
<Proxy balancer://mycluster>
BalancerMember http://app_server_1:port route=1 ProxySet stickysession=ROUTEID
</Proxy>
Se tiver 4 servidores de aplicativos, então deverá haver 4 entradas. <Proxy balancer://mycluster>
BalancerMember http://app_server_1:port route=1 BalancerMember http://app_server_2:port route=2 BalancerMember http://app_server_3:port route=3 BalancerMember http://app_server_4:port route=4 ProxySet stickysession=ROUTEID
</Proxy>
O parâmetro route= determina a ordem na qual a solicitação será enviada.
4. Salve o arquivo cognos.conf.
5. Reinicie o servidor HTTP Apache.
6. Supondo que a conexão única tenha sido configurada para o IBM Cognos Analytics, a conexão única pode ser chamada com a URL a seguir:
http://ICA_Web_Server:80/ibmcognos/bi/v1/disp?b_action=xts.run&m=portal/ main.xts&m_redirect=/ibmcognos/bi/
7. Como alternativa, se desejar remover a seção de redirecionamento da URL, será possível fazer o seguinte:
a. Acesse o diretório analytics/webcontent.
b. Edite o arquivo default.htm modificando a seguinte linha.
Altere <meta http-equiv="refresh" content="0; URL=/bi"> para <meta http-equiv="refresh" content="0; URL=/<alias>/bi">
c. Salve o default.htm
d. Faça o mesmo com index.htm
e. Teste a conexão usando http:// ICA_Web_Server:80/ibmcognos/bi/v1/disp ou http:// ICA_Web_Server:80/ibmcognos/cgi-bin/mod2_2_cognos.so