15.2 Creating a Bundle for the GroupWise Windows Client Software

ZENworks Configuration Management deploys software as bundles that include all the files and instructions required to successfully install software on users’ workstations.

15.2.1 Creating a New GroupWise Bundle

To create a ZENworks Configuration Management bundle for the GroupWise Windows client software:

  1. In ZENworks Control Center, click Bundles, then click New > Bundle.

    Create New Bundle page
  2. Select Windows Bundle, then click Next.

    Create New Windows Bundle page
  3. Click Next to accept the default of (Empty Bundle).

    Define Bundle Details page
  4. Define the new bundle:

    1. In the Bundle Name field, specify a unique name for the bundle, such as GW2012.

    2. In the Icon field, browse to and select the following file:

      software_distribution_directory\client\win32\grpwise12.ico
      
    3. Click Next to display the bundle summary.

      Bundle Summary page
    4. Select Create as Sandbox so that you can set up all the components of the bundle before publishing the bundle, then click Finish.

      Define Additional Properties is selected by default, which enables you to conveniently set up all the bundle components.

      GroupWise Bundle page
  5. Click Install to create installation actions for the GroupWise bundle:

    Bundle Install page
  6. Continue with Adding Installation Actions to the GroupWise Bundle.

15.2.2 Adding Installation Actions to the GroupWise Bundle

Several installation actions are required in order to install the GroupWise Windows client software.

Creating an Install Files Action to Copy the GroupWise Windows Client Software to Temporary Location

  1. On the Install tab, click Add > Install File(s) to add an Install File(s) action.

    Install Files dialog box

    The Install File(s) option copies the files that you select to a location that you specify. The first action you create copies the GroupWise Windows software files to a temporary location on your local server.

  2. In the Action Name field, customize the name to clearly identify the action, for example:

    Install Files to Temporary Directory
    
  3. Click Add to open the Select Files dialog box.

  4. Click Add.

  5. Browse to the following directory:

    software_distribution_directory\admin\utility\setupip
    
  6. Select the following files:

    • extract.bat

    • setupip.fil

    • setupip.xx (where xx is a two-letter language code)

  7. (Conditional) If your version of ZENworks Configuration Management provides the Do not compress or encrypt uploaded content, select this option.

    The largest file, setupip.fil, is already compressed. The other files are small and would not benefit substantially from compression.

    The uploaded files display in the File list.

  8. In the Destination Directory field, specify the temporary directory where you want to create a copy of the GroupWise Windows client software, for example:

    c:\gwclient
    

    If the directory does not already exist, it is automatically created.

  9. Click OK to close the Select Files dialog box and return to the Install File(s) dialog box with the selected files listed.

    Install File(s) dialog bog with the GroupWise Windows client software files listed
  10. (Optional) Select Run as dynamic administrator.

    The default of Run as secure system user is also appropriate for most systems.

  11. Click OK to close the Install File(s) dialog box and return to the GroupWise Bundles page with the first installation task listed.

    GroupWise bundle with an Install File(s) task
  12. Click Apply to save the first installation action.

  13. Continue with Creating a Run Script Action.

Creating a Run Script Action

  1. On the Install tab, click Add > Run Script to add a Run Script action.

    Run Script dialog box

    The Run Script option runs the script that you specify to extract all the Windows client software files from the setupip.fil file into a win32 subdirectory under gwclient.

  2. In the Action Name field, customize the name to clearly identify the action, for example:

    Run Script to Extract GroupWise Client Software
    
  3. In the Script File Name field, specify the full path to the batch file for extracting the GroupWise Windows client software, for example:

    c:\gwclient\extract.bat
    
  4. In the Wait before proceeding to next action box, select When action is complete.

  5. Click Advanced.

    Advanced tab in the Run Script dialog box
  6. In the Executable security level box:

    Select Run as secure system user.

    or

    Select Run as dynamic administrator.

  7. Click OK to add this installation action to the list.

    GroupWise bundle with a Run Scropt task
  8. Click Apply to save this installation action.

  9. Continue with Creating an Install Files Action to Add the GroupWise MST Transform File to the GroupWise Windows Client Installation.

Creating an Install Files Action to Add the GroupWise MST Transform File to the GroupWise Windows Client Installation

  1. On the Install tab, click Add > Install File(s) to add an Install File(s) action.

    Install Files dialog box

    The Install File(s) option copies the GroupWise MST transform file to the temporary location on your local server.

  2. In the Action Name field, customize the name to clearly identify the action, for example:

    Install File groupwise.mst
    
  3. Click Add to open the Select Files dialog box.

  4. Click Add.

  5. Browse to the following directory:

    software_distribution_directory\client\win32
    
  6. Select the groupwise.mst file.

  7. (Conditional) If your version of ZENworks Configuration Management provides the Do not compress or encrypt uploaded content, select this option.

    The groupwise.mst file is very small and does not benefit from compression.

    The uploaded files display in the File list.

  8. In the Destination Directory field, specify the win32 subdirectory of the temporary directory where you created the copy of the GroupWise Windows client software, for example:

    c:\gwclient\win32
    
  9. Click OK to close the Select Files dialog box and return to the Install File(s) dialog box with the groupwise.mst file listed.

    Install File(s) dialog box with the groupwise.mst file listed
  10. (Optional) Select Run as dynamic administrator.

    The default of Run as secure system user is also appropriate for most systems.

  11. Click OK to close the Install File(s) dialog box and return to the GroupWise Bundles page with this installation task listed.

    GroupWise bundle with a second Install File(s) task
  12. Click Apply to save this installation action.

  13. Continue with Creating a Launch Executable Action.

