Capítulo 1. Requisitos de Instalação para o IBM WebSphere Application Server - Express
Capítulo 2. Instalando o WebSphere Application Server - Express no Windows
Capítulo 3. Instalando o WebSphere Application Server - Express no Linux
Capítulo 4. Instalando o WebSphere Application Server - Express no AIX
Capítulo 5. Instalando o WebSphere Application Server - Express no Solaris
Capítulo 6. Instalando o WebSphere Application Server - Express no HP-UX
Capítulo 7. Plug-ins de Segurança do HTTP Web Server
Capítulo 8. Instalando os Plug-ins de Segurança do HTTP Web Server
Esta sexta edição (novembro de 2003) do Guia de Instalação contém as seguintes informações para o WebSphere Application Server - Express Versão 5.1:
Consulte o site de suporte do produto no endereço www.ibm.com/software/webservers/appserv/express/support.html para obter as seguintes informações sobre correções e suporte:
Por exemplo, para fazer upgrade de 5.0, 5.0.1 ou 5.0.2 para 5.1.
Observe o seguinte a respeito do WebSphere Application Server - Express V5.1:
Esse guia está disponível nas versões HTML e PDF do Acrobat, no diretório raiz do CD de instalação e no diretório de instalação do produto. Ambas as versões contêm informações idênticas. Você pode abrir o install.html em qualquer navegador da Web. Para abrir o arquivo install.pdf, você deve ter o software Acrobat Reader instalado, o qual pode ser transferido por download a partir do endereço www.adobe.com/products/acrobat/readstep2.html.
O hardware a seguir deve ser instalado antes do WebSphere Application Server - Express:
Monitor de 800 x 600 no mínimo (1024 x 768 recomendado)
Monitor de 1024 x 768 no mínimo
Suporte para um adaptador de comunicações
Suporte para TCP/IP e um adaptador.
O software a seguir deve ser instalado antes do WebSphere Application Server - Express:
Um dos seguintes sistemas operacionais:
Windows(R) 2000 Server ou Advanced Server com Service Pack 4 ou
superior, apenas componente do servidor remoto
Windows(R) 2003 Server Standard Edition apenas Componente Remote
Server
Windows(R) 2000 Professional com Service Pack 4 ou superior,
ferramentas e componentes de servidor do WebSphere Studio
Windows XP SP1a Professional para as ferramentas e componentes de servidor do
WebSphere Studio
Red Hat , Versão 7.2 para o componente de ferramentas do WebSphere
Studio, incluindo apenas o ambiente de teste da unidade
Red Hat, Versão 8.0 para o componente ferramentas do WebSphere Studio,
incluindo apenas o ambiente de teste da unidade.
Red Hat, Versão AS (ou EL) 2.1 apenas para o componente de servidor
remoto
SuSE, Versão 7.2, Componente WebSphere Studio Tools, incluindo apenas o
ambiente de teste da unidade.
SuSE, Versão 8.1 Componente Studio Tools incluindo apenas o ambiente de
teste da unidade.
United Linux V 1.0 (Suse SLES 8) apenas Componente Remote Server
Apenas o Componente Remote Server do AIX 5.2 (5200-Nível de
Manutenção 01), com a implementação Remote de qualquer Studio Tools Platform
suportado
Apenas o Componente Remote Server do Solaris 9 (com o Cluster de Correção
Recomendado de Abril de 2003)
Apenas o Componente Remote Server do HP 11iv1 (Nível de Correção de Dezembro
de 2002)
Tabela 1. Idiomas Nacionais Suportados pelos Sistemas Operacionais Red Hat e SuSE.
|
| Somente em Inglês | Inglês e Idioma Nacional | SBCS (Conjunto de Caracteres com Bytes Simples) | DBCS (Conjunto de Caracteres de Byte Duplo) (Nota 1) |
|---|---|---|---|---|
| Red Hat 7.2 | SIM |
|
|
|
| Red Hat 8.0 |
| SIM | SIM | SIM (1) |
| SuSE 7.2 | SIM |
|
|
|
| SuSE 8.1 |
| SIM | SIM |
|
(1) Para utilizar o conjunto de caracteres de byte duplo no Red Hat 8.0, será necessário fazer o upgrade de GTK 2.0 para GTK 2.2 ou posterior. Consulte (Opcional) Fazendo Upgrade para GTK 2.2.2 ou Superior.
Avisos:
Se você tiver o WebSphere Application Server - Express instalados e você instalou plug-ins de terceiros, será necessário obter os plug-ins correspondentes para a Versão 5.1.1 e reinstalá-los.
Este pacote contém dois conjuntos de CDs:
Installation Usage Scenarios
IMPORTANTE: Você pode utilizar o DB2 Universal Database Express Edition em uma máquina apenas para demonstração, teste e desenvolvimento de programas aplicativos. Você tem a opção de não instalar nenhum programa em um servidor de produção. Consulte a licença em anexo para obter detalhes adicionais.
Esta seção contém informações sobre a instalação do WebSphere Application Server - Express no Windows. Os principais componentes do WebSphere Application Server - Express são o Application Server, o Remote Agent Controller e o WSSD (WebSphere Studio Site Developer). Você pode optar por instalar qualquer um ou todos esses componentes. Você precisa instalar o Remote Agent Controller junto com o Application Server para conseguir administrar o Application Server utilizando o WSSD. Instale o WebSphere Application Server - Express a partir do CD-ROM ou das imagens eletrônicas das quais fez download.
Nota de Instalação:
O programa de instalação pode ser executado em um modo de console interativo em vez de utilizar os painéis do assistente GUI. O modo de console pode ser de melhor correspondência para pessoas com requisitos de acessibilidade. O modo "-accessibility" fornece informações audíveis adicionais para usuários finais com deficiência visual. Para executar em modo de console, execute este comando a partir do diretório de instalação do CD de instalação do WebSphere Application Server - Express:
Siga os prompts para completar a instalação. Observação: A opção "-is:javaconsole" é crítica. Se esta opção não for especificada, o programa de instalação travará. O "-log @NONE" efetua logoff para eliminar as informações de log advindas do console. Caso ocorra algum problema durante a instalação, é possível que você deseje eliminar esta opção para coletar informações de log.
Importante: Não instale essa versão sobre uma versão anterior. Você pode instalar em um diretório diferente para coexistência ou pode desinstalar a versão anterior antes de instalar no mesmo diretório. Se o programa de instalação detectar uma versão anterior do servidor de aplicativos, será oferecida a opção para migrar a configuração do servidor para o servidor 5.1. Consulte o Guia de Migração para obter detalhes adicionais.
Importante: Se você tentar abrir um espaço de trabalho da Versão 4.0.x a partir da Versão 5.1.1 do Studio Site Developer IDE, o espaço de trabalho será convertido em um espaço de trabalho da Versão 5.1.1. Os nomes de projetos, os arquivos de origem do projeto e os caminho de construção Java do projeto (classpaths) são retidos. No entanto, as definições da interface com o usuário, as definições de depuração e a maioria das preferências se perdem. Consulte o Guia de Migração para obter instruções sobre como migrar com segurança os projetos existentes para a Versão 5.1.1.
Como precaução, recomenda-se que você faça uma cópia de backup de seus espaços de trabalho da Versão 5.x, antes de migrar para a Versão 5.1.1
Antes de instalar o produto, verifique o seguinte:
Para instalar o WebSphere Application Server - Express a partir do primeiro CD de instalação do produto, siga estas etapas:
Dicas:
Importante: Não instale em um diretório cujo nome contenha caracteres de byte duplo ou caracteres especiais, como o cifrão. Se isso for feito poderá causar resultados indesejáveis, como problemas de caminho da classe no ambiente de teste do WebSphere.
Há várias partes que podem ser transferidas por download do WebSphere Application Server - Express. Todas as partes são archives autodescompactáveis e todas são obrigatórias.
Antes de instalar o produto, verifique o seguinte:
Para instalar a imagem eletrônica do WebSphere Application Server - Express, siga estas etapas:
Depois de instalar o WebSphere Application Server - Express, é necessário ter a seguinte estrutura de diretórios sob o <caminho_de_instalação_do_Express> selecionado durante a instalação:
Se qualquer um desses diretórios contiver um número substancialmente diferente de arquivos, comece a suspeitar de que um problema aconteceu durante a instalação. Veja o arquivo expressInstallLog.txt no diretório <caminho_de_instalação_do_Express>\logs para diagnosticar o problema.
Se a instalação tiver sido concluída com êxito, inicie o Site Developer pelo item de menu Iniciar > Programas > IBM WebSphere Application Server - Express 5.1 >Studio Site Developer. Depois que o Site Developer for iniciado, siga os links na página de boas-vindas para carregar e executar um exemplo do Express.
O IBM Agent Controller é sempre instalado como um serviço do Windows e automaticamente iniciado. O IBM Agent Controller fornece o canal de comunicação entre o Site Developer e o Application Server. Verifique o Painel de Controle> Ferramentas Administrativas > Serviços para identificar se o IBM Agent Controller está listado e em execução. Se suspeitar de um problema, veja o arquivo servicelog.log no diretório <caminho_de_instalação_do_Express>\RAC\config.
Se a instalação não tiver sido concluída com êxito, veja o arquivo racInstallLog.txt no diretório <caminho_de_instalação_do_Express>\logs. Se o arquivo racInstallLog.txt não existir, talvez seja porque outra versão do IBM Agent Controller já esteja instalada no sistema. Remova a instalação da outra versão e tente instalar novamente.
Você pode verificar a operação básica de instalação do Application Server executando Verify Server Installation a partir do aplicativo First Steps. O First Steps é ativado no final da instalação ou você pode ativá-lo a partir de Iniciar > Programas > IBM WebSphere Application Server - Express 5.1 > First Steps.
Alternativamente, você pode verificar a operação do Application Server executando o arquivo <caminho_de_instalação_do_Express>\Express\bin\testServer.bat. Esse arquivo em batch será percorrido através da inicialização e interrupção do Application Server utilizando sua configuração padrão. Observe que esse arquivo em batch é utilizado apenas para testar a instalação do seu servidor.
A execução de setupwin32.exe inicia o programa de instalação Java e depois retorna o controle para o prompt de comandos. A instalação, na verdade, continua a execução no segundo plano. Há várias maneiras simples de verificar se uma instalação silenciosa foi concluída:
Uma maneira alternativa de executar o programa de instalação é emitir o comando para executar o programa de instalação Java diretamente. Vários parâmetros da linha de comandos precisam ser passados para o programa de instalação para que ele funcione corretamente. No diretório util do primeiro CD, há um exemplo de arquivo em batch com o nome syncInstall.bat que pode ser utilizado para executar a instalação sincronicamente -- isto é, o controle não retornará para o prompt de comandos até que a instalação esteja completamente concluída. É possível transmitir parâmetros para o comando syncInstall.bat da mesma forma que para setupwin32.exe. Esse comando em batch é particularmente útil para cenários que utilizam a instalação silenciosa.
O programa de instalação do WebSphere Application Server - Express pode ser executado silenciosamente, se você mesmo quiser empacotar o produto. Para instalar o WebSphere Application Server - Express silenciosamente, a opção -silent command-line deve ser utilizada. Durante uma instalação silenciosa, você não verá os painéis do assistente após chamar o comando de instalação.
Para executar a instalação silenciosamente aceitando todos os padrões, utilize um comando semelhante a:
setupwin32.exe -silent
Se deseja alterar a localização de instalação padrão do Express (IBM/WebSphere/Express), utilize:
setupwin32.exe -silent -P waseBean.installLocation=c:\<seu_diretório>
Você também pode utilizar um arquivo de resposta para definir opções adicionais para uma instalação silenciosa. Consulte o exemplo de arquivo de resposta no CD de instalação para obter um gabarito. Para executar uma instalação silenciosa utilizando um arquivo de resposta, utilize um comando como:
setupwin32.exe -silent -options <caminho completo>\responsefile
Nota: O WebSphere Application Server - Express não suporta uma instalação silenciosa a partir de um CD quando o recurso WebSphere Studio Site Developer é selecionado. O motivo é que esse recurso requer o segundo CD e o programa de instalação não solicita o segundo CD durante uma execução silenciosa. Para instalar o recurso WebSphere Studio Site Developer silenciosamente, você pode copiar o segundo CD para o disco rígido ou montar o CD em uma segunda unidade de CD e utilizar, em seguida, a opção '-media 2=<caminho para o segundo CD>' para indicar ao programa de instalação onde localizar a segunda imagem do CD.
Um arquivo de resposta é fornecido com o Express em: \util\responsefile.txt. Você pode utilizar esse arquivo como modelo de arquivo de resposta.
Para desinstalar o WebSphere Application Server - Express:
Para remover completamente o WebSphere Application Server - Express, exclua os diretórios restantes manualmente.
Ao executar a desinstalação do WebSphere Application Server - Express, o painel de recursos exibido possui diversos recursos adicionais, exibidos durante a instalação. Esses recursos adicionais aparecem como sub-recursos do recurso Studio Site Developer. Se deseja selecionar ou remover a seleção do recurso Studio Site Developer, certifique-se de que todos os sub-recursos estejam selecionados ou não selecionados.
O IBM Agent Controller fornece o mecanismo de comunicação entre o Studio Site Developer e o Application Server. O Agent Controller é instalado como um serviço do Windows e é configurado para ser executado na conta do Sistema Local. Se você quiser, poderá utilizar o painel do gerenciador Windows Services para alterar essa configuração de modo que o IBM Agent Controller seja executado em outra conta de usuário. Depois que o Agent Controller é utilizado para iniciar o Application Server, a conta na qual o Agent Controller está sendo executado também será a conta na qual o Application Server está sendo executado.
Há várias opções de segurança de link entre o Studio Site Developer e o Agent Controller. A instalação configura o link para permitir que qualquer usuário do Studio Site Developer se conecte ao Agent Controller. Você terá que alterar esse padrão de segurança ao utilizar o Agent Controller em um ambiente do servidor de produção.
Você pode utilizar os arquivos <caminho_de_instalação_do_Express>\RAC\bin\RACSecurityOn.bat e RACSecurityOff.bat para ativar e desativar a segurança básica de login. Quando a segurança é ativada, o usuário do Studio Site Developer deve fornecer uma combinação de nome de usuário e senha válidos que seja um nome de usuário e senha do sistema operacional ao se conectar ao Agent Controller. O nome de usuário e senha são encaminhados pelo Agent Controller para o sistema operacional para autenticação. No Windows, as senhas de nomes de domínios não serão autenticadas. Você deve fornecer pares de nome de usuário e senha locais.
Para executar o utilitário SetConfig do IBM Agent Controller, você deve ter java no caminho de execução.
Se o WebSphere Application Server - Express 5.1 for instalado em uma máquina que já possua uma cópia do WebSphere Application Server - Express 5.0, o IBM Agent Controller será atualizado para a versão 5.1.1 e será configurado para apontar para o servidor Express 5.1. Se, subseqüentemente, você desejar remover o WebSphere Application Server - Express 5.1 e restaurar o ambiente 5.0, será necessário reinstalar o Application Server 5.0 ou o componente Studio Site Developer para restaurar a versão 5.0 do IBM Agent Controller. Qualquer um desses recursos 5.0 também instala o IBM Agent Controller para 5.0.
Esta seção aborda problemas e limitações conhecidos de instalação e desinstalação do WebSphere Application Server - Express no Windows. Consulte o arquivo readme para obter informações sobre problemas e limitações que afetem a utilização real do produto.
Se você mapear uma unidade de rede sem especificar um nome de dispositivo (por exemplo, \\computername\sharename), é possível que você obtenha a seguinte mensagem ao tentar instalar o WebSphere Application Server - Express: The wizard cannot continue because of the following error: could not load wizard specified in /wizard.inf(104). A solução alternativa é mapear localmente a unidade de rede, especificando um nome de dispositivo (por exemplo, x:\sharename).
Não instale em uma unidade Novell NetWare. A instalação irá falhar em uma unidade Novell NetWare.
Efetue logon como administrador antes de iniciar a instalação do WebSphere Application Server - Express.
Ocasionalmente, uma falha de instalação pode resultar na remoção de instalação de arquivos do diretório _uninst que não está sendo concluído. O indício disso é uma mensagem declarando que uma JVM adequada não pode ser localizada ao tentar executar a desinstalação. É necessário executar manualmente a desinstalação, da seguinte maneira:
Se a instalação falhar, você deverá remover qualquer arquivo do WebSphere Application Server - Express que tenha sido instalado. Se o diretório no qual você pretende instalar o WebSphere Application Server - Express estiver vazio, o processo de instalação já removeu todos os arquivos que estavam instalados e você poderá excluir o diretório vazio, se desejar.
Etapas as serem seguidas se a instalação falhar:
Esta seção contém informações sobre a instalação do WebSphere Application Server - Express no Linux. Os componentes principais do WebSphere Application Server - Express são o Application Server, o Remote Agent Controller e o WSSD (WebSphere Studio Site Developer). Você pode optar por instalar qualquer um ou todos esses componentes. Você precisa instalar o Remote Agent Controller junto com o Application Server para conseguir administrar o Application Server utilizando o WSSD.
Você pode instalar o WebSphere Application Server - Express a partir do CD-ROM ou das imagens eletrônicas transferidas por download.
Nota de Instalação:
O programa de instalação pode ser executado em um modo de console interativo em vez de utilizar os painéis do assistente GUI. O modo de console pode corresponder melhor aos requisitos de acessibilidade das pessoas. O modo "-accessibility" fornece informações audíveis adicionais para usuários finais com deficiência visual. Para executar em modo de console, execute este comando a partir do diretório de instalação do CD de instalação do WebSphere Application Server - Express:
Siga os prompts para completar a instalação. Observação: A opção "-is:javaconsole" é crítica. Se esta opção não for especificada, o programa de instalação travará. O "-log @NONE" efetua logoff para eliminar as informações de log advindas do console. Caso ocorra algum problema durante a instalação, é possível que você deseje eliminar esta opção para coletar informações de log.
Não instale essa versão sobre uma versão anterior. Você pode instalar em um diretório diferente para coexistência ou pode desinstalar a versão anterior antes de instalar no mesmo diretório. Se o programa de instalação detectar uma versão anterior do servidor de aplicativos, será oferecida a opção para migrar a configuração do servidor para o servidor 5.1. Consulte o Guia de Migração para obter detalhes adicionais.
Para obter instruções sobre como migrar com segurança os projetos existentes de uma versão anterior do Studio Site Developer para a Versão 5.1.1, consulte o Guia de Migração.
Como precaução, recomenda-se que você faça uma cópia de backup de seus espaços de trabalho da Versão 4.0.x e da Versão 5.0 antes de migrar para a Versão 5.1.1.
Para instalar o WebSphere Application Server - Express a partir do CD do produto, siga estas etapas:
Executando 'setupLinux' a partir de uma janela de comandos: Se o diretório de trabalho atual da janela de comandos for /mnt/cdrom e você estiver instalando a partir do CD, quando a instalação solicitar o segundo CD de instalação, você não conseguirá ejetar o primeiro CD da unidade. Isto acontece porque o diretório de trabalho da janela de comandos está apontando para o CD, portanto, a unidade de CD parece estar em uso. Para evitar isto, certifique-se de que o diretório de trabalho de uma janela de comandos não esteja definido como /mnt/cdrom. Isso significa que, ao invés de utilizar o comando ./setupLinux para iniciar a instalação, você utilizará o caminho completo para o CD: /mnt/cdrom/setupLinux.
Executando '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' a partir de uma janela de comandos:
Você poderá obter erros informados referentes a 'mqver not found' e 'wempsservice not found'. É possível ignorar essas mensagens de erro.
Executando o Cloudscape no Linux
Para utilizar o Cloudscape no Linux, utilize o script de shell EXPcview.sh fornecido no diretório /opt/IBM/WebSphere/Express51/Express/bin.
Antes de instalar o produto, verifique o seguinte:
A imagem do CD do Linux para o WebSphere Application Server - Express é dividida em várias partes para reduzir o tamanho do download. Cada parte é um arquivo tar (tape archive) e todas elas são necessárias.
Para instalar as imagens eletrônicas do WebSphere Application Server - Express, siga estas etapas:
Após a instalação do WebSphere Application Server - Express, é necessário ter a seguinte estrutura de diretório no diretório /opt/IBM/WebSphere/Express51:
Se qualquer um desses diretórios contiver um número substancialmente diferente de arquivos, comece a suspeitar de que um problema aconteceu durante a instalação. Veja o arquivo /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt para diagnosticar o problema.
Primeiro, veja o arquivo /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt. Vá para a parte inferior e verifique o status de conclusão de instalação. Se a instalação tiver sido concluída com êxito, inicie o Site Developer executando wasexpress51 ou /opt/IBM/WebSphere/Express51/SiteDeveloper/wasexpress51. Depois que o Site Developer for iniciado, siga os links na página de boas-vindas para carregar e executar um dos exemplos do Express.
Se a instalação não tiver sido concluída com êxito, examine o arquivo expressInstallLog.txt para determinar o motivo.
Se a instalação tiver sido concluída com êxito, inicie o IBM Agent Controller executando o /opt/IBMRAC/bin/RAStart.sh. Se você suspeitar de algum problema, consulte o arquivo /opt/IBMRAC/config/servicelog.log.
Se a instalação não for concluída com êxito, examine o arquivo racInstallLog.txt para determinar o motivo.
Você pode verificar a operação básica de instalação do Application Server executando Verify Server Installation a partir do aplicativo First Steps. O First Steps é ativado no final da instalação ou você pode ativá-lo a partir menu Start.
Alternativamente, você pode verificar a operação do Application Server executando o script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Esse script será percorrido através da inicialização e interrupção do Application Server utilizando sua configuração padrão. Observe que esse script é utilizado apenas para testar a instalação do seu servidor.
O programa de instalação do WebSphere Application Server - Express pode ser executado silenciosamente, se você mesmo quiser empacotar o produto. Para instalar o WebSphere Application Server - Express silenciosamente, a opção -silent command-line deve ser utilizada. Durante uma instalação silenciosa, você não verá os painéis do assistente após chamar o comando de instalação.
Para executar a instalação silenciosamente aceitando todos os padrões, utilize um comando semelhante a:
./setupLinux -silent
Você também pode utilizar um arquivo de resposta para definir opções adicionais para uma instalação silenciosa. Consulte o exemplo de arquivo de resposta no CD de instalação para obter um gabarito. Para executar uma instalação silenciosa utilizando um arquivo de resposta, utilize um comando como:
./setupLinux -silent -options <caminho completo>/responsefile
Nota: O WebSphere Application Server - Express não suporta uma instalação silenciosa a partir de um CD quando o recurso WebSphere Studio Site Developer é selecionado. O motivo é que esse recurso requer o segundo CD e o programa de instalação não solicita o segundo CD durante uma execução silenciosa. Para instalar o recurso WebSphere Studio Site Developer silenciosamente, você pode copiar o segundo CD para o disco rígido ou montar o CD em uma segunda unidade de CD e utilizar, em seguida, a opção "-media 2=<caminho para o segundo CD>" para indicar ao programa de instalação onde localizar a segunda imagem do CD.
Um arquivo de resposta de amostra está incluído com o Express em: /util/responsefile.txt. Você pode utilizar esse arquivo como modelo de arquivo de resposta.
O IBM Agent Controller fornece o mecanismo de comunicação entre o Studio Site Developer e o Application Server.
Há várias opções de segurança de link entre o Studio Site Developer e o Agent Controller. A instalação configura o link para permitir que qualquer usuário do Studio Site Developer se conecte ao Agent Controller. Você desejará alterar esse padrão de segurança ao utilizar o Agent Controller em um ambiente do servidor de produção.
Você pode utilizar os scripts /opt/IBMRAC/bin/RACSecurityOn.sh e RACSecurityOff.sh para ativar e desativar a segurança básica de login. Quando a segurança é ativada, o usuário do Studio Site Developer deve fornecer uma combinação de nome de usuário e senha válidos que seja um nome de usuário e senha do sistema operacional ao se conectar ao Agent Controller. O nome de usuário e senha são encaminhados pelo Agent Controller para o sistema operacional para autenticação.
Se o WebSphere Application Server - Express 5.1 for instalado em uma máquina que já possua uma cópia do WebSphere Application Server - Express 5.0, o IBM Agent Controller será atualizado para a versão 5.1.1 e será configurado para apontar para o servidor Express 5.1. Se, subseqüentemente, você desejar remover o WebSphere Application Server - Express 5.1 e restaurar o ambiente 5.0, será necessário reinstalar o Application Server 5.0 ou o componente Studio Site Developer para restaurar a versão 5.0 do IBM Agent Controller. Qualquer um desses recursos 5.0 também instala o IBM Agent Controller para 5.0.
Avisos:
Para utilizar o DBCS (Conjunto de Caracteres de Byte Duplo) no Red Hat 8.0, será necessário executar as seguintes etapas para fazer o upgrade de GTK para 2.2.2 ou posterior. As instruções a seguir destinam-se ao GTK 2.2.2.
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
rpm -q libtiff-devel
Se não estiver instalado, instale-o a partir do CD de instalação do Red Hat.
/usr/local/lib
./configure make make install /sbin/ldconfig
Por padrão, a instalação do GTK 2.0.6 é selecionada. Para certificar-se de que seu aplicativo utilize o GTK 2.2.2, sempre será necessário executar os comandos do exemplo a seguir, a partir da linha de comandos, antes de lançar o aplicativo.
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH export PATH=/usr/local/bin/:$PATH /opt/IBM/WebSphereExpress/SiteDeveloper/wasexpress51
Para obter informações adicionais sobre como utilizar o GTK, consulte o Web site no endereço developer.gnome.org/doc/API/2.2/gtk/gtk-building.html.
Para desinstalar WebSphere Application Server - Express no Linux, siga estas etapas:
./uninstaller
Para remover completamente o WebSphere Application Server - Express, exclua os diretórios restantes manualmente.
Esta seção aborda problemas e limitações conhecidos de instalação e desinstalação do WebSphere Application Server - Express para Linux. Consulte o arquivo readme para obter informações sobre problemas e limitações que afetem a utilização real do produto.
Se sua instalação falhar:
Ocasionalmente, uma falha de instalação pode resultar na remoção de instalação de arquivos do diretório _uninst que não está sendo concluído. O indício disso é uma mensagem declarando que uma JVM adequada não pode ser localizada ao tentar executar a desinstalação. É necessário executar manualmente a desinstalação, da seguinte maneira:
Esta seção contém informações sobre a instalação do WebSphere Application Server - Express no AIX. Os principais componentes do WebSphere Application Server - Express que podem ser instalados no AIX são o Application Server e o Remote Agent Controller. Você pode optar por instalar apenas um ou os dois componentes. Você precisa instalar o Remote Agent Controller junto com o Application Server para conseguir administrar o Application Server no AIX utilizando o Studio Site Developer no Windows ou Linux. Você também pode utilizar o Administrative Console do navegador de base para administrar o Application Server.
Você pode instalar o WebSphere Application Server - Express a partir do CD-ROM ou das imagens eletrônicas transferidas por download.
Se você tiver uma cópia anterior do WebSphere Application Server - Express em seu sistema, será necessário remover a instalação dela antes de continuar.
Existe apenas um CD do produto para instalação. Para instalar o WebSphere Application Server - Express a partir do CD do produto, siga estas etapas:
Antes de instalar o produto, verifique o seguinte:
A imagem do CD do AIX para o WebSphere Application Server - Express é dividida em várias partes para reduzir o tamanho do download.
Cada parte é um arquivo tar (tape archive) e todas elas são necessárias.Para instalar as imagens eletrônicas do WebSphere Application Server - Express, siga estas etapas:
Após a instalação do WebSphere Application Server - Express, é necessário ter a seguinte estrutura de diretório no diretório /opt/IBM/WebSphere/Express51:
Se qualquer um desses diretórios contiver um número substancialmente diferente de arquivos, comece a suspeitar de que um problema aconteceu durante a instalação. Veja o arquivo /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
Primeiro, veja o arquivo /opt/IBM/WebSphere/Express51/logs/expressracInstallLog.txt. Vá para a parte inferior e verifique o status de conclusão de instalação. Se a instalação tiver sido concluída com êxito, inicie o IBM Agent Controller executando o /opt/IBMRAC/bin/RAStart.sh. Se você suspeitar de algum problema, consulte o arquivo /opt/IBMRAC/config/servicelog.log.
Se a instalação não for concluída com êxito, examine o arquivo racInstallLog.txt para determinar o motivo.
Você pode verificar a operação básica de instalação do Application Server executando Verify Server Installation a partir do aplicativo First Steps. O First Steps é ativado no final da instalação ou você pode ativá-lo executando o script/opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh.
Alternativamente, você pode verificar a operação do Application Server executando o script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Esse script será percorrido através da inicialização e interrupção do Application Server utilizando sua configuração padrão. Observe que esse script é utilizado apenas para testar a instalação do seu servidor.
O programa de instalação do WebSphere Application Server Express pode ser executado silenciosamente, se você mesmo quiser empacotar o produto. Para instalar o WebSphere Application Server - Express silenciosamente, é utilizada a opção da linha de comandos -silent. Durante uma instalação silenciosa, você não verá os painéis do assistente após chamar o comando de instalação.
Para executar a instalação silenciosamente aceitando todos os padrões, utilize um comando semelhante a:
./aix/setupAIX -silent
Você também pode utilizar um arquivo de resposta para definir opções adicionais para uma instalação silenciosa. Consulte o exemplo de arquivo de resposta no CD de instalação para obter um gabarito. Para executar uma instalação silenciosa utilizando um arquivo de resposta, utilize um comando como:
./aix/setupAIX -silent -options <fully qualified path>/responsefile
Um arquivo de resposta de amostra está incluído com o Express em: /util/responsefile.text Utilize esse arquivo como modelo de arquivo de resposta.
O IBM Agent Controller fornece o mecanismo de comunicação entre o Studio Site Developer e o Application Server.
Há várias opções de segurança de link entre o Studio Site Developer e o Agent Controller. A instalação configura o link para permitir que qualquer usuário do Studio Site Developer se conecte ao Agent Controller. Você desejará alterar esse padrão de segurança ao utilizar o Agent Controller em um ambiente do servidor de produção.
Você pode utilizar os scripts /opt/IBMRAC/bin/RACSecurityOn.sh e RACSecurityOff.sh para ativar e desativar a segurança básica de login. Quando a segurança é ativada, o usuário do Studio Site Developer deve fornecer uma combinação de nome de usuário e senha válidos que seja um nome de usuário e senha do sistema operacional ao se conectar ao Agent Controller. O nome de usuário e senha são encaminhados pelo Agent Controller para o sistema operacional para autenticação.
Para desinstalar o WebSphere Application Server - Express no AIX, siga estas etapas:
./uninstaller
Esta seção abrange os problemas e limitações conhecidos de instalação e desinstalação do WebSphere Application Server - Express para AIX. Consulte o arquivo readme para obter informações sobre problemas e limitações que afetem a utilização real do produto.
Se sua instalação falhar:
Ocasionalmente, uma falha de instalação pode resultar na remoção de instalação de arquivos do diretório _uninst que não está sendo concluído. O indício disso é uma mensagem declarando que uma JVM adequada não pode ser localizada ao tentar executar a desinstalação. É necessário executar manualmente a desinstalação, da seguinte maneira:
Se você tiver uma cópia anterior do WebSphere Application Server - Express em seu sistema, será necessário remover a instalação dela antes de continuar.
Para instalar o WebSphere Application Server - Express a partir do CD do produto, siga estas etapas:
Nota de Instalação:
Se você executar o comando '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' a partir de uma janela de comandos, poderá obter erros informados referentes a 'mqver not found' e 'wempsservice not found'. É possível ignorar essas mensagens de erro.
Antes de instalar o produto, verifique o seguinte:
A imagem do CD do Solaris para o WebSphere Application Server - Express é dividida em várias partes para reduzir o tamanho do download. Cada parte é um arquivo tar (tape archive) e todas elas são necessárias.
Para instalar as imagens eletrônicas do WebSphere Application Server - Express, siga estas etapas:
Após a instalação do WebSphere Application Server - Express, é necessário ter a seguinte estrutura de diretório no diretório /opt/IBM/WebSphere/Express51:
Se qualquer um desses diretórios contiver um número substancialmente diferente de arquivos, comece a suspeitar de que um problema aconteceu durante a instalação. Veja o arquivo /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
O programa de instalação do WebSphere Application Server - Express pode ser executado silenciosamente, se você mesmo quiser empacotar o produto. Para instalar o WebSphere Application Server - Express silenciosamente, a opção -silent command-line deve ser utilizada. Durante uma instalação silenciosa, você não verá os painéis do assistente após chamar o comando de instalação.
Para executar a instalação silenciosamente aceitando todos os padrões, utilize um comando semelhante a:
./solaris/setupSolaris -silent
Você também pode utilizar um arquivo de resposta para definir opções adicionais para uma instalação silenciosa. Consulte o exemplo de arquivo de resposta no CD de instalação para obter um gabarito. Para executar uma instalação silenciosa utilizando um arquivo de resposta, utilize um comando como:
./solaris/setupSolaris -silent -options <caminho completo>/responsefile
Para desinstalar o WebSphere Application Server - Express no Solaris, siga estas etapas:
./uninstaller
Esta seção abrange os problemas e limitações conhecidos de instalação e desinstalação do WebSphere Application Server - Express para Solaris. Consulte o arquivo readme para obter informações sobre problemas e limitações que afetem a utilização real do produto.
Se sua instalação falhar:
Ocasionalmente, uma falha de instalação pode resultar na remoção de instalação de arquivos do diretório _uninst que não está sendo concluído. O indício disso é uma mensagem declarando que uma JVM adequada não pode ser localizada ao tentar executar a desinstalação. É necessário executar manualmente a desinstalação, da seguinte maneira:
Esta seção contém informações sobre a instalação do WebSphere Application Server - Express no HP-UX. Apenas o componente Application Server do WebSphere Application Server - Express pode ser instalado no HP-UX. Utilize o Administrative Console do navegador de base para administrar o Application Server no HP-UX.
Você pode instalar o WebSphere Application Server - Express a partir do CD-ROM ou das imagens eletrônicas transferidas por download.
Se você tiver uma cópia anterior do WebSphere Application Server - Express em seu sistema, será necessário remover a instalação dela antes de continuar.
Para instalar o WebSphere Application Server - Express a partir do CD do produto, siga estas etapas:
Nota de Instalação:
Se você executar o comando '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' a partir de uma janela de comandos, poderá obter erros informados referentes a 'mqver not found' e 'wempsservice not found'. É possível ignorar essas mensagens de erro.
Antes de instalar o produto, verifique o seguinte:
A imagem do CD do HP/UX para o WebSphere Application Server - Express é dividida em várias partes para reduzir o tamanho do download. Cada parte é um arquivo tar (tape archive) e todas elas são necessárias.
Para instalar as imagens eletrônicas do WebSphere Application Server - Express, siga estas etapas:
Após a instalação do WebSphere Application Server - Express, é necessário ter a seguinte estrutura de diretório no diretório /opt/IBM/WebSphere/Express51:
Se qualquer um desses diretórios contiver um número substancialmente diferente de arquivos, comece a suspeitar de que um problema aconteceu durante a instalação. Veja o arquivo /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
Você pode verificar a operação básica de instalação do Application Server executando Verify Server Installation a partir do aplicativo First Steps. O First Steps é ativado no final da instalação ou você pode ativá-lo executando o script/opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh.
Alternativamente, você pode verificar a operação do Application Server executando o script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Esse script será percorrido através da inicialização e interrupção do Application Server utilizando sua configuração padrão. Observe que esse script é utilizado apenas para testar a instalação do seu servidor.
O programa de instalação do WebSphere Application Server - Express pode ser executado silenciosamente, se você mesmo quiser empacotar o produto. Para instalar o WebSphere Application Server - Express silenciosamente, a opção -silent command-line deve ser utilizada. Durante uma instalação silenciosa, você não verá os painéis do assistente após chamar o comando de instalação.
Para executar a instalação silenciosamente aceitando todos os padrões, utilize um comando semelhante a:
./hpux/setupHPUX -silent
Você também pode utilizar um arquivo de resposta para definir opções adicionais para uma instalação silenciosa. Consulte o exemplo de arquivo de resposta no CD de instalação para obter um gabarito. Para executar uma instalação silenciosa utilizando um arquivo de resposta, utilize um comando como:
./hpux/setupHPUX -silent -options <fully qualified path/responsefile
Para desinstalar o WebSphere Application Server - Express no HP-UX, siga estas etapas:
./uninstaller
Esta seção abrange os problemas e limitações conhecidos de instalação e desinstalação do WebSphere Application Server - Express para HP-UX. Consulte o arquivo readme para obter informações sobre problemas e limitações que afetem a utilização real do produto.
Se sua instalação falhar:
Ocasionalmente, uma falha de instalação pode resultar na remoção de instalação de arquivos do diretório _uninst que não está sendo concluído. O indício disso é uma mensagem declarando que uma JVM adequada não pode ser localizada ao tentar executar a desinstalação. É necessário executar manualmente a desinstalação, da seguinte maneira:
Bem vindo ao recurso de plug-in para o WebSphere Application Server - Express.
O plug-in do servidor da Web permite que os usuários separem a máquina do servidor da Web e o servidor da máquina do Express Application para maior segurança e desempenho. Essa separação também permite ser mais flexível na arquitetura do Web site em geral.
Esses plug-ins comunicam-se com o WebSphere Application Server - Express pelo HTTP(S).
A instalação do plug-in do Servidor da Web inclui os componentes necessários para configurar automaticamente os servidores da Web a seguir nas plataformas em que são suportados.
| Apache Web Server |
|
| IBM HTTP Web Server |
|
| Microsoft IIS (Internet Information System) |
|
| iPlanet (Sun ONE) Web Server |
|
| Lotus Domino Web Server |
|
| WebSphere Application Server - Express |
Nota #1
|
Notas:
| Apache Web Server |
|
| IBM HTTP Web Server |
|
| Microsoft IIS (Internet Information System) |
|
| iPlanet (Sun ONE) Web Server |
|
| Lotus Domino Web Server |
|
| WebSphere Application Server - Express |
Consulte Nota #1 abaixo
|
Notas:
Onde os arquivos de plug-in e as bibliotecas do servidor Web serão instalados. Se o WebSphere Application Server - Express estiver instalado na máquina, a localização padrão será <Dir_de_Inst_do_Express>/Plugins.
Nota: O diretório de instalação é a localização em que os arquivos de licença, de produto, da JVM e de desinstalação estão instalados. Os arquivos do Plug-in Web Server necessários no tempo de execução são instalados em <Dir_de_Inst>/../AppServer.
Exemplo de Estrutura de diretórios:
C:\
- Arquivos de Programas
-IBM
-WebSphere
- Plugins
- AppServer
Em um ambiente de camada única, em que o servidor Web está instalado na mesma máquina do servidor Express Application, os Web Server Plugins estão localizados no diretório <Dir_de_Inst_do_Express>/AppServer do WebSphere Application Server - Express. Isso fornecerá uma integração completa do Plug-in Web Server com o servidor Express Application. Isso faz com que o diretório padrão do plugin-cfg.xml Regenerated seja o mesmo local que o servidor da Web foi configurado para utilizar. Portanto, não há necessidade de copiar manualmente ou de mover o plugin-cfg.xml restaurado após sua restauração.
É o nome do host da máquina que está executando o WebSphere Application Server - Express. Estas informações são reunidas para inserir valores apropriados no arquivo de configuração do plug-in (plugin-cfg.xml). O valor padrão é o nome do host do host local. Se o WebSphere Application Server - Express estiver sendo executado em uma máquina diferente, insira o nome do host desse servidor remoto.
Para cada plug-in do servidor da Web selecionado para instalação, você será solicitado a fornecer a localização de seu arquivo de configuração. O arquivo deve existir para continuar com a instalação.
Consulte a seção 4.0 "Quais Alterações Estão Sendo Feitas na Configuração do meu Servidor da Web" para obter informações detalhadas.
Consulte a seção 4.0 "Quais Alterações Estão Sendo Feitas na Configuração do meu Servidor da Web" para obter informações detalhadas.
Esta seção descreve as modificações nos arquivos de configuração do servidor da Web durante a instalação, como tarefas que podem ser concluídas manualmente. Essas etapas são realizadas automaticamente pelo processo de instalação e estão listadas aqui para referência.
As modificações incluem a adição de uma referência à biblioteca do plug-in do servidor da Web e uma referência à localização do arquivo de configuração do plug-in (plugin-cfg.xml) do servidor da Web.
Etapas para esta tarefa
Utilize as seguintes entradas como modelo para configuração de seu arquivo.NOTA: <Raiz_de_Inst_dos_plugins> é o diretório raiz de instalação dos plug-ins do WebSphere Application Server - Express.
LoadModule ibm_app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_ibm_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
Nota: A raiz da instalação pode variar de acordo com a plataforma do sistema operacional. Por exemplo, a raiz da instalação do AIX é /opt/IBM/WebSphere/Express51/Plugins/ para a Versão 5.
LoadModule ibm_app_server_http_module <Raiz_de_Inst_dos_plugins>\bin\mod_ibm_app_server_http.dll WebSpherePluginConfig <Raiz_de_Inst_dos_plugins>\config\cells\plugin-cfg.xml
Utilize as entradas a seguir como um modelo para a configuração de seu arquivo.
LoadModule was_ap20_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_was_ap20_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/plugins/config/cells/plugin-cfg.xml
Nota: A raiz da instalação pode variar de acordo com a plataforma do sistema operacional. Por exemplo, a raiz da instalação do AIX é /opt/IBM/WebSphere/Express51/Plugins/ para a Versão 5.
LoadModule was_ap20_module <Raiz_de_Instalação_dos_plugins>\bin\mod_was_ap20_http.dll WebSpherePluginConfig <Raiz_de_Inst_dos_plugins>\config\cells\plugin-cfg.xml
Nota: Se a diretriz do IBM HTTP Server 1.3.26, LoadModule ibm_app_server_http_module, está presente em um arquivo httpd.conf do IBM HTTP Server 2.0, o IBM HTTP Server não pode ser iniciado.Você deve comentar ou excluir a diretriz para iniciar o servidor Versão 2.
Utilize as entradas a seguir como um modelo para a configuração de seu arquivo.
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
A maioria dos servidores da Web Apache Web não são compilados com suporte de EAPI (API estendida). Se aparecer uma mensagem como a seguinte ao iniciar o servidor da Web com o módulo do plug-in mod_app_server_http.so, utilize a versão EAPI do modulo.
[Tue Jul 2 13:20:14 2002] [warn] Loaded DSO /opt/IBM/WebSphere/AppServer/bin/mod_app_server_http.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -D EAPI)
Para utilizar o módulo EAPI, configure o arquivo httpd.conf para apontar para mod_app_server_http_eapi.so, em vez de para mod_app_server_http.so:
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_app_server_http_eapi.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
Nota: A raiz da instalação pode variar de acordo com a plataforma do sistema operacional. Por exemplo, a raiz da instalação do AIX é /opt/IBM/WebSphere/Express51/Plugins/ para a Versão 5.
LoadModule app_server_http_module <Raiz_de_Instalação_dos_plugins>\bin\mod_app_server_http.dll WebSpherePluginConfig <Raiz_de_Inst_dos_plugins>\config\cells\plugin-cfg.xml
A maioria dos servidores da Web Apache Web não são compilados com suporte de EAPI (API estendida). Se aparecer uma mensagem como a seguinte ao iniciar o servidor da Web com o módulo do plug-in mod_app_server_http.dll, utilize a versão EAPI do modulo.
[Tue Jul 2 13:20:14 2002] [warn] Loaded DSO C:\WebSphere\AppServer\bin\mod_app_server_http.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -D EAPI)
Para utilizar o módulo EAPI, configure o arquivo httpd.conf para apontar para mod_app_server_http_eapi.dll em vez de para mod_app_server_http.dll:
LoadModule app_server_http_module <Raiz_de_Instalação_dos_plugins>\bin\mod_app_server_http_eapi.dll WebSpherePluginConfig <Raiz_de_Inst_dos_plugins>\config\cells\plugin-cfg.xml
Siga este procedimento para ativar o plug-in de transporte HTTP para funcionar com o Domino Versão 5.05 ou 5.06. O assistente para instalação não realiza essa modificação. Execute este procedimento manual.
Nota: Se já houver arquivos de filtro DSAPI (Domino Web Server Application Programming Interface) especificados, utilize um espaço para limitar o arquivo de plug-in do WebSphere Application Server.
Defina a variável de ambiente WAS_HOME para apontar para o diretório raiz de instalação do WebSphere Application Server.
Adicione a variável Plugin Config no registro no caminho HKEY_LOCAL_MACHINE > SOFTWARE > IBM > WebSphere Application Server > 5.1.0.0.Defina o valor dessa variável para a localização do arquivo plugin-cfg.xml, que é <Raiz_de_Instalação_dos_plugins>\config\cells\plugin-cfg.xml.
Em que <Raiz_de_Instalação_dos_plugins> é o diretório raiz de instalação dos plug-ins do WebSphere Application Server - Express.
02/12/2001 03:05:09 PM JVM: Java virtual machine initialized WebSphere Application Server DSAPI filter loaded 02/12/2001 03:05:10 PM HTTP Web Server started
Utilize as entradas a seguir como um modelo para a configuração de seu arquivo.
Inclua essas diretrizes no arquivo obj.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so" Init fn="as_init" bootstrap.properties=" /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml" Service fn="as_handler"
Nota: A raiz da instalação pode variar de acordo com a plataforma do sistema operacional. Por exemplo, a raiz da instalação do AIX é /opt/IBM/WebSphere/Express51/Plugins/ para a Versão 5.
Adicione uma diretriz ao arquivo obj.conf depois de "<Object name=default>":
Service fn="as_handler"
Inclua duas diretrizes no final do arquivo magnus.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so" Init fn="as_init" bootstrap.properties="/opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml"
Nota: A raiz da instalação pode variar de acordo com a plataforma do sistema operacional. Por exemplo, a raiz da instalação do AIX é /opt/IBM/WebSphere/Express51/Plugins/ para a Versão 5.
Inclua essas diretrizes no arquivo obj.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="<Raiz_de_Inst_dos_plugins>\bin\libns41_http.dll" Init fn="as_init" bootstrap.properties=" <Raiz_de_Inst_dos_plugins>\config\cells\plugin-cfg.xml" Service fn="as_handler"
Adicione uma diretriz ao arquivo obj.conf depois de "<Object name=default>":
Service fn="as_handler"
Inclua duas diretrizes no final do arquivo magnus.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="<Raiz_de_Inst_dos_plugins>\bin\libns41_http.dll" Init fn="as_init" bootstrap.properties=" <Raiz_de_Inst_dos_plugins>:\config\cells\plugin-cfg.xml"
Siga este procedimento para reproduzir manualmente como o assistente para instalação configura o servidor da Web do IIS (Internet Service Manager):
Em que <Raiz_de_Instalação_dos_plugins> é o diretório raiz de instalação dos plug-ins do WebSphere Application Server - Express.
É necessário gerar novamente o arquivo de configuração do plug-in, plugin-cfg.xml, após a implementação dos aplicativos para o WebSphere Application Server - Express.
Com o WebSphere Application Server - Express versão 5.1.0, utilize o script genPluginCfg para gerar novamente o arquivo plugin-cfg.xml com base na configuração atual de seu WebSphere Express Application Server.
Em que <Dir_de_Inst_do_Express> é o diretório raiz de instalação do WebSphere Application Server - Express
Em que <Raiz_de_Instalação_do_Plugin> é o diretório raiz de instalação dos plug-ins do WebSphere Application Server - Express.
As situações a seguir exigem edição manual do arquivo plugin-cfg.xml:
<?xml version="1.0" encoding="ISO-8859-1" ?> <Config> <Log LogLevel="Error" Name="C:\Arquivos de Programas\IBM\WebSphere\Express51\Plugins\logs\http_plugin.log" /> <VirtualHostGroup Name="default_host"> <VirtualHost Name="*:7080" /> <VirtualHost Name="*:80" /> <VirtualHost Name="*:7443" /> </VirtualHostGroup> <ServerCluster Name="server1_DefaultNode_Cluster"> <Server Name="DefaultNode_server1"> <Transport Hostname="myHostname.raleigh.ibm.com" Port="7080" Protocol="http" /> <Transport Hostname="myHostname.raleigh.ibm.com" Port="7443" Protocol="https"> <Property name="keyring" value=" C:\Arquivos de Programas\IBM\WebSphere\Express51\Plugins\etc\plugin-key.kdb" /> <Property name="stashfile" value=" C:\Arquivos de Programas\IBM\WebSphere\Express51\Plugins\etc\plugin-key.sth" /> </Transport> </Server> <PrimaryServers> <Server Name="DefaultNode_server1" /> </PrimaryServers> </ServerCluster> <UriGroup Name="default_host_server1_DefaultNode_Cluster_URIs"> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/UTC/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/CustomHomePageExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/YourCoExpressExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/CustomerServiceExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/DocumentMgmtExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/SurveyExample/*" /> </UriGroup> <Route ServerCluster="server1_DefaultNode_Cluster" UriGroup="default_host_server1_DefaultNode_Cluster_URIs" VirtualHostGroup="default_host" /> </Config>
Quando o seu servidor Web está instalado em uma máquina diferente da do WebSphere Application Server - Express, o arquivo plugin-cfg.xml gerado deve ser movido para o diretório <Raiz_de_Instalação_dos_Plugins/config/cells localizado na máquina do servidor Web. Como resultado, os caminhos que possuem referência no arquivo plugin-cfg.xml podem precisar ser editados manualmente. As utilizações subseqüentes do script genPluginCfg mesclarão atualizações e preservarão suas atualizações manuais para entradas de caminho.
Exemplo: export SHLIB_PATH=/usr/lib:/lib
O CD-ROM do Produto é um formato ISO-9660 com extensão Rockridge. Talvez seja necessário montar o CD-ROM manualmente. A montagem ou desmontagem do CD_ROM exige privilégios root.
Siga essas instruções para a montagem do CD_ROM em HP-UX
/usr/sbin/pfs_mountd &
/usr/sbin/pfsd &
<arquivo_de_dispositivo> <ponto_de_montagem> <tipo_de_sistema_de_arquivos> <método_de_conversão>
Exemplo: /dev/dsk/c0t0d0 /cdrom pfs-rrip ro,suid 0 0
/usr/sbin/pfs_mount /cdrom
/usr/sbin/pfs_umount /cdrom
Exemplo: export WAS_HOME=/opt/IBM/WebSphere/Express51/Plugins
O WebSphere Application Server - Express, versão 5.1, inclui um aplicativo pré-instalado chamado Snoop que pode ser utilizado para verificar se o Plug-in Web Server está instalado e configurado corretamente. O arquivo de configuração do Plug-in Web Server, plugin-cfg.xml, que é instalado durante a instalação dos Plug-ins Web Server, é pré-configurado para testar o aplicativo Snoop. No entanto, também é possível regenerar o Plug-in Web Server, conforme descrito nesta documentação.
DICA: Lembre-se de reiniciar o Servidor Web após a regeneração do arquivo de configuração do plug-in.
Procedimento para testar o Plug-in Web Server
http://yourHostName:7080
DICA: Se o Servidor Web falhar ao ser iniciado, consulte a seção "Dicas de Resolução de Problemas" deste documento para aprender a resolver o problema.
NOTA: Não especifique o transporte interno, 7080, do WebSphere Express Application Server. O Plug-in Web Server agirá como um proxy para o Servidor utilizando o transporte interno 7080. O seguinte url assume que seu Servidor Web esteja atendendo na porta HTTP padrão 80.
http://yourHostName
Se o Plug-in Web Server estiver instalado e configurado corretamente, a Página da Web do Aplicativo Padrão do WebSphere Application Server será exibida no navegador.
Tente isso primeiro: O motivo mais comum do Servidor Web falhar ao ser iniciado após a configuração do Plug-in Web Server é porque o arquivo plugin-cfg.xml contém informações inválidas ou incorretas e não pode ser analisado pelo Servidor Web. O problema é causado com maior freqüência por uma das seguintes condições:
Se você está tendo problemas com o componente de plug-in do HTTP - o componente que envia pedidos a partir do seu servidor HTTP, como um IBM HTTP Server, Apache ou IIS, para o Websphere Application Server - Express, tente seguir estas etapas:
Se estes arquivos não revelarem a causa do problema, siga estas etapas adicionais.
Etapas para Determinação de Problemas de Plug-in
O plug-in fornece rastreio legível que pode ser útil para ajudar a descobrir o problema. Definindo o atributo LogLevel no arquivo de configuração config/plugin-cfg.xml para Trace, é possível acompanhar o processamento de pedido para verificar o que está errado.Em um nível superior:
Esse processo fica claro através da leitura do rastreio para um único pedido:
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: --------------------System Information-------------------- [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Bld date: Jul 3 2002, 15:35:09 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Webserver: IIS [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Hostname = SWEETTJ05 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: OS version 4.0, build 1381, 'Service Pack 6' [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: ---------------------------------------------------------------
ws_common: websphereGetStream: Failed to connect to app server, OS err=%d
Em que %d é um código de erro específico do S.O. relacionado ao motivo da falha da chamada da conexão (). Isso pode ocorrer por uma variedade de razões.
A nova geração do arquivo plugin-cfg.xml pode ser feita através do navegador com base no Administrative Console ou utilizando o script GenPluginCfg localizado em <Dir_de_Inst_do_Express>/AppServer/bin.
Usage: GenPluginCfg [[-option.name optionValue]...]
Opções válidas:
-config.root configroot_dir
(defaults to environment variable CONFIG_ROOT)
-cell.name cell
(defaults to environment variable WAS_CELL)
-node.name node
(defaults to environment variable WAS_NODE)
-server.name server
(required for single server plugin generation)
-output.file.name file_name
(defaults to configroot_dir/plugin-cfg.xml)
-destination.root root
(install root of machine configuration will be used on)
-destination.operating.system windows/unix
(operating system of machine configuration will be used on)
-debug yes/no
(defaults to no)
Exemplos:
IBM HTTP Server
Artigos Técnicos e Código de Amostra
Atualizações na Documentação
Para obter as informações mais recentes sobre o WebSphere Application Server - Express além do que está incluído no sistema de ajuda on-line, consulte os seguintes Web sites:
Esta seção descreve como configurar o recurso do plug-in de segurança do servidor Web para o WebSphere Application Server - Express. O recurso do plug-in de segurança do servidor Web deve ser instalado a partir do CD de plug-ins do servidor Web fornecido no WebSphere Application Server - Express Versão 5.1.1.
Os plug-ins de segurança do servidor Web permitem que os usuários separem a máquina do servidor Web e a máquina do Express Application Server para aprimorar a segurança e o desempenho. Essa separação também permite ser mais flexível na arquitetura do Web site em geral.
Esses plug-ins de segurança comunicam-se com o WebSphere Application Server - Express pelo HTTP(S).
A instalação do Plug-in Web Server inclui todos os componentes necessários para configurar automaticamente os servidores Web a seguir nas plataformas nas quais são suportados.
O plug-in de segurança do servidor Web deve ser instalado na mesma máquina que o HTTP Web Server. Portanto, assegure-se de que o HTTP Web Server já esteja instalado na máquina antes de instalar o plug-in do HTTP Web Server.
Consulte o arquivo README localizado no CD do Plug-in Web Server para obter informações detalhadas sobre os seguintes tópicos:
Para instalar os plug-ins de segurança do HTTP Web Server a partir do CD, execute estas etapas:
Onde os arquivos de plug-in e as bibliotecas do servidor Web serão instalados. Se o WebSphere Application Server - Express estiver instalado na máquina, a localização padrão será <Dir_de_Inst_do_Express>/Plugins.
Nota: O diretório de instalação é a localização em que os arquivos de licença, de produto, da JVM e de desinstalação estão instalados. Os arquivos do Plug-in Web Server necessários no tempo de execução são instalados em <Dir_de_Inst>/../AppServer.
Exemplo de Estrutura de Diretórios:
C:\ Program File\IBM\WebSphere\Plugins
C:\ Program File\IBM\WebSphere\Appserver
Em um ambiente de camada única, em que o servidor Web está instalado na mesma máquina do servidor Express Application, os Web Server Plugins estão localizados no diretório <Dir_de_Inst_do_Express>/AppServer do WebSphere Application Server - Express. Isso fornecerá uma integração completa do Plug-in Web Server com o servidor Express Application. Isso faz com que o diretório padrão do plugin-cfg.xml Regenerated seja o mesmo local que o servidor da Web foi configurado para utilizar. Portanto, não há necessidade de copiar manualmente ou de mover o plugin-cfg.xml restaurado após sua restauração.
É o nome do host da máquina que está executando o WebSphere Application Server - Express. Estas informações são reunidas para inserir valores apropriados no arquivo de configuração do plug-in (plugin-cfg.xml). O valor padrão é o nome do host do host local. Se o WebSphere Application Server - Express estiver sendo executado em uma máquina diferente, insira o nome do host desse servidor remoto.
Para cada plug-in do servidor Web selecionado para instalação, será solicitada a localização de seu arquivo de configuração. O arquivo deve existir para continuar com a instalação.
O programa de instalação do WebSphere Application Server - Express Plug-ins pode ser executado silenciosamente, se você mesmo quiser empacotar o produto. Para instalar o WebSphere Application Server - Express Plug-ins silenciosamente, a opção da linha de comandos -silent deverá ser utilizada. Durante uma instalação silenciosa, você não verá os painéis do assistente após chamar o comando de instalação.
Utilize um arquivo de resposta para definir as opções apropriadas para uma instalação silenciosa. Consulte o exemplo de arquivo de resposta no CD de instalação para obter um gabarito. Para executar uma instalação silenciosa utilizando um arquivo de resposta, utilize um comando como:
Para Windows:
install.exe -silent -options <caminho completo>/responsefile
Para Linux e Unix:
linux/setupLinux -silent -options <caminho completo>/responsefile
Exemplos para plataformas Unix:
O WebSphere Application Server - Express, versão 5.1, inclui um aplicativo pré-instalado chamado Snoop que pode ser utilizado para verificar se o Web Server recurso de mensagens e enfileiramento está instalado e configurado corretamente. O arquivo de configuração do Plug-in Web Server, plugin-cfg.xml, que é instalado durante a instalação dos Plug-ins Web Server, é pré-configurado para testar o aplicativo Snoop. No entanto, também é possível regenerar o Plug-in Web Server, conforme descrito nesta documentação.
DICA: Lembre-se de reiniciar o Servidor Web após a regeneração do arquivo de configuração do plug-in.
Procedimento para testar o Plug-in Web Server
http://yourHostName:7080
DICA: Se o Servidor Web falhar ao ser iniciado, consulte a seção "Dicas de Resolução de Problemas" deste documento para aprender a resolver o problema.
NOTA: Não especifique o transporte interno, 7080, do WebSphere Express Application Server. O Plug-in Web Server agirá como um proxy para o Servidor utilizando o transporte interno 7080. O seguinte url assume que seu Servidor Web esteja atendendo na porta HTTP padrão 80.
http://yourHostName
Se o Plug-in Web Server estiver instalado e configurado corretamente, a Página da Web do Aplicativo Padrão do WebSphere Application Server será exibida no navegador.
Para desinstalar os Plug-ins de segurança do HTTP Web Server para WebSphere Application Server - Express, siga estas etapas:
Para desinstalar os Plug-ins do HTTP Web server para WebSphere Application Server - Express nas plataformas Linux e Unix, siga estas etapas:
./uninstaller
Por padrão, os plug-ins do CVS (Concurrent Versions System) são instalados automaticamente com o WebSphere Application Server - Express. A versão mais recente do servidor CVS está disponível em www.cvshome.org.Não é necessário instalar um cliente do CVS para utilizá-lo, apenas um servidor CVS. Para obter mais informações sobre instalação e utilização do CVS, consulte a ajuda on-line para equipes. Além disso, há um artigo sobre o suporte a equipe de CVS no WebSphere Application Server - Express em www.ibm.com/websphere/developer/library/ techarticles/0108_karasiuk/0108_karasiuk.html
Como uma alternativa ao CVS, você pode utilizar o Rational(R) ClearCase(R) como seu sistema SCM (Software Configuration Management). Para obter informações adicionais sobre o Rational ClearCase, consulte o site www.ibm.com/software/awdtools/clearcase/
Nem o servidor CVS nem o cliente ou servidor Rational ClearCase são instalados automaticamente. Você deve instalá-los separadamente do WebSphere Studio.
Vários outros repositórios SCM podem ser integrados ao WebSphere Application Server - Express por intermédio de adaptadores de equipe SCM (conhecidos no Eclipse como provedores de equipe). Para encontrar uma lista de produtos e adaptadores SCM fornecidos por Parceiros de Negócios da IBM, visite www-3.ibm.com/software/awdtools/studioappdev/about/ e na seção Further reading, selecione SCM Adaptor Vendors. Você pode acessar, na lista, os Web sites de fornecedores dos produtos SCM para fazer o download dos adaptadores SCM de sua escolha. A IBM não aprova ou garante tais adaptadores. Para obter suporte ou informações adicionais, entre em contato diretamente com o fornecedor do produto SCM.
Nota sobre Direitos Restritos para Usuários do Governo dos Estados Unidos - Uso, duplicação e divulgação restritos pelo documento GSA ADP Schedule Contract com a IBM Corporation.
Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. É possível que a IBM não ofereça os produtos, serviços e recursos discutidos neste documento em outros países. Consulte um representante IBM local para obter informações sobre produtos e serviços disponíveis atualmente em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente que não infrinja nenhum direito de propriedade intelectual da IBM pode ser utilizado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM são de responsabilidade do Cliente.
A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados neste documento. O fornecimento deste documento não garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para:
Gerência de Relações Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138-146
Botafogo
Rio de Janeiro, RJ
CEP 22290-240
Para pedidos de licença relacionados a informações de DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos de licença, por escrito, para:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japão
A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgar apropriada sem incorrer em qualquer obrigação para com o Cliente.
O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS OU CONDIÇÕES IMPLÍCITAS DE NÃO-VIOLAÇÃO, MERCADO OU ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, essa disposição pode não se aplicar ao Cliente.
Estas informações podem conter imprecisões técnicas ou erros tipográficos. Periodicamente, são feitas alterações nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode, a qualquer momento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nesta publicação, sem aviso prévio
Licenciados deste programa que desejam obter informações sobre este assunto com o objetivo de permitir: (i) a troca de informações entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilização mútua das informações trocadas, devem entrar em contato com:
Gerência de Relações Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138-146
Botafogo
Rio de Janeiro, RJ
CEP 22290-240
Tais informações podem estar disponíveis, sujeitas a termos e condições apropriadas, incluindo em alguns casos o pagamento de uma taxa.
O programa licenciado descrito neste documento e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, do Contrato de Licença do Programa Internacional IBM ou de qualquer outro contrato equivalente.
As informações relativas a produtos não-IBM foram obtidas junto aos fornecedores dos respectivos produtos, de seus anúncios publicados ou de outras fontes disponíveis publicamente. A IBM não testou estes produtos e não pode confirmar a precisão de seu desempenho, compatibilidade nem qualquer outra reivindicação relacionada a produtos não-IBM. Dúvidas sobre os recursos de produtos não-IBM devem ser encaminhadas diretamente a seus fornecedores.
Referências nestas informações a Web sites não-IBM são fornecidas apenas por conveniência e não representam de forma alguma um endosso a esses Web sites. Os materiais contidos nesses Web sites não fazem parte dos materiais deste produto IBM e a utilização desses Web sites é de inteira responsabilidade do Cliente.
Estas informações contêm exemplos de dados e relatórios utilizados nas operações diárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos podem incluir nomes de indivíduos, empresas, marcas e produtos. Todos estes nomes são fictícios e qualquer semelhança com nomes e endereços utilizados por uma empresa real é mera coincidência.
LICENÇA DE COPYRIGHT:
Estas informações contêm programas de aplicativos de exemplo na linguagem fonte, ilustrando as técnicas de programação em diversas plataformas operacionais. Você pode copiar, modificar e distribuir estes programas de exemplos sem a necessidade de pagar à IBM, com objetivos de desenvolvimento, utilização, marketing ou distribuição de programas aplicativos em conformidade com a interface de programação do aplicativo para a plataforma operacional para a qual os programas de exemplo são criados. Esses exemplos não foram testados completamente em todas as condições. Portanto, a IBM não pode garantir ou implicar a confiabilidade, manutenção ou função destes programas. Você pode copiar, modificar e distribuir estes programas de exemplo de qualquer maneira sem pagamento à IBM, com objetivos de desenvolvimento, utilização, marketing ou distribuição de programas aplicativos em conformidade com interfaces de programação de aplicativos da IBM.
Cada cópia ou parte destes programas de exemplo ou qualquer trabalho derivado, deve incluir um aviso de copyright com os dizeres:
(C) (nome da empresa) (ano). Partes deste código são derivadas dos Programas de Exemplo da IBM Corp. (C) Copyright IBM Corp. 2000, 2003. Todos os direitos reservados.
As informações sobre interface de programação destinam-se a facilitar a criação de software aplicativo utilizando este programa.
As interfaces de programação de uso geral permitem que o Cliente desenvolva o software aplicativo que obtém os serviços das ferramentas deste programa.
No entanto, estas informações também podem conter informações sobre diagnósticos, modificações e ajustes. As informações sobre diagnósticos, modificações e ajustes são fornecidas para ajudá-lo a depurar seu software aplicativo.
Aviso: Não utilize estas informações sobre diagnósticos, modificações e ajustes como uma interface de programação, pois elas estão sujeitas a alterações.
Os termos a seguir são marcas comerciais ou marcas registradas da International Business Machines Corporation nos Estados Unidos e/ou em outros países:
Java e todas as marcas comerciais e logotipos baseados em Java são marcas comerciais ou marcas registradas da Sun Microsystems, Inc. nos Estados Unidos e em outros países.
ActiveX, Microsoft, Windows, Windows NT e o logotipo Windows são marcas comerciais ou marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outros países.
UNIX é uma marca registrada do The Open Group.
Outros nomes de empresas, produtos ou serviços, que podem estar indicados por um asterisco duplo (**), podem ser marcas comerciais ou marcas de serviço de terceiros.