Status: Unverified
GOAL:
How to install a Progress service pack on Linux?
FIX:
The READMESP file contains the installation instructions. Below is an example for 9.1D05 on Linux of the relevant info extracted from that file - please compare this extract with what is contained in the file for your particular system.
RELEASE NOTES AND INSTALLATION INSTRUCTIONS
for LINUX Intel PROGRESS Service Pack 9.1D05
and LINUX Intel WebSpeed Service Pack 3.1D05
** Please make sure you shut down any instances of PROGRESS that you
have running before installing this Service Pack. If you do not,
you may receive messages indicating that some files could not be
copied on top of other files (because they are locked/in use by
another process).
** SHARED MEMORY VERSIONS OF LOCAL CLIENT & SERVER
If your client and server are installed on the same physical machine
and have different levels installed, you may experience shared
memory problems. For more information about this issue, refer to
Progress KBASE #18945.
SYSTEM INFORMATION:
Platform: LINUX Intel
Serial Code(s): 178 (CD-ROM)
Service Pack Version: 9.1D05
Software Release: 9.1D
1. This Service Pack includes an update of the ubroker.properties.template
file. As a result of installing a new template file, when you start up the
Adminserver, the changes in the template file will be merged into your
current ubroker.properties file. If your ubroker.properties file was
previously sorted, you may find that the result of the merge is a file now
sorted by section rather than in alphabetical order.
Users can perform an additional save of their ubroker.properties file
by starting Progress Explorer. Once saved after the merge operation,
the file should be sorted again alphabetically.
2. After installing this Service Pack, if Dynamics Version 2.0
is also installed, some Progress Libraries from the $DLC/gui and
$DLC/tty directories must be copied into the Dynamics/gui and
Dynamics/tty directories. The as4dict.pl, adedict.pl and prodict.pl
libraries installed with Version 2 Dynamics are from the previous
Service Pack.
When running Dynamics, the -baseade startup parameter changes where
the client looks for the ADE code. In order to have the changes
contained in this Service Pack for the Data Dictionaries and Data
Administration tools, these libraries must be copied into the proper
Dynamics directories.
3. The new Progress Debugger provides 4GL programmers with a modern user
interface and easier access to information about the state of their 4GL
application code. It also runs on both Windows and Unix. The new
"Progress Debugger and Diagnostics Guide" describes the new Progress
Debugger and how to use it to find errors in Progress 4GL applications.
It also describes techniques for using the Debugger to monitor and
control the execution of Progress procedures.
This manual is available, in PDF only, from the Product Updates and
Documentation page located on the Technical Support Web site at the
following URL:
http://www.progress.com/support/downloads/index.htm
A Debugger release notes document is also available at this URL.
The manual will also be accessible from the PSDN Web site at the
following URL:
http://psdn.progress.com/library/documentation/index.htm
4. Progress has enhanced Pro*Spy and re-released it as Pro*Spy
Plus. The new features of Pro*Spy Plus include a hierarchical
view of traced data as well as the ability to trace non-ADM2
procedures and user-interface trigger execution on a limited basis.
As a temporary means of documenting the enhancements in
Pro*Spy Plus, a whitepaper is available in PDF format on the
PSDN website:
<a href="http://psdn.progress.com/library/whitepapers/.v9/prospy.pdf">http://psdn.progress.com/library/whitepapers/v9/prospy.pdf
BEFORE INSTALLING THIS SERVICE PACK:
1. Read through the entire INSTALLATION INSTRUCTIONS before proceeding.
2. 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.
3. Log in as "root". If you do not know the root password for your
system, check with your system administrator.
4. Make sure the "DLC" environment variable is set to the directory
that contains the PROGRESS 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 PROGRESS directory)
------- ----------------------------------------------
sh, ksh DLC=/dlc ; export DLC
csh setenv DLC /dlc
5. Shut down all PROGRESS processes for the installation you are going
to install this Service Pack on. Check with your system administrator
if you do not know how to shut down PROGRESS.
INSTALLATION INSTRUCTIONS:
The 9.1D Service Pack installation has been engineered to offer 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 Progress 9.1D
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. If you
choose not to view these files at the end of the installation, they are
saved in your 9.1D Install directory and can be viewed later.
STARTING THE SERVICE PACK INSTALLATION
To begin the Service Pack Installation, mount the cd to your cdrom drive,
or if you have downloaded the image, unpack the image to its own directory.
From a directory other than the Service Pack cdimage directory, issue
the following command:
<path-to-Service-Pack-image-directory>/<INSTALL-COMMAND>
RECOVERING 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 9.1D installation to its original state prior to
installing the Service Pack, do the following:
cd <path-to-backup-directory>
cp -R * <91D-install-directory>
This will recursively copy the files saved in the backup to your
9.1D installation directory, thereby restoring the DLC area to its
original state prior to installing the Service Pack.
===========================================================================.