É possível criar um aplicativo em nível de negócios vazio e, em seguida, incluir
ativos, bibliotecas compartilhadas ou aplicativos em nível de negócios como unidades de composição
no aplicativo em nível de negócios vazio.
Antes de Iniciar
Antes de criar um aplicativo de nível de negócios, determine os recursos ou outros arquivos a serem incluídos em seu aplicativo.
Além disso, verifique se o servidor do aplicativo de destino está configurado. Como parte da configuração do servidor, determine
se seus arquivos de aplicativos podem ser executados nos destinos de implementação.
Sobre Esta Tarefa
É possível utilizar a ferramenta wsadmin para criar aplicativos de nível de negócios em seu ambiente. Este tópico demonstra como utilizar o objeto AdminTask para importar e registrar recursos, criar aplicativos de nível de negócios vazios e incluir recursos no aplicativo de nível de negócios como unidades de composição. Ou então,
você pode utilizar os scripts na biblioteca de scripts AdminBLA para configurar e administrar aplicativos de nível de negócios.
Procedimento
- Inicie a ferramenta de script wsadmin.
- Importe recursos em sua configuração.
Os ativos representam
binários do aplicativo que contêm a lógica de negócios executada no ambiente de tempo de execução
de destino e atende a pedidos do cliente. Um ativo pode conter um archive
de arquivos, tais como, um arquivo compactado (zip) ou Java™ archive (JAR), ou um archive de arquivos
archive, tais como, um arquivo enterprise archive (EAR) Java Platform, Enterprise Edition (Java EE). Exemplos de ativos incluem arquivos EAR, arquivos
JAR de biblioteca compartilhada e orientadores customizados para servidores proxy.
Use o comando importAsset para importar ativos para o repositório de configuração do servidor de aplicativos.
Consulte a documentação do grupo de comandos BLAManagement para o objeto AdminTask para obter opções de parâmetros e etapas adicionais.
Para esse exemplo, os comandos incluem três recursos no repositório de recursos.
Dois dos ativos
são ativos não Java EE e um é um ativo corporativo. O seguinte comando importa o recurso asset1.zip para o repositório de recursos e define o ID de configuração retornado para a variável asset1:
asset1 = AdminTask.importAsset('-source c:/ears/asset1.zip')
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[HP-UX]](../images/hpux.gif)
![[AIX]](../images/aixlogo.gif)
![[IBM i]](../images/iseries.gif)
asset1 = AdminTask.importAsset('-source /ears/asset1.zip')
O seguinte comando importa apenas o metadados de recurso asset2.zip, define o nome do recurso como testAsset.zip, define o diretório de implementação, especifica
se o recurso é utilizado para teste e define o ID de configuração retornado para a variável testasset:
testasset = AdminTask.importAsset('-source c:/ears/asset2.zip -storageType METADATA
–AssetOptions [[.* testAsset.zip .* "asset for testing"
c:/installedAssets/testAsset.zip/BASE/testAsset.zip "" "" "" false]]')
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[HP-UX]](../images/hpux.gif)
![[AIX]](../images/aixlogo.gif)
![[IBM i]](../images/iseries.gif)
testasset = AdminTask.importAsset('-source /ears/asset2.zip -storageType METADATA
–AssetOptions [[.* testAsset.zip .* "asset for testing"
/installedAssets/testAsset.zip/BASE/testAsset.zip "" "" "" false]]')
O seguinte comando importa o recurso defaultapp.ear, armazenando todos os binários do aplicativo e
define o ID de configuração retornado para a variável J2EEAsset:
J2EEAsset = AdminTask.importAsset('-source c:/ears/defaultapplication.ear
–storageType FULL –AssetOptions [[.* defaultapp.ear .* "desc" "" "" "" "" false]]')
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[HP-UX]](../images/hpux.gif)
![[AIX]](../images/aixlogo.gif)
![[IBM i]](../images/iseries.gif)
J2EEAsset = AdminTask.importAsset('-source /ears/defaultapplication.ear
–storageType FULL –AssetOptions [[.* defaultapp.ear .* "desc" "" "" "" "" false]]')
Os recursos de interesse são registrados como artefatos de configuração nomeados do repositório de configuração do servidor de aplicativos, que é conhecido como o registro de recursos. Use o comando
listAssets para exibir uma lista dos ativos registrados e verificar se as configurações estão corretas, como demonstra o exemplo a seguir:
AdminTask.listAssets('-includeDescription true -includeDeplUnit true')
- Crie um aplicativo no nível de negócios vazio.
Use o comando
createEmptyBLA para criar um novo aplicativo em nível de negócios e configurar o ID de configuração retornado para a variável
myBLA, como demonstra o exemplo a seguir:
myBLA = AdminTask.createEmptyBLA('-name myBLA
-description "BLA that contains asset1, asset2, and J2EEAsset"')
O sistema cria o aplicativo de nível de negócios. Use o comando listBLAs para exibir uma lista de cada aplicativo em nível de negócios na célula, como demonstra o exemplo a seguir:
AdminTask.listBLAs()
- Inclua os recursos, como unidades de composição, no aplicativo de nível de negócios.
As unidades de composição podem representar ativos implementados, outros aplicativos
em nível de negócios ou artefatos externos que são implementados em tempos de execução que não são do Application
Server sem ativos auxiliares.
Os aplicativos de nível de negócios contêm zero ou mais unidades de composição.
Você não pode incluir a mesma unidade de composição em mais de um aplicativo de nível de negócios, mas pode utilizar um recurso para criar mais de uma unidade de composição.
Use o comando
addCompUnit para incluir ativos como unidades de composição nos aplicativos em nível de negócios. O seguinte comando inclui o recurso
asset1.zip como uma unidade de composição no aplicativo de nível de negócios
myBLA e mapeia
a implementação para o servidor
server1:
AdminTask.addCompUnit('-blaID myBLA –cuSourceID asset1
-CUOptions [[.* .* compositionUnit1 "composition unit that is backed by asset1" 0]]
-MapTargets [[.* server1]]
–ActivationPlanOptions [[.* specname=actplan0+specname=actplan1]]')
O seguinte comando inclui um recurso
testAsset.zip como uma unidade de composição no aplicativo de nível de negócios
myBLA e mapeia a implementação para os servidores
server1 e
testServer:
AdminTask.addCompUnit('-blaID myBLA –cuSourceID asset2
-CUOptions [[.* .* compositionUnit2 "composition unit that is backed by asset2" 0]]
-MapTargets [[.* server1+testServer]]
–ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
O seguinte comando inclui o recurso
defaultapp.ear como uma unidade de composição
no aplicativo de nível de negócios
myBLA e mapeia a implementação para os servidores
server1 e
testServer:
AdminTask.addCompUnit('[-blaID bla1 -cuSourceID ' + J2EEAsset + ' -defaultBindingOptions
defaultbinding.ejbjndi.prefix=ejb#defaultbinding.virtual.host=default_host#defaultbinding.force=yes
-AppDeploymentOptions [-appname defaultapp] -MapModulesToServers [["Default Web Application" .*
WebSphere:cell=cellName,node=nodeName,server=server1] ["Increment EJB module" .*
Websphere:cell=cellName,node=nodeName,server=testServer]]
-CtxRootForWebMod [["Default Web Application" .* myctx/]]]')
- Salve as alterações da configuração.
Utilize o seguinte exemplo de comando para salvar suas alterações de
configuração:
AdminConfig.save()
- Sincronize os nós.
Utilize o script syncActiveNodes
da biblioteca de scripts AdminNodeManagement para sincronizar cada nó ativo em seu ambiente, como demonstra o seguinte exemplo:
AdminNodeManagement.syncActiveNodes()
- Inicie o aplicativo de nível de negócios.
Use o comando
startBLA para iniciar cada unidade de composição do aplicativo em nível de negócios nos destinos de implementação para os quais as unidades de composição estão configuradas, como demonstra o exemplo a seguir:
AdminTask.startBLA('-blaID myBLA')
Resultados
O sistema inclui três unidades de composição retornadas pelos recursos em um novo aplicativo de nível de negócios. Cada um dos três recursos são implementados e iniciados no servidor server1. Os recursos testAsset.zip e defaultapp.ear também são implementados e iniciados no servidor testServer.