To install the Novell Application Launcher plug-in on a workstation:
Make sure you've run the ZENworks Middle Tier Server installation program so that the Novell Application Launcher plug-in installation manager, Novell Application Launcher plug-in files, and myapps.html file have been copied to a Web server. If necessary, see Section 10.0, Installing the ZENworks Middle Tier Server.
(Optional) Modify the myapps.html page
In addition to launching the Novell Application Launcher plug-in installation manager, the myapps.html page contains parameters that determine the functionality and look of the Application Browser view used with the Novell Application Launcher plug-in and Application Launcher. You might want to use these parameters to customize the Application Browser view before it is distributed to users.
IMPORTANT:When you install the Middle Tier Server, the Middle Tier Server's private (internal) address is added to the myapps.html file. If users will run the Application Browser outside your firewall, you need to ensure that the myapps.html file lists the Middle Tier Server's public (external) IP address, if the two addresses are different. The myapps.html file's MiddleTierAddress parameter is used to specify the IP address.
The myapps.html file loads an ActiveX* control (axnalserver.dll) that is used to generate the Application Browser view. You customize the Application Browser view by modifying the parameters that are passed to the ActiveX control. There are nine parameters, shown below.
<!--param name=\"SingleTree\" value=\"ZENWORKS_TREE\"--> <!--param name=\"PortalView\" value=\"false\"--> <!--param name=\"BannerURL\" value=\"http://www.company.com/banner.html\"--> <!--param name=\"BannerHeight\" value=\"80\"--> <!--param name=\"ShowTree\" value=\"true\"--> <!--param name=\"ShowTasks\" value=\"false\"--> <!--param name=\"AppDisplayType\" value=\"0\"--> <!--param name=\"ShowAppFrameNavigation\" value=\"true\"--> <!--param name=\"ShowIEToolbarButton\" value=\"true\"-->
In addition, when you use the Novell Application Launcher plug-in installation manager to download the myapps.html file from a Middle Tier Server, you can customize two additional parameters that are used by the installation manager:
<!--param name=\"MiddleTierAddress\" value=\"$$IPADDR$$\"--> <!--param name=\"Nt4PluginVersion\" value=\"4,0,1,0\"-->
By default, the parameters are commented out, which results in the ActiveX control using its preset internal values. To modify a parameter:
Remove the !-- (beginning comment) and the -- (ending comment) to activate the parameter. For example:
<param name=\"SingleTree\" value=\"novell_tree\"
Modify the parameter's value. Each parameter is described below.
SingleTree: This parameter lets you specify a single Novell eDirectory™ tree from which to read application information. If this parameter is used, Application Launcher ignores any other trees to which the user authenticates.
This parameter applies only at installation time. After installation, changes to this parameter have no affect.
PortalView: This parameter lets you better support portals by removing the banner section of the Application Browser view. The value settings are True or False. True removes the banner section.
BannerURL: This parameter applies only if the PortalView parameter is set to False.
You can use this parameter to specify an alternate banner. For example, you could use a banner that contains your company's logo instead of the Novell logo. The value setting must be a URL to an HTML page or graphics file (.gif, .jpg, etc.). If you specify an HTML page, the page is cropped to the height specified by the BannerHeight parameter. If you specify a graphics file, the banner section scrolls to fit the entire graphics file. Unless you want the banner section to be scrollable, you should ensure that the graphic's height is not greater than the height specified in the BannerHeight parameter.
BannerHeight: This parameter applies only if PortalView parameter is set to False and the default Novell banner is being overridden by the BannerView parameter.
You can use this parameter to determine the height of the banner section. The value setting must be from 5 to 200. Any number less than 5 is rounded up to 5. Any number greater than 200 is rounded down to 200.
ShowTree: This parameter determines whether or not the Application Browser view includes the left pane (referred to as the folder view). The value settings are True and False. True causes the folder view to display, and False causes it to be removed.
ShowTasks: This parameter determines whether or not the folder view (left pane) includes the Work Online/Work Offline, MiddleTier Log In/Middle Tier Log Out, Refresh Applications, and Help options. The VALUE settings are True and False. True causes the options to display, and False causes them to be removed.
AppDisplayType: This parameter determines how the applications are displayed in the right pane of the Application Browser view. The value settings are 0 and 1. The default setting, 0, causes the application icons to display as large icons, similar to the Large Icons view in Windows Explorer. The 1 setting causes the applications to be listed in table format, similar to the List view in Windows Explorer.
ShowAppFrameNavigation: This parameter determines whether or not the right pane of the Application Browser view includes navigation. The VALUE settings are True and False. True causes the right pane to include navigation. The type of navigation depends on the setting for the AppDisplayType parameter:
When the AppDisplayType parameter is set to 0 (large icons), navigation is displayed as a breadcrumb trail (for example, ZENworks Tree > Application Folder > Application A).
When the AppDisplayType parameter is set to 1 (small icons), navigation is displayed as an Up arrow at the top of the applications list.
Setting this parameter's value to False causes the Application Browser view to start with the All folder open, meaning that all application icons are displayed in the right pane. If the All folder is disabled in the user's Launcher Configuration settings in ConsoleOne®, this parameter is ignored (in other words, the default value of True is used).
ShowIEToolbarButton: This parameter determines whether or not the Application Browser button is added to the Internet Explorer toolbar. The Application Browser button launches the local version of the myapps.html file. The VALUE settings are True and False. The True setting is the default setting and causes the Application Browser button to be added to the toolbar. The False setting causes the Application Browser button to be removed from the toolbar. Whenever this setting is changed, the user must close Internet Explorer and then reopen it for the change to take affect.
MiddleTierAddress: This parameter applies only if you've configured a ZENworks Middle Tier Server for access to eDirectory.
The MiddleTierAddress parameter lets you specify the IP address of the Middle Tier Server that the user authenticates to. It is used only if a Middle Tier Server address is not included in the Windows registry; the registry includes the address if the user entered it when running the ZENworks Desktop Management Agent installation program.
Nt4PluginVersion: This parameter applies only when upgrading from ZENworks for Desktops 4.0.1. It applies only to Windows NT 4 workstations and specifies the minimum version of the ZENworks for Desktops 4.0.1 Novell Application Launcher plug-in that must be running on the workstation. For example, if the workstation has version 4,0,1,0 and this parameter specifies 4,0,1,3, the Application Browser view runs only if the Novell Application Launcher plug-in installation manager can download version 4,0,1,3 or higher of the Novell Application Launcher plug-in .cab file (zfd40.cab) from the ZENworks Middle Tier Server. On the other hand, if the workstation has 4,0,1,3 and this parameter specifies 4,0,1,0, the installation manager does download the Novell Application Launcher plug-in from the Middle Tier Server even if the plug-in is a newer version (such as 4,0,1,4).
Save the file.
Test the setup by accessing the myapps.html page.
If you access the myapps.html page from a workstation where Novell Application Launcher or the Novell Application Launcher plug-in is already installed, the Application Browser view is displayed in the Web browser. No files are downloaded.
If you access the myapps.html page from a workstation where Novell Application Launcher and the Novell Application Launcher plug-in are not installed, the Novell Application Launcher plug-in installation manager is installed and registered. It then begins installing the Novell Application Launcher plug-in files.
Each .cab file used during the installation process includes a Novell signed certificate. You are prompted to accept the certificate before the installation can proceed. You can accept each certificate individually, or you can select the option displayed with the first certificate to accept all subsequent Novell signed certificates.
When installation is complete, you can access your user-associated applications through both the Application Browser view (by accessing the myapps.html page again) and the Application Explorer view (by launching it from the Start menu).
If you access the myapps.html page from a workstation where a previous version of Application Launcher is already installed (or was previously installed), the following error message might be displayed by the installation program:
Error: Install Error An installation error has prevented you from obtaining the ZENworks for Desktops plugin. Please contact your system administrator for help. You must first uninstall any previous versions of ZENworks for Desktops.
To resolve this problem, delete naldesk.exe from the workstation's Windows \system32 directory (typically c:\winnt\system32 or c:\windows\system32), make sure that the workstation does not have a search drive mapped to a server or directory where naldesk.exe resides, and then access the myapps.html page again.
Provide users with the URL for the myapps.html page.