aptitude install apache2

Installation der benötigten Bibliotheken:

aptitude install libstdc++5

Installation von Coldfusion:

Nun das Installationspaket (Linux bin-file) von der Adobe Webseite herrunterladen. Dazu muss man sich ggf. anmelden. Die 30 Tage Testversion ist ausreichend, da man später durch die Eingabe einer Seriennummer in der Webadministration auf die entsprechende Vollversion umstellen kann.

Nun die Datei ausführbar machen und das Installationsprogramm starten:

chmod +x ColdFusion_9_WWE_linux64.bin
./ColdFusion_9_WWE_linux64.bin

Nun die folgenden Fragen beantworten:

PRESS  TO CONTINUE:
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y

Install Type
------------

If you do not have a serial number, select either 30-day trial or Developer
Edition.

  ->1- Install new version of Adobe ColdFusion 9 with a serial number
    2- 30-day trial
    3- Developer Edition

Installation Choice: 2

Installer Configuration
-----------------------

What kind of installation do you want?

  ->1- Server configuration
    2- Enterprise Multiserver configuration
    3- J2EE configuration (EAR file)
    4- J2EE configuration (WAR file)

Choose one of the following options:: 1

Is Adobe ColdFusion 9 (Server Configuration) Installed?
-------------------------------------------------------

You cannot install the server configuration of Adobe ColdFusion 9 if it is already installed on this computer.

Is there already a server configuration of Adobe ColdFusion 9 installed?

    1- Yes
  ->2- No

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS  TO ACCEPT THE DEFAULT:: 2

Subcomponent installation
-------------------------

The following options are available for installation.

An option marked with "[X]" in front will be installed and an option with "[ ]"
will not.  Choosing an option will toggle it on or off

[X] 1) ColdFusion 9 Documentation
[X] 2) ColdFusion 9 Solr Services
[X] 3) ColdFusion 9 Search Services
[X] 4) Start ColdFusion on system init

    5) Continue with installation

Select an option: 5

Choose Install Folder
---------------------

Select the directory where you want to install Adobe ColdFusion 9.

Directory:

  Default Install Folder: /opt/coldfusion9

ENTER AN ABSOLUTE PATH, OR PRESS  TO ACCEPT THE DEFAULT
      : /opt/coldfusion

INSTALL FOLDER IS: /opt/coldfusion
   IS THIS CORRECT? (Y/N): Y

Earlier Versions of Adobe ColdFusion installed?
-----------------------------------------------

If you installed an earlier version of ColdFusion on this computer, you can migrate your settings to Adobe ColdFusion 9.

Is there an earlier version of ColdFusion installed on this computer (for example, ColdFusion 6 or ColdFusion MX 7)?

    1- Yes
  ->2- No

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS  TO ACCEPT THE DEFAULT:: 2

Configure Web Servers
---------------------

Please configure your web server(s).  If you do not configure a web server the
built-in web server will be used on port 8500 or the next available port.

    1- Add Web Server Configuration
  ->2- Continue with installation

Choice: 1

****************************************************

  ->1- Apache
    2- Sun ONE Web Server (iPlanet)
    3- Cancel

What kind of web server are you configuring: 1

What directory contains your Apache configuration file (httpd.conf)? (For
   example, on Red Hat Linux it could be located in the /etc/httpd/conf
   directory if you installed from an rpm, or for SuSe Linux, it could be in
   /etc/apache2)

   Directory: /etc/apache2

****************************************************

Where is the Apache program binary file? (For example, on Red Hat Linux it
   could be /usr/sbin/httpd if you installed from an rpm, or for SuSE Linux it
   could be located at /usr/sbin/httpd2) If you have more than one instance of
   Apache on your computer, enter the binary file location for the Apache web
   server that will use ColdFusion. (Note: this is not the Apache start and
   stop script.)

   File: /usr/sbin/apache2

****************************************************

Where is the control file that you use to start and stop the Apache web
   server? (For example, this could be /etc/init.d/httpd on Red Hat Linux if
   you installed from an rpm, /usr/sbin/apache2ctl on SuSe Linux, or it could
   be /usr/local/apache/bin/apachectl on hand-compiled versions.)

   File: /etc/init.d/apache2

