Implementando o Design Management Server no WebSphere Application Server

É 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.
Atalho: Se você instalou o Apache Tomcat no assistente de configuração, nenhuma etapa de implementação manual será necessária. Prossiga para Instalando e Configurando o Design Management Server.
Assegure que o seu ambiente esteja configurado corretamente:

Procedimento

  1. No console administrativo do WebSphere Application Server, especifique as seguintes configurações de segurança:
    1. Desative a segurança do Java™ 2 clicando em Segurança > Segurança Global e desmarcando a caixa de seleção Usar o Java 2 para restringir o acesso do aplicativo aos recursos locais.
    2. 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.
    3. Clique em Segurança > Segurança Global > Segurança da Web e SIP > Configurações Gerais e selecione a caixa de seleção Usar autenticação disponível quando um URI desprotegido é acessado.
  2. Especifique as configurações da máquina virtual Java para WebSphere Application Server:
    1. No console administrativo, clique em Servidores > Tipos de Servidor > Servidores de Aplicativo WebSphere e clique no seu servidor. Por padrão, o servidor é denominado server1.
    2. Em Infraestrutura do Servidor, clique em Gerenciamento de Java e Processo > Definição de Processo.
    3. Em Propriedades Adicionais, clique em Java Virtual Machine.
    4. No campo Tamanho do Heap Inicial, especifique 100.
    5. 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.
    6. No campo Argumentos de JVM genéricos, inclua -Xgcpolicy:gencon -Xmn1g -Xcompressedrefs -Xgc:preferredHeapBase=0x100000000 -XX:MaxPermSize=128M -Xms8G -Xmx8G
    7. 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.
    8. Clique em Aplicar.
    9. Na página Java Virtual Machine, em Propriedades Adicionais, clique em Propriedades Customizadas.
    10. 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.
    11. 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.
    12. Clique em Novo novamente e especifique uma propriedade denominada java.awt.headless com o valor true.
    13. Clique em Novo novamente e especifique uma propriedade denominada org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin com o valor true.
    14. 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.
    15. 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ê.
    Um exemplo das propriedades da máquina virtual Java
  3. 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.
  4. Instale o aplicativo Jazz Team Server:
    1. No console administrativo, clique em Aplicativos > Novo Aplicativo > Novo Aplicativo Corporativo. (Para o WebSphere Application Server 6.1, clique em Aplicativos > Instalar Novo Aplicativo. )
    2. 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.
    3. Em Como deseja instalar o aplicativo?, clique em Fast Path e depois em Avançar.
    4. Na página Etapa 1: Selecionar as opções de instalação, aceite as opções padrão e clique em Avançar.
    5. 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.
    6. 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.
    7. 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.
    8. Clique em Concluir.
  5. Repita as etapas de instalação para os arquivos war a seguir e 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
  6. Mapeie as funções de segurança do aplicativo Jazz Team 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
    1. Clique em Aplicativos > Tipos de Aplicativos > WebSphere Enterprise Applications > jts_war.
    2. 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.
    3. 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?.
  7. Verifique se os aplicativos foram instalados com êxito e salve as alterações na configuração principal para WebSphere Application Server.
  8. Depois de salvar na configuração principal, pare e reinicie o servidor.
  9. No console administrativo do WebSphere Application Server, clique em Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos WebSphere 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:
Setas verdes indicam que os aplicativos iniciaram devidamente

O que Fazer Depois

Agora, é possível configurar o Design Management Server como descrito em Instalando e Configurando o Design Management Server.

Feedback