Yosemite Server Backup

Installation Guide

Part number:
First edition: October, 2010
Legal and notice information
© Copyright 2004, 2012 Barracuda Networks, Inc.
Under copyright laws, the contents of this document may not be copied, photocopied, reproduced, translated or reduced to any electronic
medium or machine-readable form, in whole or in part, without prior written consent of Barracuda Networks, Inc..
Notice
Information in this document is subject to change without notice. Barracuda Networks, Inc. makes no representations or warranties with
respect to the contents of this document and specifically disclaims any implied warranties of merchantability or fitness for any particular
purpose. Further, Barracuda Networks, Inc. reserves the right to revise this publication and to make changes without obligation to notify any
person or organization of such revisions or changes.

Trademarks
Yosemite Server Backup is a trademark of Barracuda Networks, Inc..
Windows™ and Windows NT™ are registered trademarks of Microsoft Corporation.
Contents

Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1 Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . 7
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Before You Install Yosemite Server Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Installing Yosemite Server Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Upgrading Yosemite Server Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2 Installing Yosemite Server Backup . . . . . . . . . . . . . . . . . . . 9

Launching the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
On Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
On Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Using the Yosemite Server Backup Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Upgrading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Removing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3 Post Installation Settings . . . . . . . . . . . . . . . . . . . . . . . 11

Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4 Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Linux Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Installation Guide 3
Before you begin

Customer Support
Phone and Email Technical Support offered 24 x 7. Basic Support includes email and live chat support 24x7
and phone support between the hours of 9am and 5pm Monday through Friday in the USA (Pacific time zone).
Enhanced Support provides 24x7 phone support. You can get customer support for Yosemite Server Backup
in one of the following ways:
• Visit our website at http://www.barracudaware.com
• Phone us at +1 408 342 5300.
• Email us at support@barracuda.com.

Release Notes
Release notes are included with every release and service pack. Before using Yosemite Server Backup, please
read the release notes for additional information. The release notes are available in HTML format in the root
directory of the Yosemite Server Backup CD-ROM.

Document Conventions and Symbols

Convention Element
Blue text: Document Conventions and Symbols Cross-reference links and e-mail addresses
Blue, underlined text: http://www.website.com Website addresses

• Keys that are pressed

• Text typed into a GUI element, such as a box
Bold text
• GUI elements that are clicked or selected, such as menu
and list items, buttons, tabs, and check boxes

Italic text Text emphasis

• File and directory names

• System output
Monospace text
• Code
• Commands, their arguments, and argument values

• Code variables
Monospace, italic text
• Command variables

WARNING!
Indicates that failure to follow directions could result in data loss.

4 Before you begin

CAUTION:
Indicates that failure to follow directions could result in damage to equipment or data.

IMPORTANT:
Provides clarifying information or specific instructions.

NOTE:
Provides additional information.

TIP:
Provides helpful hints and shortcuts.

Installation Guide 5
6 Before you begin
1 Installation Overview
In this chapter
• System Requirements
• Supported platforms
• Before You Install Yosemite Server Backup
• Installing Yosemite Server Backup
• Upgrading Yosemite Server Backup

System Requirements
Most operating systems list both minimum and recommended system requirements. As a general rule, if your
system meets the minimum requirements for the operating system, it will also meet the minimum system
requirements for Yosemite Server Backup.
Depending on your specific requirements, your system should also meet the following:
• The Yosemite Server Backup Catalog requires additional space. When you install Yosemite Server
Backup on the machine that will serve as the Domain Server, Barracuda Networks, Inc. recommends
that you select a hard drive other than the default drive. A disk drive with at least an additional 20
GB is recommended.
• VGA display with 1024x768 resolution, for use with Windows or an X Window System
• CD drive for Yosemite Server Backup installation (recommended)
• CD or DVD writer for use with the Yosemite Server Backup Bare Metal Disaster Recovery
(recommended)
• Bootable tape backup device for use with Yosemite Server Backup Bare Metal Disaster Recovery
(optional)

Supported platforms
Yosemite Server Backup is supported and has been tested with many different versions of Windows and Linux
operating systems. For a current list of supported platforms, visit http://www.barracudaware.com.

NOTE:
We always recommend that you install the latest service packs and updates for your operating system.

Before You Install Yosemite Server Backup

