[AIX Solaris HP-UX Linux Windows][z/OS]

Instalando os aplicativos corporativos incluindo arquivos de propriedades em um diretório monitorado.

É possível utilizar arquivos de propriedades do aplicativo para instalar arquivos de aplicativo corporativo em um servidor ou cluster, atualizar módulos ou aplicativos implementados ou desinstalar módulos ou aplicativos implementados. Arraste ou copie um arquivo de propriedades para um diretório monitorado e o produto executa a ação de implementação descrita no arquivo de propriedades. Os arquivos de aplicativo corporativo que você pode instalar, atualizar ou desinstalar utilizando arquivos de propriedades incluem arquivos de archive corporativo (EAR), archive Web (WAR), Java™ archive (JAR) e archive de Protocolo de Inicialização de Sessão (SIP) (SAR). Um arquivo de aplicativo corporativo deve estar em conformidade com a especificação Java Platform, Enterprise Edition (Java EE).

Antes de Iniciar

Desenvolver e montar o arquivo EAR, JAR, WAR ou SAR. É possível usar uma ferramenta de montagem suportada, como um produto IBM® Rational Application Developer para WebSphere Software para especificar ligações e montar o arquivo.

Diferente do procedimento descrito para Instalar os arquivos corporativos incluindo-os em um diretório monitorado, o que não altera o Java Naming and Directory (JNDI) existente e outras ligações do aplicativo, é possível configurar ligações em um arquivo de propriedades.

Por padrão, a implementação do diretório monitorado não é ativada. Antes de usar a implementação de diretório monitorado, você deve ativá-la. Consulte Configurando Valores de Implementação do Diretório Monitorado.

Restrição: A instalação de um arquivo EAR, JAR, WAR ou SAR através da inclusão de um arquivo de propriedades em um diretório monitorado está disponível apenas em sistemas operacionais distribuídos ou z/OS. Não é suportado em sistemas operacionais IBM i.

Sobre Esta Tarefa

É possível implementar um arquivo EAR, JAR, WAR ou SAR em um servidor de aplicativos ou cluster arrastando ou copiando um arquivo de propriedade do aplicativo para um diretório monitorado monitoredDeployableApps/deploymentProperties. O produto varre um diretório monitorado em busca de novos arquivos de propriedades numa freqüência não maior do que a cada 5 segundos, por padrão. Depois de localizar um novo arquivo de propriedades em um diretório monitorado, o produto automaticamente executa o comando wsadmin applyConfigProperties, instala o aplicativo ou módulo no servidor de aplicativos ou cluster e inicia o aplicativo ou módulo.

Não é necessário iniciar o wsadmin ou inserir nenhum comando para implementar o aplicativo ou módulo. Simplesmente inclua um arquivo de propriedades em um diretório monitorado. O produto executa o comando wsadmin applyConfigProperties para você.

Você também pode usar um arquivo de propriedades para atualizar ou excluir um aplicativo implementado ou módulo. O servidor ou cluster deve estar executando para que o produto possa detectar as mudanças nos arquivos em seu diretório monitorado.

As etapas assumem que você usa um navegador de arquivo gráfico para arrastar ou copiar o arquivo de propriedades. Alternativamente, é possível usar os comandos do sistema operacional para copiar um arquivo em um diretório monitorado monitoredDeployableApps/deploymentProperties.

