Do you have a question about the ZENWORKS 10 CONFIGURATION MANAGEMENT SP3 - SOFTWARE DISTRIBUTION REFERENCE 10.3 30-03-2010 and is the answer not in the manual?
Questions and answers
Related Manuals for Novell ZENWORKS 10 CONFIGURATION MANAGEMENT SP3 - SOFTWARE DISTRIBUTION REFERENCE 10.3 30-03-2010
Further, Novell, Inc., reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
Page 3
Novell Trademarks For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/company/legal/ trademarks/tmlist.html). Third-Party Materials All third-party trademarks are the property of their respective owners.
Page 4
ZENworks 10 Configuration Management Software Distribution Reference...
HTML formats) that you can use to learn about and implement the product. For additional documentation, see the ZENworks 10 Configuration Management SP3 documentation (http:// www.novell.com/documentation/zcm10/). Documentation Conventions In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path. About This Guide...
Page 10
® A trademark symbol ( , etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party trademark. When a single pathname can be written with a backslash for some platforms or a forward slash for other platforms, the pathname is presented with a backslash. Users of platforms that require a forward slash, such as Linux*, should use forward slashes as required by your software.
Basic Concepts ® ® Novell ZENworks Configuration Management provides great flexibility in distributing software. You can distribute applications and individual files, or simply make modifications to existing files on a device. The following sections contain additional information that is important as you begin creating and managing bundles: Section 1.1, “Bundles,”...
1.2 Assigning Bundles to Devices vs. Users You can assign bundles to both users and devices. There are differences between the two assignment types that you need to be aware of. When you assign a bundle to users, the bundle is available to all assigned users regardless of the device they log on to.
Location of Temporary Files for Linux Table 1-2 Utility Used to Create Bundle Location of Temporary Files ZENworks Control Center /opt/novell/zenworks/share/tomcat/temp/ zman (command line utility) /var/opt/novell/zenworks/content-repo/tmp/ ZENworks Migration Utility /var/opt/novell/zenworks/collection/datamodel/ 1.4 Dependency Bundles When you create the following actions for a bundle, you create bundle dependencies:...
In addition, a bundle can be both a primary bundle and a dependent bundle, as shown in the following illustration. Application A as the primary bundle, with Applications B, B1, B2, C, and D as dependent bundles. Dependency Bundle Tree Figure 1-2 In the above example, Application B is one of Application A's dependent bundles.
1.4.3 Distributing, Installing, and Launching a Bundle That Has Dependencies When setting up bundle dependencies, you should be aware of the following: Bundle Assignment: A dependent bundle does not need to be assigned to devices or users. The primary bundle, however, must be assigned to one or more devices or users for it to function properly.
To redeploy the bundle from the Devices tab, locate and click the appropriate device to display its details, then click the Content tab. In the Replication Settings list, select the check box next to the bundles, then click Include to replicate the bundle. The bundle will be redeployed according to your Content Replication settings.
Page 17
For information about performing these tasks, see “Content Delivery” in the ZENworks 10 Configuration Management System Administration Reference. Basic Concepts...
Page 18
ZENworks 10 Configuration Management Software Distribution Reference...
A bundle consists of all the files, configuration settings, installation instructions, and so forth required to deploy and manage the application or files on a device. ® ® Novell ZENworks Configuration Management lets you create bundles by using ZENworks Control Center or by using the zman command line utility.
Page 20
3 Select Directive Bundle, then click Next to display the Select Bundle Category page. 4 Select the desired bundle category: Empty Bundle: A bundle with no initial tasks. This bundle category is useful to quickly create a bundle without performing all of the tasks in the Create New Bundle Wizard. After you create the empty bundle, you can edit its details to add assignments, actions, and so forth, at a later time.
Page 21
For Mozilla Firefox*, if you have not already installed the Novell File Upload extension on this device, you must do so before you can download and install the download plug-in or browse to and upload the icon.
Page 22
Wizard Page and Field Details Add Actions page > Move Up Select the check box next to the action (or actions) you want to move up. Click Move Up. Add Actions page > Move Down Select the check box next to the action (or actions) you want to move down.
Wizard Page and Field Details Store Personality page > Select this option to specify the path of the personality migration Specify a template file on the template file on the managed device. You can also specify the UNC managed device field path of the file.
Page 24
3 Select File Bundle, then click Next to display the Select Bundle Category page. 4 Select the desired bundle category: Empty Bundle: A bundle with no initial tasks. This bundle category is useful to quickly create a bundle without performing all of the tasks in the Create New Bundle Wizard. After you create the empty bundle, you can edit its details to add assignments, actions, and so forth, at a later time.
Page 25
For Mozilla Firefox, if you have not already installed the Novell File Upload extension on this device, you must do so before you can download and install the download plugin or browse to and upload the icon.
Page 26
Select Directory page > If you have not installed the Novell File Upload extension on this Install the Novell File Upload device, you must do so before you can browse to and upload files.
Page 27
The path must be resolvable by the device on which the bundle is run. Select Files page > Install the If you have not installed the Novell File Upload extension on this Novell File Upload extension device, you must do so before you can browse to and upload files.
Page 28
Create Directory field device. Select Files page > Install the If you have not installed the Novell File Upload extension on this Novell File Upload extension device, you must do so before you can browse to and upload files. link For more information, see Appendix C, “Novell File Upload...
Page 29
The Status field displays each file’s upload status. Select Files page > Install the If you have not installed the Novell File Upload extension on this Novell File Upload extension device, you must do so before you can browse to and upload files.
Page 30
You can click Clear to remove all the files from the list. Select Files page > Install the If you have not installed the Novell File Upload extension on this Novell File Upload extension device, you must do so before you can browse to and upload files.
14 Click Finish to create the bundle as configured per settings on the Summary page. When you click Finish, the bundle is created but it does not have users or devices assigned, schedules, and group membership. At some point in the future, you need to configure additional options for the bundle by continuing with Section 3.2, “Assigning Existing Bundles to Devices,”...
Page 32
MSI package for the application and then use the MSI Application option to create a bundle. For more information on installing AdminStudio, see AdminStudio 9.5 ZENworks Edition Installation Guide (http://www.novell.com/documentation/zcm10/pdfdoc/adminstudio/ AS95ZENInstallGuide.pdf). For more information on the Software Packaging, see AdminStudio 9.5 ZENworks Edition User Guide (http://www.novell.com/documentation/zcm10/pdfdoc/adminstudio/...
Page 33
For Mozilla Firefox, if you have not already installed the Novell File Upload extension on this device, you must do so before you can download and install the download plugin or browse to and upload the icon.
Page 34
.msi Select .msi File page > If you have not installed the Novell File Upload extension on this Install the Novell File device, you must do so before you can browse to and upload files. For...
Page 35
Wizard Page and Field Details Select .msi File page > Click Add to browse to and select the desired transform file. You can Select Transforms File upload the transform file or you can specify its location. field Different groups within an organization often use the same application, but that doesn’t mean they require the same feature set.
Page 36
%ProgramFiles%\filename On 64-bit managed device: %ProgramFiles32%\filename If you have not installed the Novell File Upload extension on this device, you must do so before you can browse to and upload files. For more information, see Appendix C, “Novell File Upload Extension,” on page 105.
Page 37
\\server1\vol1\apps\notepad.exe Enter the Command to Run If you have not installed the Novell File Upload extension on this page > Install the Novell File device, you must do so before you can browse to and upload files.
Page 38
Directory* domain, enter the domain name. If the user’s name and Domain field password in the domain matches the user name and password in Novell eDirectory , the user is not prompted to log in to the terminal server when launching the application.
2.5 Creating Bundles by Using the zman Command Line Utility ZENworks Configuration Management allows you to create different types of bundles, such as Windows bundle, File bundle, Directive bundle, and Imaging bundle. Each bundle has its own set of data and configuration settings. Because it is complex to pass the data as arguments in the command line, the zman utility takes XML files as an input to create bundles.
Sample format templates, , are available WindowsMSIBundle.xml ActionInfo.xml on a Linux server and in /opt/novell/zenworks/share/zman/samples/bundles on a Windows "%ZENWORKS_HOME%\Novell\Zenworks\share\zman\samples\bundles server. For more information about , see Section 2.5.3, ActionContentInfo.xml “Understanding the zman Bundle XML File Format,” on page...
Page 41
If you want to create a new bundle with new data, continue with Step 3. If you want to create a new bundle with the same data as the officeXP bundle, skip to Step 3 Modify the files according to your officeXP.xml officeXP_ActionContentInfo.xml requirements.
ActionSets and their actions. The file does not include information about assignment of the bundle to devices or users, and add-on images for the bundle. A sample XML format template, , is available at WindowsMSIBundle.xml /opt/novell/ on a Linux server and in zenworks/share/zman/samples/bundles on a Windows server. "%ZENWORKS_HOME%\Novell\Zenworks\share\zman\samples\bundles...
Page 43
For example, the MSI file to be installed when you create the Windows MSI Bundle is associated to the first Install MSI action in the Install action set of the created Windows MSI Bundle. is specified by the attribute. It should be the same as the Action Set <ActionSet>...
Page 44
and Multicast Image Set actions. Ensure that the linked bundle already has an add-on image that was created manually, because it is not automatically created when the bundle is linked to the image bundle. ZENworks 10 Configuration Management Software Distribution Reference...
Managing Bundles ® ® The Novell ZENworks Configuration Management Software Management features let you effectively manage software and content in your ZENworks system. For information about creating Directive, File, Imaging, and Windows bundles, see Chapter 2, “Creating Bundles,” on page 19.
3.2 Assigning Existing Bundles to Devices When you create bundles, the object is created without assigning devices or users to it, or specifying distribution, launch, or availability schedules. Before the bundle can be used on assigned devices, you must complete the steps in this procedure. You can use ZENworks Control Center or the zman command line utility to assign bundles.
Page 47
3b Click the underlined link in the Name column to select the device, group, or folder and display its name in the Selected list box. 3c Click OK to add the selected devices, folders, and groups to the Devices list. 4 Specify the bundle’s shortcut location.
Install Immediately After Distribution: Performs any installation actions immediately after the bundle is distributed to the device. Launch Immediately After Installation: Performs any launch actions immediately after the bundle is installed. This option is available only if the Install Immediately After Distribution option is enabled.
Page 49
2 Select the desired bundle in the Bundles list by clicking the box next to its name, click Action, then click Assign to User. Click the desired bundle, click Relationships. In the Device Assignments panel, click Add. A bundle must be assigned to devices and users before it can be distributed to them. You can assign the bundle to individual devices, users, folders, or groups.
Page 50
System Tray: Places the icon in the system tray (notification area) of the Windows taskbar. Start Menu: Places the icon on the Start menu on all Windows devices except for Windows Vista. On Windows Vista, it places the icon in Start > All Programs. On Windows Vista device, if you want to change the look and feel of the Start menu or pin applications to the Start menu, see Appendix G, “Best Practices,”...
10 In the Schedule Type field, select one of the following schedules, then fill in the fields. For detailed information, click the Help button on the wizard page or see the following sections: Section D.1, “Date Specific,” on page 109 Section D.4, “Recurring,”...
Page 52
4 Select Add selected items to an existing group if the group to which you want to add the objects already exists. Select Create a new group to contain the selected items if you need to create a new group for the selected objects.
3.5 Renaming, Copying, or Moving Bundles Use the Edit drop-down list on the Bundles page to edit an existing object. To access the Edit drop- down list, you must select an object by clicking the check box next to the object's name in the list. Depending on the type of object you select, you can rename, copy, or move the selected object.
To specify system requirements for a bundle: 1 In ZENworks Control Center, click the Bundles tab. 2 Click the underlined link for the desired bundle to display the bundle’s Summary page. 3 Click the Requirements tab. 4 Click Add Filter, select a filter condition from the drop-down list, then fill in the fields. As you construct filters, you need to know the conditions you can use and how to organize the filters to achieve the desired results.
Page 55
Disk Space Free: Determines the amount of free disk space on the device. The condition you use to set the requirement includes a disk designation, an operator, and a value. The disk designation can be a local drive map (for example, c: or d:). The possible operators are equals (=), does not equal (<>), is greater than (>), is greater than or equal to (>=), is less than (<), and is less than or equal to (<=).
Page 56
The two conditions you can use to set the requirement are Yes and No. If you select Yes, the device must be using the Novell Client to meet the requirement. If you select No, it must not be using the Novell Client.
Page 57
equal to (>=), is less than (<), and is less than or equal to (<=). The property values vary depending on the property. For example, if you set the condition to , the version = Windows XP Versions device’s Windows version must be XP to meet the requirement. NOTE: Be aware that operating system version numbers contain four components: Major, Minor, Revision, and Build.
If the value type is Integer, ZCM compares only those values in the registry if the actual type in the registry is REG_DWORD. Leave the key value field blank to use the default value. The default value of a registry key has no name and is displayed in regedit as (Default) Registry Key and Value Exists: Determines if a registry key and value exist.
u AND v AND x AND y AND Nested Filters and Filter Sets Filters and filter sets cannot be nested. You can only enter them in series, and the first filter or filter set to match the device is used. Therefore, the order in which they are listed does not matter. You are simply looking for a match to cause the bundle to be applied to the device.
---: The bundle is not inheriting the setting and the setting is not configured directly on the bundle. In other words, the setting is not configured at the system level, the folder level, or the bundle level. To configure a setting for the bundle: 1 Click Bundle Management.
Page 61
You can define system variables at three levels: Management Zone: The system variables are inherited by the following: device folders, devices, and bundles. Device Folder: The system variables are inherited by all devices contained within the folder or its subfolders. Device or Bundle: The system variables apply only to the device or bundle for which they are configured.
3.10 Deleting a Bundle Deleting a bundle removes the bundle content from the ZENworks content servers but does not uninstall it from devices where it has already been installed. To uninstall it from devices, you should use the Uninstall options before deleting the bundle. 1 In ZENworks Control Center, click the Bundles tab.
3.12 Installing a Bundle The Install Bundle option in the Bundle Tasks list in the left navigation pane of ZENworks Control Center lets you immediately install a bundle to one or more devices. 1 In ZENworks Control Center, click the Bundles tab. 2 In the Bundles list, select the check box next to the bundle (or bundles).
4 In the Devices section, click Add to select the devices where you want to launch the bundle. 5 In the Select Objects dialog box, browse to and select the objects on which you want to launch the bundle. The Select Objects dialog box opens with the folder as the root folder.
Page 65
4 Specify the default replication behavior for new servers added to the system: New Primary Servers Will: Specify the default replication behavior for new ZENworks Primary Servers added to the system: Include This Content: Replicates the content to any servers created in the future. Exclude This Content: Excludes the content from being replicated to any servers created in the future.
This page lets you specify on which content servers (ZENworks Servers and satellite servers) the content is hosted. The relationships between content and content servers that you create using this wizard override any existing relationships. For example, if Bundle A is currently hosted on Server 1 and Server 2 and you use this wizard to host it on Server 1 only, Bundle A is excluded from Server 2 and is removed during the next scheduled replication.
3 Click Action > Disable. 3.16 Enabling a Bundle to Be Deployed 1 In ZENworks Control Center, click the Bundles tab. 2 In the Bundles list, select the check box next to the bundle (or bundles). 3 Click Action > Enable. 3.17 Enabling a Bundle to Be Uninstalled When you create a bundle, the Undo Install action is enabled by default;...
5 Select the Enable Uninstall option. The following uninstall options are available only if Enable Uninstall option is selected: User Options: Specify whether the user should be allowed to uninstall or cancel the uninstallation of an application from a device: Allow User to perform uninstall: Select this option to enable users to remove the application from their devices.
NOTE: To use the Uninstall Bundle quick task, you must enable the bundle’s uninstall options (which are disabled by default), increment the bundle’s version, and refresh the device. For more information, see Section 3.17, “Enabling a Bundle to Be Uninstalled,” on page 67 Section 3.11, “Incrementing a Bundle’s Version Number,”...
Because you are removing the bundle from devices, the Add Assignments dialog box opens with the folder as the root folder. By default, the folders Devices Servers Workstations are displayed along with any custom folders that you have created in the folder.
5 Specify how often you want the bundle’s install actions performed: Install once per device: Performs the bundle’s install actions once on each managed device. Install once per user per device: Performs the bundle’s install actions once for each user on each managed device.
5 Fill in the fields: Run Once: Select this option to configure the bundle’s launch actions, then select one of the following options. If you do not select this option (the default), the launch actions are performed each time a user launches the application contained in the bundle. For each device: Launches the bundle’s actions once on each managed device.
Page 73
5 Select the Enable Uninstall option. The following uninstall options are available only if Enable Uninstall option is selected: User Options: Specify whether the user should be allowed to uninstall or cancel the uninstallation of an application from a device: Allow User to perform uninstall: Select this option to enable users to remove the application from their devices.
2 In the ZENworks Reporting Server Reporting panel, click ZENworks Reporting Server InfoView to launch the ZENworks Reporting Server InfoView. 3 Navigate to the Novell ZENworks Reports > Predefined Reports > Bundles and Policies folder. ZENworks 10 Configuration Management Software Distribution Reference...
Page 75
4 The following predefined reports are included for bundles: Assigned Bundles and Policies by Device: Displays information on all the bundles and policies that are assigned to a particular device. Bundle Deployment Status: Prompts for the device name, deployment status, and bundle name and displays the deployment details of the bundle.
Page 76
ZENworks 10 Configuration Management Software Distribution Reference...
Managing Bundle Groups A bundle group lets you group bundles to ease administration and to provide easier assigning and scheduling of the bundles in the bundle group. ® You can use ZENworks Control Center or the zman command line utility to create bundle groups. This section explains how to perform this task using the ZENworks Control Center.
Folder: Type the name or browse to and select the ZENworks Control Center folder where you want the bundle to reside. The default is , but you can create additional folders to /bundles organize your bundles. If you want to create the group in another folder, browse to and select the folder. By default, the group is created in the current folder.
2 In the Bundles list, select the box next to the bundle group’s name, click Edit, then click an option: Rename: Click Rename, provide a new name for the folder, then click OK. Move: Click Move, select a destination folder for the selected objects, then click OK. 4.3 Copying a Bundle Group’s System Requirements 1 In ZENworks Control Center, click the Bundles tab.
Page 80
4 Browse for and select the devices, device groups, and device folders to which you want to assign the group. To do so: 4a Click next to a folder (for example, the folder or folder) to Workstations Servers navigate through the folders until you find the device, group, or folder you want to select. If you are looking for a specific item, such as a Workstation or a Workstation Group, you can use the Items of type list to limit the types of items that are displayed.
Install Immediately After Distribution: Performs any installation actions immediately after the bundle is distributed to the device. Launch Immediately After Installation: Performs any launch actions immediately after the bundle is installed. This option is available only if the Install Immediately After Distribution option is enabled.
Page 82
4 Browse for and select the user, user groups, and user folders to which you want to assign the group. To do so: 4a Click next to a folder to navigate through the folders until you find the user, group, or folder you want to select.
Page 83
The distribution schedule defines the dates and times when the bundle is distributed from the ZENworks Server to the managed device. The default schedule (no schedule) causes the bundle to be distributed to the device when it is first launched. 8 In the Schedule Type field, select one of the following schedules, then fill in the fields.
14 Click Next to display the Finish page, review the information and, if necessary, use the Back button to make changes to the information. 15 Click Finish. 4.7 Adding a Bundle to a Group For more information, see Section 3.4, “Adding a Bundle to a Group,” on page 51 4.8 Copying a Bundle Group to a Content Server By default, a bundle is copied to each content server.
Managing Folders A folder is an organizational object. You can use folders to structure your bundles and bundle groups ® into a manageable hierarchy for your ZENworks system. For example, you might want a folder for each type of bundle (Directive Bundles folder, Windows Bundles folder, File Bundles folder, and so forth), or, if applications are department-specific, you might want a folder for each department (Accounting Department folder, Payroll Department folder, and so forth).
Depending on the type of object you select, you can rename, copy, or move the selected object. For example, if you select a Bundle object, you can rename, copy, and move the bundle. If you select a Folder object, you can rename or move the Folder object, but not copy it. If the option is dimmed, that option is not available for the selected object type.
ZENworks Adaptive Agent ® ® The ZENworks Adaptive Agent is part of the Novell ZENworks Configuration Management software that lets your administrator manage devices over the network. NOTE: This section contains information from the Adaptive Agent online Help system and is written from the perspective of the end-user.
“Using the Command Prompt” on page 89 “Using the ZENworks Window as the Windows Shell” on page 90 Using the Start Menu 1 Click Start > Programs > Novell ZENworks > ZENworks Application Window ZENworks 10 Configuration Management Software Distribution Reference...
Page 89
The ZENworks Window left pane displays the following: [All] folder: Contains all bundles that have been distributed to you, regardless of the folder in which they are located. ZENworks folder: Contains all bundles that have not been assigned to a different folder. The ZENworks folder is the default folder for bundles;...
1 On the Windows 2000/XP workstation, run and locate the following setting: regedit.exe HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon 2 Change the SHELL value from explorer.exe c:\program files\novell\zenworks\nalwin.exe If you want the ZENworks Window to be maximized when it comes up, add the switch to /max (for example, nalwin.exe nalwin.exe /max...
Bundles Displayed in Windows Explorer Figure 6-1 Bundles Displayed on the Desktop Figure 6-2 You can perform the same tasks on the bundles in the ZENworks Explorer as you can in the ZENworks Window. NOTE: Windows does not allow certain characters in folder paths ( \ / : * ? “< > | ). If you use any of these characters as part of the name of the ZENworks Explorer folder path, each character displays as an underscore ( _ ) in the Start menu.
The bundle list includes the following information: Name: Displays the name of the bundle. Click the name to display the properties for the bundle, including such information as the version, folder and icon locations, and help contacts. Status: Displays the installation status for the bundle. Effective: Displays whether or not the bundle can be used on the device.
To launch a bundle: 1 Access the bundle in one of the following locations: ZENworks Window: From the Start menu, click Programs > Novell ZENworks > ZENworks Window. ZENworks Explorer: Open Windows Explorer and find the ZENworks Adaptive Agent entry.
In addition, if the bundle is unavailable, you can see if it is unavailable because of system requirements or schedule restrictions. 1 Access the bundle in one of the following locations: ZENworks Window: From the Start menu, click Programs > Novell ZENworks > ZENworks Window. ZENworks Explorer: Open Windows Explorer and find the ZENworks Adaptive Agent entry.
Install, Uninstall, and Repair Parameters While creating Windows MSI bundles, you can select install, uninstall, and repair parameters. The following sections contain information to help you select the desired options: Section A.1, “Install Parameters,” on page 95 Section A.2, “Uninstall Parameters,” on page 97 Section A.3, “Repair Parameters,”...
A.1.1 Restart Options In some cases, installing an application requires restarting the workstation. In the Install Parameters dialog box, select the desired Restart option: None (default): Uses the MSI application’s settings to determine whether or not a restart occurs. ® ZENworks does not force a Restart option.
Install (/i): Installs the application. Administrative Install (/a): Creates an administrative installation point for the application. This option is useful for a network installation. For All Users (/im): Advertises the application on the computer and installs the application for all users on first use.
Section A.2.2, “Display Options,” on page 98 Section A.2.3, “Command Line Parameters,” on page 98 A.2.1 Restart Options In some cases, uninstalling an application requires restarting the workstation. SIn the Uninstall Parameters dialog box, select the desired Restart option: None (default): Uses the MSI application’s settings to determine whether or not a restart occurs. ZENworks does not force a Restart option.
Always Restart (/forcerestart): Forces the workstation to restart without prompting users. A.3.2 Display Options In the Repair Parameters dialog box, select the desired Display options. You can choose to perform the repair process with or without a user interface, whether to display a modal dialog box at the end of the repair process (a modal dialog box demands a response from the user before the repair process is complete), or to hide the Cancel button so that users cannot cancel the repair process.
Failed Checksum (c): Instructs Windows Installer to perform a checksum on all executable files and to repair a file if it is missing or if the checksum verifies that the file is corrupt. Only files that have in the Attributes column of the MSI package’s File Table msidbFileAttributesChecksum are repaired.
Page 102
102 ZENworks 10 Configuration Management Software Distribution Reference...
Authentication Hook An authentication hook enables you to control the installation or launching of the bundle. Create an executable file containing your authentication logic and begin its name with authhook For example, . During the installation or launching of the bundle, the bundle authhookinstall.exe ®...
Page 104
104 ZENworks 10 Configuration Management Software Distribution Reference...
Section C.2, “Reinstalling the Novell File Upload Extension,” on page 106 C.1 Installing the Novell File Upload Extension The Novell File Upload extension must be installed on the device before you can browse for file paths and upload files. C.1.1 On Mozilla Firefox Perform the following steps: 1 Click the Install the Novell File Upload extension link.
If you are running Internet Explorer (assuming that you are using the default settings and have not marked Novell as trusted), the following message displays in the information bar: To help protect your security, Internet Explorer stopped this site from installing an ActiveX control on your computer.
Page 107
2 Install ZENworks 10 Configuration Management File Upload extension. You are prompted to install the latest Novell File Upload Extension the next time you use ZENworks Control Center to browse for file paths and upload files. Follow the prompts to install the Novell File Upload extension. For more information, see Section C.1, “Installing the Novell File Upload...
Page 108
108 ZENworks 10 Configuration Management Software Distribution Reference...
Bundle Schedules Types The following schedules are available: Section D.1, “Date Specific,” on page 109 Section D.2, “Event,” on page 110 Section D.3, “Now,” on page 111 Section D.4, “Recurring,” on page 111 D.1 Date Specific The Date Specific scheduling option lets you specify one or more dates on which to run the event. Date Specific Schedule Figure D-1 Start Dates: Click...
Use Coordinated Universal Time (UTC): The Start Time is converted to Universal Coordinated Time (UTC). Select this option to indicate that the Start Time you entered is already in Coordinated Universal Time and should not be converted. For example, suppose you are in the Eastern time zone. If you enter 10:00 a.m.
changes can show up on the device, even if one of the event triggers occur. By default, devices refresh randomly between 300 and 360 seconds after device startup with a full refresh every 12 hours. For example, if you create a bundle and schedule it to launch when the device connects to the network, the device must be manually refreshed or refreshed according to schedule before the Adaptive Agent can upload or launch the bundle, even if the device connects to the network.
Page 112
When a Device Is Refreshed: This schedule causes the event to occur each time the ZENworks Adaptive Agent performs a refresh on the device. If you want to delay the event so that it does not happen immediately upon refresh, select the Delay execution after refresh option and specify the number of days, hours, or minutes you want to delay the event.
Page 113
Start at a Random Time between Start Time and End Time: Starts the event at a randomly selected time between the time you specify in the Start Time and End Time boxes. You can use this option to avoid possible network overload from concurrently scheduled events. Restrict Schedule Execution to the Following Date Range: Limits running of the event to the time period specified by the starting and ending dates.
Page 114
114 ZENworks 10 Configuration Management Software Distribution Reference...
Actions The Actions panel displays the action sets available for the bundle. Depending on the bundle type, the possible action sets are Distribute, Install, Launch, Verify, Uninstall, Terminate, and Preboot. For example, if you select a Windows bundle, five actions sets are available. If you select an Imaging bundle, Preboot is the only available action set available.
You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category. For more information, see Section 2.1, “Creating Directive Bundles,” on page In ZENworks Control Center, click the Bundles tab, click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click the Add drop-down list, then select the Apply Personality action.
Page 118
Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an available action. Source Directory: If you have not installed the Novell File Upload extension on this device, you must do so before you can browse for a directory. For more information, see Novell File Upload Extension.
Copy If Does Not Exist: Copies the contents of the directory only if the files does not currently exist on the workstation. Copy If Newer: Copies the contents of the directory only if the modified date and time of the file is newer than the existing file’s date and time, or if the files does not currently exist on the workstation.
Page 120
Action - Copy Files Dialog Box Figure E-3 You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category. For more information, see Section 2.1, “Creating Directive Bundles,” on page In ZENworks Control Center, click the Bundles tab, click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an...
NOTE: Performing this action as dynamic administrator on a Windows domain controller fails because Microsoft does not allow the use of local administrator accounts on domain controllers. E.4 Action - Create/Delete Directory The Action -Create/Delete dialog box lets you create or delete directory on the managed device. Action - Create/Delete Directory Dialog Box Figure E-4 You can access this dialog box by using the following methods:...
set to Secure, the application's interface is not displayed to the user and the application is only visible in the Task Manager. This option is useful when running applications that require full access to the workstation but require no user intervention. Run as dynamic administrator: A dynamic administrator is an administrator account that is created on the fly to perform certain procedures, such as installing applications.
Wait for Processes or Services to Start: Specify the processes or services that must start before the next action in the action set is performed. To add a process or service to the list: 1 Click Add to display the Add Service/Process dialog box. 2 Select Process, specify the process that must start before performing the next action, then click OK.
Define Prompts: Define the prompt that you want to display on the device. Additionally, you can specify different locales with different messages. To create a message: 1 Click Add to display the Select Locale and Prompt dialog box. 2 Select a language from the Locale drop-down list. The message displays only on devices in the specified locale.
E.8.2 Encoding Specify the encoding that you want to use: Auto detect: Use the encoding used in the original file that you specified in the Filename field. This is the default option. ASCII: Use ASCII encoding. Unicode: Use Unicode* encoding. UTF-8: Use UTF-8 (8-bit UCS/Unicode Transformation Format) encoding.
Page 126
You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category. For more information, see Section 2.1, “Creating Directive Bundles,” on page In ZENworks Control Center, click the Bundles tab, click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an available action.
Task Steps Additional Details Change the order of 1. Select the check box next to an items item, click Edit, then select an option (Sort, Move Up, Move Down). Select all the objects 1. Select the check box next to the of a parent folder parent folder, then click Edit >...
Comment Character: Specify the character you want precede comments in the INI file. You can use a semicolon (;) or a pound sign (#). Append key-value separator to the key when value is not available: Select this option to append the key-value separator to the key even if the value is not available.
Page 129
You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category. For more information, see Section 2.1, “Creating Directive Bundles,” on page In ZENworks Control Center, click the Bundles tab, click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an available action.
Run Action As: Specify System (the default) or User from the Run Action As list. Specify System if removing files requires access to all areas of the device’s file system. If you use mapped network drives to specify files and directories, you must run the action as User. E.10 Action - End Process The Action - End Process dialog box lets you specify the executable name of the process that you want to stop (for example,...
Page 131
Action File Removal Dialog Box Figure E-11 You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category. For more information, see Section 2.1, “Creating Directive Bundles,” on page In ZENworks Control Center, click the Bundles tab, click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an...
You can also use this page to install the Novell File Upload extension, which allows you to browse for directories.
Page 133
If you have not installed the Novell File Upload extension on this device, you must do so before you can browse to and upload directories to be installed. For more information, see “Novell File Upload...
Page 134
Read-Only: Select the Read-only check box to specify that the directory is read-only after installation. Copy Option: Select a copy option from the list: Copy Always: Copies the contents of the directory regardless of whether the files currently exists on the workstation. Copy If Exists: Copies the contents of the directory only if the files currently exists on the workstation.
E.14 Action - Install Files The Action - Install Files dialog box lets you specify the file to copy to the content server and from content server to the device, the destination directory and filename, and the copy options. Action - Install Files Dialog Box Figure E-14 You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category.
Page 136
Open. Repeat this step as many times as necessary to copy the desired files. If the Novell File Upload extension is not installed on this device, you must install it before you can browse for file paths. For more information, see “Novell File Upload Extension”...
Copy Option: Select a copy option from the list: Copy Always: Copies the file regardless of whether the file currently exists on the workstation. Copy If Exists: Copies the file only if the file currently exists on the workstation. Copy If Does Not Exist: Copies the file only if the file does not currently exist on the workstation.
Page 138
Select .msi File dialog box. Browse to and select the file to .msi install. If you have not installed the Novell File Upload extension on this device, you must do so before you can browse to and upload files. For more information, see “Novell File Upload Extension” on page 105.
Page 139
Transform File: Click Add to browse to and select the desired transform file. You can upload the transform file or you can specify its location. If you have not installed the Novell File Upload extension on this device, you must do so before you can browse for a file path. For more information, see “Novell File Upload Extension”...
If the logged-in user's security level does not provide sufficient rights and file access to run the application, you can configure the application to run in the “system” space or as a dynamic administrator, as described below: Run as logged in user: The MSI application inherits the logged-in user’s credentials. For example, the application has the same rights to the registry and the file system as the logged-in user.
Page 141
.msp If you have not installed the Novell File Upload extension on this device, you must do so before you can browse for a file path. For more information, see “Novell File Upload Extension” on page 105.
Run as secure system user (Don't allow system to interact with desktop): The application is run under the Local System user and inherits Administrator-level credentials. For example, the application has full rights to the registry and the file system. Because the security level is set to Secure, the application's interface is not displayed to the user and the application is only visible in the Task Manager.
Page 143
.msi File: Specify the file to install. .msi If you have not installed the Novell File Upload extension on this device, you must do so before you can browse for a file path. For more information, see “Novell File Upload Extension” on page 105.
Page 144
Transform File: Click Add to browse to and select the desired transform file. You can upload the transform file or you can specify its location. If you have not installed the Novell File Upload extension on this device, you must do so before you can browse to for a file path. For more information, see “Novell File Upload Extension”...
If the logged-in user's security level does not provide sufficient rights and file access to run the application, you can configure the application to run in the “system” space or as a dynamic administrator, as described below: Run as logged in user: The MSI application inherits the logged-in user’s credentials. For example, the application has the same rights to the registry and the file system as the logged-in user.
Action - Launch Bundle Dialog Box Figure E-19 You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category. For more information, see Section 2.1, “Creating Directive Bundles,” on page In ZENworks Control Center, click the Bundles tab, click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an...
Page 147
(Distribute, Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an available action. Java Program Name: Specify the Java program name. For example, com.novell.TestProg Program Parameters: Specify the program parameters. Path to Java Runtime Executable (JRE): Specify the path to the Java Runtime Executable (JRE*).
Working Directory: Click More Options to specify the Java application’s working directory. Specify the initial working directory for the application. Priority: Click More Options to specify the Java application’s priority. Specify the priority of the process that runs the application. This option lets you configure how much of the CPU usage the application process consumes.
Click Test URL to open a Web browser to verify that the URL is correct. E.21 Action - Launch Executable The Add Actions - Launch Windows Executable dialog box lets you specify the Windows executable, command line parameters, and additional optional settings. Actions - Launch Executable Dialog Box Figure E-22 You access this dialog box by using the following methods:...
Click Add to browse to and select the desired transform file. You can upload the transform file or you can specify its location. If you have not installed the Novell File Upload extension on this device, you must do so before you can browse for a file path. For more information, see...
Page 151
Field Description Executable Security Click More Options to specify the Window executable’s security level. Level The executable can run in either the “user” space or the “system” space. By default, the Run normal option is selected, which causes the application to run in the “user”...
Field Description Wait Before Click More Options to specify how long to wait after launching the Windows Proceeding to Next executable and before proceeding to the next action. Action Specify what happens after the executable launches: No wait: The next action in the list is immediately performed. When launch action is complete: The next action in the list is performed after the launch action completes.
Field Description Display Click More Options to specify the Window executable’s display settings. Select the desired display options: Run in 256 colors: Sets the color quality setting to 256 colors while this executable is running. The color quality setting reverts back to your default setting when you close the executable.
Action - Launch Windows Thin Client Application Dialog Box: ICA Session Figure E-23 Published Application Name: Type the published application name exactly as it is defined in Citrix. Servers Hosting the Application: Add the Citrix servers that host the application. 1 Type the server’s IP address or hostname.
Page 155
Server Domain: If the terminal server is part of a Windows NT domain or an Active Directory domain, specify the domain name. If the user’s name and password in the domain matches the user name and password in Novell eDirectory , the user is not prompted to log in to the terminal server when launching the application.
Advanced Settings for redirection: Select the settings, such as drivers, printers, serial ports, and smart cards, that you want to map to the remote desktop machine. E.23 Action - Prompt User The Action - Prompt User dialog box lets you specify that a prompt displays on the device and configure its settings.
How Often to Prompt: Select the desired option: Always: Display the prompt every time the action is performed. Once per device: Display the prompt once on the device, regardless of how many users log in. Once per user: Display the prompt once per user, regardless of how many devices the user logs in to.
Page 158
Action - Reboot/Shutdown Dialog Box Figure E-26 You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category. For more information, see Section 2.1, “Creating Directive Bundles,” on page In ZENworks Control Center, click the Bundles tab, click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an...
message displays indefinitely until the user clicks OK to perform the reboot or shutdown process. If you select both this option and the Allow user to cancel option, a message displays indefinitely until the user clicks OK or Cancel. A value of -1 causes the device to wait an indefinite period of time, essentially preventing the device from rebooting or shutting down.
You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category. For more information, see Section 2.1, “Creating Directive Bundles,” on page In ZENworks Control Center, click the Bundles tab, click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an available action.
Page 161
2. Specify the key’s name. For example, Software. You can also specify multiple levels of keys by separating them with a backslash (\). For example, Novell\ZENworks\Zfd. Do not use the forward slash (/) as a separator. 3. Select one of the following registry operations: Create Always: Creates the key regardless of whether the key currently exists in the workstation’s registry.
Page 162
Task Steps Add a registry 1. Select the check box next to the desired item, then click Value to display the Add value Value To dialog box. 2. Select one of the following options from the Value Type list: Default: Adds a default string value to the selected key. String: Adds a string value to the selected key.
Task Steps Rename an 1. Select the check box next to the desired item, then click Edit > Rename. entry 2. Specify the new name. Remove an 1. Select the check box next to the desired item, then click Delete. entry Import the 1.
Take a Backup of the Registry Before Applying the Registry File: Select the check box, then specify the path to the backup file, for example, c:\BackupFile.reg If you select this option, the entire registry is backed up before importing the configured registry file.
Page 165
Action - Run Script Dialog Box Figure E-29 Script Filename: Specify the path to the script file on the target device, for example, C:\scripts\xyz.pl Script Parameters: Specify any additional parameters you want to place on the command line after the script filename is specified. This results in parameters being passed to your executable script. Path to Script Engine: Specify the interpreter that launches to run your script.
If a script returns non-zero success codes, you should specify these non-zero success codes while launching the action. For example, explorer.exe in Windows returns a success code of 1. To successfully launch the Explorer application, you should add 1 as the success code while launching the action.
Page 167
Action - Run Script Dialog Box Figure E-30 Script Content: Click Edit to display a text box where you type your script. This script is delivered to the assigned devices and is executed in the standard device shell environment. For example, you can automate drive mapping using the script capabilities of bundles. Your bundle’s script could read: net use m: \\server\sys net use w: \\server\vol1...
Wait for _ seconds: Wait the specified number of seconds before proceeding to the next action. Terminate action if wait period exceeded: If you select the Wait for _ seconds option, this option is enabled. If the specified number of seconds is exceeded and the action is not successfully performed, the action is terminated.
Page 169
Action - Run Script Dialog Box Figure E-31 Select From This Device: Browse to and select the script file. Script Parameters: Specify any additional parameters you want to place on the command line after the script filename is specified. This results in parameters being passed to your executable script. Path to Script Engine: Specify the interpreter that launches to run your script.
Run As: Click More Options to specify the script’s run as setting. Specify an option: System: Runs the script as the system account (as a service). Administrator: Runs the script as a dynamic administrator user. A dynamic administrator is an administrator account that is created on the fly to perform certain procedures, such as installing applications or running scripts.
E.28 Action - Store Personality The Store Personality page lets you specify the personality migration template and the path where the Platform Neutral Package (PNP) file is to be created. Action - Store Personality Dialog Box Figure E-33 You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category.
Span to multiple files You can choose to span the personality migration data across multiple files to enable you to store data in removable media. The available options are: Never span. Select this option to migrate personalities without spanning the files. Span at the size.
2 Select a language from the Locale drop-down list. The message displays only on devices in the specified locale. You can create different messages, each with its own locale setting. 3 Specify the text you want to display on the device. You can include in your text to provide a running counter that counts down the number of seconds to 0, after which the prompt is auto-accepted.
Seconds to be Displayed: Specify the number of seconds that the prompt is displayed before the action is performed. For example, suppose you configure a prompt to notify the user that an application is in the process of terminating. If you specify that the prompt display for 10 seconds, the prompt displays for 10 seconds, then the application terminates.
Action - Uninstall Bundle Dialog Box Figure E-36 You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category. For more information, see Section 2.1, “Creating Directive Bundles,” on page In ZENworks Control Center, click the Bundles tab, click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an...
You access this dialog box by using the following methods: As part of the process of creating a Directive bundle by using the Actions bundle category. For more information, see Section 2.1, “Creating Directive Bundles,” on page In ZENworks Control Center, click the Bundles tab, click the underlined link of a bundle in the Name column of the Bundles list, click the Actions tab, click one of the action set tabs (Install, Launch, Verify, Uninstall, Terminate, or Preboot), click the Add drop-down list, then select an available action.
Troubleshooting The following sections explains the scenarios that you might encounter while using the Bundles ® ® component of Novell ZENworks 10 Configuration Management. “Unable to locate the active text box in the user interface of ZENWorks Control Center” on page 177 “Uploading content from a text file to a Directive bundle corrupts the content”...
While launching applications, the window prompting for user input might not be displayed Source: ZENworks 10 Configuration Management; Software Distribution. Explanation: If you use bundles to launch applications that require user input, the window prompting for the input might be hidden behind the application. This problem might occur if the applications are launched for the first time for each user login.
Explanation: Because Linux devices cannot have the ZENworks Adaptive Agent, you cannot assign bundles to be sent to them. However, in ZENworks Control Center, Directive bundles assigned to a Linux device might show as effective, which is incorrect. Action: Ignore. Cannot back up the registry and edit the HKEY_CURRENT_USER by using a single registry action on a Windows Vista device Source: ZENworks 10 Configuration Management;...
Explanation: If a bundle having the distribution schedule configured is assigned to a managed device such that the Wake-on-LAN schedule is behind the server’s time zone, the device fails to wake up. Action: Ensure that the Wake-on-LAN schedule on the managed device is not behind the server’s time zone.
Page 181
4 In the Repair Parameters option, Click to display the Repair Parameters dialog box. 5 In the Command Line Parameters option, specify instead of , then click OK. 6 In the MSI Properties panel, add the following properties: Name = REINSTALLMODE ; Value = omus Name = REBOOT ;...
Page 182
182 ZENworks 10 Configuration Management Software Distribution Reference...
The following sections contain information on the best practices to follow while using the Bundles ® ® component of Novell ZENworks 10 Configuration Management: Section G.1, “Changing the Look and Feel of the Start Menu on a Windows Vista Device,” on page 183 Section G.2, “Pinning Applications to the Start Menu on a Windows Vista Device,”...
G.4 ZENworks Explorer Folder Naming Convention If the ZENworks Explorer Folder name for two or more bundles is the same but has a different case, then only one folder and containing all the bundle's shortcuts is displayed in the start menu and the ZENworks Explorer window.
Macros ® ® The following sections contain information on the macros supported in Novell ZENworks Configuration Management: Section H.1, “Windows Macros,” on page 185 Section H.2, “Login Script Macros,” on page 187 H.1 Windows Macros A Windows macro is one that defines the Windows directories. The typical paths listed below are based on default installations and might not match your specific setup.
Page 186
Macro Description ${CommonAppData} File system directory that contains the application-specific data for all users who log in to Windows 2000/XP. Typically C:\Documents Settings\All Users\Application Data ${CommonDocuments} File system directory that contains the documents shared by all users who log in to Windows 2000/XP. Typically C:\Documents Settings\All Users\Documents ${CommonTemplates}...
Macro Description ${SendTo} File system directory that contains Send To menu items. Typically C:\Documents and Settings\username\SendTo ${StartMenu} File system directory containing Start menu items. Typically C:\Documents and Settings\Username\Start Menu ${Startup} File system directory that corresponds to the user’s Startup program group.
Page 188
Macro Description ${LAST_NAME} Last name of the current user (also known as the user’s eDirectory Surname attribute). For example: Jones. ${MINUTE} Current minute. For example: 02, 59. ${MONTH} Current month number. For example: 01 for January. ${NDAY_OF_WEEK} Numeric day of the week. For example: 1 for Sunday, 2 for Monday. ${NETWORK} Workstation network address.
Documentation Updates This section contains information on documentation content changes that were made in this ® ® ZENworks Software Distribution Guide for Novell ZENworks 10 Configuration Management SP3. The information can help you to keep current on updates to the documentation.
Page 190
Location Change Entire Guide Replaced all instances of AdminStudio 9.0 ZENworks Edition Installation Guide with AdminStudio 9.5 ZENworks Edition Installation Guide and AdminStudio 9.0 ZENworks Edition User Guide Guide to AdminStudio 9.5 ZENworks Edition User Guide because ZENworks 10 Configuration Management SP3 currently supports AdminStudio 9.5. 190 ZENworks 10 Configuration Management Software Distribution Reference...
Need help?
Do you have a question about the ZENWORKS 10 CONFIGURATION MANAGEMENT SP3 - SOFTWARE DISTRIBUTION REFERENCE 10.3 30-03-2010 and is the answer not in the manual?
Questions and answers