Instalação do Coldfusion 8 J2EE no JBoss (Windows Vista 32 bits)

Este roteiro compreende 3 instalações:

I) Instalação do Java.
II) Instalação do JBoss.
III) Instalação do ColdFusion 8 J2EE.

I) Instalaçao do Java

Notas:

1. As versões do Java que são suportadas pelo ColdFusion rodando no Windows Vista 32 bits são: Sun JDK 1.2.3_14, 1.5.0_13 e 1.6_04 .
2. Mas no Windows 32 bits o JBoss só roda oficialmente no JDK 1.5.
3. Neste caso não será utilizado Apache, o webserver será o Tomcat que vem no JBoss.

I.1) Faça o download do Sun JDK 5.0 (Java 2 Development Kit) no site da SUN:

http://java.sun.com/javase/downloads/index_jdk5.jsp.

Selecione “JDK 5.0 Update” (onde x é a última versão disponível) e então selecione a plataforma correspondente a do seu Windows (no caso, 32 bits).

I.2) Instale o JDK.

I.3) Crie uma variável de ambiente chamada JAVA_HOME que tem que apontar para o diretório da instalação do JDK. Por exemplo: C:\Program Files\Java\jdk1.5.0_11\

Obs: Não terminar a string com ponto e virgula.

I.4) Para conseguir rodar o comando “java” na linha de comando, adicione o diretório jre\bin a variável de ambiente PATH. Por exemplo: C:\Program Files\Java\jdk1.5.0_11\jre\bin.

II) Instalação do JBoss

Notas:

1. As versões do JBoss que rodam o CF no Windows Vista são: JBoss 4.0.3, 4.0.5, 4.2 .
2. Site oficial: http://www.jboss.org/jbossas
3. Documentação do JBoss: http://www.jboss.org/jbossas/docs/index.html
4. A porta padrão do Tomcat, que é o web-container do JBoss, é 8080.

II.1) Baixe o JBoss http://www.jboss.org/download/ (versão 4.2.2GA) em formato ZIP.

II.2) Descompacte o arquivo ZIP em um diretório vazio da sua escolha. Por exemplo, c:\jboss.

II.3) Agora deve-se testar a instalação do servidor de aplicação JBoss para saber se não há problemas entre o sistema operacional e a Java VM da sua máquina. Vá para o diretório onde o JBoss está instalado e então para o sub-diretório bin. Por exemplo: C:\JBoss\bin e execute run.bat.

Observação: Se você quiser, pode editar o arquivo run.bat e alterar a linha @echo off para @echo on, assim você verá o trace do script.

II.4) No seu navegador preferido abra http://localhost:8080 para acessar a página principal do site de administração local do JBoss. Certifique-se antes de que não há nada rodando nesta porta.

III) Instalação do ColdFusion

Notas:

1. Em um ambiente de produção o servidor ColdFusion deve estar hospedado em um servidor dedicado só para ele. Os servidores de banco de dados, de email, não devem estar no mesmo computador.
2. O ColdFusion, na instalação J2EE no JBoss, apesar de ser fornecido como um pacote EAR, só roda com a sua árvore de diretórios expandida no servidor.
3. Quando o deployment do ColdFusion é feito como uma aplicação J2EE, o CF “core” (os arquivos binários) ficam localizado no diretório /WEB-INF/cfusion.

III.1) Desinstalar qualquer versão do ColdFusion 8 pré-existente (clean install).

III.2) Faça o download do CF8 para Windows 32 bits. Selecione as edições Enterprise ou Developer (que é gratúita). A edição Developer é funcionalmente completa, e além do localhost aceita mais dois IPs remotos.

http://www.adobe.com/devnet/coldfusion/?navID=gettingstarted

III.3) Execute o programa instalador.

- Durante a instalação selecione a opção “Developer Edition”.

- Logo depois você terá que escolher o tipo de instalação. Selecione a opção “J2EE configuration” com arquivo EAR (EAR file). O programa instalador irá criar um arquivo no disco com o nome cfusion.ear .

- As opções de módulos adicionais é escolha sua; pode manter os defaults.

- Selecione o diretório de instalação (que não é ainda a instalação final do ColdFusion funcionando!). Este é o diretório dentro do qual o programa instalador criará o arquivo cfusion.ear.

- Quando o programa instalador perguntar se a aplicação será distribuida em um servidor WebSphere, informe que não (porque estamos falando de JBoss, certo?).

- Quando perguntado sobre qual será o nome do context root das suas aplicações ColdFusion, informe “/cfusion” (sem as aspas). Este nome de contexto será utilizado no exemplos. Esclarecimento: o nome do contexto e o nome do ear não têm correspondência. Independente do nome do contexto, o arquivo gravado sempre terá o nome cfusion.ear.

- Digite a senha de acesso para a interface de administração do servidor ColdFusion.

- Não habilite a opção de RDS, deixe como está.

