Readme for the Access Client for MetaFrame, Version 4.0
Introduction
Readme Version: 1.62
Notes: For the latest service packs and critical updates for Citrix products, see http://support.citrix.com/criticalupdates.
About the Access Client for MetaFrame
For information about new features and system requirements, see the product administration guides.
Finding Documentation
To view, search, and print the PDF documentation, you need Adobe Reader (supported versions: Acrobat Reader 5.0.5 with Search through Adobe Reader 7.0). You can download Adobe Reader for free from the Adobe Systems Web site. Documentation is available on the Citrix Knowledge Center Web site (select Product Documentation). Updates to Citrix technical manuals are posted on the Web site.
Access Client for MetaFrame Documentation
This readme contains information about using the Access Client for MetaFrame in your network environment.
Documentation for other languages can be found on the Citrix Knowledge Center Web site (select Product Documentation).
Licensing Documentation
Licensing documentation is available from the Documentation folder on all product CD-ROMs.
Documentation for other languages can be found on the Citrix Knowledge Center Web site (select Product Documentation).
Citrix provides technical support primarily through Citrix Solutions Advisor. Contact your supplier for first-line support or use Citrix Online Technical Support to find the nearest Citrix Solutions Advisor.
Citrix offers online technical support services on the Citrix Support Web site. The Support page includes links to downloads, the Citrix Knowledge Center, Citrix Consulting Services, and other useful support pages.
About the Access Client for MetaFrame
Managing Client Software Using the Access Client for MetaFrame
The products in the MetaFrame Access Suite require that various pieces of client software be installed on your users’ devices. If you are using multiple products within the suite, you can use the Access Client for MetaFrame to create a Windows Installer package that contains the client software pieces you need to deploy.
The Access Client for MetaFrame contains a number of the client-side pieces of the MetaFrame Access Suite, allowing you to quickly and easily deploy and maintain the client-side software to your users using one convenient Windows Installer package. Once you have deployed your client software, you can update your installations simply by creating and deploying an updated installation package using the latest version of the Access Client for MetaFrame.
The Access Client for MetaFrame is available in the Download section of the Citrix Web site, www.citrix.com, and contains up to date client software and hotfixes for a number of the client-side pieces of the MetaFrame Access Suite.
Client Software Available for the Access Client for MetaFrame
• MetaFrame Presentation Server: Program Neighborhood, Program Neighborhood Agent, Web Client
• MetaFrame Secure Access Manager (Access Gateway Enterprise): Web Site Viewer, Gateway Client, Advanced Gateway Client, Live Edit Client, End-Point Analysis Client
• MetaFrame Password Manager: MetaFrame Password Manager agent
Creating a Client Distribution Package
Run the Access Client for MetaFrame in administrative mode to select the client-side software pieces you want to package together. Enter the following command at a command line to run in administrative mode:
msiexec.exe /a [path to msi file]
Select your client components, and optionally customize the installation process of each client. Additionally, you can choose to reduce the overall size of the final distribution package by selecting the option to remove unused files. For more information about custom installation options for each client-side component, see the Client for 32-bit Windows Administrator’s Guide, the MetaFrame Password Manager Administrator’s Guide, or the MetaFrame Secure Access Manager Administrator's Guide.
Each client installation that includes a MetaFrame Presentation Server client includes the Program Neighborhood Connection Center, allowing users to see information about their current ICA connections.
Planning Your Client Software Package
The Access Client for MetaFrame installs and upgrades all available clients that you specify when you build your software package. Every item included in your original client software package should be included in any subsequent upgrade packages you create.
For example, if you create a software package that includes Program Neighborhood and the Password Manager agent software, subsequent upgrade packages must included both client software packages. If you create an upgrade package that includes only Program Neighborhood, the Access Client for MetaFrame will uninstall the Password Manager agent software.
Conversely, if you later want to add the Web Site Viewer to your environment, rebuild your package to include Program Neighborhood, the Password Manager agent, and the Web Site Viewer. When this Windows Installer File is run on client devices that have your original package installed, the Web Site Viewer will be installed, while Program Neighborhood and the Password Manager agent software will simply be verified as installed and not changed in any way.
The final software package will install only the software pieces you select; however, the package itself will include information and files for all software pieces available for installation. You can remove the unneeded software pieces by selecting the file size reduction option during the package creation process.
Reducing the Size of your Client Software Package
When you create your client software package, you select which software components to include in the package. One option available, file size reduction, allows you to create a smaller software package. If you select this option during the package creation process, the final Windows Installer file will include only the software components needed for your installation and making the file smaller in size.
If you have created a client software package using the file size reduction option, and find you need to redistribute a new package with additional software components, uninstall your original client software package, then install the new client software package.
Distributing and Installing Your Client Software Package
Once you have created your client software package, you can make it available to your users on a network share point, or distribute it using your Active Directory infrastructure.
Client devices must meet the requirements of each client software component within your package. For example, if you attempt to install a package that includes Program Neighborhood and the Advanced Gateway client on a device that does not meet the requirements for Program Neighborhood, only the Advanced Gateway client is installed.
The software package you create using the Access Client for MetaFrame will upgrade previously installed client software on your client devices. For example, if you create a Windows Installer package that includes the Program Neighborhood Agent, installing that package on a device that has a stand-alone version of the Program Neighborhood Agent will upgrade the Program Neighborhood Agent automatically and treat it as part of the software package. You will not be able to upgrade the Program Neighborhood Agent without creating a new client software package.
To uninstall a client that was installed or upgraded using a Windows Installer package, users must run the Add/Remove Programs utility from the Control Panel, or run the installer package again and select the Remove option.
To install the client software using the Windows Installer package, the Windows Installer Service must be installed on the client device. This service is present by default on Windows 2000 systems.
Supported operating systems
You can use the Access Client for MetaFrame to install Citrix client software on client devices running Windows 2000, Windows XP, and Windows 2003. Windows 95, Windows 98, and Windows Me are not supported. [#121162, 120451,121017,121030,120532, 121024, 121020, 120598] ]
Installing Program Neighborhood, Program Neighborhood Agent, or the Web Client
If the software package you create includes Program Neighborhood, Program Neighborhood Agent, or the Web Client, unnistall any existing Program Neighborhood, Program Neighborhood Agent, or Web Client software from the user device before installing your software package. [#121023, 120958]
Verifying the selected client software packages during package creation
When you create a client software package, if you click the Reset button on the Select Client screen of the Package Creation wizard, you may not see all of the client software options you originally selected. Select or clear the required client software options to complete the creation of the client software package. [#117455, 121022]
Upgrading packaged client software using stand-alone client software
If you install client software on client devices using the Access Client for MetaFrame, always use the Access Client for MetaFrame to upgrade individual clients as needed. Do not attempt to upgrade the client software using stand-alone client installation software. [#113033, 121018]
