Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Information

It is possible to create a record of a ZCB installation and export backup set configuration. 

Once created, and then use this record to install the program the installation recording and exported backup set configuration can be used to install ZCB via the command line on any number of other machines. This process  

Info

Command-line operations, including ZCB installation, can be automated. Windows Powershell, batch scripts, Group Policies, and more can all be used for

...

automation purposes.

...

The steps below can

...

be

...

Command-line Installation

ZCB must be installed manually on the first machine. A recording of this installation can then be used to perform subsequent installations via the command line. Command-line installations can be automated using batch files, Powershell, Group Policies, and other similar management tools. 

used to build automated, large-scale rollouts of pre-configured ZCB installations to any number of machines. However, the exact automation process is beyond the scope of this article.

The following steps are required:

Table of Contents
maxLevel2
minLevel2

Record an Installation

Step 1: Download the installer

Log into your account and download the latest installer file.

Example:

The Carbonite-Server-Backup-4.12.exe file has been downloaded to Y:\.

Image Added

Step 2: Extract the

...

setup files

Do not run the installer by double-clicking. Instead, use a zip program, such at as 7-zip, to open the installer to , and extract the contents to a directory of your choosing. 

The installer will extract two foldersTwo folders will be extracted: one for 32-bit ZCB, and another for 64-bit ZCB. 

For easiest installation, choose a common location that is accessible to all machines on which ZCB will be installed, such as a network share.

If a common location cannot be chosen, the setup files must be copied to each machine before installation begins on those machines. 

In our example, we have extracted the installer to Z:\Installation, which is on mapped network drive accessible to all machines. 

...

Example: 

The contents of Carbonite-Server-Backup-4.12.exe have been extracted to Y:\InstallationFiles

Image Added

Image Added

Step 3: Ensure that the Java Runtime Environment is installed

ZCB requires that the Java Runtime Environment be installed on the system prior to installation. To ensure a clean recording, please install the Java Runtime Environment before installation of ZCB begins.

Please see How to Install the Java Runtime Environment for more information.

Step 4: Start installation and create a recording

  1. Open an elevated command prompt using the Run As Administrator option. 
  2. Change directories to the folder where you extracted the installer.Inside are  There will be two folders located inside the directory where you extracted the installer, one containing the 32bit installer and another for the 64bit installer. 
  3. Change directory to one of these folders.
    1. A recording made of a 64-bit installation can only be run on 64-bit machines. Likewise, a recording of a 32-bit installation can only be run on a 32-bit machine.
  4. Verify that the setup.exe file exists inside the folder you have chosen, but do not run it.
  5. to the folder that matches your system.
    1. For example, you'll need to change to the 32bit installation folder if you are on a 32bit machine.
  6. Enter the following command 
    1. setup.exe /r /f1"Z:\Installation\<Path to some folder>\Setup.iss"
    2. The name filename or path inside the parentheses can be changed to suit your needs. 

      For example, we could

    3. Make sure that the folder where you choose to create Setup.iss in C:\Temp\ by using the command setup.exe /r /f1"C:\Temp\Setup.iss" instead.exists before installation begins. 
  7. The ZCB installation wizard will appear. 

  8. Proceed through the entire installation process. 

The

...

choices you

...

make during installation will be recorded. Take care to make choices that are generic and match the expected configuration of the other machines on which you plan to install ZCB. 

For example, you should

...

Step 4: Ensure that the recording and the extracted installation files accessible on each machine

The recording (Setup.iss) and all of the installation files must be available to not record an installation to a folder on the E:\ drive if not all machines will have an E:\ drive. 

Tip

Disable the "Open ZCB after installation completes" option during installation.

The last step in command-line installation and configuration, "Import the Backup Set Configuration", requires that the user interface be closed. If this option is not disabled, the user interface will open after installation and must be closed somehow (manually or by killing the process) before Import can proceed.

Example:

The 64-bit version of ZCB will be installed, and the Setup.iss recording file will be created in Y:\InstallationRecording\

Image Added

Installation complete!

Image Added

Configure Backup Sets and Export the Configuration

Step 1: Configure one or more backup sets

Open ZCB and configure one or more backup sets.

As with the installation, take care to make choices that make sense for the other machines on which you plan to install ZCB. When in doubt, stick to the defaults, as they represent the settings that work for most users.

Save each backup set after configuration. When you are done configuring all backup sets, exit the program.

Example:

Two backup sets, a File System backup and a System State backup, were configured and saved.

Image Added

Step 2: Export backup set configuration

  1. Close ZCB if it is open.
  2. Open a command prompt.
  3. Change directories to the \bin\ folder in the directory where ZCB is installed.
    1. By default, this is C:\Program Files\Zmanda\Zmanda Cloud Backup\bin\
  4. Run the following command
    1. Export_ZCBConfiguration.bat C:\Export_Folder
    2. You may replace C:\Export_Folder with any directory of your choice. The configuration will be exported as a zip file to this location.
  5. A file named ZCB.zip will be found in the folder you choice after the export process is complete.

Example:

Start export.

Image Added

Export complete!

Image Added

Prepare Other Machines for Installation

Ensure that the files necessary for installation and configuration of ZCB are available on all machines on which ZCB will be installed.  The For example, these files can be placed on a mapped network drive. They may also be copied to each machine manually or in an automated fashion using batch files, Powershell, Group Policies, or any other method of your choice. 

Step 5: Start the installation