****************************************************

Please configure your web server(s).  If you do not configure a web server the
built-in web server will be used on port 8500 or the next available port.

    1- Add Web Server Configuration
    2- Remove Web Server Configuration
    3- Edit:Apache : /etc/apache2
  ->4- Continue with installation

Choice: 4

Choose Adobe ColdFusion 9 Administrator Location
------------------------------------------------

Select the location of the web root for Adobe ColdFusion 9. This is where the installer places the Adobe ColdFusion 9 Administrator.

This directory must be the web root for one of the websites to be configured for use with Adobe ColdFusion 9.

Directory: (DEFAULT: /etc/htdocs): /var/www

Runtime User
------------

Enter the name of the runtime user.   This user must already exist on the system.

User Name: (DEFAULT: nobody):

Configure ColdFusion with OpenOffice
------------------------------------

Configuring OpenOffice installation with ColdFusion will enable Office documents to be processing using OpenOffice. If OpenOffice is not configured ColdFusion will not be able to convert some Microsoft Office Documents to PDF. Check the documentation for more details.

    1- Configure ColdFusion with local Openoffice installation
  ->2- Skip

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS  TO ACCEPT THE DEFAULT:: 2

Administrator Password
----------------------

Enter the password that you will use to restrict access to the ColdFusion
Administrator.

This field is required.

Password:
Confirm Password:

Enable RDS
----------

The ColdFusion Remote Development Service (RDS) lets developers using Adobe
tools remotely connect to this server for development purposes. RDS is required
for Line Debugging, Report Builder, and Dreamweaver Extensions.

If this is a production server, Adobe recommends that you disable RDS.
Note, however, that disabling RDS also disables debugging, the directory
browsing applets in the ColdFusion Administrator and some of the functionality
in the Report Builder.

Enable RDS  (Y/N): Y
Password:
Confirm Password:

Installation Confirmation
-------------------------

Installation Type:
  Server configuration

Licensing:
  30-day trial

Installation Directories:
  Product: /opt/coldfusion
  Web root: /var/www

Server Information:
  Web Server: Apache (/etc/apache2)
  Port:
  Search Services: installed
  ColdFusion Solr Search Services: installed
  Documentation: installed
  RDS: enabled

Disk Space Information (for Installation Target):
  Required: 992,437,542 bytes
  Available: 4,799,873,024 bytes

PRESS  TO CONTINUE:

Installing...
-------------

 [==================|==================|==================|==================]
 [------------------|------------------|------------------|------------------]

===============================================================================
Installation Complete
---------------------

You have successfully completed the first step in installing Adobe ColdFusion
9.

To continue with your installation, go to /opt/coldfusion/bin and type
"./coldfusion start" to start your server.

Once the server, is started log in to the Configuration Wizard at

http://[machinename]/CFIDE/administrator/index.cfm

Press Enter to exit the installer:

Coldfusion Server starten

/opt/coldfusion/bin/coldfusion start

Coldfusion installiert nun den Connector für den Apache 2 Webserver (/etc/apache2/httpd.conf) welcher dafür verantwortlich ist, dass später Skripte an den Coldfusion Server weitergeleitet werden.

Coldfusion Server automatisch beim Systemstart starten:

cp /opt/coldfusion/bin/coldfusion /etc/init.d
update-rc.d coldfusion defaults

Installation abschließen:

Um die Installation abschließen, muss man nur noch den Coldfusion-Administrator mit dem Browser aufrufen.

http://SERVERNAME/CFIDE/administrator/index.cfm

Bemerkung:

Die gesamte Anleitung funktioniert absolut identisch mit Adobe Coldfusion 8.

1. Vorbedingungen:

* Apache 2 ist installiert und arbeitet korrekt.

* libstdc++5 ist installiert.

aptitude install libstdc++5

* Eine eigene Domain für den virtuellen Host steht bereit. (www.testsrv.local)

* Der neuste Coldfusion Installer wurde von www.adobe.com heruntergeladen. (z.B. coldfusion-801-lin64.bin)

2. Coldfusion Installation:

