Status: Unverified
GOAL:
How do I install a Service Pack?
GOAL:
How to install a Service Pack
FACT(s) (Environment):
All Supported Operating Systems
OpenEdge 10.x
OpenEdge 10.1x
OpenEdge 10.2x
OpenEdge 10.0x
FIX:
The information needed to install a service pack is included in the README file which is contained in the service pack download file for your platform.
It will include the following as well as any additional Product Notes for that service pack version:
Ports: All
Date: April, 2010
--------------------------------
Copyright (c) 1984-2010 Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.
To access third party product licenses, go to the 'licenses' directory
located in the OpenEdge installation directory. For example, go to
C:/OpenEdge/licenses.
Additional third party license information for zlib v1.2.3:
Copyright (c) 2006-2007, ComponentAce
http://www.componentace.com
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of ComponentAce nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Read these On-line Release Notes
================================
It is important to read these on-line release notes. They are the
primary release notes. The hard-copy release notes supplement them,
but do not replace them.
The on-line release notes are on the distribution medium as two
text files:
* READMESP
* READMESP.txt
The files have identical content.
In addition, the distribution medium includes the following HTML report
files which list the issues addressed in all Service Packs for this
release - organized by version, issue number (CR ID), or product component.
* oe-<release#>-version.htm (Lists fixed issues by Version)
* oe-<release#>-issue.htm (Lists fixed issues by Issue Number)
* oe-<release#>-component.htm (Lists fixed issues by Component)
--------------------------------
This readme file contains the following information:
- Installation Instructions
- Product Notes
- List of Issues Addressed in this Service Pack
- End User License Agreement
========================================================================
INSTALLATION INSTRUCTIONS
--------------------------------------------------------------------------------
This section contains the following information:
- Before you install this Service Pack.
- About the Backup and Selective Install Functionality.
- Starting the Service Pack Installation.
- Installing the Service Pack in Silent or Batch Mode.
- Recover.ing a Previous Installation.
- Reporting Problems with the Service Pack Installation.
BEFORE YOU INSTALL THIS SERVICE PACK:
-------------------------------------
1. Make sure you shut down any instances of OpenEdge that you
have running before installing this Service Pack. If you do not,
when you run the Service Pack installation, you might receive messages
indicating that some files could not be copied on top of other files
(because they are locked/in use by another process). Check with your system
administrator if you do not know how to shut down OpenEdge.
2. Read through the entire INSTALLATION INSTRUCTIONS (see next section below)
before proceeding.
3. Make sure you read the "End User Product License Agreement" included
at the end of these notes. You are agreeing to its terms and conditions
by installing this Service Pack.
4. If your client and server are installed on the same physical machine
and have different levels installed, your machine might experience shared
memory problems. For more information about this issue, refer to the
following Progress Solutions (accessible via the Progress Software Support
Web site: ">http://www.progress.com/openedge/support)
P132 :"What Type of Connection is Possible from Client to Server when the
Progress versions differ?"
P13987: "What causes shared memory version errors 1178 and 1423?"
5. Log in as "Administrator" or as a user with Administrator privileges. If you
do not know the Administrator password for your system, check with your
system administrator.
6. For UNIX only: Make sure the DLC environment variable is set to the directory
that contains the OpenEdge installation you want to Service Pack.
If the DLC variable has not been set, then enter one of the
following commands to set it:
Shell Commands (assume "/dlc" is the OpenEdge directory)
------- ----------------------------------------------
sh, ksh DLC=/dlc ; export DLC
csh setenv DLC /dlc
ABOUT THE BACKUP and SELECTIVE INSTALL FUNCTIONALITY
----------------------------------------------------
The Service Pack installation offers you two key functions:
* The option to create a backup of existing files.
* The ability to install only those files relevant to your license.
The Service Pack installation will ask if you want to backup existing
files. If you choose to create a backup, you will have the option of
changing or accepting the default backup location, and the backup will
be created for only those files that are about to be updated via the
Service Pack.
The Service Pack installation will then determine what OpenEdge
license(s) have been installed. Based on that information, the install
will unpack from the Service Pack archives, only the files that are
relevant for the license(s) installed.
The end of the installation presents the option to review the Service
Pack README file (this file) and the SP(n)-log.txt file which contains
a list of files installed and backed up if a backup was executed.
The installation saves the readmesp and log files to your Install directory
so you can also view them later.
STARTING THE SERVICE PACK INSTALLATION
--------------------------------------
UNIX:
-----
1. If you have downloaded the Service Pack image, unpack the image to its own
directory.
OR
If you have received the Service Pack on CD-ROM, mount the CD to your CD-ROM
drive.
.2. From a directory other than the Service Pack cdimage directory, issue
the following command:
<path-to-service-pack-image-directory>/<INSTALL-COMMAND>
Windows:
--------
1. If you have downloaded the Service Pack image, unpack the image to its own
directory.
OR
If you have received the Service Pack on CD-ROM, insert the CD into your
CD-ROM drive.
2. Using Windows Explorer, go to the Service Pack directory, and double-click
the 'Setup' icon to begin the installation.
INSTALLING THE SERVICE PACK IN SILENT OR BATCH MODE
---------------------------------------------------
Silent or batch install is available for Service Packs on UNIX and Windows.
UNIX
----
A normal (interactive) installation will prompt you for required
information with dialog boxes.
A batch install will not prompt for your input. It will read the required
information from an installation INI file. By default, the batch install
will look for the "install.ini" file in your current directory.
You must create the INI file before you run a silent install.
If no INI file is found, the installation will fail.
Here are the contents of a sample INI file:
[Service Pack]
ProgressInstallDir=/usr/OpenEdge/101B/dlc
ReInstall=1
Backup=1
BackupDir=/usr/OpenEdge/101B/SP_Backup
BackupOverwrite=1
To perform a batch install, run the following command (all one line):
<path-to-service-pack>/proinst -b <path-to-file>/install.ini -l
<path-to-file>/<logfile.log>
If you do not specify a filename with the -l switch, the install script uses the
install.log filename, by default. If you do not specify a directory for the -l
switch, the install script uses the first of the following environment variables
found: TMP, TEMP, TMPDIR.
Windows
-------
A normal (non-silent) installation will prompt you for required information
with dialog boxes.
The silent install will not prompt for input. It will read the required
information from a response file, typically named response.ini. A response.ini
file is automatically generated when you run an interactive installation. There
is a file named response.ini that is kept in the <Destination Path>\install
directory.
You must create the response.ini file before you run a silent install.
To have the install program create a response.ini file, run an interactive
(non-silent) install and specify to record the user inputs with the following
command:
drive:\setup.exe -psc_r -psc_f1=c:\<path-to-file>\response.ini
Alternately, you can manually create a response.ini file. The following
sample provides the default responses to an initial Service Pack install:
==========================
BEGIN SAMPLE RESPONSE FILE
==========================
[InstallShield Information]
Version=7.1.100.1242
[Application]
Name=OpenEdge
Version=10.1B
Company=Progress Software
File=Response File
;
; DESCRIPTION of Welcome Dialog
;
; Result - is used as the return code for this section. Only a value of 1 is
; acceptable.
;
[Welcome Dialog]
Result=1
[Service Pack Backup Directory Dialog]
_nSPBackup=0
_sSPBackupDir=C:\Progress\OpenEdge\SPBackup
Result=1
;
; DESCRIPTION of Summary Dialog
;
; Result - is used as the return code for this section. Only a value of 1 is
; acceptable.
;
.[Summary Dialog]
Result=1
[SdFinish]
Result=1
bOpt1=0
bOpt2=0
==========================
END SAMPLE RESPONSE FILE
==========================
To perform a silent install, issue the following command:
drive:\setup.exe -psc_s -psc_f1=c:\<path-to-file>\response.ini
[-psc_f2=c:\<path-to-file>\setup.log]
If you choose to create a log file, the contents of a successful silent install
will be as follows:
[InstallShield Silent]
Version=v7.00
File=Log File
[ResponseResult]
ResultCode=0
RECOVERING A PREVIOUS INSTALLATION
----------------------------------
If you created a backup during the Service Pack installation, you can
restore your installation to its original state if so desired. Because
the backup saves the files just prior to installing the Service Pack
it is possible only to return to that point. If multiple Service Packs
have been installed, it is not possible to roll back through each
Service Pack unless backups have been saved for each installation in
separate directories. Each backup would have to be restored in the
reverse order from which they were installed.
To restore your 10.1A installation to its original state prior to
installing the Service Pack, do the following:
UNIX:
1. cd <path-to-backup-directory>
2. cp -R * <101B-install-directory>
WINDOWS:
1. Using Windows Explorer, navigate to the
<Progress-install-dir>/<SPBackup-dir>.
2. Choose Edit->Select All, and choose Edit->Copy.
3. Go to <Progress-install-dir> and choose Edit->Paste.
This will recursively copy the files saved in the backup to your
10.1B installation directory, thereby restoring the DLC area to its
original state prior to installing the Service Pack.
REPORTING A PROBLEM WITH THE SERVICE PACK INSTALLATION
------------------------------------------------------
If you encounter problems with the installation of the Service Pack,
or with the OpenEdge product as a result of installing the Service Pack,
please contact Technical Support at www.progress.com..