Installation can be started using a simple command. The installation can be run manually or automated using batch files, Powershell, Group Policies, etc. 

Each machine must have access to the following:

  1. The installation recording. In our examples, this file is named Setup.iss.
  2. All of the files extracted from the installer, including the setup.exe files for 32-bit or 64-bit CSB.
  3. The ZCB.zip file that was created when configuration was exported.

The Java Runtime Environment must also be installed on each machine prior to ZCB installation. Please see How to Install the Java Runtime Environment for more information. 

Example:

All files are available on a network share. The share has been mapped as the Y: drive for easy access.

Image Added

Use the Installation Record to Install ZCB

Start the installation using the following command. 

<Path to>\setup.exe /s /f1"<Path to>\Setup.iss"

Replace <Path to> with actual path to the setup.exe and Setup.iss files.

...

The setup.exe file is found within the extracted setup files. There will be separate setup.exe files for 32bit and 64bit installations. You must provide the path to the correct setup.exe file. 

For example, if you extracted setup.exe to C:\CSB\Install\Carbonite-Server-Backup-4.11-64bit\ and Setup.iss to C:\CSB\Install\SetupRecording\, then command would be:

C:\CSB\Install\Carbonite-Server-Backup-4.11-64bit\setup.exe /s /f1"<Path to>\C:\CSB\Install\SetupRecording\Setup.iss"

Installation will be silent and mostly invisible.

...

An InstallShield setup window may appear in the task bar. Other than that, there will be

...

little feedback once the installation begins.

The command prompt will immediately be available for other commands.

...

 If you wish for the command prompt to wait until setup is complete, use this command instead. 


start /WAIT <Path to>\setup.exe /w /s /f1"<Path to>\Setup.iss"

With either command, the setup.exe process will be visible in Task Manager, and

...

an installation log file will be created in the directory where Setup.iss is located. 

ZCB will open automatically once installation is complete, if the "Open ZCB after installation completes" option was selected in the initial recording.

...

 

 

Example:

In our example, setup.exe is in Z:\Installation\64bit\. Setup.iss is in Z:\Installation\

The command to start the silent installation would be:

Z:\Installation\64bit\setup.exe /s /f1"Z:\Installation\Setup.iss"

Command-line Configuration

Like installation, the configuration of the first machine must be done manually. Once configuration is complete, the configuration settings can be exported and subsequently imported into other machines via the command line. 

Export Configuration

Export_ZCBConfiguration.bat will export an existing configuration into a .zip file, which can then be used to automate the installation of ZCB on new machines. Export_ZCBConfiguration.bat is located in C:\Program Files\Zmanda\Zmanda Cloud Backup/bin/.

...

Start installation via command line.

Image Added

Installation in progress. The Task Manager has been opened to show the setup.exe process.

Image Added

Installation complete!

Import the Backup Set Configuration

  1. Wait for installation to complete.
  2. Make sure the ZCB user interface is closed.
    1. The ZCB user interface process is named javaw.exe. If necessary for automation purposes, this process can be killed via command line.
  3. Open a command prompt.
  4. Change directories to the \bin\ folder in the directory where ZCB is installed.
    1. By default, this is C:\Program Files\Zmanda\Zmanda Cloud Backup\bin\

...

  1. Run the following command
    1. Import_ZCBConfiguration.bat C:\Export_Folder

...

    1. Replace C:\Export_Folder

...

Import_ZCBConfiguration.bat will import the ZCB.zip folder created by Export_ZCBConfiguration.bat

The import script needs access to the exported ZCB.zip file. Copy it to a local folder or provide path to the network share.

  • Make sure that there are no existing backup sets on the new machine to avoid any conflicts during the import process.
  • Open the command prompt and run Import_ZCBConfiguration.bat from the /bin/ directory.
  • The following example uses the same destination folder as above.
    • C:\Program Files\Zmanda\Zmanda Cloud Backup\bin\Import_ZCBConfiguration.bat C:\Export_Folder

...

    1. with the folder path that contains the ZCB.zip file 
 

After completion of the import process, open the ZCB UI to make sure that all the backup sets

...

and their respective

...

configurations

...

Note: The Backup Folder for the local storage will be modified depending on a target machine's operating system if default path is used. On the other hand, if the user modifies this location when they create a backup set template, then ZCB on all the other machines will have the same modified location.

  1. Run Validate Backup Set before running backups to make sure that all the configurations are in good shape.

 

Warning

Don't forget to add labels to the article!

 

 

 

To write a recording file for uninstallation, use the command: setup.exe /r /removeonly /f1"<filename.iss>"

An example command for replaying user input from C:\Temp\Setup.iss file:

The command will finish before the installation or uninstallation process is completed. Use the /WAIT flag if you want the setup.exe command to wait for the process to be completed. For example: The following installation command will wait until the process is complete in the Windows command prompt

start /WAIT setup.exe /w /s /f1"C:\tmp\Setup.iss''

The Zmanda Network provides default install.iss and uninstall.iss that can be used for unattended installation and uninstallation. These setup files assume that:

  1. ZCB will be installed in the C:\Program Files\Zmanda\Zmanda Cloud Backup folder. You will be asked to provide a password for the amandabackup user. Please note this password as it may be required for advanced configurations!
  2. ZCB uninstallation will not preserve configuration data

are complete.

Example:

Start the import from the command line.

Image Added

Import complete.

Image Added

Backup sets successfully imported! When CSB is next opened, the backup sets will be available.

Image Added