chmod +x coldfusion-801-lin64.bin
./coldfusion-801-lin64.bin

Bemerkung: Dies ist der 64-Bit Installer. Wenn kein 64-Bit Betriebssystem vorhanden ist, wird die 32-Bit Version benötigt (coldfusion-801-lin.bin).

Konfigurationseinstellungen:

CHOOSE LOCALE BY NUMBER: 1
PRESS <ENTER> TO CONTINUE: <ENTER>
PRESS <ENTER> TO CONTINUE: <ENTER>
...
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y
Installation Choice: 1 (Install new version of Adobe ColdFusion 8 with a serial number)
Serial Number: XXXX-XXXX-XXXX-XXXX-XXXX-XXXX
Choose one of the following options:: 2 (Multiserver configuration)
Is there already a multiserver configuration of Adobe ColdFusion 8, or Macromedia JRun 4, installed?: 2 (No)
Select an option: 5 (Continue with installation)
Default Install Folder: /opt/jrun4 <ENTER>
PRESS <ENTER> TO CONTINUE: <ENTER>
PRESS <ENTER> TO CONTINUE: <ENTER>
...
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y
Serial Number:: <ENTER>
Earlier Versions of Adobe ColdFusion installed?
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 2 (No)
Configure Webserver: 1 (Add Web Server Configuration)
Select "Apache" 1
Directory: /etc/apache2
File: /usr/sbin/apache2
File: /etc/init.d/apache2
Choice: 4 (Continue with installation)
Directory: (DEFAULT: /etc/htdocs): /var/www
User Name: (DEFAULT: nobody): <ENTER>
Password: <Default Development Password>
Enable RDS  (Y/N): Y
Password: <Your Password>
PRESS <ENTER> TO CONTINUE: <ENTER>

Time for a cup of coffee ...

Press Enter to exit the installer: <ENTER>

3. Init-Skript anlegen:

Unter Suse oder Redhat kann man <pre>/opt/jrun4/bin/cf-init.sh install<pre> verwenden, um ein init-Skript anzulegen. Unter Ubuntu oder Debian muss man jedoch sein eigenes Skript anlegen:

vim /etc/init.d/coldfusion8multi

#!/bin/sh
# MultiServer cfusion instance Init-Script

CF_DIR="/opt/jrun4"

cfstart() {
echo "The ColdFusion 8 server is starting up and will be available shortly."
nohup $CF_DIR/bin/jrun -start cfusion > $CF_DIR/logs/cfusion-event.log &
echo "======================================================================"
echo "ColdFusion 8 has been started."
echo "ColdFusion 8 will write logs to $CF_DIR/logs/cfusion-event.log"
echo "======================================================================"
}

cfstop() {
echo "Stopping ColdFusion 8, please wait"
nohup $CF_DIR/bin/jrun -stop cfusion
echo "ColdFusion 8 has been stopped"
}

case $1 in
    start)
        cfstart
    ;;
    stop)
        cfstop
    ;;
    restart)
        cfstop

    cfstart
    ;;
esac

exit 0

Init-Skript installieren:

update-rc.d coldfusion8multi defaults

Coldfusion Server starten:

/etc/init.d/coldfusion8multi start

Den Apache Connector einrichten:

/opt/jrun4/bin/cf-connectors.sh

Dies wird das “mod_jrun22″ für den Apache installieren und konfigurieren. (/etc/apache2/httpd.conf)

# JRun Settings
LoadModule jrun_module /opt/jrun4/lib/wsconfig/1/mod_jrun22.so
<IfModule mod_jrun22.c>
    JRunConfig Verbose false
    JRunConfig Apialloc false
    JRunConfig Ignoresuffixmap false
    JRunConfig Serverstore /opt/jrun4/lib/wsconfig/1/jrunserver.store
    JRunConfig Bootstrap 127.0.0.1:51020
    #JRunConfig Errorurl url <optionally redirect to this URL on errors>
    #JRunConfig ProxyRetryInterval 600 <number of seconds to wait before trying to reconnect to unreachable clustered server>
    #JRunConfig ConnectTimeout 15 <number of seconds to wait on a socket connect to a jrun server>
    #JRunConfig RecvTimeout 300 <number of seconds to wait on a socket receive to a jrun server>
    #JRunConfig SendTimeout 15 <number of seconds to wait on a socket send to a jrun server>
    AddHandler jrun-handler .jsp .jws .cfm .cfml .cfc .cfr .cfswf
