CFX Installation – To download the CFX data files, click here:
http://muffin.ai.uic.edu:8080/CFX/setup_cfx.zip
Note: CFX has only been tested on a windows system. To install on a UNIX or Linux based system please note that the environment variables and paths to the CFX directory will be specific to your machine’s setup.
Step 1 – Install Java Standard Edition SDK
Go to the following link to download the latest version of the Java Software Development Kit for Windows.
http://java.sun.com/j2se/1.4.1/download.html
Follow the instructions at the following link to correctly install the Java SDK. Take careful note of the path variables setup.
http://java.sun.com/j2se/1.4.1/install-windows.html
Step 2 – Install Apache-Tomcat
Go to the following link to download the latest version of Tomcat (4.1.18 as of February 10th, 2003)
http://jakarta.apache.org/site/binindex.cgi
We recommend that you install tomcat in “C:\Tomcat 4.1” since configuration files are already set for this directory.
After you have downloaded and installed Tomcat you must set up the following environmental variables:
Note: For the rest of the install procedure we assume you install Tomcat into “C:\Tomcat 4.1”. You may change this if you wish.
New:
CATALINA_BASE=C:\Tomcat 4.1
CATALINA_HOME=C:\Tomcat 4.1
CATALINA_TMP=C:\Tomcat 4.1\temp
CLASSPATH=C:\Tomcat 4.1\common\lib\servlet.jar;C:\Tomcat 4.1\webapps\CFX\WEB-INF\classes
Edit: Add to the end of the following variables:
C:\Tomcat 4.1\server\lib;C:\Tomcat 4.1\common\lib
If JAVA_HOME is not set from the JavaSDK setup, set it now:
JAVA_HOME=C:\j2sdk
Note: change j2sdk to the directory for which you installed the JavaSDK
Step 3 – Install MySql
MySql is required for the CFX database.
Go to http://www.mysql.com and download and install the latest version of MySql.
Refer to the following link for installation instructions:
http://www.mysql.com/doc/en/Installing.html
Step 4 – Unpacking the CFX data
a) After steps 1-3 have been completed, you are now ready to install CFX onto the tomcat server. Take the downloaded CFX.zip and unzip the contents into: C:\Tomcat 4.1\webapps
b)
Edit server.xml in C:\Tomcat 4.1\conf
Add the following lines…
<Context path="" docBase="webapps" debug="0"
/>
<Context path="/CFX" docBase="CFX" debug="0"
reloadable="true" crossContext="true">
<Realm className="org.apache.catalina.realm.MemoryRealm" pathname="webapps/CFX/WEB-INF/CFXUsers.xml"
/>
</Context>
… just before
</Host>
</Engine>
</Service>
c)
To use a web port other than the default Tomcat port of 8080, change
the port value in the following attribute in server.xml:
<Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
port=8080 … />
For the rest of the installation we will assume that this port is left unchanged.
d) Save and close server.xml
Step 5 – Install CFX
a) After you have correctly set up the Environment variables, server.xml, and web.xml files, you are now ready for the final step.
b)
Go to http://localhost:8080/CFX/CFXInstall.html
Note: if no page shows up, make sure you have followed the directions correctly
in steps 1-4
c)
Set the values for the appropriate fields and press Submit
This will call a script that will set up the CFX database on the MySql server
and also create a personal web.xml file according to the information provided
in /CFX/WEB-INF (You can change these values later by editing /CFX/WEB-INF/web.xml)
Administrative users can be changed after installation by editing /CFX/WEB-INF/CFXUsers.xml
d) In the first line of /CFXdata/mainui.js, change the thisPage variable to the correct web url of MainUI.jsp.
e)
Any errors after submit will have to be noted. Most likely an error
in steps 1-4 is to blame.
Step 6 – Finished!
After you have completed step 5 you are now completed with the CFX installation.
Please note the following links to the CFX areas:
Add Examples page:
http://localhost:8080/CFX/AddExamples.jsp
Main User Interface:
http://localhost:8080/CFX/MainUI.jsp
Administration Area:
http://localhost:8080/CFX/admin/EditTree.htm
Netscape-compatible User Interface