LINUX DS-Billing

Installation Guide

Disclaimer
Information in this document is subject to change without notice and does not represent a
commitment on the part of ASIGRA Inc.
ASIGRA Inc. makes no representation or warranty, express, implied, or statutory, with respect to,
and assumes no responsibility for the accuracy, completeness, sufficiency or usefulness of the
information contained herein.
This document may contain sample screen shots, used to demonstrate Asigra Cloud Backup
procedures. All information appearing in this document is used for illustration purposes only, and it
should be considered fictitious.

Copyright
The software described in this document is furnished under a license agreement. It is against the
law to copy the software on any medium except as specifically allowed in the license agreement.
Asigra, the Asigra logo, Asigra Cloud Backup, Recovery is Everything, and Recovery License
Model are trademarks of Asigra Inc. All other brand and product names are, or may be
trademarks of their respective owners.

Document Prepared by:

Asigra Inc.
All rights reserved. Confidential.

1120 Finch Avenue West, Suite 400

Toronto, Ontario, CANADA M3J 3H7

info@asigra.com

www.asigra.com

LINUX DS-Billing Installation Guide

v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

Generated on: 1/22/15

Page: 2
Confidential.

Before you install DS-Billing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

I) Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
II) Hardware & Software Minimum Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Run The DS-Billing Installation Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
DS-Billing Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
DS-Billing GUI Only Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Before Installing DS-Billing GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Install DS-Billing GUI only (for remote management). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DS-Billing GUI Upgrade (Upgrading an existing installation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7
7
7
7

Run The DS-Billing Installation Program (Console mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Configure Linux DS-Billing with an external PostgreSQL database . . . . . . . . . . . . . . . . . . . . . . 10
Connecting to an embedded PostgreSQL database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

LINUX DS-Billing Installation Guide

v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

Generated on: 1/22/15

Page: 3
Confidential.

Before you install DS-Billing

This document contains installation instructions for LINUX DS-Billing. Before installing or
upgrading DS-Billing, make sure that:
The DS-Billing computer meets the minimum hardware and software
requirements.
The time on the target DS-Billing computer is correct.
You have logged in as the target DS-Billing computers root user.
Verify the installation computer meets the following requirements:

I) Supported Platforms
For the official list of this products supported Operating Systems and versions, refer to the
Installation and Support Matrix. This can be found on the Installation DVD in the following path:
\Documentation\Release_Information
Platform

Version

Operating System
x64 (64-bit)

RedHat Enterprise Linux 6.5 - ES/AS (x64)

SUSE Linux Enterprise Server 11 SP3 (x64)

II) Hardware & Software Minimum Requirements

You should use the best hardware possible to maximize Asigra Cloud Backup performance. If
applicable, it is strongly recommended that you use the fastest brand-name components available.
Hardware

x64 (64-bit) Architecture

2 CPU (Dual)

3 GHz or greater

RAM

2 GB RAM or more

System disk (for OS and SQL).

Minimum 18GB

Network Cards

At least one 100/1000 Mbps Network Card

DS-Billing Database Disk

At least 10GB for production DS-Billing.

Software

Version

PostgreSQL Server
(For dsbilling database)

LINUX DS-Billing Installation Guide

v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

For the official list of this products supported Databases

and versions, refer to the Installation and Support
Matrix.
9.1 or 9.2 (upgrade existing installations only - external
database)
9.3 (new installations - external database)
9.1 (embedded, no separate installation required) - THIS
IS THE RECOMMENDED DATABASE TO USE.

Generated on: 1/22/15

Page: 4
Confidential.

Run The DS-Billing Installation Program

1. Make sure:
You have logged on as user root
If you are upgrading an existing DS-Billing Installation that uses an external
database, make sure the postgreSQL database is running. You should also
backup the existing DS-Billing database using the command:
# pg_dump -U postgres dsbilling > /<installation_path>/dsbilling.dmp