Procedimento

  1. Crie um arquivo de propriedades que define a tarefa de implementação que você deseja concluir.

    Os exemplos no final fornecem arquivos de propriedades do aplicativo de amostra para usar em diretórios monitorados.

    Os arquivos de propriedades que você utiliza em diretórios monitorados são como arquivos de propriedades descritos no tópico sobre como usar arquivos de propriedades para instalar, atualizar e excluir arquivos de aplicativo corporativo. Entretanto, os arquivos de propriedades que são usados para diretórios monitorados diferem ligeiramente:

    • Não é necessário especificar instruções como CreateDeleteCommandProperties=true no cabeçalho.
    • Para desinstalar um aplicativo corporativo, especifique DELETE=true no cabeçalho da seção de propriedades.

    Especifique apenas operações do tipo de recurso de aplicativo, ImplementingResourceType=Application, no arquivo de propriedades. Se o arquivo de propriedades contiver um tipo de recurso de não aplicativo, como ImplementingResourceType=Server, o produto retornará uma mensagem de erro e não executará a operação no tipo de recurso.

    É possível usar um arquivo de propriedades editado para instalar ou atualizar um aplicativo. Para extrair o arquivo de propriedades de um aplicativo corporativo implementado para editar ou usar como um modelo, execute o comando extractConfigProperties:
    • Extraia as propriedades do aplicativo para um arquivo que utiliza o antigo formato de saída do aplicativo.
      AdminTask.extractConfigProperties('[-propertiesFileName myApp.props -configData Deployment=MyApplication]')

      A execução desse exemplo Jython produz um arquivo denominado myApp.props que lista as propriedades de um objeto de configuração do aplicativo denominado MyApplication. Por padrão, o comando extractConfigProperties produz saída que exibe todas as colunas, inclusive as colunas ocultas e não-ocultas, da tarefa de instalação e valores dos dados de tarefa em linhas separadas. A linha mutáveis mostra quais colunas é possível editar (verdade) e quais não pode editar (falso).

      ...
      taskName=MapModulesToServers
        mutables={false false true false false false} #readonly
        row0={module uri server ModuleVersion moduletype moduletypeDisplay} # readonly
      ...

      Esse formato é mostrado no exemplo Instalar um aplicativo corporativo com várias opções de tarefa utilizando o antigo formato de saída do aplicativo. .

    • Extraia as propriedades do aplicativo para um arquivo que utiliza o formato de saída simples.
      AdminTask.extractConfigProperties('[-propertiesFileName myApp.props -configData Deployment=MyApplication
         -options [[SimpleOutputFormat true]]]')

      A execução desse exemplo de Jython com a opção SimpleOutputFormat definida para verdade produz um arquivo denominado myApp.props que relaciona as propriedades de um objeto de configuração do aplicativo denominado MyApplication em um formato de leitura mais fácil. A saída exibe colunas não-ocultas de propriedades do aplicativo em pares columnName=value. Colunas ocultas de propriedades do aplicativo não estão incluídas na saída.

      ...
      taskName=MapModulesToServers
      row0={ module="My EJB Module"  #readonly
             uri=MyEjbModule.jar,META-INF/ejb-jar.xml  #readonly
             server=WebSphere:cell=!{cellName},node=!{nodeName},
             server=!{serverName} }
      ...

      Esse formato é mostrado no exemplo Instalar um aplicativo corporativo com várias opções de tarefa utilizando o formato de saída simples.

    Para obter mais informações sobre como extrair propriedades do aplicativo e os formatos de saída, consulte o tópico sobre como usar arquivos de propriedades do aplicativo para instalar, atualizar e excluir os arquivos de aplicativo corporativo.

  2. Certifique-se de que o servidor de aplicativos ou membro de cluster no qual deseja instalar o aplicativo corporativo esteja executando.
  3. Certifique-se de que a implementação do diretório monitorado esteja ativada.

    Consulte Configurando valores de implementação do diretório monitorado.

  4. Abra um navegador da Web e crie o diretório monitorado deploymentProperties.

    Para servidores de aplicativos base (independentes), o diretório monitorado está sob o perfil do servidor de aplicativos. Depois de criar o diretório deploymentProperties, o caminho do diretório é app_server_root/profiles/application_server_profile_name/monitoredDeployableApps/deploymentProperties.

    Para servidores de aplicativos em um nó gerenciado (federado) de um gerenciador de implementação, crie o diretório monitorado deploymentProperties sob o perfil de gerenciador de implementação. Depois de criar o diretório deploymentProperties, o caminho do diretório é app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/deploymentProperties.

    Para clusters, crie um diretório monitorado deploymentProperties sob o perfil de gerenciador de implementação. Depois de criar o diretório deploymentProperties, o caminho do diretório é app_server_root/profiles/deployment_manager_profile_name/monitoredDeployableApps/deploymentProperties.

  5. Copie o arquivo de propriedades para o diretório monitorado deploymentProperties.

Resultados

O produto inclui um diretório que tem o mesmo nome que o arquivo no diretório installedApps/cell_name do perfil.