Observação: quando o RDS não é instalado, o botão “Browse Server” não funciona no site de administração do ColdFusion (ColdFusion Administrator). Mas isto não é um grande problema pois pode-se fazer facilmente os mapeamentos de diretórios com copiar-colar.

Ao término você verá, no diretório que você escolheu, o cfusion.ear e alguns outros arquivos.

III.4) Descompacte o arquivo cfusion.ear (eu utilizo o 7-zip para isso). Faça um “extract here”. Depois disso o diretório terá:

- META-INF (diretório novo)
- Adobe_ColdFusion_8_InstallLog.log (arquivo)
- cf-j2ee-readme.txt (arquivo)
- cfusion.ear (arquivo)
- cfusion.war (arquivo novo)
- license.txt (arquivo)
- Readme.htm (arquivo)

III.5) Apague o arquivo cfusion.ear pois ele não será mais necessário.

Atenção agora !!!

III.6) Renomeie o arquivo cfusion.war para cfusion_temp.war .

III.7) Crie um diretório chamado cfusion.war .

III.8) Descompacte o conteúdo do arquivo cfusion_temp.war dentro do diretório cfusion.war que você acabou de criar.

III.9) Apague o arquivo cfusion_temp.war porque ele não será mais necessário também. O diretóro deve ter ficado assim:

- cfusion.war (diretório)
- META-INF (diretório)
- Adobe_ColdFusion_8_InstallLog.log (arquivo)
- cf-j2ee-readme.txt (arquivo)
- license.txt (arquivo)
- Readme.htm (arquivo)

III.10) Deixe eles aí e pule para o diretório C:\JBoss\server.

III.11) Faça uma cópia do diretório “default”, para servir de backup.

III.12) Vá para C:\JBoss\server\default\deploy e crie um subdiretório chamado cfusion.ear.

III.13) Copie para baixo deste diretório os dois diretórios que ficaram no diretório de instalação do ColdFusion.

- cfusion.war (diretório)
- META-INF (diretório)

Pronto, o ColdFusion está pronto para ser utilizado!

III.14) Iniciar o servidor:

run.bat –c default

III.15) Testar a instalação do ColdFusion:

- Abrir o ColdFusion Administrator

http://localhost:8080/cfusion/CFIDE/administrator/index.cfm (a primeira vez demora)

- Fazer as configurações necessárias pela interface do ColdFusion Administrator.

IV) Procedimentos opcionais

IV.1) Alterar a porta do JBOSS:

Se o Tomcat for ser utilizado como o servidor web principal, a porta pode ser alterada para 80. Para fazer isso, editar o arquivo

C:\jboss\server\cfusion1\deploy\jboss-web.deployer\server.xml , e na seção
Connector port 8080” address=”${jboss.bind.address}”
maxThreads=”250″ maxHttpHeaderSize=”8192″
emptySessionPath=”true” protocol=”HTTP/1.1″
enableLookups=”false” redirectPort=”8443″ acceptCount=”100″
connectionTimeout=”20000″ disableUploadTimeout=”true” />

mudar a porta de 8080 para 80.

V) Recomendações

V.1) Baixe no site da Adobe as atualizações e hot fixes do ColdFusion.

V.2) Increva-se para receber notícias sobre o ColdFusion e manter-se atualizado sobre o produto.

References / Referências:

ColdFusion MX 6.1 for J2EE – Deploying ColdFusion MX 6.1 on J2EE Application Servers
http://www.adobe.com/support/coldfusion/j2ee/cfmxj2ee_home.html

Deploying ColdFusion 8 on JBoss Application Server http://livedocs.adobe.com/coldfusion/8/htmldocs/help.html?content=installj2ee_15.html#144211

(Obs: Contem algumas informações erradas a respeito da instalação, por exemplo, a instrução que manda trocar os pontos por hífen. Ver os comentários que foram feitos no artigo)

Setting up ColdFusion on JBoss: A Standalone Primer
http://www.fusioncube.net/?p=94

ColdFusion directory structure / Este link mostra a estrutura de diretórios do ColdFusion
http://livedocs.adobe.com/coldfusion/8/htmldocs/help.html?content=installj2ee_10.html

ColdFusion MX 7 on JBoss?
http://corfield.org/blog/index.cfm/do/blog.entry/entry/ColdFusion_MX_7_on_JBoss

JBoss vs Tomcat vs Jrun
http://www.houseoffusion.com/groups/cf-community/thread.cfm/threadid:26842

JBoss At Work, Part 1: Installing and Configuring JBoss
http://today.java.net/pub/a/today/2005/03/01/InstallingJBoss.html

Using mod_jk 1.2.x with JBoss/Tomcat bundle and Apache2
http://wiki.jboss.org/wiki/UsingMod_jk1.2WithJBoss

Unofficial JBoss Performance Tuning Guide
http://hodgman.info/phpBB/viewtopic.php?p=3&sid=126ec1e0062bf631124472aa82e5d16a