Even though Yosemite Server Backup is easy to install, you must first make some important decisions about
how to implement Yosemite Server Backup. Before you install Yosemite Server Backup, you should consider
the following subjects.

Yosemite Server Backup Backup Domain

When you install Yosemite Server Backup, you will define a Yosemite Server Backup Backup Domain. Each
Backup Domain includes one Domain Server — a computer that contains the Yosemite Server Backup catalog.
Each Yosemite Server Backup Domain Server may also include other computers, including Media Servers
and clients.

Installation Guide 7
 On a very small Backup Domain, all three components (Domain Server, Media Server, and client) can be on
the same machine.
Since Yosemite Server Backup is scalable, you can easily upgrade your license whenever you need to expand the
Yosemite Server Backup Backup Domain.
To define the Backup Domain, identify:
• The computer that will be the Domain Server.
• The Media Servers that will belong to the Domain Server.
• The clients that will belong to the Backup Domain.

Yosemite Server Backup Service

The Yosemite Server Backup service lets you run scheduled jobs automatically, whether or not an operator is
present. The Yosemite Server Backup service is called a service on Windows and a daemon on Linux systems.
When installed, the Yosemite Server Backup service automatically loads at system startup. It runs in the
background without a user interface. At any time, you can start the Yosemite Server Backup user interface.
Later, when you close the Yosemite Server Backup user interface, the Yosemite Server Backup service continues
to run in the background.
If the system loses power, the Yosemite Server Backup service automatically restarts following system restart.
Therefore, your backup jobs still run as scheduled.
You must install Yosemite Server Backup on each computer that will be included in an automatic backup
schedule.

Installing Yosemite Server Backup

1. Install all of your backup devices according to the manufacturer’s directions
2. Install Yosemite Server Backup on the Domain Server machine.
3. Install Yosemite Server Backup on the remaining Media Servers and clients in the Backup Domain. Supply
the hostname or IP address of the Domain Server when installing the clients.

Upgrading Yosemite Server Backup

1. Upgrade Yosemite Server Backup on the Domain Server.
2. Each client in the Backup Domain will upgrade itself automatically.

NOTE:
There is a Backup Domain configuration setting to disable automatic updates that is on by default. If you
turn this option off you will need to manually update each client. Clients running older versions of Yosemite
Server Backup will not operate with a Domain Server running a newer version.

8 Installation Overview
2 Installing Yosemite Server
Backup
In this chapter
• Launching the Installer
• Using the Yosemite Server Backup Installer

Launching the Installer

On Windows
You must have Administrator access to install Yosemite Server Backup.
1. Insert the Yosemite Server Backup CD-ROM in your CD drive. The Yosemite Server Backup Installer
launches automatically.
2. If it does not launch automatically, access the root directory on the Yosemite Server Backup CD-ROM
and double-click setup.exe.

On Linux
You must install Yosemite Server Backup as the root user.
1. Insert the Yosemite Server Backup CD-ROM.
2. If auto-mount is not enabled on your system, you must mount the CD-ROM yourself. Refer to the following
example for some Linux systems:
a. Access a terminal window.
b. Type
mount /dev/cdrom /mnt/cdrom
and press Enter.
c. Wait a moment for Linux to mount the CD-ROM.
3. Access the root directory on the CD-ROM. For example, on some Linux systems, type
cd /mnt/cdrom
and press Enter to access the root directory on the installation CD-ROM.

NOTE:
If Yosemite Server Backup is running, you must close it before continuing.

4. To run the installation program, type

./install
as the root user and press Enter.

Using the Yosemite Server Backup Installer

Installing
To install Yosemite Server Backup:

Installation Guide 9
 1. Launch the installer.
2. Select a language.
3. Read and accept the End User Licence Agreement.
4. Decide whether this machine will be the Domain Server or a client of the Backup Domain and select
the appropriate radio button.
If this is the Backup Domain, click the Next button.
If this is a client, enter the hostname or IP address of the Domain Server already installed and click the
Next button.
Optionally, you may change location of the install folder prior to leaving the page.
5. Installation will proceed. Progress is reported on the screen. On the Domain Server, once installation is
complete the Administrator will launch automatically. You may see a flashing red Alert button in the
bottom right corner of the Administrator. If you do, see Licenses to install a license key. Or you an continue
to use the product in evaluation mode.

