Menu
Mostrando postagens com marcador JBoss AS. Mostrar todas as postagens
Mostrando postagens com marcador JBoss AS. Mostrar todas as postagens

terça-feira, 30 de junho de 2015

Amazing JBoss EAP/Wildfly profile cloner

Some time ago I began to save my JBoss EAP configurations as CLI scripts. The problem is that after each new release it was common to find out my scripts were broken due to command/argument changes.

Fortunately I found out today about Profile Cloner on mastertheboss. It was developed by Tom Fonteyne and it's available at github. This tool allows you to effortlessly convert the current configuration of your JBoss/Wildfly server into a CLI script.

How to use it

git clone https://github.com/tfonteyn/profilecloner
cp target/profilecloner-2015-06-25.jar profilecloner.jar
./profilecloner.sh -f save-script.cli  --controller=localhost --username=user --password=password /profile=ha ha-copy

quinta-feira, 16 de janeiro de 2014

org.jboss.as.clustering.lock.AbstractClusterLockSupport.lock exception


I spent two days trying to find out the source of this exception, so I think it's worth to share this solution with the community.

Background


First things first, this is my JBoss EAP 6.1 layout:

Hosts
dese-001 - domain controller + server-one
dese-002 - slave with server-one

Both are development servers using the main-server-group with full-ha profile and full-ha-sockets. They are meant to be an environment for tests before I deploy my applications to production.

And I also have a production environment with the same layout (prod-001 and prod-002 hosts). The production environment was made as a clone of the development one, so they were both sharing the same configurations.

All my servers were running on Suse Enterprise Linux with IBM JDK.

Problem


My servers were all very buggy and unreliable, often asking for reloads. My applications were quite slow and my deployments were frequently failing.

I had to restart my servers all the time, so I decided I should try to track down the root cause of my issues.

My first hunch was IBM JDK, which I replaced with openjdk6. Memory usage was improved, since IBM JDK loads permgen into heap memory, but my frequent restart issues were still present.

I upgraded from JBoss EAP 6.1 to 6.2. That's when I noticed this error log:

