Installing the Server Configuration

Although the ColdFusion 10 installer provides an intuitive interface, it helps to plan your answers to the questions asked by the installer. Use the following tables to help plan for installing the server configuration of ColdFusion 10.

Once you have determined the answers to the questions in the section Gathering information necessary to install the server configuration, you can install the ColdFusion server configuration in Windows or UNIX, as applicable.

By default, ColdFusion10 is your installation directory. The following table describes the directory structure:

ColdFusion provides in-built Tomcat application server that you can use to develop ColdFusion applications.

During the ColdFusion installation, choose a web server. If you select the built-in web server, your web root directory is located in the cfroot/wwwroot directory. By default, the web server runs on port 8500. It means that to display a page in your application, append:8500 to the host name or IP address in the URL; for example, http://localhost:8500/YourApp1/index.cfm. If the page does not appear, ensure that the document is located in the built-in web server’s web root directory; for example, C:\ColdFusion10\cfusion\wwwroot\YourApp1\index.cfm.

If you select an external web server during installation, the built-in web server is deactivated.

While installing, if you have configured ColdFusion on an external web server, do the following to configure ColdFusion on in-built Tomcat:

1. Open the cfroot\cfusion\runtime\conf\server.xml file.

2. Search for internal webserver start. Uncomment the following connector XML.

   <Connector executor="tomcatThreadPool" 
           port="8500" protocol="org.apache.coyote.http11.Http11NioProtocol" 
           connectionTimeout="20000" 
           redirectPort="8445"/>

3. Save the file, and then restart ColdFusion.

To edit the JVM settings, open the cfroot\cfusion\bin\jvm.config file and update the following details:

• java.home: Java home. If not set, ColdFusion verifies the default JRE in the cfroot\jre folder, in the registry, or in the JAVA_HOME environment variable.

• java.args: Settings for -Xmx, ColdFusion classpath, and so on.

• java.library.path: Settings for library path.

• java.class.path: Additional classpath settings in a comma-separated list.

• application.home: Default is cfroot\cfusion

After installing ColdFusion in stand-alone mode, create an instance of ColdFusion using the ColdFusion Administrator.

Register a new remote instance of ColdFusion using the ColdFusion Administrator.

1. In the ColdFusion Administrator, click Enterprise Manager > Instance Manager > Register Remote Instance.

2. Specify the details such as instance name, remote host, remote port, http port, and JVM route.

   Instance name is a string that is used to identify the instance. Remote port and HTTP port are displayed in the Instance Manager page. These ports are provided in the server.xml file available in the runtime\conf folder of the instance. Remote port is the AJP port and the instance port is the connector port.

   JVM route is the remote instance name. The JVM route is an attribute that acts as an identifier for a particular Tomcat worker. JVM route is provided in the server.xml file available in the runtime\conf folder of the instance. For more information on JVM route, see http://tomcat.apache.org/tomcat-5.5-doc/cluster-howto.html.

   Note: A remote instance and a local instance cannot have the same JVM route if they are added in a cluster with sticky session enabled.

3. If you want remote start and stop functionality over HTTP, enter Admin Component port, Admin Component user name, and Admin Component password. The default Admin Component port is 8985.

   Note: To enable this feature, install admin component on the remote host.

   1. In the remote host, open the ColdFusion_installtion\cfusion\jetty\etc\jetty.xml.

   2. Search for the string, org.mortbay.jetty.bio.SocketConnector.

   3. Update the host with the IP address of the remote host.

   4. Restart the jetty server.

4. Click Submit.

You can start and stop a remote instance over HTTPS or HTTP. To enable this feature, install admin component while installing ColdFusion. You can install Solr, admin component, or both while installing ColdFusion.

1. Do the following in the remote host.

   1. In the remote host, generate a private key in a keystore file. Provide the details at prompt.

      cfroot\jre\bin\keytool -genkeypair -alias certificatekey -keyalg RSA -validity 7 -keystore keystore.jks

   2. Export the certificate. You can have a self-signed certificate or a certificate from a Certificate Authority.

      cfroot\jre\bin\keytool -export -alias certificatekey -keystore keystore.jks -rfc -file selfsignedcert.cer

   3. Copy the jks file created in the jetty\etc directory.

   4. Open the jetty\etc\jetty.xml file.

   5. Search for the string, To add an HTTPS SSL Listener and add the following entry:

       <Call name="addConnector"> 
          <Arg> 
          <New class="org.mortbay.jetty.security.SslSocketConnector"> 
              <Set name="Port">8443</Set> 
              <Set name="maxIdleTime">30000</Set> 
              <Set name="keystore"><SystemProperty name="jetty.home" default="." />/etc/jks-file.jks</Set> 
              <Set name="password">changeit</Set> 
              <Set name="keyPassword">changeit</Set> 
              <Set name="truststore"><SystemProperty name="jetty.home" default="." />/etc/jks-file.jks</Set> 
              <Set name="trustPassword">changeit</Set> 
          </New> 
          </Arg> 
      </Call> 

   6. Update the keystore name, password, key password, and jks file in the entry.

   7. Search for the string org.mortbay.jetty.bio.SocketConnector.

   8. Update the host with the IP address of the remote host.

   9. Restart the jetty server.

      Note: If the remote server is running on Windows Vista, Windows 7, or Windows Server 2008, start the jetty sever with admin privileges.