Upgrading

NOTE:
You do not have to uninstall Yosemite Server Backup before upgrading to a newer version. However, the
previous version of Yosemite Server Backup and the previous catalog will be updated to the new format,
and will no longer be available in the old format.
To upgrade Yosemite Server Backup:

1. Launch the installer.

2. Select Upgrade Yosemite Server Backup.
3. Read and accept the End User License Agreement.
4. Installation will proceed. Progress is reported on the screen. Once complete the Administrator will
launch automatically.

Removing
To remove Yosemite Server Backup:
1. Launch the Yosemite Server Backup installer.
2. Select Remove Yosemite Server Backup.
3. If you want to retain your catalog or your data backed up to disk, deselect the appropriate checkboxes before
clicking the Next button. If you leave these items intact they can be reused in a different installation.
4. Confirm that you want to remove Yosemite Server Backup.
5. Yosemite Server Backup will be removed from your system. Any files that cannot be removed during the
uninstall process will be removed during the next reboot. You do not need to reboot immediately.

10 Installing Yosemite Server Backup

3 Post Installation Settings
In this chapter
• Passwords
• Licenses
After you install Yosemite Server Backup, you can restrict access to it by setting a password or obtain access
to additional options by adding licenses.

Passwords
When you start Yosemite Server Backup, it has no password for the Admin user, which has access to all data
inside the Yosemite Server Backup Backup Domain.
To set a password for the Admin user
1. Start the Administrator.
2. Select File —> > Domain Configuration menu item.
3. Click the Domain Security link in the Navigation bar.
4. Select the Enable advanced domain security option and click OK.
5. Expand the Advanced link in the Navigation bar in the top left corner of the screen and click the Security
link.
6. Select the Admin icon in the main part of the screen and click the Change Password command in
the command toolbar.
7. Leave the old password blank and enter a new password. Click OK.

Licenses
When you purchase Yosemite Server Backup, you purchase one base license for each Yosemite Server Backup
Backup Domain. The base license includes the Yosemite Server Backup catalog and one or more client or server
machines, depending on the type of license. You can also purchase licenses for additional clients.
Yosemite Server Backup uses a system of key codes that represent your licenses to use all Yosemite Server
Backup features as well as its options. When you purchase and install Yosemite Server Backup key codes, you
can use Yosemite Server Backup and all licensed options with no expiration date. When you install Yosemite
Server Backup as an evaluation, all optional features are installed that are supported by the base license. You
can use these features during a 60-day evaluation period. To continue using these features after the evaluation
period has expired, you must purchase a license for them. When you enter a license key code, the applicable
features or options are changed from evaluation to permanent licenses.
For reference, each license key has a type and serial number, which is assigned to your order.
You can see all attributes of a license key in the License window.

To enter a new key code

1. Start Yosemite Server Backup Administrator.
2. Click on the Licenses icon in the main screen or select the Licenses command from the Help menu.
3. Select the command New to add a new license.
4. Enter the key code for the license and click OK.

Installation Guide 11
 A new license object is created, which is listed as a new item in the License window.
5. To see a summary of all installed licenses deselect any licenses and select the Status command to open the
Properties of Licenses window.

12 Post Installation Settings

4 Installation Notes

Linux Installation Notes

SCSI generic module required for device support
If you are running Yosemite Server Backup under Linux, you must install the sg (SCSI generic) module for
device support in Yosemite Server Backup.
To verify that this module is loaded and running, issue the following command at a terminal prompt:

lsmod

sg should be listed in the list of running modules. If it is not listed, you must manually load this module so that
Yosemite Server Backup can communicate with tape devices. Consult your operating system documentation
for instructions on manually loading the sg module.

Red Hat Enterprise Linux EXT3 hardware issue

If you are running Yosemite Server Backup on Red Hat Enterprise Linux (RHEL) v3 or v4, a known hardware
issue exists when you use the EXT3 journal or file system on certain hardware configurations. Update your Red
Hat Enterprise Linux v3 or v4 installation to the latest kernel and jbd patches listed below to resolve this issue:
• jbd-1.1-multiarch-1
• kernel-2.6.9-11.EL (RHEL 4)
• kernel-2.4.21-37.EL (RHEL 3)