2. Run the Installation Center for Linux Products (setup_lin.sh) located in the root
directory of the installation DVD.
The Installation Center is a common launcher for all Linux-platform
installations. It allows you to choose the specific installation package you
want, without the need to browse the installation DVD.
3. The Installation starts:
Choose the Setup Language (English / German) and Click Install.
Note: The selected language will be installed for the DS-Billing service. Once set, the DS-Billing
Service language cannot be changed (for logs and popup messages). The DS-Billing GUI
language can be changed from the Initialization screen.
The license agreement screen appears. You must accept the license
agreement to continue.
Click "Next". A pre-requisite check is performed on the installation machine.
This scans the hardware and Operating System for compatibility (see II)
Hardware & Software Minimum Requirements on page 4).
4. Click Next. The Select Installation Type and Destination screen appears. DS-Billing
files will be installed to this directory.
5. Choose what you want to install. By default, both options are selected.
DS-Billing Service (installs the service daemon)
DS-Billing GUI (installs the user interface that allows you to manage the
service)
6. Choose the installation destination directory.
7. Click Install.
For new DS-Billing installations, setup will automatically create a new
embedded database.
If you are upgrading a DS-Billing installation that uses an embedded
database, a popup appears when the old database is found. The default is to
reuse (keep) this database. If you do not reuse the database, you will be
creating a fresh DS-Billing installation.
If you are upgrading a DS-Billing installation that uses an external database,
the old database that is found will automatically be reused.
8. The Complete Installation screen appears after setup has copied all files to the
installation destination. For a full installation (including both GUI and service), the
following selections are available:
Start DS-Billing GUI

Check to launch the DS-Billing GUI after you click Done.

Start DS-Billing Service

Check to start the DS-Billing daemon after you click Done.

Start DS-Billing at boot time Check to configure the DS-Billing daemon to automatically
(run-level 3)
start every time the computer enters run-level 3 (boots up).

9. Click Done to exit the installation.

You can manually start and stop the DS-Billing daemon with the following commands:
Start DS-Billing: /etc/init.d/dsbilling.sh start
Stop DS-Billing: /etc/init.d/dsbilling.sh stop
LINUX DS-Billing Installation Guide
v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

Generated on: 1/22/15

Page: 5
Confidential.

DS-Billing Upgrade
Before upgrading, read the new versions Release Notes for any special steps you need to perform.
To upgrade a DS-Billing System from one version / Service Pack to the next, do the following:
1. Stop the DS-Billing daemon.
2. Run the DS-Billing Release / Service Pack installation on the machine where the DSBilling software is installed.
The installation will detect the existing DS-Billing database and will apply the
database patches.
The installation will also detect and upgrade the DS-Billing components that
are installed on the DS-Billing machine.
3. Finish the installation.
4. If no errors occurred from the database patches, start the DS-Billing daemon.
5. Check if you can connect to the DS-Billing daemon using the same (upgraded)
version of the DS-Billing GUI.
If the connection is successful, check the DS-Billing Event Log for errors.

LINUX DS-Billing Installation Guide

v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

Generated on: 1/22/15

Page: 6
Confidential.

DS-Billing GUI Only Installation

This section deals with DS-Billing GUI only installations, intended for the end-user workstations
that will remotely administer the DS-Billing server.

Before Installing DS-Billing GUI

Make sure that:
You are logged in as the workstations root user (or a user with equivalent
privileges);
The workstation is connected to a local/network printer (for Reports);
The time on the computer is correct;
The workstation is networked to a DS-Billing server;
The installation computer is running one of the supported Operating Systems
from section I) Supported Platforms on page 4.
Note:

These are minimum requirements. Use the best hardware possible to maximize Asigra
Cloud Backup performance.

Install DS-Billing GUI only (for remote management)

1. Follow the same steps from the section Run The DS-Billing Installation Program on
page 5 until you reach the Select Installation Type and Destination screen.
Select DS-Billing GUI.
2. Complete the installation.
3. You may start the program and make initial configurations using the Connection
Screen (DS-Billing GUI > Setup menu > Initialization).

DS-Billing GUI Upgrade (Upgrading an existing installation)

