Personal Communications provides four installation options:
Installation to a local hard drive, including installing to run
from source, where source medium is a installation image. See for more information.
Administrative installation, including installing or running from
source, where source medium is a network server. See Appendix E. Administrative Installation for more information.
Installation and Uninstallation of IBM Personal Communications must
be done manually using setup.exe or by using
SCCM (Deployment tool). as the configuration and prerequisite checks
will happen only with setup.exe.
This chapter describes the general installation procedure for all
options and the specific procedure for installing to a local hard
drive. Typical and custom setups are described in this chapter, as
well as silent installation options. Additionally, this chapter provides
an introduction to the Microsoft Windows Installer service.
Microsoft Windows Installer
Personal Communications utilizes the Windows Installer service. When the Personal Communications installation
image is first run, it examines the target system and, if necessary,
automatically installs the proper version of the Windows Installer service.
Setup.exe is the bootstrap loader that calls the Windows Installer service
(msiexec.exe) and launches the installation dialogs. For a detailed
description of the Microsoft Windows Installer service,
refer to the Windows Installer SDK available online at http://www.msdn.microsoft.com.
For more information on setup.exe, see Appendix I. IPWI Command line parameters.
Note:
The following should be taken into account when installing Personal Communications:
In some cases, installation of Windows Installer triggers a reboot of
the system. If you are required to reboot, upon subsequent startup
you are taken immediately back to Windows Installer to continue installation
of Personal Communications.
After Windows Installer has been successfully installed, if the installation
of Personal Communications fails or is cancelled by the user, Windows Installer rolls back
all partially installed Personal Communications files and returns the system to its
original state.
You must be a member of the Administrator's group
to perform these installations.
Before you begin installation, make sure all other applications
are stopped. If you are reinstalling Personal Communications or are upgrading Personal Communications,
make sure that Personal Communications is not running before you start setup.
Typical Installation
Typical installation selects all default features for installation.
Features are defined as the specific functions of a program. See Feature Selection for a list of default features. You can customize Personal Communications features
by selecting the custom installation option (see Custom Installation).
To start a typical installation, click Next in
the installation type panel. A panel appears, indicating that Personal Communications is
computing the disk space requirements.
Note:
Once the installation
has passed this point, you cannot change the installation type. You
would then need to cancel the installation on the Application Data
panel, and begin a new installation.
To continue with the typical installation, use the following installation
procedure.
The Application Data Location dialog opens. Select from the following
application data location options:
User's application data folder ([UserProfile]\Application Data)
All users' common application data folder (All Users\Application
Data)
Classic private directory
Personal Communications uses multiple configuration files: user-class files
can be stored individually by user profile, while system-class files
are stored in a common location. Refer to Quick Beginnings for
more information about user-class and system-class files and locations.
If
the [UserProfile]\Application Data location is selected, the following
profile paths are used:
Operating System
User-Class Directory (Current
User)3
System-Class Directory
Windows Server
2003, XP
C:\Documents and Settings\ %USERNAME%\Application
Data\IBM\Personal Communications
C:\Documents and Settings\All Users\Application
Data\IBM\Personal Communications
1If the User Preference Manager (UPM) was set
to a directory other than the default directory, Personal Communications will utilize
that directory to store the user-class files. System-class
files are always stored in the Private directory.
2For the classic Private
directory locations, C:\Program Files\IBM\Personal Communications is
the drive where Personal Communications is installed.
3The FTP Client configuration
files are stored in the profile path mentioned the above, under the FTP folder.
Note:
For installations
on Windows x64 platforms, the directory path Program Files is
replaced by Program Files (x86).
After selecting your application data location, click Next to continue with the installation.
The Ready to Install the Program dialog opens. Click Back to
change your previous settings, or click Cancel to
terminate the installation process. Click Install to
continue with installation.
The typical setup uses the C:\Program Files\IBM\Personal Communications directory
for program installation.
Note:
If there is not enough disk
space on the C: drive, you are prompted to choose the custom installation
setup type in order to choose an alternate installation destination.
After installation is complete, the Installation Complete
dialog opens. Click Finish to exit the installation
process.
After installation is complete, you are prompted to reboot the
computer. You must reboot the computer before configuration changes
take effect and you can use Personal Communications.
Notes:
Typical installs the most common features for the applicable
emulators.
Typical does not include API sample programs.
Custom Installation
Though the default feature selection for a custom setup is the
same as for a typical setup, a custom configuration allows you to
modify feature selection for your system. To continue with the custom
installation setup:
Click the button to choose Custom setup
type. Click Next to continue.
The English language product is automatically installed. Only
the system default language locale and English are default. Select
any additional languages that you want to install. Click Next to
continue. A panel appears, indicating that Personal Communications is computing the
disk space requirements.
Note:
Once the installation has
passed this point, you cannot change the installation type. You would
then need to cancel the installation on the Application Data panel,
and begin a new installation.
The Custom setup dialog opens and asks you to select the program
features that you want to install. Some features have subfeatures
available. To view the subfeatures for a particular feature, click
the plus sign (+) to the left of the feature name.
Included in the
Custom Setup window are Feature Descriptions.
You can view the description of any feature by clicking on that feature
and then reading the description section to the right of the feature
selection tree. The feature description gives basic information about
each feature, as well as the disk space required for installation.
For more detailed information on disk space requirements for each
feature, click the Disk Space button. For a
description of available features, see Feature Selection. For
a description of feature installation options, see Feature Installation Options.
From the Custom Setup dialog, you can change the directory where Personal Communications is
installed. Click the Change button to choose
another installation directory.
After making your feature selection choices and confirming the
installation directory, click Next to continue
with the installation.
Note:
If there is not enough space
on the destination drive, you are prompted to choose another location.
The Application Data Location dialog opens. Select from the following
application data location options:
User's application data folder ([UserProfile]\Application Data)
All users' common application data folder (All Users\Application
Data)
Classic private directory
See Typical Installation for information on the profile paths
used for each application data location. For more information about
the location of application data, including workstation profiles,
refer to Quick Beginnings. Click Next to
continue.
The Automatic Migration Options dialog opens. By default, the Automatic Migration of Profiles box is checked.
If you clear this check box, no migration occurs. The migration choices
that are available to you are based on the information that you provided
in the Application Data Location dialog. For information on the Application
Data Location dialog, see .
By default, the highest
level of migration available for your application data location is
selected. This is the recommended level of migration for your configuration.
You can proceed with the installation using the default migration
option, or you can choose another level of migration. For a description
of the different levels of migration available for each Application
Data Location, see .
Click Next to continue with the installation.
The Ready to Install dialog opens. Click Install to
complete the installation.
Feature Selection
The features and subfeatures available for Personal Communications are described
in Table 1. This table also identifies which features
are installed by default.
Note:
In the custom setup window, if the icon to the
left of the feature name is white, that feature and all of its subfeatures
will be installed. If the icon appears grey, that feature or one or
more of its subfeatures will not be installed.
Your workstation can emulate a zSeries terminal
(display, printer, or both). The emulator APIs (such as EHLAPPI, PCSAPI,
DDE and ) and utilities (such as Multiple
Sessions, Menu Bar, , and Zip Print)
are installed.
ZipPrint
Yes
3270 Emulation and
Services
Your workstation
can emulate an TN3270, TN3270E terminal (display, printer, or both).
The emulator APIs and utilities (such as Multiple Sessions, Menu Bar, and Data Transfer) are installed.
ZipprintDefaultYes
5250 Emulation and Services
Your workstation can emulate an iSeries®, eServer™ i5,
or System i5® terminal (display, printer, or both).
The emulator APIs and utilities (such as Multiple Sessions, Menu Bar, and Data Transfer) are installed.
Data Transfer
iSeries Connection Configuration
Yes
VT Emulation
Your workstation can emulate an ASCII terminal.
The emulator APIs (such as Multiple Sessions, and Menu Bar) are installed.
None
Yes
Fonts
Additional fonts are available, such as special
3270.
Fonts listed in dialog
Yes
Secure Sockets Layer
Allows encryption and authentication customization.
MS CryptoAPI Security
No
Administrative and PD Aids
Diagnosis and update tools are included.
Log Viewer
Information Bundler
Internet Service
Yes
Utilities
Optional product utilities that can be installed.
Convert Macro
Menu Bar Customization Utility
Multiple Sessions
User Preferences
FTP client
Yes
Emulator Programming APIs
APIs and sample programs.
.NET Interops
Register to GAC
Interops Sample
Sample Programs for APIs
Host Access Class Library for C++
Visual Basic
Miscellaneous APIs
No
Notes:
The .NET Interops Register to GAC option
is only available if the installation program detects that the .NET
framework is present. However, the primary FTP client assembly will
not be registered in the GAC.
FTP Client requires
.NET Framework v2.0 or higher to be installed on the system.
Feature Installation Options
Each feature and subfeature allows several installation options.
To view the options available for each feature, click on the drop
down icon to the left of the feature name. Select the desired installation
type by clicking on it in the drop down menu. A description of each
possible installation option follows:
This feature will be installed on local hard
drive selects this feature for installation to the local hard
drive.
This feature, and all subfeatures, will be installed
on local hard drive selects the main feature and all of its associated
subfeatures to be installed on the local hard drive.
This feature will be installed to run from CD selects
the feature to run from source where source medium is the installation
image at the local workstation. This option is only available for
top-level features and installs only the base files needed to run
the feature.
Note:
If you are installing from a network,
this option instead displays as, This feature will
be installed to run from network. For more information on running
from a network server, see Install to run from network.
This feature, and all subfeatures, will be installed
to run from the CD selects the main feature and all associated
subfeatures to run from source where source medium is installation
image at the local workstation. This installation option installs
only the base files needed to run the features.
Note:
If
you are installing from a network, this option instead displays as, This feature, and all subfeatures, will be installed
to run from the network. For more information on running from
a network server, see Install to run from network.
This feature will be installed when required places
a shortcut on the Personal Communications menu allowing the feature to be installed
when the shortcut is selected. This installation option is also called advertisement.
This feature will not be available deselects
the feature for installation or advertisement.
Note:
If no installation choice is made, features are installed
to the local hard drive.
Silent Installation
Personal Communications is installed silently by passing command-line parameters
through setup.exe to the MSI (Windows Installer database) package. When running
a silent installation, the user does not provide input via dialogs
or see a progress bar during the installation process. Instead, installation
occurs automatically using either a typical configuration or a custom
configuration created during initialization file processing.
Note:
When migrating through silent installation, all active Personal Communications sessions
and actions will be closed without any prompting.
The base version IBM personal Communications V14.0.0.0 must be
installed in the system prior to the installation of IBM Personal
Communications V14.0.1.0 RefreshPack update installer.
The user must be an Administrator to perform the rollback configuration,
which enables the user to roll back to the base package.
Steps to Install:
Extract the RefreshPack zip file to get RefreshPack update installer,
IBM Personal Communications RP1.msi, version 14.0.1.0.
Double click IBM Personal Communications RP1.msi. A message "Welcome
to Installshield wizard for IBM Personal Communications RP1" is displayed.
Click Next to go to the next panel.
Click Next to install in Ready to Install the program panel.
Click Install and then click Finish.
Steps to Install Using Managed PCOMM:
After the base version is installed, unzip the RefreshPack zip
file to copy the IBM Personal Communications RP1.msi to the WebServerURL
location provided.
Note:
Please refer to the section Web
Server Details under the topic, HACP Server Details in the Quick Beginnings
book.
From the PCOMM client, invoke the Start or Configure Sessions
- Online. The user gets a notification about the latest available
PCOMM version. To upgrade, refer to the Auto-Update of IBM Personal
Communications (PCOMM).
Click Update. The application is closed and the installer is
downloaded to install the RefreshPack.
Configuration Involved:
The IBM Personal Communication RPs are Cumulative.
Supports all the languages (CHS, CHT, KOR).
Adds all the files required for the Refresh Pack, which includes
all APARs, Bugs, and PMRs.
When a user installs IBM Personal Communication 14.0.1, the Base
Pack IBM Personal Communication 14.0.0 installation is upgraded to
IBM Personal Communication 14.0.1, which is RP1.
The RefreshPack takes the backup of the base package files into
a newly created folder BackupBase under the installation directory
and restores them back to RP1.
The RefreshPack overwrites a registry key under HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Personal
Communications\CurrentVersion\VersionNumber with RefreshPack version.
The registry key is replaced back to the base version after the uninstallation.
The new registry key is also added for the restricting coexistence
under HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Personal Communications\CurrentVersion\VersionNumber
Value:- Fixpack_Version = 14.0.1.0, and after uninstallation, the
key is removed.
Uninstallation of 14.0.1 is also possible without affecting 14.0.0.
A new ARP Entry 'IBM Personal Communications 14.0.1' is added
to the control panel in addition to IBM Personal Communications 14.0.0
and is removed after the uninstallation.