Linux/Unix Installation
The following provides complete instructions on installing Cascade Server on a Linux/Solaris/Mac OS X computer. All necessary components are either included in this installation or supplied as links to free downloads. First, Java 1.5 must be installed and configured onto the system. Second, the Cascade Server package needs to be unzipped and configured. Third, a MySQL 4.1/5.0 database needs to be set up which Cascade Server will have access. After these steps, a simple shell script will start up the system. Should you have questions at any time please call us at (678) 904-6900. If you are upgrading, see our upgrade section.
Java Installation
First, install or upgrade to the Sun Java 1.5 JRE (if you are on Mac OS X, please upgrade your existing JRE). Please follow the installation instructions available from Sun here: http://java.sun.com/j2se/1.5.0/install-linux.html#install.
Next, the JAVA_HOME system environment variable needs to be configured. This environment variable needs to be set for the user that Cascade Server will run under.
To set the appropriate environment variables, first ensure you are logged in as the user Cascade Server will run under. Next, edit the appropriate "rc" file (.bashrc or .cshrc, for example) to set the following information in the user's environment:
JAVA_HOME=/usr/java/j2sdk1.5
PATH="$PATH:$JAVA_HOME/bin"
export JAVA_HOME PATH
Now if you type:
source .bashrc
echo $JAVA_HOME
you should see the directory that was set for the JAVA_HOME variable
Unpack Cascade Server
Unzip cascade_full.zip in the directory you wish to install the program (please use the 'unzip' command line tool and not the 'gzip' tool).
Note: We recommend that you do this in /usr/java which will create the directory /usr/java/cascade.
MySQL 4.1/5.0 Installation And Configuration
Download the appropriate MySQL 4.1/5.0 installation files from http://dev.mysql.com/downloads/mysql/4.1.html
and install the software (if it is not already installed on the machine).
Please open your MySQL my.cnf file and add the following under your [mysqld] section:
set-variable=max_allowed_packet=16M
set-variable=key_buffer=16M
Please restart your MySQL server for these changes to take (these allow files up to 16 megabytes in size).
Now we need to create a new database and load the Cascade Server tables into the database. At the command prompt type:
mysqladmin -u root -p create cascade
Please enter the following commands:
mysql -u root -p
ALTER DATABASE `cascade` DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;
exit
mysql --default-character-set=utf8 -u root cascade < %Cascade Server%/vendor/db/mysql/cascade.sql
Where %Cascade Server% is the directory Cascade Server was installed.
The database and all necessary tables are now created.
If you prefer not to use root in this case, you may create a new user and grant them privileges on the Cascade database.
We need to setup the Cascade Server connection to the MySQL database by editing the file cascade/server/default/deploy/mysql-ds.xml file. Using a text editor set up the connection-url field to point to the database with the form "jdbc:MySQL://MACHINE_IP_ADDRESS:3306/cascade". Also in mysql-ds.xml, set the user-name and password fields to those created in the previous step.
Start Cascade Server
Please change directories into the Cascade Server bin folder "%Cascade Server%/cascade/bin". Once in the /bin folder, please execute the run.sh shell script. If the script isn't executable, or you aren't able to run it, please do the following:
sudo chmod u+x ./run.sh
sudo ./run.sh &
Please make sure to add the ampersand '&' to run in the background, if necessary.
To run Cascade Server, first start the script which will cause information to appear on the console. Next, open your web browser and go to the url "http://MACHINE_IP_ADDRESS:8080/admin/index". This will take you to the log in page. The default username and password to login:
username: admin
password: admin
That's it! You're ready to go. Please contact us at (678) 904-6900 if you have any questions. We recommend editing your rc.local or rc.common file to have Cascade Server booted up upon restart of the machine.
Upgrading Cascade Server
To upgrade Cascade Server, please do the following:
NOTE: The upgrade script requires that curl be installed on the machine.
- Download the latest upgrade script.
- Stop Cascade Server by issuing:
./shutdown.sh -S - Verify that the upgrade.sh file is set to be executable
- Execute the upgrade script by issuing:
./upgrade.sh - Follow the prompts to ensure the correct download
- Once the upgrade has finished, start Cascade Server:
./run.sh &
Let us know if you have any questions.