To upgrade an existing DS-Billing GUI installation, perform the following steps:
Close all open DS-Billing GUIs on that machine.
Choose the correct installation package for upgrade, and run it.
Open the DS-Billing GUI and try to connect to a DS-Billing daemon that has
the same version as the DS-Billing GUI. Connection will be successful;
otherwise, an error message will be reported.

LINUX DS-Billing Installation Guide

v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

Generated on: 1/22/15

Page: 7
Confidential.

Run The DS-Billing Installation Program (Console

mode)
Note:

If a Graphical Interface is not installed on this UNIX Operating System, DS-Billing GUI
cannot be run locally. DS-Billing GUI can be run from a remote machine to connect to this
DS-Billing daemon.

Depending on your selections, some different screens will appear. These differences are noted
below.
1. Make sure:
You have logged on as user root
If you are upgrading an existing DS-Billing Installation that uses an external
database, make sure the postgreSQL database is running. You should also
backup the existing DS-Billing database using the command:
# pg_dump -U postgres dsbilling > /<installation_path>/dsbilling.dmp

2. Run the installation program (setupLinuxBilling.bin) from the following folder on the
installation DVD:
/Software/DS-Billing/Linux_64_bit/

3. Run the command-line

setupLinuxBilling.bin -i console

4. The Installation starts:

Console mode offers a command-line style interface that requires single-key input commands to
change settings. The current selection is always indicated with an arrow (for example:
> 2 - English). If you press the Enter key, the default number is input. For a different
command, press another number from the menu on the screen.
5. Choose the Setup Language:
German: Press [1] and Enter
English: Press [2] and Enter
Note: The selected language will be installed for the DS-Billing service. Once set, the DS-Billing
Service language cannot be changed (for logs and popup messages). The DS-Billing GUI
language can be changed from the Initialization screen (if the required language
components have been installed).
6. The software license agreement appears. You must accept the terms of the license
agreement to continue.
Keep pressing Enter until you reach the end of the license agreement
To accept: Press [Y] and Enter
7. A pre-requisite check is performed on the installation machine. This scans the
hardware and Operating System for compatibility (see II) Hardware & Software
Minimum Requirements on page 4).
If the scan fails with any errors, you are prompted if you would like to continue
with the installation. If the scan passes, setup automatically proceeds to step
8 (below).
8. The Select Installation Type and Destination screen appears. By default, both the
service and the GUI will be installed.
Press [1] to select only the DS-Billing Service
Press [2] to select only the DS-Billing GUI

LINUX DS-Billing Installation Guide

v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

Generated on: 1/22/15

Page: 8
Confidential.

9. Press Enter to continue. Choose the installation destination directory. DS-Billing files
will be installed to this directory.
You can change this location by entering a valid path on the local computer in
this field.
10. Press Enter to continue. The installation starts.
For new DS-Billing installations, setup will automatically create a new
embedded database.
If you are upgrading a DS-Billing installation that uses an embedded
database, setup asks what to do when the old database is found. The default
is to reuse (keep) this database. If you do not reuse the database, you will be
creating a fresh DS-Billing installation.
If you are upgrading a DS-Billing installation that uses an external database,
the old database that is found will automatically be reused.
11. Once the installation finishes, the Complete Installation screen appears. For a full
installation (including both GUI and service), the following selections are available:
1

Start DS-Billing GUI

Select to launch the DS-Billing GUI.

Start DS-Billing Service

Select to start the DS-Billing daemon.

Start DS-Billing at boot time Select to configure the DS-Billing daemon to automatically
(run-level 3)
start every time the computer enters run-level 3 (boots up).

By default, all items are selected.

12. Press Enter to start / configure the selected items and exit the installation.
You can manually start and stop the DS-Billing service with the following
commands:
Start DS-Billing: /etc/init.d/dsbilling.sh start
Stop DS-Billing: /etc/init.d/dsbilling.sh stop

LINUX DS-Billing Installation Guide

v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

Generated on: 1/22/15

Page: 9
Confidential.

Configure Linux DS-Billing with an external

