Tarantella Administration Guide > Arrays, servers and load balancing > Backing up and restoring a Tarantella installation

Backing up and restoring a Tarantella installation

This topic describes how you:

• make a full backup of a Tarantella installation;
• restore a damaged Tarantella component; and
• do a full restore of a Tarantella installation.

How to make a full backup of a Tarantella installation

To be able to restore a Tarantella installation or to be able to repair some individual Tarantella components, you will need a full backup.

While making the backup, do not run any command-line tools or use Object Manager or Array Manager. It is also best if you shut down the Tarantella server while making the backup. However, if this is not possible, do it when the server is least loaded.

To back up Tarantella:

1. Run the tarantella archive command.
2. Backup the entire Tarantella installation directory on each member of the array.

Tarantella also uses the following configuration files which only need to be backed up if you are using them and you have modified them:

• /etc/ttaprinter.conf - this contains the lpr defaults.
• /etc/sdace.txt and /var/ace/data - these contain RSA SecurID^® settings.
• web server password and .htaccess files if you have created these files for use with the Tarantella Web Server and they are stored outside the Tarantella installation directory.

How to restore a damaged Tarantella component

For the purposes of restoring a damaged installation, Tarantella can be divided up into the following components:

• Binaries, scripts and template files;
• HTML theme files;
• Expect scripts;
• Server-specific configuration;
• Array-wide configuration;
• The enterprise (ENS) database;
• Automatic log archives;
• Tarantella printing; and
• the Tarantella Web Server and Tarantella web services.

Binaries, scripts and template files

The binaries, scripts and template files are only modified as part of an installation, patch or custom engineering work. These do not change very often.

You can restore these files from a backup or another installation.

• The binaries are in the following directories:
  • install_dir/bin/bin
  • install_dir/var/docroot/java
  • install_dir/var/docroot/mac
  • install_dir/var/docroot/native
• The scripts are in the install_dir/bin/scripts directory.
• The template files are in the install_dir/etc/templates directory.

HTML theme files

The HTML theme files control the appearance of the webtop.

How you recover these files depends on whether or not you are using customized themes. If you:

• are not using customized themes, you can restore these files from another installation, a backup, or from the install_dir/etc/templates directory.
• are using customized themes, you must only restore these files from a backup.

The theme files are under the install_dir/var/docroot/resources directory.

Note The locale-specific template theme files are in directories with names of the form locale_0x3d_locale/. These correspond to the locale=locale/ directories in the install_dir/var/docroot/resources directory.

Expect scripts

The Expect scripts control the interaction between Tarantella and the application servers (for example, by logging a user in).

How you recover these scripts depends on whether or not you are using customized scripts. If you:

• are not using customized scripts, you can restore these files from another installation, a backup, or from the install_dir/etc/templates directory.
• are using customized scripts, you must only restore these files from a backup.

The scripts are in the install_dir/var/serverresources/expect directory.

Server-specific configuration

Server-specific configuration covers all the properties for a Tarantella server that are not shared with the other members of the array, such as the server DNS name and server tuning.

As this configuration is unique to a particular Tarantella host, it must only be restored from a backup taken from that host.

The server-specific configuration is in the install_dir/var/serverconfig/local directory.

If you are using the Tarantella Security Pack, you can restore the .x509 certificates for the server from a back-up of the server's install_dir/var/tsp directory.

Array-wide configuration

Array-wide configuration covers all the properties that are the same for all the array members, for example the names of the other array members.

To restore global configuration for:

• a primary Tarantella server, you must only restore from a backup of the primary.
• a secondary Tarantella server, we recommend you restore from the primary.

The array-wide configuration is in the install_dir/var/serverconfig/global directory.

The enterprise (ENS) database

The enterprise (ENS) database is shared across the array and contains all the webtop, application and user information. This information changes very regularly.

We recommend you restore the enterprise database from the backup of the primary Tarantella server.

The enterprise database is in the install_dir/var/ens directory.

Automatic log archives

By default, Tarantella archives its log files each week at 4am on Sunday using a cron job.

If the root user's crontab becomes corrupt or the archiving does not take place, use tarantella setup to restore the default setting, or change the time and day that the archiving takes place.

The log files are archived under the install_dir/var/log/ directory.

Tarantella printing

When you install Tarantella, it configures a Tarantella print queue.

If the print queue is not present, you can restore it:

• by manually running the print install script (prtinstall.en.sh); or
• by running the tarantella setup command.

The print queue is in the install_dir/var/print directory.

The Tarantella Web Server and Tarantella web services

If you are using the Tarantella Web Server or Tarantella web services, its configuration is unique to a particular Tarantella host and must only be restored from a backup taken from that host.

The configuration for the Tarantella Web Server is in the install_dir/webserver/apache/1.3.27 directory. You may also have web server password and .htaccess files which may be stored in other locations.

The configuration for Tarantella web services is in the install_dir/webserver/tomcat/4.1.18 directory.

How to do a full restore of your Tarantella installation

If you are unable to restore a damaged Tarantella component or you are unsure about the extent of the damage to your system, you must do a full restore of your Tarantella installation. To do a full restore, you must have a full backup.

To do a full restore:

1. Stop the Tarantella server (tarantella stop).
2. Manually remove the Tarantella packages by running pkgrm tta.

   Note You can check for Tarantella packages by running pkginfo| grep tta.

3. Delete the Tarantella installation directory by running rm -rf install_dir
4. Re-install Tarantella and any patches (if applicable). This will install the printer, rc scripts and set-up package database.
5. Stop the Tarantella server (tarantella stop).
6. Delete the Tarantella installation directory by running rm -rf install_dir and reinstate Tarantella from backup.

   Note Make sure server names match.

7. Restart the Tarantella server (tarantella start).