Terra Cotta Download

here -- terracotta.tar.gz

1. To install, run gunzip terracotta.tar.gz on the zipped version, then move to the root directory of where you want to install the software. The software will create no files in this directory, it expands into sub-directories.

2. Run tar xvf terracotta.tar to untar the file. This will create some subdirectories, including a "tc/nucleus" directory.

3. Important! Make sure that .mdl files are protected from anonymous download on your server. There is an htaccess.dist that will do this, as well as set the prepend directive for you. You'll have to edit it to point to the local.mdl file correctly, though. You can either use it in your httpd.conf or as a .htaccess file.

4. Edit the local.mdl file to substitute in your local information. This includes, at the bottom, possibly changing the code that includes the dbabstract, util, and session modules.

5. Run the install.sql SQL commands to create the data model. Note that you will need to have a database created within which to run this script. This can typically be accomplished by doing something like this...

   1. Run mysql client and create the database. (create database databasename;)
   2. Edit install.sql and put use databasename; in as the first line. This will make the script go into the right tablespace.
   3. Run mysql -u username -p < install.sql. This will complete the install.

6. In the util/ sub-directory you will find a script called adjustcore.pl. This will adjust your COREREQUIRE data if need be--if you can't use a prepend, then edit the 'corerequire' line in the local.mdl file to point to the local.mdl file itself. Then either run the adjustcore.pl file, or the corech.php3 file in the util directory. This will edit all the files in the distribution to correctly perform the REQUIRE statement to include the core Terra Cotta modules. If you are using the prepend, this won't be necessary. There is also a file called corech.php3. This is a PHP script that does the same thing as adjustcore.pl. It can be run with the web server. It needs some editing to make it work: you need to change the COREREQUIRE line to include local.mdl wherever it is, and also you'll have to change manually the line that includes the filetool.mdl module. You'll likely have to comment out the checkperm() call, as well. (Remember to enable it again when you're done!)

7. Unless you edited the install.sql script, your root password is 'password'. This needs to be changed. You can go to the admin page (the "tc/admin" subdirectory of where you installed the software) and use the User Manager to edit the root account and change the password.

8. The system is ready to go!