2. Do the following in the local host from where you add the remote instance:

   1. Copy the .cer file created in the remote host to any of the locations.

   2. Import the certificate.

      cfroot\jre\bin\keytool.exe -importcert -keystore "cfroot\jre\lib\security\cacerts" -file selfsignedcert.cer -storepass password

   3. Register the remote instance using the ColdFusion Administrator. For more information, see Registering a remote instance.

   4. In the Register Remote Instance page, enter the admin component port, admin component user name, and admin component password (user name and password. These details you specified while installing the Remote Instance Administrator). The default https port is 8443.

   5. Select the HTTPS check box.

   6. Click Submit.

You can set up start and stop remote instance functionality in Server Manager. To enable this feature, install Remote Instance Administrator while installing ColdFusion.

1. Do the following in the remote host.

   1. In the remote host, generate a private key in a keystore file. Provide the details at prompt.

      cfroot\jre\bin\keytool -genkeypair -alias certificatekey -keyalg RSA -validity 7 -keystore keystore.jks

   2. Export the certificate. You can have a self-signed certificate or a certificate from a Certificate Authority.

      cfroot\jre\bin\keytool -export -alias certificatekey -keystore keystore.jks -rfc -file selfsignedcert.cer

   3. Copy the .jks file created in the remote host to the jetty\etc directory.

   4. Open the jetty\etc\jetty.xml file.

   5. Search for the string, To add a HTTPS SSL Listener and then add the following entry:

       <Call name="addConnector"> 
          <Arg> 
          <New class="org.mortbay.jetty.security.SslSocketConnector"> 
              <Set name="Port">8443</Set> 
              <Set name="maxIdleTime">30000</Set> 
              <Set name="keystore"><SystemProperty name="jetty.home" default="." />/etc/server.jks</Set> 
              <Set name="password">changeit</Set> 
              <Set name="keyPassword">changeit</Set> 
              <Set name="truststore"><SystemProperty name="jetty.home" default="." />/etc/server.jks</Set> 
              <Set name="trustPassword">changeit</Set> 
          </New> 
          </Arg> 
      </Call>

   6. Update the keystore name, password, key password, and jks file in the entry.

   7. Search for the string, org.mortbay.jetty.bio.SocketConnector.

   8. Update the host with the port number of the remote host.

   9. Restart the jetty server.

      Note: If the remote server is running on Windows Vista, Windows 7, or Windows Server 2008, start the jetty sever with admin privileges.

2. Do the following in the local host from where you add remote instance:

   1. Copy the .cer file created in the remote host to any of the locations.

   2. Import the certificate.

      cfroot\jre\bin\keytool.exe -importcert -keystore "cfroot\jre\lib\security\cacerts" -file selfsignedcert.cer -storepass password

3. Open wwwroot\CFIDE\ServerManager\ServerManager.air on the local host.

4. Specify the connection details.

5. Click Start/Stop Details.

6. Select HTTPS.

7. Provide the following information:

   • App Server Username: User name for the admin component that you specified while installing ColdFusion. Default value is admin.

   • App Server Password: Password for the admin component.

   • Port: ColdFusion remote instance’s HTTPS port.

   • Server: ColdFusion remote instance name.

   • ColdFusion Version: For ColdFusion, 10.

   • Admin Server Port: Default https port is 8443. Port of the Jetty server.

   • Context Root: Value is AdminServlet.

8. Click Apply.

You can set up start and stop remote instance functionality in Server Manager. To enable this feature, install Remote Instance Administrator while installing ColdFusion.

1. Do the following in the remote host:

   1. In the remote host, open the ColdFusion_installtion\cfusion\jetty\etc\jetty.xml.

   2. Search for the string, org.mortbay.jetty.bio.SocketConnector.

   3. Update the host with the IP address of the remote host.

   4. Start the jetty server. Go to the ColdFusion_installation\cfusion\jetty directory and use jetty.exe. You can also use the jetty services in the Windows services.

2. Open wwwroot\CFIDE\ServerManager\ServerManager.air on the local host.

3. Specify the connection details.

4. Click Start / Stop Details.

5. Select HTTP.

6. Provide the following information:

   • App Server Username: User name for the admin component that you specified while installing ColdFusion. The default value is admin.

   • App Server Password: Password for the admin component.

   • Port: ColdFusion remote instance’s HTTP port.

   • Server: ColdFusion remote instance name.

   • ColdFusion Version: For ColdFusion Zeus, 10.

   • Admin Server Port: Default https port is 8985. Port of the Jetty server.

   • Context Root: Value is AdminServlet.

7. Click Apply.

Manage clusters using the ColdFusion Administrator.

1. In the ColdFusion Administrator, click Enterprise Manager > Cluster Manager.

2. Enter a cluster name and then click Add.

3. Click the cluster name and move the servers to the cluster based on the requirement.

