Para quem desenvolve aplicações ColdFusion JEE para público alvo brasileiro, é necessário “internacionalizar” a JVM (acentuação e formatos de data, hora e moeda).  Observação: parãmetros válidos para a Sun’s HotSpot™ Java Virtual Machin.

No arquivo run.conf:

JAVA_OPTS=”-Xms1024m -Xmx1024m -Xmn512m -Xss128k -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -XX:MaxPermSize=128m -XX:+UseParallelGC -XX:+UseParallelOldGC -Djava.awt.headless=true -Djava.net.preferIPv4Stack=true -Dsun.lang.ClassLoader.allowArraySyntax=true “

Acrescentar uma linha com:

JAVA_OPTS=%JAVA_OPTS% -Duser.language=pt -Duser.country=BR -Duser.timezone=Etc/GMT+3  -Dfile.encoding=iso_8859_1

Curiosidade: muitos textos em inglês se referem a internacionalização como “i18n”, porque a palavra “internationalization” começa com a letra “i”, termina a letra com “n”, e possui 18 caracteres entre elas.

2. Habilitar o agente jconsole localmente

Acrescentar uma linha com:

set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote

3. Habilitar o agente jconsole remotamente sem utilizar seguraça nem ssl

set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.port=12345″

set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.authenticate=false”

set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.ssl=false”

Refs:

http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp

http://java.sun.com/performance/reference/whitepapers/tuning.html

http://www.jboss.org/community/wiki/UseJDK5JConsole

Na plataforma J2EE uma aplicação web pode ser instalada desempacotada em uma estrutura de diretórios, ou empacotada dentro de um arquivo WAR.

Um arquivo WAR é simplesmente uma estrutura de diretórios de uma aplicação web, que foi empacotada em um arquivo ZIP para o qual é dada a extensão .WAR.

Arquivos WAR podem ser criados com qualquer utilitário que seja capaz de criar um arquivo ZIP, como por exemplo, o Winzip (no Windows) Gzip (no Unix) ou o utilitário Jar do JDK.

Deste modo, arquivos WAR são um modo conveniente de instalar uma aplicação J2EE inteira como se fosse um único arquivo.

Um pacote WAR pode conter:

- Arquivos de classe java que os desenvolvedores criaram,

- Arquivo de configuração do pacote – o descritor da instalação / deployment descriptor (web.xml, jboss-web.xml),

- Arquivos fontes para a aplicação (arquivos de configuração, arquivos de imagens, arquivos HTML, arquivos XML, etc).

http://pt.wikipedia.org/wiki/Subversion

- Baixe e instale o cliente subversion Tortoise (que possui interface gráfica) em:

http://tortoisesvn.net/downloads

Um cliente subversion é útil para podermos baixar frameworks e aplicações-exemplo que somente estão disponíveis através dele.

Caso apareça a mensagem abaixo durante o primeiro checkout após a instalação

svn: PROPFIND of ‘XXXXXXX’: could not connect to server (XXXXXXXX)

é porque provavelmente falta você especificar o proxy da sua rede na configuração do Tortoise.

- BlueDragon http://www.newatlanta.com/bluedragon/

- IgniteFusion http://www.ignitefusion.com/

- Railo (é um projeto do JBoss desde junho/2008 )

http://www.railo-technologies.com/
http://www.jboss.org/railo/

- Smith http://www.smithproject.org/

See also / Veja também:

http://en.wikipedia.org/wiki/ColdFusion_Markup_Language

http://pt.wikipedia.org/wiki/ColdFusion

ColdFusion MX/J2EE Hybrid Applications
http://coldfusion.sys-con.com/read/42059.htm

ColdFusion/Java Hybrid application – Proof of Concept
http://www.mattwoodward.com/blog/index.cfm?event=showEntry&entryId=0192D021-CFFA-F449-F1A8F35D5F5C3BB6

ColdBox – http://www.coldboxframework.com
ColdSpring – http://www.coldspringframework.org
Fusebox – http://www.fusebox.org
MachII – http://www.mach-ii.com
Model-Glue – http://www.model-glue.com
onTap – http://ontap.riaforge.org , http://on.tapogee.com/
Reactor – http://trac.reactorframework.com
Transfer – http://www.transfer-orm.com
PureMVC – http://puremvc.org

2) Links to frameworks articles / Links para artigos sobre frameworks

Which Framework?
http://corfield.org/blog/index.cfm/do/blog.entry/entry/Which_Framework

Remote Synthesis: Mach II or ColdSpring? Understanding the differences between ColdFusion frameworks
http://www.remotesynthesis.com/post.cfm/Mach-II-or-ColdSpring-Understanding-the-Differences-Between-ColdFusion-Frameworks

IoC, AOP, and Rails-like productivity…in ColdFusion?
http://www.theserverside.com/news/thread.tss?thread_id=41189

3) Links to Design Patterns articles / Links para artigos sobre Design Patterns

ColdFusion Design Patterns
http://www.cfdesignpatterns.com/
Mere Mortals
http://stannard.net.au/blog/index.cfm/Design-Patterns
IBO: A ColdFusion Design Pattern
http://www.alagad.com/go/blog-entry/ibo-a-coldfusion-design-pattern
Design Patterns in ColdFusion
http://corfield.org/blog/index.cfm/do/blog.entry/entry/Design_Patterns_in_ColdFusion_1
Design Patterns: Elements of Reusable Object-Oriented Software
http://www.adobe.com/devnet/coldfusion/articles/design_patterns.html

http://corfield.org/

http://www.petefreitag.com/

http://www.forta.com/blog/index.cfm

http://www.houseoffusion.com

http://www.talkingtree.com/blog/

http://www.fusioncube.net/

http://www.coldfusionjedi.com/

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