É possível configurar uma instância do IBM® HTTP Server no sistema operacional z/OS após instalar o código do IBM HTTP Server usando o IBM Installation Manager.
Antes de Iniciar
Antes de utilizar o programa instalador:
Sobre Esta Tarefa
Usando o programa instalador, execute as
tarefas a seguir
para instalar uma instância em execução do IBM HTTP
Server para z/OS em sua máquina.
Procedimento
- Efetue login no shell z/OS UNIX System Services com
o ID do usuário que executa o instalador. (Consulte a seção Antes de Começar
neste tópico). Altere o diretório para o diretório do código do produto do IBM HTTP Server:
cd /usr/lpp/IHSA/V8R5
- Configure o valor de umask como 022
especificando umask
022. Para verificar se o valor de umask está configurado
como 022, execute o comando umask.
- Execute o programa instalador para instalar os arquivos do produto no diretório
de instalação, execute a customização inicial e crie links simbólicos do diretório de
instalação até o diretório do produto.
bin/install_ihs -admin server_installation_directory server_port
Três parâmetros podem ser utilizados para chamar o programa instalador.
- Opcional: A palavra-chave -admin, que
permite o uso do console administrativo para modificar o arquivo httpd.conf.
- O diretório de instalação para a instância do servidor. Ele não deve ser igual ao do
diretório do produto.
- Opcional:
A porta não SSL para o servidor da
Web. A porta padrão é 80. Também é possível alterar a porta na diretiva Listen.
Os exemplos a seguir chamam o programa instalador a partir do console administrativo. Você pode chamar o comando com ou sem suporte para modificar o arquivo
httpd.conf. Para os dois exemplos,
/etc/websrv1 é o diretório de instalação e
80 é a porta não SSL do servidor da Web.
Nota: Se o caminho do diretório do produto contiver links simbólicos, aponte os links simbólicos para o diretório do produto padrão a seguir: /usr/lpp/IHSA/V8R5.
Se você não usar o diretório do produto padrão, deverá chamar o script de instalação usando seu caminho absoluto, como por exemplo, /WebSphere/8.5/SMPE/bin/install_ihs.
Se você não usar uma das duas opções, o IBM HTTP
Server criará links físicos, não links lógicos, quando ele criar
os links simbólicos para o diretório de instalação.
- Opcional: Esta etapa é opcional, a menos
que o console administrativo
esteja configurado para iniciar e parar o IBM HTTP Server. É possível iniciar a instância do IBM HTTP Server a partir do console MVS criando um procedimento catalogado de JCL
para a instância. Para obter informações adicionais, consulte o tópico sobre como usar
procedimentos JCL para iniciar o IBM HTTP
Server no z/OS. Assegure que
o procedimento JCL esteja designado ao usuário e grupo definidos para IBM HTTP Server, conforme descrito no
tópico sobre como executar configurações do sistema z/OS
necessárias.
- Opcional: É possível
criar diversas instâncias
do IBM HTTP Server executando
o programa instalador do IBM HTTP
Server mais de uma vez. No entanto, você deve especificar um diretório de instalação diferente sempre
que executar o programa instalador.
Resultados
Desempenhe as tarefas a seguir para confirmar se você instalou com êxito
uma versão em execução do produto em sua máquina:
- Efetue logon no shell OMVS utilizando o ID do usuário do servidor. Verifique se o ID
do usuário do servidor tem um valor UID diferente de zero. Altere o diretório para o diretório de instalação da instância do servidor:
cd /etc/websrv1
- Execute os seguintes comandos para verificar a instalação do programa: apachectl
-v e apachectl configtest
A saída de amostra a seguir
é um exemplo de uma instalação de programa bem-sucedido:
# bin/apachectl -v
Versão do servidor: IBM_HTTP_Server/8.5.0.0 (Unix)
Servidor construído: 9 de janeiro de 2012 11h20min34s
# bin/apachectl configtest
Sintaxe OK
A sequência de versão e a data de compilação reais variam.
- Inicie o IBM HTTP Server.
bin/apachectl start
- Aponte um navegador da Web para o nome ou endereço IP de seu sistema z/OS, usando o número da porta
não SSL especificado ao executar o programa instalador ou a
porta padrão de 80. Você deve ver a página inicial padrão do IBM HTTP
Server.
- Pare o IBM HTTP
Server
executando o comando a seguir:
bin/apachectl stop
O que Fazer Depois
- Instale e configure
o plug-in do WebSphere Application
Server para o IBM HTTP
Server
- Para obter informações
sobre como editar o arquivo de configuração do IBM HTTP
Server, httpd.conf, e informações sobre
módulos Apache suportados, consulte o tópico sobre como configurar o IBM HTTP Server.
As alterações típicas que você pode fazer no arquivo de configuração são:
- Edite a diretiva DocumentRoot para apontar para as páginas da Web do seu site.
- Ative o plug-in do WebSphere Application
Server para IBM HTTP
Server incluindo as seguintes diretivas no final de httpd.conf:
LoadModule was_ap22_module <plugin_config_hfs>/bin/mod_was_ap22_http.so
WebSpherePluginConfig /path/to/existing/plugin-cfg.xml
Se
o arquivo de configuração de plug-in tiver sido usado com um plug-in do WebSphere Application Server Versão 5.0
ou 5.1, o arquivo estará em EBCDIC. Antes de usar o arquivo
com este plug-in do WebSphere Application
Server Versão 6.0 ou superior, é necessário convertê-lo em ASCII.
O exemplo a seguir é para converter o arquivo de configuração de plug-in de EBCDIC em ASCII:
$ iconv -f IBM1047 -t ISO8859-1 < /path/to/existing/plugin-cfg.xml \
> /path/to/ascii/plugin-cfg.xml
- Ative o suporte SSL incluindo as seguintes diretivas no final de httpd.conf:
LoadModule ibm_ssl_module modules/mod_ibm_ssl.so
Listen 443
<VirtualHost *:443>
SSLEnable
</VirtualHost>
SSLDisable
Keyfile /saf saf-keyring-name
A diretiva Keyfile pode
especificar um nome do arquivo HFS usando a sintaxe: Keyfile /path/to/keyfile.kdb.
O arquivo .sth deve estar no mesmo diretório do arquivo .kdb. Para obter informações adicionais, consulte Protegendo com Comunicações SSL e Diretivas SSL.
- Ative o mod_status removendo o delimitador de comentário no arquivo de configuração padrão destacado no exemplo a seguir:
<IfModule mod_status.c>
ExtendedStatus On
</IfModule>
...
#<Location /server-status>
# SetHandler server-status
# Order deny,allow
# Deny from all
# Allow from .example.com
#</Location>
Se você desejar restringir o acesso a redes específicas,
remova o comentário da configuração da amostra mod_access,
mas modifique a diretiva Allow from para especificar o domínio ou a rede apropriado.
- É possível instalar o servidor da Web em um R/W compartilhado do HFS
através de vários hosts em um sysplex.
Há requisitos de configuração especiais para componentes
do servidor da Web que utilizam soquetes AF_UNIX. Os soquetes AF_UNIX não são suportados por um
HFS que são R/W compartilhados, de modo que as diretivas de configuração são utilizadas para colocar soquetes AF_UNIX em um sistema de arquivos possuído pelo host no qual o servidor da Web é executado.
- Se mod_ibm_ssl estiver carregado, utilize a diretiva SSLCachePortFilename para especificar um arquivo
em um sistema de arquivos possuído pelo host local.
- Se mod_fastcgi estiver carregado, utilize a diretiva FastCGIIpcDir para especificar um
diretório em um sistema de arquivos possuído pelo host local.
- Inclua suporte no console administrativo após a instalação inicial.