IDE/ATAPI Support
Yosemite Server Backup supports the use of IDE/ATAPI tape devices. If your Linux distribution compiled the
ide-tape.o module into the kernel, update the configuration file and verify the configuration to access these
devices.

NOTE:
When Yosemite Server Backup runs, it loads the ide-scsi module. This may cause the ide-cdrom module
to fail to load, which may affect CD operation. To work around this problem, mount the CD as a SCSI
device, even though it is an IDE device.

To update the configuration file and verify the configuration (LILO)

1. Add the following line to the end of each boot selection section in the /etc/lilo.conf file:

Installation Guide 13
 Master on primary IDE append="hda=ide-scsi"

Slave on primary IDE append="hdb=ide-scsi"

Master on secondary IDE append="hdc=ide-scsi"

Slave on secondary IDE append="hdd=ide-scsi"

2. Update your system configuration, using the following command:

lilo

3. Save the file and reboot your system.

4. Verify that the change has been implemented, using the following command:

cat /proc/cmdline

5. If hda=ide-scsi (or similar) does not appear, you did not update the configuration file correctly. Start
over with Step 1 above.
6. Verify that your system detects the tape device, using the following command:

cat /proc/scsi/scsi

To update the configuration file and verify the configuration (GRUB)

1. Locate the grub.conf file. This file may also be called menu.lst. Possible locations include
/boot/grub and /etc.
2. Add the appropriate text from the following to the end of each kernel image line in the grub.conf file:

Master on primary IDE hda=ide-scsi

Slave on primary IDE hdb=ide-scsi

Master on secondary IDE hdc=ide-scsi

Slave on secondary IDE hdd=ide-scsi

Each kernel image line will read similar to the following:

kernel /vmlinuz-2.2.6-2 ro root=/dev/hda3 hda=ide-scsi

3. Save the file and reboot your system.

4. Verify that the change has been implemented, using the following command:

14 Installation Notes
 cat /proc/cmdline

5. If hda=ide-scsi (or similar) does not appear, you did not update the configuration file correctly. Start
over with step 1 above.
6. Verify that your system detects the tape device, using the following command:

cat /proc/scsi/scsi

Libraries missing from Linux distribution

Problem:
I cannot launch the X Window System version of Yosemite Server Backup. It gives me the following message:
error while loading shared libraries libstdc++.so.5
Cause: Either the libstdc++ library is missing from your version of Linux distribution or the wrong version of
the library is installed.
Solution: Install the missing library.
1. Identify the required version of the library:
a. Navigate to the Yosemite Server Backup directory in a terminal window. The default directory is
/usr/local/barracuda/yosemiteserverbackup.
b. Type lld ytadmin.bin from the command prompt and press Enter. A list of libraries required
for Yosemite Server Backup appears.
The name of the missing libstdc++ library will be similar to libstdc++.so.5.
2. Contact your Linux distributor for the missing library.

NOTE:
If you are using RedHat Linux EL 4, you can use an RPM package called "compat-libstdc++.rpm"
to install the necessary library.

3. Install the library according to the documentation provided by your distributor.

4. Try to launch the X Window System version of Yosemite Server Backup. It should work properly.

Installation Guide 15
16 Installation Notes
Index

C P
conventions password, setting, 11
document, 4
text symbols, 4
Customer support, 4 R
Red Hat Enterprise Linux
EXT3 journal or filesystem, 13
D Removal instructions
document GUI Installer, 10
conventions, 4

S
G Service, Windows, 8
GUI Installer setting, password, 11
installation procedure, 9 sg Module, 13
uninstall procedure, 10 symbols in text, 4
upgrade procedure, 10

T
I text symbols, 4
IDE/ATAPI support Troubleshooting
Linux, 13 libraries missing from Linux distribution, 15
Installation
and catalogs, 7
as a Windows service, 8 U
copy installer to disk, 9 Update License, 11
installing catalog server first, 8 Upgrade Procedure
Installation instructions GUI Installer, 10
GUI Installer, 9 overview, 8

L Y
Linux Yosemite Server Backup Backup Domain
EXT3 journal or filesystem, 13 installation, 7
copy installer to disk, 9
device support, 13
IDE/ATAPI support , 13
libraries missing from Linux distribution, 15

Installation Guide 17