LINUX DS-Billing

Installation Guide

Suite 400 ▫ Toronto. ▫ 1120 Finch Avenue West. or may be trademarks of their respective owners. Ontario. Confidential.Disclaimer Information in this document is subject to change without notice and does not represent a commitment on the part of ASIGRA Inc. “Asigra”. All information appearing in this document is used for illustration purposes only. It is against the law to copy the software on any medium except as specifically allowed in the license agreement. All Rights Reserved. implied. used to demonstrate Asigra Cloud Backup™ procedures. Document Prepared by: ▫ © Asigra Inc.com ▫ www. CANADA M3J 3H7 ▫ info@asigra. makes no representation or warranty. ASIGRA Inc. Copyright The software described in this document is furnished under a license agreement. “Asigra Cloud Backup”. the Asigra logo. and assumes no responsibility for the accuracy. sufficiency or usefulness of the information contained herein. and it should be considered fictitious. with respect to. “Recovery is Everything”.asigra. All rights reserved. All other brand and product names are. Generated on: 1/22/15 Page: 2 Confidential. 2015] © Asigra Inc.com ▫ LINUX DS-Billing Installation Guide v13 [Revision Date: January 22. . or statutory. This document may contain sample screen shots. express. completeness. and “Recovery License Model” are trademarks of Asigra Inc.

. . . . . . . . . . . . . . . . . . 8 Configure Linux DS-Billing with an external PostgreSQL database . . . . . . . . . . . . . . . . . . . . . . . . . 4 Run The DS-Billing Installation Program . Before Installing DS-Billing GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 DS-Billing Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Install DS-Billing GUI only (for remote management). . . . . . . . . . . . . . . . . . . . . . . . . . . DS-Billing GUI Upgrade (Upgrading an existing installation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Generated on: 1/22/15 Page: 3 Confidential. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . All Rights Reserved. . . . . . . . . . . . . . . . . . . . 4 I) Supported Platforms . . . . . . . . . . . . . . . 10 Connecting to an embedded PostgreSQL database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Before you install DS-Billing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2015] © Asigra Inc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 II) Hardware & Software Minimum Requirements . 6 DS-Billing GUI Only Installation. . . . . . . . . . . . . 7 7 7 7 Run The DS-Billing Installation Program (Console mode) . . 12 LINUX DS-Billing Installation Guide v13 [Revision Date: January 22.

Before you install DS-Billing This document contains installation instructions for LINUX DS-Billing. • You have logged in as the target DS-Billing computer’s root user. Generated on: 1/22/15 Page: 4 Confidential. • The time on the target DS-Billing computer is correct. Minimum 18GB Network Cards At least one 100/1000 Mbps Network Card DS-Billing Database Disk At least 10GB for production DS-Billing. For the official list of this product’s supported Databases and versions.1 (embedded.external database) 9. it is strongly recommended that you use the fastest brand-name components available.external database) 9.1 or 9.5 . 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. Verify the installation computer meets the following requirements: I) Supported Platforms For the official list of this product’s supported Operating Systems and versions. If applicable. 2015] © Asigra Inc. Software Version • PostgreSQL Server (For dsbilling database) • • • LINUX DS-Billing Installation Guide v13 [Revision Date: January 22. 9. .3 (new installations . Before installing or upgrading DS-Billing.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. Hardware x64 (64-bit) Architecture 2 CPU (Dual) 3 GHz or greater RAM 2 GB RAM or more System disk (for OS and SQL). make sure that: • The DS-Billing computer meets the minimum hardware and software requirements.2 (upgrade existing installations only . refer to the Installation and Support Matrix.THIS IS THE RECOMMENDED DATABASE TO USE. no separate installation required) . All Rights Reserved. refer to the Installation and Support Matrix.

you will be creating a fresh DS-Billing installation. For a full installation (including both GUI and service). • DS-Billing Service (installs the service daemon) • DS-Billing GUI (installs the user interface that allows you to manage the service) 6. You should also backup the existing DS-Billing database using the command: # pg_dump -U postgres dsbilling > /<installation_path>/dsbilling. • If you are upgrading a DS-Billing installation that uses an external database. The Installation starts: • Choose the Setup Language (English / German) and Click “Install”. The DS-Billing GUI language can be changed from the Initialization screen.d/dsbilling. Run the Installation Center for Linux Products (setup_lin. 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).sh) located in the root directory of the installation DVD. a popup appears when the old database is found. Start DS-Billing Service Check to start the DS-Billing daemon after you click “Done”. DS-Billing files will be installed to this directory. Choose the installation destination directory.d/dsbilling. • If you are upgrading a DS-Billing installation that uses an embedded database. 3. A pre-requisite check is performed on the installation machine. Click “Done” to exit the installation. • Click "Next". Click Next. both options are selected.dmp 2. It allows you to choose the specific installation package you want. Generated on: 1/22/15 Page: 5 Confidential. 4. . • The license agreement screen appears. The “Complete Installation” screen appears after setup has copied all files to the installation destination. the DS-Billing Service language cannot be changed (for logs and popup messages). setup will automatically create a new embedded database.Run The DS-Billing Installation Program 1. The default is to reuse (keep) this database. The “Select Installation Type and Destination” screen appears. Once set. 7. Make sure: • You have logged on as user root • If you are upgrading an existing DS-Billing Installation that uses an external database. You must accept the license agreement to continue. 8. make sure the postgreSQL database is running. Choose what you want to install. the old database that is found will automatically be reused. All Rights Reserved. 9. the following selections are available: Start DS-Billing GUI Check to launch the DS-Billing GUI after you click “Done”. Note: The selected language will be installed for the DS-Billing service. • The Installation Center is a common launcher for all Linux-platform installations.sh stop LINUX DS-Billing Installation Guide v13 [Revision Date: January 22. Click “Install”.sh start Stop DS-Billing: /etc/init. You can manually start and stop the DS-Billing daemon with the following commands: Start DS-Billing: /etc/init. without the need to browse the installation DVD. If you do not reuse the database. • For new DS-Billing installations. By default. 2015] © Asigra Inc. This scans the hardware and Operating System for compatibility (see “II) Hardware & Software Minimum Requirements” on page 4). 5.

5. 3. do the following: 1. read the new version’s Release Notes for any special steps you need to perform. 2015] © Asigra Inc. To upgrade a DS-Billing System from one version / Service Pack to the next. . Stop the DS-Billing daemon. Generated on: 1/22/15 Page: 6 Confidential. • The installation will detect the existing DS-Billing database and will apply the database patches. 2. All Rights Reserved. Finish the installation. LINUX DS-Billing Installation Guide v13 [Revision Date: January 22.DS-Billing Upgrade Before upgrading. Check if you can connect to the DS-Billing daemon using the same (upgraded) version of the DS-Billing GUI. 4. start the DS-Billing daemon. check the DS-Billing Event Log for errors. Run the DS-Billing Release / Service Pack installation on the machine where the DSBilling software is installed. • The installation will also detect and upgrade the DS-Billing components that are installed on the DS-Billing machine. • If the connection is successful. If no errors occurred from the database patches.

Generated on: 1/22/15 Page: 7 Confidential.DS-Billing GUI Only Installation This section deals with DS-Billing GUI only installations. Before Installing DS-Billing GUI Make sure that: • You are logged in as the workstation’s root user (or a user with equivalent privileges). otherwise. Complete the installation. . 2015] © Asigra Inc. • Choose the correct installation package for upgrade. • The time on the computer is correct. Install DS-Billing GUI only (for remote management) 1. 2. DS-Billing GUI Upgrade (Upgrading an existing installation) To upgrade an existing DS-Billing GUI installation. • The workstation is networked to a DS-Billing server. • Open the DS-Billing GUI and try to connect to a DS-Billing daemon that has the same version as the DS-Billing GUI. Note: These are minimum requirements. perform the following steps: • Close all open DS-Billing GUIs on that machine. 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. an error message will be reported. Use the best hardware possible to maximize Asigra Cloud Backup™ performance. • The workstation is connected to a local/network printer (for Reports). LINUX DS-Billing Installation Guide v13 [Revision Date: January 22. • The installation computer is running one of the supported Operating Systems from section “I) Supported Platforms” on page 4. intended for the end-user workstations that will remotely administer the DS-Billing server. 3. You may start the program and make initial configurations using the Connection Screen (DS-Billing GUI > Setup menu > Initialization). All Rights Reserved. and run it. • Select “DS-Billing GUI”. Connection will be successful.

Run The DS-Billing Installation Program (Console mode) Note: If a Graphical Interface is not installed on this UNIX Operating System. some different screens will appear. Make sure: • You have logged on as user root • If you are upgrading an existing DS-Billing Installation that uses an external database. the default number is input. 2015] © Asigra Inc. The Installation starts: Console mode offers a command-line style interface that requires single-key input commands to change settings.dmp 2. 8. The “Select Installation Type and Destination” screen appears. The software license agreement appears. A pre-requisite check is performed on the installation machine. 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. press another number from the menu on the screen.English”). • Keep pressing Enter until you reach the end of the license agreement • To accept: Press [Y] and Enter 7. setup automatically proceeds to step 8 (below). . These differences are noted below. 1. All Rights Reserved. This scans the hardware and Operating System for compatibility (see “II) Hardware & Software Minimum Requirements” on page 4). Generated on: 1/22/15 Page: 8 Confidential. make sure the postgreSQL database is running. Run the installation program (setupLinuxBilling. Run the command-line setupLinuxBilling. • If the scan fails with any errors. For a different command. DS-Billing GUI cannot be run locally.bin) from the following folder on the installation DVD: /Software/DS-Billing/Linux_64_bit/ 3. 5. both the service and the GUI will be installed. the DS-Billing Service language cannot be changed (for logs and popup messages). you are prompted if you would like to continue with the installation. The DS-Billing GUI language can be changed from the Initialization screen (if the required language components have been 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. You must accept the terms of the license agreement to continue. If the scan passes. 6. Depending on your selections.bin -i console 4. You should also backup the existing DS-Billing database using the command: # pg_dump -U postgres dsbilling > /<installation_path>/dsbilling. DS-Billing GUI can be run from a remote machine to connect to this DS-Billing daemon. By default. Once set. If you press the Enter key. The current selection is always indicated with an arrow (for example: “—> 2 .

Once the installation finishes.9. the following selections are available: 1 Start DS-Billing GUI Select to launch the DS-Billing GUI. setup will automatically create a new embedded database.sh start Stop DS-Billing: /etc/init. 2015] © Asigra Inc. Generated on: 1/22/15 Page: 9 Confidential. For a full installation (including both GUI and service). Press Enter to start / configure the selected items and exit the installation. • By default. DS-Billing files will be installed to this directory.d/dsbilling. All Rights Reserved.d/dsbilling. • For new DS-Billing installations. you will be creating a fresh DS-Billing installation. the “Complete Installation” screen appears. 12. Choose the installation destination directory. 10. 3 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). • You can change this location by entering a valid path on the local computer in this field. If you do not reuse the database. the old database that is found will automatically be reused. • You can manually start and stop the DS-Billing service with the following commands: Start DS-Billing: /etc/init. Press Enter to continue. The default is to reuse (keep) this database. • If you are upgrading a DS-Billing installation that uses an external database.sh stop LINUX DS-Billing Installation Guide v13 [Revision Date: January 22. 11. The installation starts. 2 Start DS-Billing Service Select to start the DS-Billing daemon. Press Enter to continue. . setup asks what to do when the old database is found. all items are selected. • If you are upgrading a DS-Billing installation that uses an embedded database.

Run this script to initialize the database: psql -d dsbilling -Upostgres -f <path>/postgresbilling. in order to prevent connection problems between the DS-Billing machine and the Postgres server. Generated on: 1/22/15 Page: 10 Confidential. 3. <path> is the /<installation_path>/db/scripts (default is usually /opt/CloudBackup/DSBilling/db/scripts). >= PostgreSQL 9. Note: The IP address of the local computer (DS-Billing machine) must be added to the pg_hba. 2015] © Asigra Inc. • Database Type: PostgreSQL • Database User: postgres • Database Password: This must be in encrypted format.) Install Linux DS-Billing and configure it with an external PostgreSQL database 1. default installations of Linux DS-Billing will come with an embedded PostgreSQL database (on the local machine). Find the following file in the /<installation_path>/db/scripts folder: postgresbilling.cfg at /<installation_path>/etc to point to the external PostgreSQL. LINUX DS-Billing Installation Guide v13 [Revision Date: January 22. (This is a PostgreSQL issue.conf file located under <Postgres_Installation_Path>/data folder. If it is lower.0. This article helps you to configure the Linux DS-Billing to use an unembedded. 2014 Revision Date: January 06. the DS-Billing will only run in standby mode due to incompatible database patches. • Database Home: This is the directory where you can find "bin/psql". Follow the GUI to install DS-Billing. . IMPORTANT: The external PostgreSQL database must be the same version or higher than the embedded database (i. 2014 Product: DS-Billing (Linux) Summary From v12.Configure Linux DS-Billing with an external PostgreSQL database Creation Date: January 06. If running PostgreSQL Server on the a remote computer. Then you must create a new. 5. Copy the postgresbilling.sql • • If running PostgreSQL Server on the local (DS-Billing) computer.e. 2.1. All Rights Reserved. external (remote or local) database./asigraenc mypassword) • Database Port: 5432 4. Use the 'asigraenc' application in /<DS-Billing_Installation_Path>/Tools to generate an encrypted version of your postgres password. • Database Host: IP address or computer_name where the PostgreSQL instance resides. <path> can be any location. Install the Linux DS-Billing on the target machine. Modify the dsbilling. empty external "dsbilling" database with the following commands: psql template1 -Upostgres create database dsbilling template=template0 encoding='UTF8'. (For example: .1).sql 6.sql script to the PostgreSQL computer and run the above psql commands. Do not start DS-Billing Service or GUI.

even if ASIGRA or its business partners have been advised of the possibility of such damages. .7. indirect. © Asigra Inc. consequential. without warranty of any kind. Generated on: 1/22/15 Page: 11 Confidential. All Rights Reserved. 2015] © Asigra Inc. either express or implied. including direct. incidental. In no event shall ASIGRA or its business partners be liable for any damages whatsoever. loss of business profits or special damages. Start the DS-Billing service with the following command: Start DS-Billing: /etc/init. ASIGRA Inc. LINUX DS-Billing Installation Guide v13 [Revision Date: January 22.d/dsbilling start The information provided in this document is provided "AS IS". (ASIGRA) disclaims all warranties. Confidential. All Rights Reserved.

including direct. found in the Embedded PostgreSQL database instance. DATABASE_NAME is the database name to connect to. All Rights Reserved. By default. consequential. ASIGRA Inc. 2014 Revision Date: January 06. 2015] © Asigra Inc. The information provided in this document is provided "AS IS". incidental. even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. In no event shall ASIGRA or its business partners be liable for any damages whatsoever. Confidential. /etc/ dsbilling. this path is /opt/CloudBackup/DS-Billing/db/pgsql. without warranty of any kind. default installations of Linux DS-Billing will come with an embedded PostgreSQL database (on the local machine). For DSBilling installed with embedded PostgreSQL database instance. indirect. by default. (ASIGRA) disclaims all warranties. . LINUX DS-Billing Installation Guide v13 [Revision Date: January 22. follow the steps below: 1. either express or implied. 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. loss of business profits or special damages.0. 2014 Product: DS-Billing (Linux) Summary From v12.Connecting to an embedded PostgreSQL database Creation Date: January 06. in the Database Host value.cfg file. This path value can be found in the DS-Billing installation directory. this path is: /opt/CloudBackup/DS-Billing/db/pgsql/bin • • PATH_TO_EMBEDDED_PGSQL is the path where the Embedded Database is installed. All Rights Reserved. Generated on: 1/22/15 Page: 12 Confidential. su to root user 2. To connect to the embedded database instance that is installed with the Linux DS-Billing.