Além disso, o produto grava mensagens sobre a implementação do aplicativo no arquivo SystemOut.log no diretório app_server_root/logs/server_name. As mensagens são iniciadas com a chave de mensagem CWLDD.

As mensagens indicam que o produto implementou o arquivo de aplicativo e que o aplicativo está executando.

Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma recomendação alternativa, é possível configurar o servidor para usar a infraestrutura de log e rastreio do High Performance Extensible Logging (HPEL) em vez de usar os arquivos SystemOut.log , SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM i. Também é possível usar HPEL em conjunção com os recursos de criação de log z/OS nativos. Se você estiver usando HPEL, será possível acessar todas as informações de log e rastreio usando a ferramenta de linha de comandos LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre a utilização do HPEL para resolução de problemas dos aplicativos para obter mais informações sobre o uso do HPEL.

Para instalações em um diretório monitorado de gerenciador de implementação, o produto não inicia um aplicativo ou módulo automaticamente se o agente do nó ou servidor não estiver executando. Se um agente do nó estiver parado, o produto instala o aplicativo ou módulo no nível do gerenciador de implementação, mas não sincroniza as mudanças com o nó e não inicia o aplicativo ou módulo. As mudanças ocorrerão no nó na próxima vez que o agente estiver executando e ocorrer uma sincronização de nós Se o servidor estiver parado, mas o agente do nó estiver em execução, o produto instalará o aplicativo ou módulo e sincronizará as mudanças com o nó, mas não iniciará o servidor.

Exemplo

No exemplo a seguir os arquivos de propriedades fornecem modelos que você pode modificar para implementar seus aplicativos:

Instalar um aplicativo corporativo em um destino de implementação

Tabela 1. Propriedades Obrigatórias. Especifique as propriedades nesta tabela no arquivo de propriedades.
Propriedade Descrição
Nome Especifica o nome do aplicativo a instalar.
TargetServer Especifica o nome do servidor no qual o aplicativo deve ser instalado
TargetNode Especifica o nome do nó no qual instalar o aplicativo
EarFileLocation Especifica o local do archive corporativo (arquivo EAR). Fornece um nome do caminho completo.
#
# Cabeçalho
#
ResourceType=Application
ImplementingResourceType=Application


# Propriedades
Name=hello
TargetServer=!{serverName}
TargetNode=!{nodeName}
EarFileLocation=/temp/HelloWorld.ear
#TargetCluster=cluster1

EnvironmentVariablesSection
#
#
#Variáveis de Ambiente
cellName=myCell
nodeName=myNode
serverName=myServer

Instalar um aplicativo corporativo com várias opções de tarefa usando o antigo formato de saída de aplicativo

As propriedades de exemplo instalam o aplicativo corporativo com opções de tarefa. O arquivo de propriedades exibe todas as colunas, inclusive as colunas ocultas e não-ocultas, de tarefa de instalação, valores de dados de tarefa, em linhas separadas. A linha mutáveis mostra quais colunas é possível editar (verdade) e quais não pode editar (falso).

#
# Cabeçalho
#
ResourceType=Application
ImplementingResourceType=Application


# Propriedades
Name=!{applicationName}
EarFileLocation=c:/temp/HelloWorld.ear

#
# SubSection 1.0.2 # MapModulesToServers Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=MapModulesToServers
  mutables={false false true false false false} #readonly
  row0={module uri server ModuleVersion moduletype moduletypeDisplay} # readonly
  row1={“My Web Module” myWebModule.war,WEB-INF/web.xml WebSphere:cell=!{cellName},node=!{nodeName},server=!{serverName} 14 moduletype.web "Web Module"}
  row2={"My EJB module" MyEjbModule.jar,META-INF/ejb-jar.xml WebSphere:cell=!{cellName},node=!{nodeName},server=!{serverName} 13 moduletype.ejb "EJB Module"}


#
# SubSection 1.0.3 # MapRolesToUsers Section. taskName and
# row0 should not be edited. row0 contains column names for
# the tasks.
#ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=MapRolesToUsers
row0={role role.everyone role.all.auth.user role.user role.group role.all.auth.realms role.user.access.ids role.group.access.ids} #readonly
mutables={false true true true true true true true} 
#readonly
row1={administrator AppDeploymentOption.No AppDeploymentOption.No "adminuser" "admingroup" AppDeploymentOption.No "" ""}


