Skip past navigation linksSecure Global Desktop 4.31 Administration Guide > Arrays, servers and load balancing > Backing up and restoring a Secure Global Desktop installation

Backing up and restoring a Secure Global Desktop installation

This topic describes how you:

How to make a full backup of a Secure Global Desktop installation

To be able to restore a Secure Global Desktop installation or to be able to repair some individual Secure Global Desktop 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 Secure Global Desktop server while making the backup. However, if this is not possible, do it when the server is least loaded.

To back up Secure Global Desktop:

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

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

How to restore a damaged Secure Global Desktop component

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

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.

HTML theme files

The HTML theme files control the appearance of the classic webtop.

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

The theme files are under the /opt/tarantella/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 /opt/tarantella/var/docroot/resources directory.

Expect scripts

The Expect scripts control the interaction between Secure Global Desktop 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:

The scripts are in the /opt/tarantella/var/serverresources/expect directory.

Server-specific configuration

Server-specific configuration covers all the properties for a Secure Global Desktop 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 Secure Global Desktop host, it must only be restored from a backup taken from that host.

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

If you are using Secure Global Desktop security services, you should restore the following directories and file:

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:

The array-wide configuration is in the /opt/tarantella/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 Secure Global Desktop server.

The enterprise database is in the /opt/tarantella/var/ens directory.

Automatic log archives

By default, Secure Global Desktop 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 /opt/tarantella/var/log/ directory.

Secure Global Desktop printing

When you install Secure Global Desktop, it configures a Secure Global Desktop print queue.

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

The print queue is in the /opt/tarantella/var/print directory.

The Secure Global Desktop Web Server, web services and the browser-based webtop

The configuration of the Secure Global Desktop Web Server, web services and the browser-based webtop is unique to a particular Secure Global Desktop host and must only be restored from a backup taken from that host.

The configuration for the Secure Global Desktop Web Server is in the /opt/tarantella/webserver/apache/apache_version directory. You may also have web server password and .htaccess files which may be stored in other locations.

The configuration for Secure Global Desktop web services is in the /opt/tarantella/webserver/tomcat/tomcat_version directory.

The files used for the browser-based webtop are in the /opt/tarantella/webserver/tomcat/tomcat_version/webapps/sgd directory.

How to do a full restore of your Secure Global Desktop installation

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

To do a full restore:

  1. Stop the Secure Global Desktop server (tarantella stop).
  2. Uninstall Secure Global Desktop by running the tarantella uninstall --purge command.

    Note If this fails, you may have to manually remove the Secure Global Desktop package. Use rpm -e tta on Linux platforms and pkgrm tta on Solaris Operating System platforms.

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

    Note Make sure the server names match.

  7. Restart the Secure Global Desktop server (tarantella start).
Related topics