[Server:server-one] 09:50:04,687 ERROR [org.hornetq.core.server] (Old I/O server worker (parentId: 1675436606, [id: 0x63dd223e, /189.90.65.216:5445])) HQ224018: Failed to create session: HornetQException[errorType=SECURITY_EXCEPTION message=HQ119031: Unable to validate user: HORNETQ.CLUSTER.ADMIN.USER]
[Server:server-one]     at org.hornetq.core.security.impl.SecurityStoreImpl.authenticate(SecurityStoreImpl.java:146) [hornetq-server-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.hornetq.core.server.impl.HornetQServerImpl.createSession(HornetQServerImpl.java:964) [hornetq-server-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.hornetq.core.protocol.core.impl.HornetQPacketHandler.handleCreateSession(HornetQPacketHandler.java:151) [hornetq-server-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.hornetq.core.protocol.core.impl.HornetQPacketHandler.handlePacket(HornetQPacketHandler.java:78) [hornetq-server-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.hornetq.core.protocol.core.impl.ChannelImpl.handlePacket(ChannelImpl.java:631) [hornetq-core-client-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.hornetq.core.protocol.core.impl.RemotingConnectionImpl.doBufferReceived(RemotingConnectionImpl.java:547) [hornetq-core-client-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.hornetq.core.protocol.core.impl.RemotingConnectionImpl.bufferReceived(RemotingConnectionImpl.java:523) [hornetq-core-client-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.hornetq.core.remoting.server.impl.RemotingServiceImpl$DelegatingBufferHandler.bufferReceived(RemotingServiceImpl.java:564) [hornetq-server-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.hornetq.core.remoting.impl.netty.HornetQChannelHandler.messageReceived(HornetQChannelHandler.java:72) [hornetq-core-client-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.SimpleChannelHandler.handleUpstream(SimpleChannelHandler.java:88) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.DefaultChannelPipeline.sendUpstream(DefaultChannelPipeline.java:564) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.DefaultChannelPipeline$DefaultChannelHandlerContext.sendUpstream(DefaultChannelPipeline.java:791) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.Channels.fireMessageReceived(Channels.java:281) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.hornetq.core.remoting.impl.netty.HornetQFrameDecoder2.decode(HornetQFrameDecoder2.java:169) [hornetq-core-client-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.hornetq.core.remoting.impl.netty.HornetQFrameDecoder2.messageReceived(HornetQFrameDecoder2.java:134) [hornetq-core-client-2.3.12.Final-redhat-1.jar:2.3.12.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.SimpleChannelUpstreamHandler.handleUpstream(SimpleChannelUpstreamHandler.java:70) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.DefaultChannelPipeline.sendUpstream(DefaultChannelPipeline.java:564) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.DefaultChannelPipeline.sendUpstream(DefaultChannelPipeline.java:559) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.Channels.fireMessageReceived(Channels.java:268) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.Channels.fireMessageReceived(Channels.java:255) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.socket.oio.OioWorker.process(OioWorker.java:71) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.socket.oio.AbstractOioWorker.run(AbstractOioWorker.java:73) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.channel.socket.oio.OioWorker.run(OioWorker.java:51) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.util.ThreadRenamingRunnable.run(ThreadRenamingRunnable.java:108) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.util.internal.DeadLockProofWorker$1.run(DeadLockProofWorker.java:42) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at org.jboss.netty.util.VirtualExecutorService$ChildExecutorRunnable.run(VirtualExecutorServic.java:175) [netty-3.6.6.Final-redhat-1.jar:3.6.6.Final-redhat-1]
[Server:server-one]     at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1146) [rt.jar:1.6.0_27]
[Server:server-one]     at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615) [rt.jar:1.6.0_27]
[Server:server-one]     at java.lang.Thread.run(Thread.java:701) [rt.jar:1.6.0_27]

Supposedly I just needed to fill out hornet's cluster-password property in the domain.xml file, just as recommended on many forum threads found on Google:

<hornetq-server>
    <persistence-enabled>true</persistence-enabled>
        <cluster-password>${jboss.messaging.cluster.password:password}</cluster-password>

I did that, but the error log was still present in the server log. I managed to make it disappear by filling out the same hornet password used by the prod environment (which is the same used in JBoss EAP 6.1 development environment as well).

I noticed that production servers were being registered by development ones. At first I thought that was normal since the host controllers broadcast through a few services.

I deployed and tested my applications, but then I would be faced with the following stacktrace:

java.lang.NullPointerException
 org.jboss.as.clustering.lock.AbstractClusterLockSupport.lock(AbstractClusterLockSupport.java:157)
 org.jboss.as.clustering.lock.SharedLocalYieldingClusterLockManager.lock(SharedLocalYieldingClusterLockManager.java:436)
 org.jboss.as.clustering.web.infinispan.DistributedCacheManager.acquireSessionOwnership(DistributedCacheManager.java:400)
 org.jboss.as.web.session.ClusteredSession.acquireSessionOwnership(ClusteredSession.java:520)
 org.jboss.as.web.session.ClusteredSession.access(ClusteredSession.java:488)
 org.apache.catalina.connector.Request.doGetSession(Request.java:2616)
 org.apache.catalina.connector.Request.getSession(Request.java:2361)
 org.apache.catalina.connector.RequestFacade.getSession(RequestFacade.java:790)
 org.jboss.weld.context.beanstore.http.LazySessionBeanStore.getSession(LazySessionBeanStore.java:73)
 org.jboss.weld.context.beanstore.http.LazySessionBeanStore.<init>(LazySessionBeanStore.java:59)
 org.jboss.weld.context.http.HttpSessionContextImpl.associate(HttpSessionContextImpl.java:28)
 org.jboss.weld.context.http.HttpSessionContextImpl.associate(HttpSessionContextImpl.java:16)
 org.jboss.weld.servlet.WeldListener.requestInitialized(WeldListener.java:145)
 org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:97)
 org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:336)
 org.apache.coyote.ajp.AjpProcessor.process(AjpProcessor.java:488)
 org.apache.coyote.ajp.AjpProtocol$AjpConnectionHandler.process(AjpProtocol.java:420)
 org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:920)
 java.lang.Thread.run(Thread.java:701)

This one was really hard to find out, until I realized that since both server environments were sharing the same hornet password, maybe they were affecting each other, so I decided to shutdown production.

That completely solved my issue.

Conclusion


Both server environments should not share the same hornet passwords, but if they are different, the connection error log will be displayed every few seconds, since they are broadcasting to each other.

You can raise hornet log level to avoid the display of connection error logs, but the best solution, in my opinion, is to configure a firewall to block each other.

sexta-feira, 25 de maio de 2012

Compressão gzip no JBoss AS 7

Compressão gzip é uma boa prática para aplicativos web em que o servidor de aplicação comprime a página ou alguns elementos dela (html, css, javascript, imagens, etc) diminuindo seu tamanho em até  70% e, consequentemente, reduzindo também a carga na rede do servidor. Quando o cliente recebe a página compactada o web browser realiza a descompressão e o conteúdo é exibido ao usuário.

Para habilitá-la no JBoss AS 7 há dois modos. Podemos simplesmente adicionar um parâmetro inicializando-o pelo terminal como demonstrado abaixo:

$./standalone.sh -Dorg.apache.coyote.http11.Http11Protocol.COMPRESSION=on

Podemos também fazer esta configuração no arquivo standalone.xml, dentro da tag server:

<server xmlns="urn:jboss:domain:1.2">
    <system-properties>
        <property name="org.apache.coyote.http11.Http11Protocol.COMPRESSION" value="ON"/>
    </system-properties>
</server>

Para testar se a compressão está realmente habilitada, inicialize o servidor, acesse sua aplicação e por meio do Firebug, ou outra ferramenta equivalente, verifique se as requisições contém Accept-Encoding: gzip,deflate no cabeçalho.

Outra alternativa é utilizar o curl, aplicativo por linha de comando, que pode ser encontrado facilmente nos repositórios das distribuições linux:

ceefour@annafi:~$ curl --raw --compressed -s http://localhost:8080/Aplicacao -o - | wc -c
1259
ceefour@annafi:~$ curl --raw -s http://localhost:8080/Aplicacao -o - | wc -c
2432

A diferença do tamanho da página nos dois comandos executados (um com compressão habilitada e outro desabilitada) indica que a compressão gzip está funcionando adequadamente.

Referências

Solicitação do Suporte à Compressão GZip - https://issues.jboss.org/browse/AS7-2991

quarta-feira, 25 de abril de 2012

Uso de @ViewScoped no CDI em projetos EE sem Maven

Uma das primeiras dificuldades de quem começa com CDI após ter utilizado o JSF 2 é a falta da anotação @ViewScoped, que permite que o escopo do bean seja mantido enquanto o usuário permanecer na mesma página.

A solução recomendada para contornar este problema é adicionar a biblioteca seam-faces em seu projeto. Esta biblioteca possui a implementação do escopo de view.

Entretanto não é assim tão simples quanto parece. Para utilizar os componentes do JBoss Seam é geralmente necessário utilizar Maven para gerenciar seu projeto, pois a biblioteca seam-faces possui outras bibliotecas como dependências (seam-solder e seam-international). Nem sempre isso é possível, além de adicionar uma nova tecnologia para a fila daquelas que você precisa aprender na linguagem Java.

Primeiramente é necessário baixar o seam-bundle, que inclui todas as libs do seam em um único arquivo compactado. O seam-bundle na versão 3.1 pode ser encontrado aqui.

Após baixar o seam-3.1.0.Final.zip, extraia seu conteúdo para qualquer diretório. As bibliotecas necessárias serão todas encontradas na pasta artifacts. 

Em projetos enterprise, adicionar o seam-faces não se resumirá a colocar todas as bibliotecas em um único local, algumas ficam no projeto enterprise e outras no projeto web. Abaixo está a estrutura do meu projeto, que consiste em um projeto enterprise, um projeto web e diversos projetos EJBs (que não listei já que não são necessários para esta configuração).


  • Projeto Enterprise
    • EarContent
      • lib
        • solder-api.jar
        • solder-impl.jar
        • solder-logging.jar
  • Projeto Web
    • WebContent
      • WEB-INF
        • lib
          • seam-faces.jar
          • seam-faces-api.jar
          • seam-international.jar
          • seam-international-api.jar

Quando houver apenas o projeto Web, acredito que seja necessário apenas colocar as bibliotecas do seam-solder também em WEB-INF/lib.

Ressaltando que meu servidor de aplicação é o JBoss AS 7, talvez em outros servidores a configuração seja diferente.

quarta-feira, 11 de abril de 2012

Configuração de Drivers JDBC no JBoss AS 7

Há alguns anos atrás, quando comecei meus primeiros estudos na plataforma J2EE 5, perdi algumas semanas quebrando a cabeça para configurar datasources no servidor de aplicação JBoss AS (versão 5.1 na época). A última versão deste servidor (JBoss AS 7) mudou consideravelmente a forma de realizar esta configuração. Agora é possível fazer praticamente tudo em um único arquivo (standalone.xml) e as bibliotecas podem ser adicionadas como módulos, o que é uma das razões pela grande melhoria na velocidade de inicialização do servidor.

Nesta primeira postagem pretendo apenas demonstrar como devemos configurar o driver do banco de dados (abordarei a configuração para os SGBDs Oracle, PostgreSQL e MySQL).

A partir do JBoss Application Server na versão 7 há dois meios para configurar um driver JDBC. O primeiro é fazendo o deploy do driver (arquivo com a extensão .jar) no servidor e a outra é configurá-lo como módulo.

Adicionando o Driver JDBC como deployment

Por meio do primeiro método, recomendado pela documentação oficial do JBoss AS, é necessário apenas copiar o driver para o sub-diretório /standalone/deployments, assim como quando adicionávamos o driver no diretório common/lib nas versões anteriores (JBoss AS 5 e 6).

A vantagem dessa solução é que ela é a mais simples e que no modo domain (i.e., em ambientes clusterizados) você faz o deploy do driver e o mesmo é automaticamente propagado para todas as instâncias do servidor sem nenhum trabalho adicional.

A limitação é que ele funciona apenas para drivers compatíveis com o JDBC 4, sendo porém possível modificar drivers JDBC 3 de modo que funcionem por meio do deploy e, além disso, exige que seja especificada em toda xa-datasource a classe do driver. O driver também não pode ser adicionado como módulo caso ele consista em mais de um JAR. Nesse caso ele deve ser necessariamente ser instalado como deployment.

É importante destacar que no caso do servidor em modo domain não há um diretório em que você possa simplesmente colocar o JAR do driver e esperar que ele seja implantado automaticamente. Nesse caso é necessário utilizar as ferramentas de gerenciamento do JBoss (pretendo abordar essas ferramentas em um novo artigo).

Adicionando o Driver JDBC como módulo

O segundo método, que é recomendado por Francesco Marchioni [1], é adicionar o driver JDBC como um módulo do servidor, que é inicializado apenas quando especificado explicitamente no standalone.xml (ou domain.xml).

A configuração do driver JDBC como módulo no JBoss AS 7 é similar para qualquer SGBD, entretando há algumas particularidades. Primeiramente a estrutura de diretório depende da estrutura de empacotamento do driver JDBC e, além disso, esta estrutura deve estar descrita em um arquivo denominado module.xml. Esta diferenciação estará mais explícita conforme é demonstrada a configuração para cada um dos três SGBDs abordados neste post.

Configuração para o Oracle

O driver JDBC do Oracle pode ser obtido aqui e os seguintes passos devem ser seguidos para criar a estrutura de diretórios requerida pelo JBoss AS:
  1. Vá ao diretório [JBoss_AS_Home]/modules/com
  2. Crie o diretório ojdbc6 e dentro dele outra pasta chamada main
  3. Coloque o driver JDBC (ojdbc6.jar) dentro do diretório main e dentro desta mesma pasta crie o arquivo module.xml que conterá a definição do módulo.
Ao final, a estrutura dos diretórios deverá ser a seguinte:
  • [JBoss_AS_Home]/
    • modules
      • com
        • oracle
          • ojdbc6
            • main
              • module.xml
              • ojdbc6.jar
O arquivo module.xml deverá ter o seguinte conteúdo:
<module xmlns="urn:jboss:module:1.0" name="com.oracle.ojdbc6">
 <resources>
   <resource-root path="ojdbc6.jar"/>
 </resources>
 <dependencies>
   <module name="javax.api"/>
 </dependencies>
</module>

Configuração para o PostgreSQL

Primeiramente é necessário baixar o driver JDBC do PostgreSQL que pode ser encontrado aqui. A versão do driver durante a edição deste post é a 9.1-901.jdbc4.

Os passos são similares aos descritos no tópico anterior sobre a configuração para o Oracle, porém no caso do Postgres a estrutura de diretório deve ficar assim:
  • [JBoss_AS_Home]/
    • modules
      • org
        • postgres
          • main
            • module.xml
            • postgresql-9.1-901.jdbc4.jar
O arquivo modules.xml para o Postgres deve ser o seguinte:
<module xmlns="urn:jboss:module:1.0" name="org.postgres">
  <resources>
    <resource-root path="postgresql-9.0-801.jdbc4.jar"/>
  </resources>
   <dependencies>
     <module name="javax.api"/>
   </dependencies>
</module>

Configuração para o MySQL

O driver JDBC do MySQL pode ser baixado aqui e, novamente, os passos são similares aos dois drivers anteriores e a estrutura de diretório para o MySQL deve ser como abaixo:
  • [JBoss_AS_Home]/
    • modules
      • com
        • mysql
          • main
            • module.xml
            • mysql-connector.jar
E este é o modules.xml para o MySQL:
<module xmlns="urn:jboss:module:1.0" name="com.mysql">
  <resources>
    <resource-root path="mysql-connector-java-5.1.17-bin.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
  </dependencies>
</module>

Datasources Transacionais

Caso sua aplicação precise utilizar datasources transacionais (xa-datasources) é necessário adicionar a dependência adicional javax.transaction.api no arquivo module.xml como no seguinte exemplo.
<module xmlns="urn:jboss:module:1.0" name="com.oracle.ojdbc6">
  <resources>
    <resource-root path="ojdbc6.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>
A adição desta dependência para o driver dos outros SBGDs é equivalente à configuração exibida acima para o Oracle.

Declaração do Driver JDBC

Após a definição do driver JDBC como módulo é ainda necessário declará-lo no arquivo standalone.xml no subsystem "urn:jboss:domain:datasources:1.0", dentro das tags datasources e drivers como no exemplo abaixo:

<subsystem xmlns="urn:jboss:domain:datasources:1.0">
    <datasources>
        <drivers>
            
            
        </drivers>
    </datasources>
</subsystem>

Abaixo estão representadas as declarações para cada SGBD abordado neste artigo.

Oracle
<driver name="oracle" module="com.oracle.ojdbc6">
  <xa-datasource-class>
    oracle.jdbc.OracleDriver
  </xa-datasource-class>
</driver>

PostgreSQL
<driver name="postgresql" module="org.postgresql">
  <xa-datasource-class>
    org.postgresql.xa.PGXADataSource
  </xa-datasource-class>
</driver>

MySQL
<driver name="mysql-xa" module="com.mysql">
  <xa-datasource-class>
    com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
  </xa-datasource-class>
</driver>

Conclusão


Seguidos os passos acima, será necessário reiniciar o servidor (caso ele esteja iniciado) e o driver estará adequadamente configurado e disponível para ser utilizado pelas datasources configuradas no JBoss AS.

Fica a seu critério decidir o método de inclusão do driver de seu SGBD no JBoss AS 7 de acordo com as vantagens e limitações de cada alternativa. O intuito deste artigo foi simplesmente o de mostrar como realizar a configuração necessária independente de sua escolha.

Demonstrei como fazer o JBoss AS reconhecer o driver e, em breve (provavelmente até a semana que vem), publicarei outro artigo entrando em detalhes na configuração das datasources e xa-datasources.

Referências Úteis:

[1] Livro JBoss AS 7 Configuration, Deployment and Administration
[2] Documentação de Referência do JBoss AS 7 - Datasource Configuration

segunda-feira, 9 de abril de 2012

Iniciação no servidor JBoss AS 7

Em breve estarei publicando artigos que explicam a configuração de diversas funcionalidades do servidor JBoss Application Server 7 e, portanto, achei válido escrever este post para apresentá-lo, mostrar como realizar sua instalação e inicialização.

JBoss Application Server 7

O JBoss AS 7 é um servidor de aplicação Java que teve seu kernel totalmente reprojetado para suportar modularização dos recursos e prover uma velocidade de inicialização até 10 vezes maior do que em suas versões anteriores.

A partir da versão 7.1 ele passou a ser certificado para Java EE 6 (Certified Java EE 6 Full Profile), de tal modo é garantido que ele irá funcionar com EJB, JMS, JTA, JCA, JAX-WS, JPA, CDI e tudo o que estiver especificado na versão 6 do Java EE.

O JBoss AS 7 pode ser baixado aqui, sendo a versão 7.1.1 a mais recente no momento da escrita deste artigo. Ele pode ser baixado compactado tanto em .zip quanto em .tar.gz.

Após baixado faça a extração de seu conteúdo para qualquer diretório de sua escolha e a partir deste momento vamos passar a considerar este diretório como JBoss_Home. A estrutura principal de diretórios do servidor está representada abaixo:
  • [JBoss_Home]/
    • appclient
    • bin
      • add-user.bat
      • add-user.sh
      • domain.bat
      • domain.sh
      • standalone.bat
      • standalone.sh
    • bundles
    • docs
    • domain
      • configuration
      • data
      • tmp
    • modules
    • standalone
      • configuration
      • deployments
      • lib
      • tmp
    • welcome-content

O único diretório com que vamos nos preocupar por enquanto é o bin que contém os scripts de inicialização para os modos standalone e domain, para criação de novos usuários e para gerenciamento do servidor. Todos os scrips são disponibilizados em .sh (shell script) para sistemas Unix (Linux e Mac) e .bat para Windows.

O modo standalone executa apenas uma instância do servidor, enquanto o modo domain é utilizado quando queremos diversas instâncias do servidor (possivelmente com clusterização). É no primeiro modo que vamos inicializar o JBoss AS, portanto execute o script standalone.sh (ou standalone.bat, no caso do Windows).

Log do JBoss AS após ser executado o script de inicialização no modo standalone.
Para verificar que o servidor está realmente funcionando tente acessá-lo por seu web browser com esta URL. A página abaixo deverá ser exibida:

Página de boas-vindas do JBoss AS.
Para acessar o console administrativo do servidor clique aqui. Você deve ser apresentado à seguinte página de erro.

Erro no console administrativo do JBoss AS.
Isso ocorre porque à partir da versão 7.1 o JBoss AS passou a ser seguro por padrão e, como consequência, agora é obrigatório criar um usuário para poder editar as configurações do servidor por intermédio do web browser. O único meio de alterar essas configurações sem criar um usuário é editar os arquivos de configuração diretamente com o uso de editores de texto.

Para criar um novo usuário precisamos apenas executar o script add-user.sh. Em cada pergunta apenas aceite a opção padrão (teclando Enter) e digite seu nome de usuário e senha quando solicitados. Ao final responda yes para confirmar a criação da conta.

Criação de novo usuário no JBoss AS.
Tente acessar o console administrativo novamente. Digite seu usuário e senha e agora o acesso será permitido.

Agora podemos acessar o console administrativo.

Além da edição direta dos arquivos de configuração e do console administrativo, também podemos gerenciar o JBoss AS por meio da ferramenta chamada CLI (Command Line Interface), método que pretendo abordar em um artigo futuro.

Conclusão

Meu intuito com este artigo foi o de apresentar o JBoss AS, mostrar como inicializá-lo e também como acessar o console administrativo pelo web browser. Em meu próximo artigo vou escrever sobre como configurar drivers JDBC no JBoss AS 7.

Referências
[1] Livro JBoss AS 7 Configuration, Deployment and Administration
[2] https://docs.jboss.org/author/display/AS7/Getting+Started+Developing+Applications+Guide