#
# SubSection 1.0.4 # BindJndiForEJBNonMessageBinding 
# Section. taskName and row0 should not be edited. row0 
# contains column names for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
#Propriedades
#
taskName=BindJndiForEJBNonMessageBinding
row0={EJBModule EJB uri JNDI ModuleVersion localHomeJndi remoteHomeJndi} #readonly
mutables={false false false true false true true} #readonly
row1={"My EJB module" myEjb myEjbModule.jar,META-INF/ejb-
jar.xml myEjb 20 "" “"}


#
# SubSection 1.0.5 # MapEJBRefToEJB Section. taskName and 
# row0 should not be edited. row0 contains column names for
# the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
#Propriedades
#
taskName=MapEJBRefToEJB
row0={module EJB uri referenceBinding class JNDI ModuleVersion} #readonly
mutables={false false false false false true false} 
#readonly
row1={"My EJB module" myEJB MyEjbModule.jar,META-INF/ejb-
jar.xml myEJB com.ibm.defaultapplication.Increment 
Increment 23}

#
# SubSection 1.0.6 # DataSourceFor20EJBModules Section.
# taskName and row0 should not be edited. row0 contains
# column names for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
#
#Propriedades
#
taskName=DataSourceFor20EJBModules
row0={AppVersion EJBModule uri JNDI resAuth login.config.name auth.props dataSourceProps} #readonly
mutables={false false false true true true true true} 
#readonly
row1={13 "My EJB module" MyEjbModule.jar,META-INF/ejb-
jar.xml MyDataSource cmpBinding.perConnectionFactory "" ""
 ""}

#
# SubSection 1.0.7 # DataSourceFor20CMPBeans Section.
# taskName and row0 should not be edited. row0 contains 
# column names for the task.#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=DataSourceFor20CMPBeans
row0={AppVersion EJBVersion EJBModule EJB uri JNDI resAuth login.config.name auth.props} #readonly
mutables={false false false false false true true true true} #readonly
row1={13 13 "My EJB module" MyEjb MyEjbModule.jar,META-
INF/ejb-jar.xml myDataSource
cmpBinding.perConnectionFactory "" ""}

#
# SubSection 1.0.8 # MapWebModToVH Section. taskName and 
# row0 should not be edited. row0 contains column names for
# the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}

#
# Propriedades
#
taskName=MapWebModToVH
row0={webModule uri virtualHost} #readonly
mutables={false false true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/web.xml default_host}
#


#
# SubSection 1.0.9 # CtxRootForWebMod Section. taskName and
# row0 should not be edited. row0 contains column names for
# the task.#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=CtxRootForWebMod
row0={webModule uri web.contextroot} #readonly
mutables={false false true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/web.xml /}


#
# SubSection 1.0.10 # MapSharedLibForMod Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=MapSharedLibForMod
row0={module uri sharedLibName} #readonly
mutables={false false true} #readonly
row2={"My Web Application" MyWebModule.war,WEB-INF/web.xml ""}
row1={myApp META-INF/application.xml ""}#


#
# SubSection 1.0.11 # JSPReloadForWebMod Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=JSPReloadForWebMod
row0={webModule uri jspReloadEnabled jspReloadInterval} 
#readonly
mutables={false false true true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/ibm-web-
ext.xmi AppDeploymentOption.Yes}
#


#
# SubSection 1.0.35 # SharedLibRelationship Section. 
# taskName and row0 should not be edited. row0 contains 
# column names for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=SharedLibRelationship
row0={module uri relationship compUnitName matchTarget 
origRelationship} #readonly
mutables={false false true true true false} #readonly
row2={"My Web Application" MyWebModule.war,WEB-INF/web.xml "" "" AppDeploymentOption.Yes ""}
row1={myApp META-INF/application.xml "" "" AppDeploymentOption.Yes ""}
#

EnvironmentVariablesSection
#
# Variáveis de Ambiente
#
applicationName=myApp
cellName=myCell
nodeName=myNode
serverName=myServer

Instalar um aplicativo corporativo com várias opções de tarefa usando o formato de saída simples

As propriedades de exemplo instalam um aplicativo corporativo com opções de tarefa. O exemplo mostra propriedades do aplicativo que foram extraídas com a opção SimpleOutputFormat. Com essa opção, o arquivo de propriedades exibe colunas não-ocultas de propriedades do aplicativo em pares columnName=value. Colunas ocultas de propriedades do aplicativo não estão incluídas na saída. É possível descobrir que extraindo arquivos de propriedades do aplicativo com a opção SimpleOutputFormat produz um formato que é mais fácil de ler e editar.

#
   # Cabeçalho
   #
   ResourceType=Application
   ImplementingResourceType=Application 

# Propriedades
Name=!{applicationName}
EarFileLocation=c:/temp/HelloWorld.ear

#
# SubSection 1.0.2 # MapModulesToServers Section. taskName
# and lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#         

#
# Propriedades
#
taskName=MapModulesToServers
row0={ module="My EJB Module"  #readonly
       uri=MyEjbModule.jar,META-INF/ejb-jar.xml  #readonly
       server=WebSphere:cell=!{cellName},node=!{nodeName},
       server=!{serverName} }
row1={ module="My Web Module"  #readonly
       uri=myWebModule.war,WEB-INF/web.xml  #readonly
       server=WebSphere:cell=!{cellName},node=!{nodeName},
       server=!{serverName} }


#
# SubSection 1.0.3 # MapRolesToUsers Section. taskName and
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=MapRolesToUsers
row0={ role="All Role"  #readonly
       role.everyone=AppDeploymentOption.No
       role.all.auth.user=AppDeploymentOption.Yes
       role.user=""
       role.group=""
       role.all.auth.realms=AppDeploymentOption.No
       role.user.access.ids=""
       role.group.access.ids="" }


#
# SubSection 1.0.4 # BindJndiForEJBNonMessageBinding 
# Section. taskName and lines marked as "#readonly" should
# not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
#Propriedades
#
taskName=BindJndiForEJBNonMessageBinding
row0={ EJBModule="My EJB Module"  #readonly
      EJB=myEjb  #readonly
      uri=myEjbModule.jar,META-INF/ejb-jar.xml  #readonly
      JNDI=myEjb
      localHomeJndi=""
      remoteHomeJndi="" }


#
# SubSection 1.0.5 # MapEJBRefToEJB Section. taskName and 
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
#Propriedades
#
taskName=MapEJBRefToEJB
row0={ module="My EJB Module"  #readonly
      EJB=myEJB  #readonly
      uri=MyejbModule.jar,META-INF/ejb-jar.xml  #readonly
      referenceBinding=myEJB  #readonly
      class=com.ibm.defaultapplication.Increment #readonly
      JNDI=myejb }


#
# SubSection 1.0.6 # DataSourceFor20EJBModules Section. 
# taskName and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
#
#Propriedades
#
taskName=DataSourceFor20EJBModules
row0={ EJBModule="My EJB Module"  
       #readonly
       uri=myEjbModule.jar,META-INF/ejb-jar.xml  #readonly
       JNDI=MyDatasource
       resAuth=cmpBinding.perConnectionFactory
       login.config.name=""
       auth.props=""
       dataSourceProps="" }


#
# SubSection 1.0.7 # DataSourceFor20CMPBeans Section. 
# taskName and lines marked as "#readonly" should not be
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
# Propriedades
#
taskName=DataSourceFor20CMPBeans
row0={ EJBModule="My EJB Module”  #readonly
       EJB=MyEjb  #readonly
       uri=MyEjbModule.jar,META-INF/ejb-jar.xml  #readonly
       JNDI=MyDatasource
       resAuth=cmpBinding.perConnectionFactory
       login.config.name=""
       auth.props="" }


#
# SubSection 1.0.8 # MapWebModToVH Section. taskName and 
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}


