Cheshire 3

Introduction

These instructions will guide you through installing the base Cheshire software and the Cheshire for Archives software that has been specially developed for EAD. We recommend that archivists have technical support when undertaking this installation.

• It is important to note at this point that in order to install the latest version of Cheshire3 and Cheshire for Archives you need to already have installed Linux (Fedora 7 or later or Red Hat Enterprise). During this process you should have already created a 'cheshire' user.

• You will need to ask your IT Support for the outgoing email host name and port before you start this installation.

What do I do now?.

Installing From Scratch

To install the Cheshire3 software and Cheshire for Archives follow the instructions from sections A , B , C , D in that order.

If you want to reconfigure the names or graphics on your interface - follow instructions from section C .

Upgrading from Cheshire for Archives 3.3.x or earlier

If you are upgrading from Cheshire for Archives from any version earlier than v3.4.0, it is not possible to patch the base Cheshire3 install to the latest version. You will therefore need to install the latest version from scratch.

1. Please be aware that any changes you've made to the display of your spoke may be lost if you do not make a backup of your CSS files (this does not apply to changes made to the localStyles.css file.)
   If you have made changes to your style.css file you can back this up by using the cp command to copy style.css into the cheshire3 directory.

   cp /home/cheshire/cheshire3/cheshire3/www/ead/css/style.css /home/cheshire/cheshire3

   You will need to restore the backup of your style.css file once the installation has taken place, instructions about how to do this will be given in section C6.

   In addition, if you have made changes to other css files, it is advisable to seek the assistance from the person who implemented your css changes and backup these files now. Make a backup of all other css files as follows:

   cp /home/cheshire/cheshire3/cheshire3/www/ead/css/*.css /home/cheshire/cheshire3

2. You will need to remove some files on your server. Navigate to the appropriate folder:

   cd /home/cheshire/cheshire3

   Enter the following commands to remove the files (press 'enter' to execute each in turn):

   • rm *.tgz
   • rm *.sh
   • rm *.tmp
   • rm -rf build
   • rm -rf install

3. You can now carry out the installation procedure by following the instructions from the following sections in this order:

   • A : Installing Cheshire3
   • B : Installing Cheshire for Archives
   • C : Configuring your local interface
   • D : Building the Database

Upgrading from Cheshire for Archives 3.4.x

If you are updgrading from Cheshire 3.4.0 or later, you should update the base Cheshire3 install to the latest version. To do this you should carry out the following steps:

1. Open a terminal window (right click on the desktop and select 'terminal window' ). Change directory to /home/cheshire/cheshire3, using the command:

   cd /home/cheshire/cheshire3

   Ensure that you are logged in as user 'cheshire'. You can do this by typing the command whoami .

2. Download the file:
   http://www.cheshire3.org/download/latest/update.sh

   Save it in /home/cheshire/cheshire3 (right-click and save link/target as).

3. Go back to the terminal window and check that the file is in the directory using the ls command.
   HINT: If it is not here, it might be in the directory /home/cheshire/Download or /home/cheshire/Desktop. Find it and move it to this directory.

4. Make the update script executable, using the command:

   chmod u+x update.sh

   Run the update.sh script using the command:

   ./update.sh

   This will download, unpack and install the latest version of Cheshire3, without the pre-requisites which you installed previously. This makes this method much faster than installing the latest version from scratch.

5. please follow just the instructions from the following steps
• B 1-5
• C
• D
6. In addition you will also need to clear the cached HTML files via your admin interface before completing this upgrade.