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 then use this record to install the program record the options chosen during ZCB installation. This recording can be used to install ZCB via the command line on other machines. This process  Configuration can also be automated and used for unattended installation.

Configuration can also be automated, provided the machines will all be backing up the same data sets.

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. 

exported and imported via command line as well.

Command-line operations can be automated in many ways, such as batch files, Windows Powershell, and more. The exact automation process is beyond the scope of this article as the infrastructure will vary greatly from one site to the next.

ZCB must be installed and configured manually on at least one machine in order to create a record of installation and configuration options.

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.

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. 

...

Step 3: 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.
  3. Inside are two folders, one containing the 32bit installer and another for the 64bit installer. 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\Setup.iss"
    2. The name or path inside the parentheses can be changed to suit your needs. 

      1. For example, we could create Setup.iss in C:\Temp\ by using the command setup.exe /r /f1"C:\Temp\Setup.iss" instead. 
  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. 

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.

Step 2: Export configuration

  1. Open a command prompt.
  2. 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\
  3. 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.
  4. A file named ZCB.zip will be found in the folder you choice after the export process is complete.

Prepare for Installation to Other Machines

Ensure that the files necessary for installation and configuration are available on all machines on which ZCB will be installed. Each machine must have access to the following:

  1. The installation recording (Setup.iss) 
  2. The setup files, extracted from the installer. 
  3. The ZCB.zip file created when configuration was exported

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. 

...

Use the Installation Record to Install ZCB

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. 

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

...

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.

Installation will be silent and invisible. There will be no feedback once the installation begins, and no windows will appear. 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 if the "Open ZCB after installation completes" option was selected in the initial recording. If not selected, the program can be launched via start menu or desktop shortcut. 

 

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/.

...

Import the Configuration

  1. Wait for installation to complete.
  2. Make sure ZCB is closed.
  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 
 

On successful completion of the import process, open the ZCB UI to make sure that all the backup sets, their respective schedules and configurations such as Backup Folder, Local & Cloud Retention period, Compression, etc are correctly imported to the new machine.

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