#
# Propriedades
#
taskName=MapWebModToVH
row0={ webModule="My Web Application"  #readonly
       uri=myWebModule.war,WEB-INF/web.xml  
       #readonly
       virtualHost=default_host }


#
# SubSection 1.0.9 # CtxRootForWebMod Section. taskName and
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


# Propriedades
#
taskName=CtxRootForWebMod
row0={ webModule="My Web Application"  #readonly
       uri=myWebModule.war,WEB-INF/web.xml 
       #readonly
       web.contextroot=/ }


#
# SubSection 1.0.10 # MapSharedLibForMod Section. 
# taskName and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=MapSharedLibForMod
row0={ module=myApp”  #readonly
       uri=META-INF/application.xml  #readonly
       sharedLibName="" }
row1={ module="My Web Application"  #readonly
       uri=MyWebModule.war,WEB-INF/web.xml  #readonly
       sharedLibName="" }


#
# SubSection 1.0.11 # JSPReloadForWebMod Section. taskName
# and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
# Propriedades
#
taskName=JSPReloadForWebMod
row0={ webModule="My Web Application"  #readonly
      uri=MyWebModule.war,WEB-INF/web.xml  
           #readonly
       jspReloadEnabled=AppDeploymentOption.Yes
       jspReloadInterval=10 }