4. (If necessary) Edit the multicast port.

   Multicast port is used to group the cluster members together. Default value of multicast port is 45564. After you create a cluster, the port is added in the cfroot\config\cluster.xml file.

   For more information on multicast port, see http://tomcat.apache.org/tomcat-7.0-doc/config/cluster-membership.html.

5. Specify if you need sticky session.

   Sticky session ensures that after a session is established on an instance, all future requests from the client are mapped to that instance.

6. Click Submit.

Use the Web Server Configuration Tool to configure other web servers.

 Run cfroot\runtime\bin\wsconfig.exe.

You can also configure web servers using the command-line interface as follows.

Configuring IIS

wsconfig.exe -ws iis -site <site_no> 

or

wsconfig.exe -ws iis -site <site_name>

Configuring cluster

wsconfig.exe -ws iis -site <site_no> -cluster <cluster-name>

Configuring Apache

(Windows only) wsconfig.exe –ws apache –dir <apache_conf_directory> 
(Linux or MAC only) ./wsconfig –ws apache –dir <apache_conf_directory>

or

(Windows only) wsconfig.exe –ws apache –dir <apache_conf_directory> –bin <apache_bin_directory>/httpd –script <apache_bin_directory>/apachectl 
(Linux or Mac only) ./wsconfig –ws apache –dir <apache_conf_directory> –bin <apache_bin_directory>/httpd –script <apache_bin_directory>/apachectl

Configuring cluster

(Windows only) wsconfig.exe -ws apache –dir <apache_conf_directory> -cluster <cluster-name> 
(Linux or MAC only) ./wsconfig -ws apache –dir <apache_conf_directory> -cluster <cluster-name>

Configuring Sun Java Web Server

(Windows only) wsconfig.exe –ws SunJWS –dir <SunJWS_conf_directory> 
(Linux or MAC only) ./wsconfig –ws SunJWS –dir <SunJWS_conf_directory>

Configuring cluster

(Windows only) wsconfig.exe -ws SunJWS –dir <SunJWS_conf_directory> -cluster <cluster-name> 
(Linux or MAC only) ./wsconfig -ws SunJWS –dir <SunJWS_conf_directory> -cluster <cluster-name>

Unconfiguring IIS

wsconfig.exe -remove -ws iis -site <site_no>

or

wsconfig.exe -remove iis -site <site_name>

Unconfiguring Apache

./wsconfig -remove –ws apache –dir <apache_conf_directory>

or

./wsconfig -remove –ws apache –dir <apache_conf_directory> –bin <apache_bin directory>/httpd –script <apache_bin_directory>/apachectl

Unconfiguring Sun Java Web Server

./wsconfig -remove –ws SunJWS –dir <SunJWS_conf_directory>

Unconfiguring all webservers

./wsconfig -uninstall

Seeing the list of webservers

./wsconfig -list

SSL allows the browser and the server to communicate over a secured connection. Data that is sent is encrypted at one side, transmitted, and then decrypted at the other end. For more information about SSL configuration on Tomcat, see http://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.html.

Do the following to change the virtual directory and doc root:

1. Open CFInstallation\cfusion\runtime\conf\server.xml.

2. Under host block, search for the string, “To add virtual directory.”

3. Uncomment the entry context path below.

4. To add a virtual directory, add the aliases attribute as shown below:

   <Context path="/" docBase="<absolute_path_to_cfrootectory>\wwwroot" WorkDir="<cf_home>\runtime\conf\Catalina\localhost\tmp" aliases="/path1=<absolute_path_to_directory1>,/path2=<absolute_path_to_directory2>"></Context>

   Note: Alias path must include a leading ‘/’.

5. To change the doc root, change the docBase value in the above entry.

   For more details on the Context attributes, see http://tomcat.apache.org/tomcat-6.0-doc/config/context.html.

You can use the connector output for logging cfstat metric. The cfconnector port is defined in the CFInstallation/cfusion/lib/neo-metric.xml file. If you have configured a connector, update the port with the connector port. The connector port (AJP port) is provided in the CFInstallation/cfusion/runtime/conf/server.xml.

To update the connector port using the Administrator console:

1. Login ColdFusion Administrator.

2. Click Debugging & Logging > Debug Output.

3. Update the connector port and click Submit Changes.

*New for ColdFusion 10*

ColdFusion allows you to secure ColdFusion server furthermore by enabling or disabling certain settings. When installing ColdFusion, you can enable Secure Profile by selecting the option when prompted on the Secure Profile screen. Further, you could provide a comma separate list of IP addresses that may be allowed to access the ColdFusion Administrator. For more information, see Enabling Secure Profile for ColdFusion Administrator.

You can change the log rotation settings such as maximum number of backup files and the size of the backup files.

To persist a session after a Tomcat restart, do the following:

1. Open the cfroot\cfusion\runtime\conf\context.xml file.

2. Uncomment the Manager pathname node.

If you have skipped the migration or you have to make modifications to the previous installation that has to be migrated, do the following:

Uninstalling ColdFusion deletes all program files and related components from your computer.