É possível implementar o
Design Management Server
no
WebSphere
Application Server
em vez de no servidor Apache Tomcat que acompanha o servidor. As instruções são baseadas no WebSphere
Application Server versão 8.0, com algumas variações para as versões 7.0 e
6.1.
Antes de Iniciar
Importante: Há um potencial para a exposição da segurança
ao usar o WS-Security; isso poderá resultar em um usuário obtendo privilégios
elevados. Isso causa um impacto em aplicativos que usam JAX-WS e JAX-RPC.
Para obter detalhes completos sobre como obter e instalar essa correção de segurança,
leia estes
boletins. Além disso, considere assinar
as atualizações do
WebSphere
Application Server por meio de
Minhas Notificações. Assim, você receberá avisos relacionados à segurança
para atualizações e correções.
Assegure que o seu ambiente esteja configurado corretamente:
- O
WebSphere
Application Server
está instalado.
O Jazz Team
Server, que fornece a base para o Design Management Server, requer o WebSphere
Application Server Versão 8.0.0.3 ou WebSphere
Application Server Versão 7.0 ou WebSphere
Application Server Versão 6.1 com Fixpack 27.
- Se estiver usando um banco de dados diferente do Apache Derby, o banco de dados estará
configurado como descrito em Configurando o Banco de Dados.
- O Design Management Server está instalado conforme descrito em Instalando o Design Management.
Procedimento
- No console administrativo do
WebSphere
Application Server,
especifique as seguintes configurações de segurança:
- Desative a segurança do Java™ 2 clicando em
e desmarcando a caixa de seleção Usar o Java
2 para restringir o acesso do aplicativo aos recursos locais.
- No campo Definição do domínio atual, assegure que o domínio de
segurança apropriado esteja configurado e definido como o domínio padrão. Em seguida,
marque as caixas de seleção Ativar segurança administrativa e
Ativar segurança do aplicativo.
- Clique em e selecione a caixa de seleção Usar
autenticação disponível quando um URI desprotegido é acessado.
- Especifique as configurações da máquina virtual Java para WebSphere
Application Server:
- No console administrativo, clique em
e clique no seu servidor. Por padrão, o servidor é denominado server1.
- Em Infraestrutura do Servidor, clique em
.
- Em Propriedades Adicionais, clique em Java Virtual
Machine.
- No campo Tamanho do Heap Inicial,
especifique 100.
- No campo Tamanho do Heap Máximo,
especifique a memória máxima do servidor em MB. Para computadores de 64
bits, especifique uma quantia de memória que seja apropriada ao seu ambiente, como 4096 para 4 GB de memória.
- No campo Argumentos de JVM genéricos,
inclua -Xgcpolicy:gencon -Xmn1g -Xcompressedrefs -Xgc:preferredHeapBase=0x100000000
-XX:MaxPermSize=128M -Xms8G -Xmx8G
- Para sistemas operacionais Solaris, no campo Argumentos Genéricos da
JVM, inclua o -XX:MaxPermSize=384m.
Para obter informações adicionais sobre a configuração de um ambiente Solaris para o WebSphere
Application Server,
consulte o Capítulo 2 do redbook IBM WebSphere Application Server
V6.1 no Sistema Operacional Solaris 10.
- Clique em Aplicar.
- Na página Java Virtual Machine, em Propriedades
Adicionais, clique em Propriedades Customizadas.
- Clique em Novo e especifique a propriedade
JAZZ_HOME, que identifica o local dos arquivos de configuração do
Design Management Server,
incluindo as pastas jts e dm.
Essa propriedade usa um URI em vez de um caminho de arquivo simples, e sempre começa com
file:///. O local padrão em um sistema Windows é como segue:
file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf
Em
um sistema Linux, o local padrão é como segue:
file:///opt/ibm/JazzTeamServer/server/conf
Nota: Para
evitar problemas, não use espaços nos caminhos de arquivo. Para as pastas
Arquivos de Programas nas instalações de 32 bits do
Windows, é possível usar
PROGRA~1, e para as pastas Arquivos de Programas
(x86) em instalações de 64 bits do
Windows, é possível usar
PROGRA~2.
- Clique em Novo novamente e especifique uma propriedade denominada log4j.configuration. Use
o local do arquivo startup_log4j.properties como o valor. Esta propriedade usa o mesmo formato que a propriedade JAZZ_HOME.
Na maioria dos casos, esse arquivo está na pasta JAZZ_HOME.
O valor padrão em um sistema Windows é como
segue:
file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf/startup_log4j.properties
O
valor padrão em um sistema Linux é como segue:
file:///opt/ibm/JazzTeamServer/server/conf/startup_log4j.properties
Nota: As configurações em startup_log4j.properties são usadas nos estágios
anteriores no processo de inicialização para transmitir mensagens ao arquivo
SystemOut.log.
Após os estágios iniciais, cada aplicativo alterna para o uso das configurações
específicas do aplicativo no arquivo
server/conf/<app_context>/log4j.properties.
- Clique em Novo novamente e especifique uma propriedade denominada
java.awt.headless com o valor true.
- Clique em Novo novamente e especifique uma propriedade denominada
org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin
com o valor true.
- Se você estiver usando um banco de dados SQL Server, clique em Novo novamente
e especifique um SQLSERVER_JDBC_DRIVER_FILE nomeado corretamente com
o local do arquivo sqljdbc4.jar.
- Se estiver usando um banco de dados Oracle, clique em Novo novamente
e especifique um ORACLE_JDBC_DRIVER_FILE nomeado corretamente com
o local do arquivo ojdbc5.jar.
As propriedades customizadas parecem similar à seguinte figura.
Observe que algumas propriedades estão presentes por padrão em adição às propriedades
incluídas por você.
- Salve as alterações na configuração principal e reinicie o WebSphere
Application Server.
Agora o servidor está pronto para implementar os arquivos de aplicativo
Design Management Server.
Nota: Em um
sistema UNIX ou
Linux, se o
WebSphere
Application Server
estiver instalado em um ambiente não raiz, o usuário que instalar o
Design Management Server
deverá ter acesso de leitura e gravação ao diretório de instalação e todos os seus
subdiretórios.
- Instale o aplicativo JazzTeam
Server:
- No console administrativo, clique em
. (Para o
WebSphere
Application Server
6.1, clique em . )
- Em Caminho para o Novo Aplicativo, clique em Procurar para especificar o local do
arquivo jts.war e clique em Avançar. Se você não instalou o Apache Tomcat quando instalou o
Design Management Server,
o local padrão desse arquivo é
installDir/server/webapps.
Se você instalou o Tomcat, o local padrão é
installDir/server/tomcat/webapps.
- Em Como deseja instalar o aplicativo?,
clique em Fast Path e depois em Avançar.
- Na página Etapa 1: Selecionar as opções de instalação,
aceite as opções padrão e clique em Avançar.
- Na página Etapa 2: Mapear módulos para servidores,
marque a caixa de seleção ao lado de jts.war, assegure-se de que
o servidor de destino ou cluster esteja correto e clique em Avançar.
- Na página Etapa 3: Mapear hosts virtuais para módulos da web,
marque a caixa de seleção ao lado de jts.war e clique em Avançar.
- Na página Etapa 4: Mapear raízes de contexto para módulos da web,
configure Raiz de Contexto para /jts e
clique em Avançar.
- Clique em Concluir.
- Repita as etapas de instalação para os arquivos war a seguir
e as raízes de contexto correspondentes:.
| Opção |
Descrição |
| dm.war |
/dm |
| admin.war |
/admin |
| vvc.war |
/vvc |
| rdmhelp.war |
/rdmhelp |
| clmhelp.war |
/clmhelp |
- Mapeie as funções de segurança do aplicativo JazzTeam
Server
para usuários e grupos em seu domínio de segurança. A configuração de
segurança está além do escopo dessa tarefa, mas na maioria dos casos em
que o domínio de segurança global usar o registro LDAP, mapeie os grupos no
registro LDAP para as seguintes funções de segurança do aplicativo:
- JazzAdmins
- JazzDWAdmins
- JazzProjectAdmins
- JazzGuests
- JazzUsers
- Clique em .
- Em Detalhar Propriedades, clique em Função de segurança
ao mapeamento de usuário/grupo. Esta página mostra
os grupos de usuários para o Design Management Server que
você deve mapear para usuários e grupos em seu domínio de segurança.
- Selecione uma função e clique em Mapear Grupos para
mapear essa função para um grupo em seu domínio de segurança.
Nota: Não ative a opção Todos autenticados?.
- Verifique se os aplicativos foram instalados com êxito e salve as alterações na
configuração principal para
WebSphere
Application Server.
- Depois de salvar na configuração principal, pare e reinicie
o servidor.
- No console administrativo do WebSphere
Application Server, clique em para confirmar se todos os aplicativos estão em execução.
Resultados
Setas verdes aparecem ao lado dos aplicativos para indicar que eles iniciaram
corretamente. A página
Aplicativos Corporativos se parece com a
figura a seguir:
O que Fazer Depois
Agora, é possível configurar o
Design Management Server
como descrito em
Instalando e Configurando o Design Management Server.