</IfModule>

Den Apache neu starten:

/etc/init.d/apache2 restart

Nun kann man den Coldfusion Administrator öffnen:

http://<SERVER>/CFIDE/administrator/index.cfm

Nun kann man die Installation mit dem Coldfusion Administrator abschließen.

4. Eine neue Coldfusion Instanz und virtuellen Host anlegen:

Zuerst muss man die neue Instanz mit dem “Instance Manager” anlegen. Dazu den Coldfusion Administrator öffnen und unter “Enterprise Manager” den “Instance Manager” auswählen. Der nächste Schritt ist dort mit “Add New Instance” eine weitere Instanz anzulegen. Einfach einen neuen “Server Name” eingeben “webapp1″ in diesem Beispiel und das ganze mit “Submit” bestätigen.

Jrun erzeugt nun ein neues Serververzeichnis “/opt/jrun4/servers/webapp1″ und startet die neue Instanz. Im “Instance Manager” kann man diese sehen. Außerdem sieht man dort den zugewiesenen HTTP-Port. Zum Beispiel “8301″. Damit kann man nun den Coldfusion Administrator für diese neue Instanz öffnen “http://<SERVER>:8301/CFIDE/administrator/index.cfm”.

Das “Document root” befindet sich unter “/opt/jrun4/servers/webapp1/cfusion.ear/cfusion.war/”.

Man kann ein einfaches Test-Skript erzeugen:

vim /opt/jrun4/servers/webapp1/cfusion.ear/cfusion.war/test.cfm

<h2>Test</h2>
<cfset test="Hello World">
<cfoutput>#test#</cfoutput>

Man kann diese Skript mit “http://<SERVER>:8301/test.cfm” aufrufen.

Nun muss man einen virtuellen Host für “webapp1″ im Apache anlegen:

vim /etc/apache2/sites-available/webapp1

<VirtualHost *>
    ServerName www.testsrv.local

    <IfModule mod_jrun22.c>
        JRunConfig Verbose false
        JRunConfig Apialloc false
        JRunConfig Ignoresuffixmap false
        JRunConfig Serverstore /opt/jrun4/lib/wsconfig/1/jrunserver.store
        JRunConfig Bootstrap 127.0.0.1:51000
        #JRunConfig Errorurl url <optionally redirect to this URL on errors>
        #JRunConfig ProxyRetryInterval 600 <number of seconds to wait before trying to reconnect to unreachable clustered server>
        #JRunConfig ConnectTimeout 15 <number of seconds to wait on a socket connect to a jrun server>
        #JRunConfig RecvTimeout 300 <number of seconds to wait on a socket receive to a jrun server>
        #JRunConfig SendTimeout 15 <number of seconds to wait on a socket send to a jrun server>
        AddHandler jrun-handler .jsp .jws .cfm .cfml .cfc .cfr .cfswf
    </IfModule>

    DocumentRoot /opt/jrun4/servers/webapp1/cfusion.ear/cfusion.war/
    <Directory /opt/jrun4/servers/webapp1/cfusion.ear/cfusion.war/>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride None
        Order allow,deny
        allow from all
    </Directory>

    ErrorLog /var/log/apache2/error.log
    CustomLog /var/log/apache2/access.log combined
</VirtualHost>

Bemerkung: Sehr wichtig ist die Zeile “JRunConfig Bootstrap 127.0.0.1:51000″. Für jede Multiserver-Instanz erzeugt Coldfusion einen eigenen Port für den “JRunProxyService”. Dieser Port ist in der “jrun.xml” für jede Instanz definiert.

vim /opt/jrun4/servers/webapp1/SERVER-INF/jrun.xml

...
<service class="jrun.servlet.jrpp.JRunProxyService" name="ProxyService">
...
<attribute name="port">51000</attribute>
<attribute name="deactivated">false</attribute>
...
</service>
...