#
# SubSection 1.0.35 # SharedLibRelationship Section.
# taskName and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=SharedLibRelationship
row0={ module=myApp  #readonly
       uri=META-INF/application.xml  #readonly
       relationship=""
       matchTarget=AppDeploymentOption.Yes }
row1={ module="My Web Application"  #readonly
       uri=MyWebModule.war,WEB-INF/web.xml  
       #readonly
       relationship=""
       matchTarget=AppDeploymentOption.Yes }

EnvironmentVariablesSection
#
# Variáveis de Ambiente
#
applicationName=myApp
cellName=myCell
nodeName=myNode
serverName=myServer

Atualizar um único arquivo em um aplicativo corporativo implementado

As propriedades de exemplo incluem um único arquivo em um aplicativo implementado:

#
# Cabeçalho
#
ResourceType=Application
ImplementingResourceType=Application


# Propriedades
Name=hello
Update=true
operationType=add
contentType=file
contentURI=test.war/com/ibm/addMe.jsp
contentFile=/temp/addMe.jsp

Remover um único arquivo de um aplicativo corporativo implementado

As propriedades de exemplo excluem um único arquivo de um aplicativo implementado:

#
# Cabeçalho
#
ResourceType=Application
ImplementingResourceType=Application


# Propriedades
Name=hello
Update=true
operationType=delete
contentType=file
contentURI=test.war/com/ibm/addMe.jsp

Atualizar um único módulo em um aplicativo corporativo implementado

As propriedades de exemplo incluem um único módulo em um aplicativo implementado:

#
# Cabeçalho
#
ResourceType=Application
ImplementingResourceType=Application


# Propriedades
Name=hello
Update=true
operationType=add
contentType=moduleFile
#contextRoot=”/mywebapp” # required for web module only
contentURI=Increment.jar
contentFile=/apps/app1/Increment.jar
deployEJB=false

Remover um único módulo de um aplicativo corporativo implementado

As propriedades de exemplo excluem um único módulo de um aplicativo implementado:

#
# Cabeçalho
#
ResourceType=Application
ImplementingResourceType=Application


# Propriedades
Name=hello
Update=true
operationType=delete
contentType=moduleFile
contentURI=test.war

Substituir, incluir ou excluir vários arquivos de um aplicativo corporativo implementado

Esta opção especifica como atualizar vários arquivos de um aplicativo instalado por meio do upload de um arquivo compactado. Dependendo do conteúdo do arquivo compactado, uma única utilização desta opção pode substituir arquivos, incluir novos arquivos e excluir arquivos do aplicativo instalado. Cada entrada no arquivo compactado é tratada como um único arquivo e o caminho do arquivo na raiz do arquivo compactado é tratado como o caminho relativo do arquivo no aplicativo instalado.

Para substituir um arquivo, um arquivo do arquivo compactado deve ter o mesmo caminho relativo que o arquivo a ser atualizado no aplicativo instalado.

Para incluir um novo arquivo no aplicativo instalado, um arquivo do arquivo compactado deve ter um caminho relativo diferente do que os arquivos do aplicativo instalado.

O caminho relativo de um arquivo no aplicativo instalado é formado por concatenação de caminho relativo do módulo, se o arquivo estiver dentro de um módulo, e o caminho relativo do arquivo da raiz do módulo separado por uma barra (/).