PostgreSQL database
Creation Date: January 06, 2014
Revision Date: January 06, 2014
Product:
DS-Billing (Linux)

Summary
From v12.0, default installations of Linux DS-Billing will come with an embedded PostgreSQL
database (on the local machine). This article helps you to configure the Linux DS-Billing to use an
unembedded, external (remote or local) database.
IMPORTANT: The external PostgreSQL database must be the same version or higher than the
embedded database (i.e. >= PostgreSQL 9.1.1). If it is lower, the DS-Billing will only run
in standby mode due to incompatible database patches. (This is a PostgreSQL issue.)

Install Linux DS-Billing and configure it with an external PostgreSQL database

1. Install the Linux DS-Billing on the target machine.
2. Follow the GUI to install DS-Billing. Do not start DS-Billing Service or GUI.
3. Modify the dsbilling.cfg at /<installation_path>/etc to point to the external PostgreSQL.
Database Home: This is the directory where you can find "bin/psql".
Database Host: IP address or computer_name where the PostgreSQL
instance resides.
Database Type: PostgreSQL
Database User: postgres
Database Password: This must be in encrypted format. Use the 'asigraenc'
application in /<DS-Billing_Installation_Path>/Tools to generate an encrypted
version of your postgres password. (For example: ./asigraenc mypassword)
Database Port: 5432
4. Then you must create a new, empty external "dsbilling" database with the following
commands:
psql template1 -Upostgres
create database dsbilling template=template0 encoding='UTF8';

5. Find the following file in the /<installation_path>/db/scripts folder:

postgresbilling.sql

6. Run this script to initialize the database:

psql -d dsbilling -Upostgres -f <path>/postgresbilling.sql

If running PostgreSQL Server on the local (DS-Billing) computer, <path> is

the /<installation_path>/db/scripts (default is usually /opt/CloudBackup/DSBilling/db/scripts).
If running PostgreSQL Server on the a remote computer, <path> can be any
location. Copy the postgresbilling.sql script to the PostgreSQL computer
and run the above psql commands.
Note: The IP address of the local computer (DS-Billing machine) must be added to the
pg_hba.conf file located under <Postgres_Installation_Path>/data folder, in order to
prevent connection problems between the DS-Billing machine and the Postgres server.

LINUX DS-Billing Installation Guide

v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

Generated on: 1/22/15

Page: 10
Confidential.

7. Start the DS-Billing service with the following command:

Start DS-Billing: /etc/init.d/dsbilling start

The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. Asigra Inc. All Rights Reserved. Confidential.

LINUX DS-Billing Installation Guide

v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

Generated on: 1/22/15

Page: 11
Confidential.

Connecting to an embedded PostgreSQL database

Creation Date: January 06, 2014
Revision Date: January 06, 2014
Product:
DS-Billing (Linux)

Summary
From v12.0, default installations of Linux DS-Billing will come with an embedded PostgreSQL
database (on the local machine).
To connect to the embedded database instance that is installed with the Linux DS-Billing, follow
the steps below:
1. su to root user
2. In a command line type:
PATH_TO_PSQL/psql -h PATH_TO_EMBEDDED_PGSQL -U dsbilling -d DATABASE_NAME

where:
PATH_TO_PSQL is the path where psql command can be found. For DSBilling installed with embedded PostgreSQL database instance, by default,
this path is:
/opt/CloudBackup/DS-Billing/db/pgsql/bin

PATH_TO_EMBEDDED_PGSQL is the path where the Embedded Database

is installed. By default, this path is /opt/CloudBackup/DS-Billing/db/pgsql. This
path value can be found in the DS-Billing installation directory, /etc/
dsbilling.cfg file, in the Database Host value.
DATABASE_NAME is the database name to connect to, found in the
Embedded PostgreSQL database instance.

The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no
event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special
damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. Asigra Inc. All Rights Reserved. Confidential.

LINUX DS-Billing Installation Guide

v13 [Revision Date: January 22, 2015]
Asigra Inc. All Rights Reserved.

Generated on: 1/22/15

Page: 12
Confidential.