Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Information

It is possible to create a record of a ZCB installation, and then use this record to install the program via the command line on other machines. This process can 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. 

Step 1: Download the installer

Log into your account and download the latest installer file.

Step 2: Extract the installer

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

The installer will extract two folders: 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: 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. 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. 
  6. Proceed through the installation process. 

    1. The options you choose will be used for all CSB installations that use this recording in the future, and thus care should be taken to choose options that will make sense on the other machines.

    2. For example, you should choose to install the program on a drive letter that that will exist for all machines.

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 all machines on which ZCB will be installed. 

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

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

<Path to>\setup.exe /s /f1"<Path to>\Setup.iss"
Installation will be silent and invisible. There will be no 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 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/.

  • Run the file from the command prompt.
  • You must specify the export location from the command prompt as well.
  • For example, to export to C:\Export_Folder you would enter
    • C:\Program Files\Zmanda\Zmanda Cloud Backup\bin\Export_ZCBConfiguration.bat C:\Export_Folder
  • A file named "ZCB.zip" is now in 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

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.

 

Icon

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
  • No labels