Creating a Launch Executable Action

  1. On the Install tab, click Add > Launch Executable to add a Launch Executable action.

    Lanuch Executable dialog box

    The Launch Executable option launches the install.bat file to install the GroupWise Windows client software on users’ workstations.

  2. In the Action Name field, customize the name to clearly identify the action, for example:

    Launch Executable install.bat
    
  3. In the Command field, specify the full path to the executable file that was extracted from the setupip.fil file, for example:

    c:\gwclient\win32\install.bat
    
  4. In the Command Line Parameters field, specify one of the following parameters:

    • /unattended: Users see the window displayed by the groupwise.msi file while the GroupWise client software is being installed. The users do not need to do anything during the process, but they are informed that the installation is taking place.

    • /silent: Users see nothing happening while the GroupWise client software is being installed, so they do not know that it has occurred.

    The instructions that follow assume that /silent has been specified.

  5. In the Environment Variables box:

    1. Click Add.

      Add Environment Variable dialog box

      Two environment variables must be set in order to customize the interaction of the groupwise.msi file with the groupwise.mst file.

    2. In the Name field, specify GW_INST_TRANSFORM_FILE.

      This environment variable provides the name of the GroupWise MST transform file. The default location of the file is the same as the location of the MSI file, so you do not need to specify a full path for the file.

    3. In the Value field, specify groupwise.mst, then click OK to return to the Launch Executable dialog box.

    4. Click Add again to add the second environment variable.

    5. In the Name field, specify GW_INST_REMOVE_MSI.

      This environment variable allows for updates of previous versions of the GroupWise Windows client that were installed using the groupwise.msi file. For example, it allows the automatic removal of obsolete GroupWise icons.

    6. In the Value field, specify True, then click OK to return to the Launch Executable dialog box.

      Launch Executable dialog box with environment varieables listed
  6. Click Advanced.

    Advanced tab in the Run Script dialog box
  7. In the Wait before proceeding to next action box, select When action is complete.

  8. In the Executable security level box:

    Select Run as secure system user.

    or

    Select Run as dynamic administrator.

  9. Click OK to close the Launch Executable dialog box and return to the GroupWise Bundles page with this installation task listed.

    GroupWise bundle with a Launch Executable task
  10. Click Apply to save this installation action.

  11. (Optional) Add additional installation actions based on your preferences for how you want to install the GroupWise Windows client software.

  12. Continue with Adding a Launch Action to the GroupWise Bundle.

15.2.3 Adding a Launch Action to the GroupWise Bundle

The launch action is the command to start the GroupWise Windows client on users workstations. It is useful for testing your GroupWise bundle. You might not want to use it after you have tested your GroupWise bundle.

  1. On the GroupWise Bundle page, click Launch.

    Launch tab on the GroupWise Bundles page
  2. Click Add > Launch Executable to open the Launch Executable dialog box.

    Launch Executable dialog box
  3. In the Action Name field, customize the name to clearly identify the action, for example:

    Launch Executable grpwise.exe
    
  4. In the Command field, specify the command to start the GroupWise Windows client.

    The command depends on the architecture of the Windows workstation where the GroupWise Windows client is being installed:

    32-bit architecture:

    C:\Program Files\Novell\GroupWise\grpwise.exe
    

    64-bit architecture:

    C:\Program Files (x86)\Novell\GroupWise\grpwise.exe
    

    For testing purposes, specify the command for the architecture of workstation where you plan to test the bundle.

  5. (Conditional) If your environment includes both 32-bit and 64-bit workstations, define the system requirements for this launch action:

    1. Click Requirements > Add Filter.

      Launch Executable Requirements tab
    2. In the drop-down list, select Architecture, then select 32 or 64.

    3. Click General to return to the General tab.

    4. In the Action Name field, customize the name with the architecture you selected for the launch action.

  6. (Optional) In the Command Line Parameters field, add any desired client startup options, as listed in Startup Options for the GroupWise Windows Client in Client in the GroupWise 2012 Administration Guide.

    For this installation action, no Advanced settings are required, because the default settings of No wait and Run as logged in user are appropriate.

  7. Click OK to return to the Launch Executable dialog box.

    Launch tab of the GroupWise Buncles page with grpwise.exe listed
  8. Click Apply to save the launch action.

  9. (Conditional) If you selected an architecture requirement in Step 5, repeat Step 1 through Step 8 to create a launch action for the other workstation architecture in your environment.

  10. Continue with Displaying GroupWise Bundle Activity on User Workstations.

15.2.4 Displaying GroupWise Bundle Activity on User Workstations

By default, ZENworks Configuration Management does not display any user interface when it is installing a software bundle. You can configure the GroupWise bundle to provide feedback to the user about how the installation is progressing.

  1. On the GroupWise Bundle page, click Summary:

    GroupWise bundle Summary tab
  2. In the Show Bundle Activity field, click Yes.

    With this setting enabled, users receive messages showing status information as the GroupWise Windows software is downloaded and installed on their workstations.

  3. Continue with Section 15.2.5, Publishing the GroupWise Bundle.

15.2.5 Publishing the GroupWise Bundle

  1. On the GroupWise Bundle page, click Publish.

    Publish page

    The default setting of Publish as new version is appropriate for the GroupWise bundle.

  2. Click Finish to publish the GroupWise bundle.

    This changes the Displayed Version field from Sandbox to Published.

  3. Continue with Section 15.3, Associating the GroupWise Bundle with Devices on Your Network.