Custom Package - Macintosh

Before you Begin

Verify System Requirements

Verify that the computer in which you want to install the custom package satisfies the minimum requirements specified in System Requirements.

Download Software Packages

Download the latest SnapProtect® software using the Download Manager application. The Download Manager bundles an installation package from the SnapProtect components that you chose to download. Use the installation package to launch the software installer and create a custom package.

See Download Manager - Getting Started for instructions on creating an installation package.

Set Up User Authentication

The installation of a custom package does not involve much user interaction. However, if you want to include user authentication during the package installation, do the following:

  1. Log on to the CommCell Console, right-click the <CommServe> node and then click Properties.
  2. In the CommCell Properties dialog box, select Require authentication for Agent Installation.

Other Custom Package Configurations

  • If you need to create a laptop package, see Deployment for Laptop Backup.
  • If you plan to deploy the custom package on multiple clients, you can configure the package to deploy with automatic registration. See Automatic Registration for more information.

Creating a Custom Package

  1. Log on to a Macintosh computer as a user with administrative privileges (ability to run sudo commands).
  2. Run the following command from the installation package that was created using the Download Manager.

    ./cvpkgadd

    If the installation package was copied to a DVD, run the following command to mount the DVD:

    mount -t iso9660,udf /dev/dvd /mnt/dvd

    You can also run the installation command as a SUDO user with root privileges:

    ./sudo cvpkgadd

    To add a SUDO user to /etc/sudoers, see Adding SUDO Users with Root Privileges to Log On to a UNIX Client.

  3. The product banner and other information is displayed.

    Press Enter.

  4. Read the license agreement. Type y and press Enter.
  5. On the Selecting Unix Setup Task dialog, type 2 and then press Enter.
  6. On the Selecting Unix Setup Advanced Options dialog, press Enter to create a custom install package.
  7. On the Deciding If to Install Agents as non root dialog, press Enter to install as non root user.
  8. On the Selecting Package Type dialog, press Enter to create a general package.
  9. On the Selecting Platform dialog, type 9 (for Darwin) and press Enter. Then, type d press Enter.
  10. On the Selecting Subsystem dialog, type the number associated with the File System components, and press Enter.
  11. On the Setting Custom Package Directory dialog, press Enter to save the custom package to the default path. If you want to specify a different location, type the path and then press Enter.
  12. On the Deciding If to Record the Install dialog, type Yes and press Enter.
  13. On the Deciding If to Install Agents as non root dialog, press Enter to install as non root user.

    A prompt to hide the dialog is displayed. Press Enter to hide the above dialog during install.

    On every next step, you will see the prompt to hide the screen. When you press Enter to the prompt, the current dialog will not show up during the installation of the custom package. If you want the dialog to be displayed during the installation, type yes and press Enter.

  14. On the Selecting Modules to Install dialog, select all components and press Enter.
  15. On the Deciding If to Install Agents for Restore only dialog, press Enter to select the standard install.
  16. On the Preparing Registry Directory dialog, specify where you want the registry files to reside and press Enter.
  17. On the Preparing Installation Directory dialog, specify where to install the package and press Enter.

    Consider the following when specifying the location:

    • Do not install the software to a mapped network drive.
    • Do not use the following characters when specifying the path:

      !@#$%^&*():/?\

    • It is recommended that you use alphanumeric characters only.
  18. On the Preparing Log Directory dialog, specify where you want the log files to reside and press Enter.

    Consider the following when specifying the location:

    • Do not use the following characters when specifying the path:

      !@#$%^&*():/?\

    • It is recommended that you use alphanumeric characters only.
    • All the modules installed on the computer will store the log files in this directory.
  19. On the Preparing Job Results Directory dialog, specify where you want the JobResults directory to reside and press Enter.
  20. On the Deciding If to Use a Unix Group dialog, press Enter to assign a group.
  21. On the Setting Unix Group dialog, enter the group name and press Enter.
  22. On the Setting Access Permissions for Group and Other Users dialog, type d to allow all permissions and press Enter.
  23. On the Setting Number of Streams dialog, enter the number of streams that you plan to run at the same time and press Enter.
  24. On the Setting Instance Port Number of cvd dialog, enter the port number and press Enter.
  25. On the Setting Instance Port Number of EvMgrC dialog, enter the port number and press Enter.
  26. On the Deciding If to Configure Firewall dialog, check if the computer where the package will be installed is in a firewall. Do one of the following:
    • If firewall configuration is not required, press Enter.
    • If this computer and the CommServe is separated by a firewall, type Yes and then press Enter.

    For firewall options and configuration instructions, see Firewall Configuration.

  27. On the Setting CommServe Host Name dialog, type the fully qualified domain of the CommServe hostname and press Enter.
  28. On the Deciding If to Record as Decoupled Install dialog, do one of the following:
    • Press Enter to not record as decoupled install. The Setting CommServe Host Name dialog is displayed, where you have to specify the fully qualified domain name of the CommServe hostname and then press Enter.
    • Type yes and press Enter to record as decouple install.
  29. On the Specifying If CommServe Per-Client Certificate is Enabled dialog, do one of the following:
    • If per-client certificate is enabled, type yes and press Enter.
    • If per-client certificate is disabled, press Enter.
  30. On the Deciding If to Use CommCell Authentication dialog, do one of the following:
    • If CommCell authentication is enabled, type yes and press Enter. You will need to provide the CommCell credentials in order to continue with the installation.
    • If CommCell authentication is disabled, press Enter.
  31. On the Selecting How to Set CommCell Level Global Filters dialog, type the appropriate number to select the global filter configuration and press Enter.
  32. On the Setting Client Computer Group dialog, type the name of the client group and press Enter.
  33. On the Deciding If to Configure Subclient Policy dialog, press Enter.
  34. On the Setting Storage Policy dialog, enter the storage policy name and press Enter.
  35. On the Selecting Instance for the Recording dialog, press Enter to install to a new instance.

    If you want to install the components to a different instance, type the number associated with the instance and then press Enter.

  36. On the Archiving dialog, type yes to create a TAR file of the custom package, and then press Enter.

    Make a note of the location where the package was created (sample shown below), and make it available to the computers where you plan to install the package.

    [Custom Regular Package Summary] General package created at
    /opt/UnixCustomPackage/pkg
    [Custom Native Package Summary] Tar package created at
    /opt/UnixCustomPackage/tar