Para remover um arquivo do aplicativo instalado, especifique metadados no arquivo compactado utilizando um arquivo denominado META-INF/ibm-partialapp-delete.props em qualquer escopo de archive. O arquivo ibm-partialapp-delete.props deve ser um arquivo ASCII que lista arquivos a serem excluídos nesse archive com uma entrada para cada linha. A entrada pode conter um padrão de cadeia, como uma expressão regular que identifica vários arquivos. Os caminhos de arquivo para os arquivos a serem excluídos devem ser relativos ao caminho do archive que tem o arquivo META-INF/ibm-partialapp-delete.props.

Para obter mais informações sobre o arquivo .props de metadados a incluir nos arquivos compactados, consulte a seção "Substituir, incluir ou excluir vários arquivos" em Preparando para configurações de atualização do aplicativo.

As propriedades de exemplo utilizam o arquivo compactado myAppPartial.zip para atualizar um aplicativo implementado denominado hello:

#
# Cabeçalho
#
ResourceType=Application
ImplementingResourceType=Application


# Propriedades
Name=hello
Update=true
operationType=update
contentType=partialapp
contentFile=/temp/MyApp/myAppPartial.zip

Substituir todo o aplicativo corporativo implementado

As propriedades de exemplo atualizam o aplicativo implementado inteiro:

#
# Cabeçalho
#
ResourceType=Application
ImplementingResourceType=Application


# Propriedades
Name=hello
Update=true
operationType=update
contentType=app
contentFile=/apps/app1/newApp1.ear
useDefaultBindings=true

Desinstalar um aplicativo de um destino de implementação

As propriedades de exemplo desinstalam um aplicativo implementado:

#
# Cabeçalho
#
ResourceType=Application
ImplementingResourceType=Application
DELETE=true

# Propriedades
Name=hello

Editar as opções de implementação de um aplicativo implementado

As propriedades de exemplo atualizam as opções de implementação de um aplicativo implementado:

#
# Cabeçalho
#
ResourceType=Application
ImplementingResourceType=Application

# Propriedades
Name=!{applicationName}

#
# SubSection 1.0.1 # AppDeploymentOptions Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Propriedades
#
taskName=AppDeploymentOptions
row1={$(APP_INSTALL_ROOT)/$(CELL)
AppDeploymentOption.Yes 
AppDeploymentOption.No
AppDeploymentOption.No 
AppDeploymentOption.No 
"" 
off .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 
"WASX.SERV1 [x0617.27]" 
AppDeploymentOption.No 
AppDeploymentOption.No}
mutables={true true true true true true true true false true true}
row0={installed.ear.destination
distributeApp 
useMetaDataFromBinary 
createMBeansForResources 
reloadEnabled 
reloadInterval 
validateinstall 
filepermission 
buildVersion 
allowDispatchRemoteInclude 
allowServiceRemoteInclude} #readonly

#
EnvironmentVariablesSection
#
#
#Variáveis de Ambiente
applicationName=newhello

Editar as propriedades de implementação do módulo da web

As propriedades de exemplo editam as propriedades de implementação de um módulo da Web:

#
# WebModuleDeployment
#
ResourceType=WebModuleDeployment
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=
:WebModuleDeployment=uri#web.war


#
#Propriedades
#
startingWeight=90000 #integer,required,default(1)
deploymentId=1 #required
classloaderMode=PARENT_FIRST ENUM(PARENT_FIRST|PARENT_LAST),default(PARENT_FIRST)
altDD=null
uri=web.war #required
#applicationDeployment=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=
#ObjectName(ApplicationDeployment)


EnvironmentVariablesSection
#
#
#Variáveis de Ambiente
cellName=myCell
applicationName=myApp 

O que Fazer Depois

Se o arquivo de propriedades implementa um aplicativo ou módulo, teste o aplicativo implementado ou módulo. Por exemplo, insira a URL para um aplicativo implementado em um navegador da Web e examine o desempenho do aplicativo.

Se a implementação não for bem-sucedida, leia as mensagens no arquivo SystemOut.log, corrija a condição de erro e inclua o arquivo de propriedades em um diretório monitorado novamente.


Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_install_dragdrop_prop
Nome do arquivo: trun_app_install_dragdrop_prop.html