Nun kann man den neuen virtuellen Host installieren:

a2ensite webapp1

und den Apache Server neu laden:

/etc/init.d/apache2 reload

Nun kann man mit “http://www.testsrv.local/test.cfm” auf das Test-Skript zugreifen.

Auch auf den Coldfusion Administrator kann über “http://www.testsrv.local/CFIDE/administrator/index.cfm” zugegriffen werden

Man sollte natürlich noch weitere Konfigurationen an dem virtuellen Host vornehmen. Zum Beispiel den Zugriff auf “CFIDE” mit einer zusätzlichen “.htaccess” Datei einschränken, das Verzeichnisauflisten deaktivieren und weitere Apache Sicherheitseinstellungen vornehmen.

5. Init-Skript anpassen:

Der Coldfusion Server startet die Instanzen nicht automatisch beim starten. Deshalb müssen die Instanzen zum Init-Skript hinzugefügt werden. Hier ist eine angepasste Version für “webapp1″:

#!/bin/sh
# MultiServer cfusion instance Init-Script

CF_DIR="/opt/jrun4"

cfstart() {
echo "The ColdFusion 8 server is starting up and will be available shortly."
nohup $CF_DIR/bin/jrun -start cfusion > $CF_DIR/logs/cfusion-event.log &
nohup $CF_DIR/bin/jrun -start -childVM webapp1 > $CF_DIR/servers/webapp1/cfusion.ear/cfusion.war/WEB-INF/cfusion/logs/cfusion-event.log &
echo "======================================================================"
echo "ColdFusion 8 has been started."
echo "ColdFusion 8 will write logs to $CF_DIR/logs/cfusion-event.log"
echo "======================================================================"
}

cfstop() {
    echo "Stopping ColdFusion 8, please wait"
    nohup $CF_DIR/bin/jrun -stop cfusion
    nohup $CF_DIR/bin/jrun -stop -childVM webapp1
    echo "ColdFusion 8 has been stopped"
}

case $1 in
    start)
        cfstart
    ;;
    stop)
        cfstop
    ;;
    restart)
        cfstop
        sleep 20
        cfstart
    ;;
esac

exit 0

Bemerkung: Man könnte auch eigene Init-Skripte für jede Instanz anlegen. Die Haupt Coldfusion Applikation wird übrigens nicht benötigt um die Instanzen laufen zu lassen.

Wird der Coldfusion Server in verschiedenen virtuellen Hosts installiert, wird jeder seinen eigenen Coldfusion Administrator mit eigenen Einstellungen besitzen.

1. Download

Zuerst die entsprechende Installationsdatei coldfusion-801-lin.bin (oder coldfusion-801-lin64.bin für 64-Bit) von der Adobe Webseite herunterladen.

wget http://trials.adobe.com/Applications/ColdFusion/801WWE/coldfusion-801-lin64.bin
chmod +x coldfusion-801-lin64.bin

2. System vorbereiten

2.1 Bibliotheken installieren

Coldfusion benötigt noch einige zusätzliche Bibliotheken für die Installation:

aptitude install libstdc++6 libstdc++5
ln -s /usr/lib/libstdc++-libc6.2-2.so.3 /usr/lib/libstdc++-libc6.1-1.so.2

2.2 Virtuelle Hosts im Tomcat anpassen

vim /opt/tomcat/conf/server.xml

<!-- www.testsrv.local -->
<host name="www.testsrv.local" appBase="/var/www/vhost1/htdocs" unpackWARs="true" autoDeploy="true">
    <context path="" docBase="cfusion" debug="0" reloadable="true"/>
    <valve className="org.apache.catalina.valves.AccessLogValve" directory="/var/www/vhost1/logs"  prefix="tomcat_access_" suffix=".log" pattern="common" resolveHosts="false"/>
</host>

2.3 Virtuelle Hosts im Apache anpassen

vim /etc/apache2/sites-enabled/vhost1