Installing the Custom Package

Use the following procedure to install the custom package.

  1. Log on to the computer where you want to install the custom package.
  2. Navigate to the directory where the custom package resides (for example, /opt/UnixCustomPackage/pkg), and then run the following command:

    ./silent_install -p default

    The custom package is installed silently. The following is a sample output you might see in the command prompt:

    Performing non-interactive Install of the following modules...
    * Base Client [1002] [CVGxBase]
    * Base0 Client [1003] [CVGxBase0]
    * UNIX File System iDataAgent [1101] [CVGxIDA]
    Install of the above modules completed successfully.

Registering the Client Computer

If your Macintosh computer had no connection to the CommServe during the custom package installation (decoupled install), you need to register the client computer with the CommServe.

Use one of the following methods to register your client computer:

Method 1: Register a Client Using the Process Manager

Method 3: Register a Client Using the CommCell Console

Method 4: Register a Client from the Command Line

Register a Client Using the Process Manager

  1. From the Applications window of your Macintosh computer, launch the Process Manager application.
  2. On the Introduction page of the Process Manager application, click Continue to start the laptop registration.

    The instances drop-down list is displayed when multiple instances are running on the client.

  3. On the Configuration page, provide the following details:
    1. Enter the name of the client in the Computer Name box.
    2. Enter the CommServe host name in the CommServe box. The CommServe name might be already provided.
    3. Enter your CommCell user credentials in the User Name and Password boxes.
    4. Click Continue.

  4. On the Summary page, review the information and then click Register.

    The Process Manager prompts for your laptop password to proceed with the registration. Enter the password and then click OK.

  5. Click Close to exit the laptop registration.

    The client computer will be listed under the Client Computers node in the CommCell Browser.

If there is another client in the CommCell with the same name, the client registration will fail. The following table displays details about the CommCell users that can and cannot re-register the client:

User Capability
Admin Allowed to re-register client with same name and host name
User with Install capability but not Owner Not allowed to register
User with install capability and an owner Allowed to re-register client with same name and host name
User without Install capability Not allowed to register
User is owner but does not have install rights Not allowed to register

Register a Client Using the CommCell Console

  1. From the CommCell console, right-click the Client-Computers node and then click New Client | File System | Unix.

  2. In the Client Name box, type the name of the client computer. In the Host Name box, type the host name of the client computer.

    Click Next.

  3. If you want to override the client name, click the Overrides the Client name check box, specify the client name in the Client name box, and then click Next.

  4. Click Finish.

    The client computer will be listed under the Client Computers node in the CommCell Browser.

Register a Client from the Command Line

You can log on to the CommServe computer or to any other client to register the new client from the command line.

  1. Log onto a client computer and open the command prompt.
  2. From the command prompt, go to the Installation_Directory/snapprotect/Base directory, and run the following command after substituting the parameter values.

    ./SIMCallWrapper -OpType 1000 -CSHost <CS Host Name> -clientname <Client Name> -output <Location for XML File>

    Usage of the command is:

    SIMCallWrapper -OpType 1000 [-instance <instance name>] [-user <User Name>] [-password <User password>] [-passwordEncrypted]] [-CSName <CS Name>] [-CSHost <CS Host Name>] [-ClientName <Client Name>] [-ClientHostName <Client Host Name>] [-ClientGroup <Client Group>] [-subclientPolicy <Subclient Policy>] [-StoragePolicy <Storage Policy>] [-overwriteClientInfo] [-resetNetworkPassword] [-regPath <alternative registry path>] [-instanceFor1Touch <instance>] -output <xmlFileName> [-Instance <Instance Name>] [-skipCertificateRevoke] [-registerme]

  3. Available Parameters

    The following table displays all the parameters you can use with the commands mentioned above:

    Parameter Description of Parameter Values
    -opType 1000 * Name of the operation type to register the client to the CommServe.
    -clientName * Name of the client computer
    -output * Location for xml file
    -instance Instance of the CommServe on which the command is run.
    -user Name of a CommCell user account with sufficient permissions to install clients. This parameter is required if user authentication is enabled in the CommCell.

    Note: If the user is part of a domain, specify the user name as 'domain\user'.

    -password Password for the user account provided.
    -CSName Name of the CommServe
    -CSHost * Host name of the CommServe
    -clientHostName Host name of the client computer
    -clientGroup Name of the client group
    -subclientPolicy Nam of the subclient policy
    -storagePolicy Name of the storage policy
    -overwriteClientInfo It overwrites client name or host name if there is a mismatch between the two. It's either ON or OFF.
    -regPath Name of the alternative registry path
    -instanceFor1Touch Name of the instance for 1-Touch
    -Instance Name of the instance

    * marked parameters are mandatory to run the command. Other parameters are optional.