<virtualhost www.testsrv.local:80>
    JkMount /*.cfm default
    JkMount /*.cfc default
    JkMount /*.cfchart default
    DirectoryIndex index.cfm index.html index.htm
    ServerName www.testsrv.local
    ServerAdmin servermaster@testsrv.local
    DocumentRoot /var/www/vhost1/htdocs/cfusion
    ErrorLog /var/www/vhost1/logs/error.log
    CustomLog /var/www/vhost1/logs/access.log common
    <directory /var/www/vhost1/htdocs/cfusion>
        Options -Indexes
    </directory>
    <directory /var/www/vhost1/htdocs/cfusion/WEB-INF>
        Options -Indexes
        AllowOverride None
        deny from all
    </directory>
    <directory /var/www/vhost1/htdocs/cfusion/META-INF>
       Options -Indexes
       AllowOverride None
       deny from all
    </directory>
</virtualhost>

Bemerkung: Man sollte das CFIDE Verzeichniss ebenfalls absichern. Zum Beispiel mit einer .htaccess Datei.

3. WAR Datei erstellen

./coldfusion-801-lin64.bin

“J2EE configuration (WAR file)” auswählen
Dies wird eine cfusion.war Datei unter /opt/coldfusion8 anlegen.

4. WAR Datei für den virtuellen Host installieren

cp /opt/coldfusion8/cfusion.war /var/www/vhost1/htdocs/

Bemerkung: Tomcat wird die WAR Datei entpacken und das cfusion Verzeichniss anlegen. Danach kann die WAR Datei gelöscht werden.

5. Konfiguration anwenden

/etc/init.d/tomcat restart
/etc/init.d/apache2 reload

6. Coldfusion Installation abschließen

Nun kann auf den Coldfusion Administrator mit dem Browser zugegriffen werden:

http://www.testsrv.local/CFIDE/administrator/index.cfm

Wird der BlueDragon Server in verschiedenen virtuellen Hosts installiert, wird jeder seinen eigenen Coldfusion Administrator mit eigenen Einstellungen besitzen.

1. Download

Die “J2EE WAR Distribution” kann unter http://www.openbluedragon.org/download.cfm heruntergeladen werden.

2. System vorbereiten

2.1 Virtuelle Hosts im Tomcat anpassen

vim /opt/tomcat/conf/server.xml

<!-- www.testsrv.local -->
<host name="www.testsrv.local" appBase="/var/www/vhost1/htdocs" unpackWARs="true" autoDeploy="true">
    <context path="" docBase="openbluedragon" debug="0" reloadable="true"/>
    <valve className="org.apache.catalina.valves.AccessLogValve" directory="/var/www/vhost1/logs"  prefix="tomcat_access_" suffix=".log" pattern="common" resolveHosts="false"/>
</host>

2.2 Virtuelle Hosts im Apache anpassen

vim /etc/apache2/sites-enabled/vhost1

<virtualhost www.testsrv.local:80>
    JkMount /*.cfm default
    JkMount /*.cfc default
    JkMount /*.cfchart default
    DirectoryIndex index.cfm index.html index.htm
    ServerName www.testsrv.local
    ServerAdmin servermaster@testsrv.local
    DocumentRoot /var/www/vhost1/htdocs/openbluedragon
    ErrorLog /var/www/vhost1/logs/error.log
    CustomLog /var/www/vhost1/logs/access.log common
    <directory /var/www/vhost1/htdocs/openbluedragon>
        Options -Indexes
    </directory>
    <directory /var/www/vhost1/htdocs/openbluedragon/WEB-INF>
        Options -Indexes
        AllowOverride None
        deny from all
    </directory>
</virtualhost>

3. WAR Datei für den virtuellen Host installieren

Kopieren der heruntergeladenen openbluedragon.war Datei nach /var/www/vhost1/htdocs/

Bemerkung: Tomcat wird die WAR Datei entpacken und das cfusion Verzeichniss anlegen. Danach kann die WAR Datei gelöscht werden.

4. Konfiguration anwenden

/etc/init.d/tomcat restart
/etc/init.d/apache2 reload

5. Konfiguration testen

Nun kann die Installation getestet werden indem man die BlueDragon CFML Testseite öffnet:

http://www.testsrv.local/index.cfm

6. Administration

Unter http://bdadmin.riaforge.org ist ein Webadministrationsinterface für den OpenBlueDragon Server verfügbar.

Zuerst wird ein Skript benötigt welches den cfstat Befehl auf den Servern ausführt:

#!/bin/bash

# This script call the coldfusion server stat service and format the output for cacti
# 2008 by Mogilowski Sebastian

# Settings:
HOSTNAME='127.0.0.1'
SSH_USER='username'
SSH_KEY_FILE='/path/to/ssh/key/file'
# Check argument
if [ $# -ne 1 ]
then
  echo "Usage: `basename $0` <hostname>"
  exit $E_BADARGS
fi

# Using command line argument 1 for hostname
HOSTNAME=$1

# Request statistics from the coldfusion stat service
STAT_OUTPUT=`ssh -i $SSH_KEY_FILE $SSH_USER@$HOSTNAME /opt/coldfusion8/bin/cfstat -n -x`

# Format the output for cacti
IFS=" "
ARRAY_OUTPUT=($STAT_OUTPUT)
echo "Pg/Sec_Now:"${ARRAY_OUTPUT[0]}" Pg/Sec_Hi:"${ARRAY_OUTPUT[1]}"
      DB/Sec_Now:"${ARRAY_OUTPUT[2]}" DB/Sec_Hi:"${ARRAY_OUTPUT[3]}"
      CP/Sec_Now:"${ARRAY_OUTPUT[4]}" CP/Sec_Hi:"${ARRAY_OUTPUT[4]}"
      Reqs_Qed:"${ARRAY_OUTPUT[6]}" Reqs_Rung:"${ARRAY_OUTPUT[7]}"
      Reqs_TOed:"${ARRAY_OUTPUT[8]}" Templ_Qed:"${ARRAY_OUTPUT[9]}"
      Templ_Rung:"${ARRAY_OUTPUT[10]}" Templ_TOed:"${ARRAY_OUTPUT[11]}"
      Flash_Qed:"${ARRAY_OUTPUT[12]}" Flash_Rung:"${ARRAY_OUTPUT[13]}"
      Flash_TOed:"${ARRAY_OUTPUT[14]}" CFC_Qed:"${ARRAY_OUTPUT[15]}"
      CFC_Rung:"${ARRAY_OUTPUT[16]}" CFC_TOed:"${ARRAY_OUTPUT[17]}"
      WebS_Qed:"${ARRAY_OUTPUT[18]}" WebS_Rung:"${ARRAY_OUTPUT[19]}"
      WebS_TOed:"${ARRAY_OUTPUT[20]}" AvgQ_time:"${ARRAY_OUTPUT[21]}"
      AvgReq_Time:"${ARRAY_OUTPUT[22]}" AvgDB_Time:"${ARRAY_OUTPUT[23]}"
      Bytes_In/Sec:"${ARRAY_OUTPUT[24]}" Bytes_Out/Sec:"${ARRAY_OUTPUT[25]}

Dieses Skript führt per ssh die cfstat Anfrage auf dem Coldfusion Server aus, und formatiert die erhaltenen Daten so um, das diese mit Cacti auszuwerten sind. Mit dem Parameter -n wird die Ausgabe der Kopfzeile (Feldnamen) unterdrückt und mit -x holt man sich alle Werte. Für die Einrichtung der Schlüsselbasierten ssh Authtifizierung verweise ich auf Google oder http://oreilly.com/pub/h/66. Zum ausführen von cfstat sind keine root-Rechte erforderlich, somit ist kein sudo erforderlich. Hier das Skript als Download:

Es muss im script Verzeichnis von Cacti abgelegt werden. (Debian: /usr/share/cacti/site/scripts/getColdFusionStats.sh)

Als nächstes müssen entsprechende Cacti Templates angelegt werden. Hier sollte man sich die Cacti Dokumentation ansehen. Hier habe hier auch mein Template zum download bereitgestellt:

Zur Zeit werden 4 Werte abgefragt (AvgQ Time, AvgReq Time, AvgDB Time, Req TO’ed).

Hier einige Screenshots von den erstellten Graphen:

[Show as slideshow]

Ich bitte um Feedback, wenn entsprechendes Interesse besteht, kann man einen Thread im Cacti Forum erstellen.

Bemerkung: Funktioniert nur mit der Singleserver Installation, da in der Multiserver cfstat nicht verfügbar ist.

Der Apache 2 Webserver sollte bereits installiert und konfiguriert sein.

Bevor man mit der eigentlichen Installation beginnt, müssen noch einige erforderliche Pakete installiert werden:

sudo aptitude install libstdc++5 libstdc++6

Zusätzlich muss noch ein Symlink für die Bibliotheken angelegt werden:

sudo ln -s /usr/lib/libstdc++-libc6.2-2.so.3 /usr/lib/libstdc++-libc6.1-1.so.2

Nun kann man den Linux Installer starten, den man sich von der Adobe Webseite heruntergeladen hat.

sudo chmod +x coldfusion-801-lin.bin
sudo ./coldfusion-801-lin.bin

Der Installer stellt einige Fragen zu Pfaden sowie dem Installationsverzeichnis, für das ich “/opt/coldfusion” gewählt habe:

CHOOSE LOCALE BY NUMBER: 1
PRESS <ENTER> TO CONTINUE: <ENTER>
PRESS <ENTER> TO CONTINUE: <ENTER>
...
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y
Installation Choice: 3 (Developer Edition)
Choose one of the following options:: 1 (Server configuration)
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 2
Select an option: 2 (remove "Adobe LiveCycle Data Services ES")
Select an option: 5
ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: /opt/coldfusion
INSTALL FOLDER IS: /opt/coldfusion IS THIS CORRECT? (Y/N): Y
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 2
Configure Webserver: 1 (Add Web Server Configuration)
Select "Apache" 1
Directory: /etc/apache2
File: /usr/sbin/apache2
File: /etc/init.d/apache2
Choice: 4 (Continue with installation)
Directory: (DEFAULT: /etc/htdocs): /var/www
User Name: (DEFAULT: nobody): <ENTER>
Password: <Your custom CF Password>
Enable RDS  (Y/N): Y
Password: <Your custom CF Password>
PRESS <ENTER> TO CONTINUE: <ENTER>
Press Enter to exit the installer: <ENTER>

Nach der Installation kann man den Coldfusion Server starten

sudo /opt/coldfusion/bin/coldfusion start

Damit der Coldfusion Server automatisch beim Systemstart mitgestartet wird, sind noch diese beiden Schritte notwendig:

sudo cp /opt/coldfusion/bin/coldfusion /etc/init.d
sudo update-rc.d coldfusion defaults

Damit ist der Coldfusion Server fertig installiert. Die Konfiguration und das Einspielen der neusten HotFixes erfolgt über den Coldfusion Administrator. (http://SERVER/CFIDE/administrator/index.cfm)

Dabei wird nicht einfach ein Statusbild eingeblendet, sondern der Status richtig ausgelesen, um zum Beispiel eigene Texte und Bilder zu verwenden, oder um den Status in anderen Codeteilen weiterzuverwenden. Außerdem ist es so möglich den Status in verschiedenen Sprachen anzuzeigen.

Informationen über die Unterschiede der beiden Versionen findet man auf der Produktinformationsseite von NewAtlanta.

Verzeichnis anlegen

Um einige Probleme mit falschen Pfadlinks zu vermeiden, ist das Verzeichnis /opt gegenüber /usr/local vorzuziehen. Wer dennoch /usr/local oder ein anderes Verzeichnis wählt, muss die Pfade in dieser Anleitung entsprechend seiner Konfiguration anpassen.

/opt/BlueDragon

# BlueDragon 7 JX
LoadModule servletexec_module /usr/lib/apache2/modules/mod_servletexec22.so

# BlueDragon 7 JX
LoadModule servletexec_module /usr/lib/apache2/modules/mod_servletexec2.so

ServletExecInstances default 127.0.0.1:9999
ServletExecAliases default /servlet .cfc .cfm .cfml .cfchart
<location /servlet>
SetHandler servlet-exec
</location>
AddHandler servlet-exec cfc
AddHandler servlet-exec cfm
AddHandler servlet-exec cfml
AddHandler servlet-exec cfchart