This document
provides an overview of the changes made to HP Select Federation for version
7.01. It contains important information not included in the manuals or in
online help. This patch may or may not be incorporated into a future release in
its present or enhanced form.
In
This Version
Installation Notes
Support
Legal Notices
The following
enhancements and fixes are included in the current patch.
1.
Added Linux to the Quick Start Guide.
2.
Added support for WebLogic 9.2.
This patch contains the following files:
§
tfs.ear
§
config.pdf
§
install.pdf
§
quickstart.pdf
Installation
requirements, as well as instructions for installing Select Federation 7.00,
are documented in the HP Select
Federation Installation Guide. Before installing Select Federation,
be sure that your system meets the minimum requirements documented in this guide.
To update config.pdf, install.pdf, and quickstart.pdf
perform the following steps:
1.
Rename $SF_HOME/docs/config.pdf to $SF_HOME/docs/config70.pdf
2.
Copy config.pdf from your patch to $SF_HOME/docs/config.pdf
3.
Rename $SF_HOME/docs/install.pdf to $SF_HOME/docs/install70.pdf
4.
Copy install.pdf from your patch to $SF_HOME/docs/install.pdf
5.
Rename $SF_HOME/docs/quickstart.pdf to $SF_HOME/docs/quickstart70.pdf
6.
Copy quickstart.pdf from your patch to $SF_HOME/docs/quickstart.pdf
The deployment
process for tfs.ear is
dependent upon the particular application server you are currently using.
1. Stop the Built-in
application server instance where Select Federation is running as follows:
For Windows, enter the following commands:
cd $SF_HOME\
bin\shutdown.bat
For UNIX, enter the following commands:
cd $SF_HOME/
./bin/shutdown.sh
NOTE: You must start and stop the Built-in
application server from the installation directory. Otherwise, the server may
not start or stop correctly.
2. Create a new staging directory in a working
area.
3. Unzip the contents of
the patch file into this new directory (referred to as <patch_path> in the instructions below).
4. Unpack the EAR file in this new directory using the
following command:
%
jar xf <patch_path>/sf-7.0/tfs.ear
5. Copy all the *.jar files from the staging directory to the $SF_HOME/shared/lib directory.
6. Remove the following .war files and corresponding directories for these
files from the $SF_HOME/webapps directory:
pm.war styles.war tfs-intro.war tfs-wsp.war sa-adapter.war tfs-fs.war hpamintegrator.war tfs.war sf-demo.war tfs-internal.war tfs-soap.war
7. Copy all files with a .war extension from the staging directory to the $SF_HOME/webapps directory.
8. Restart the Built-in
application server.
For Windows, enter the
following commands:
cd $SF_HOME\
bin\startup.bat
For UNIX, enter the following commands:
cd $SF_HOME/
./bin/startup.sh
9. Verify your updated
deployment by doing the following:
a.
Navigate
to the Select Federation Administration console startup page.
b.
Click on Administration
Console to open the Administration console logon page and log on.
c.
Verify
that you see the text Product Version: 7.0.0 build1 at the bottom of the
Administration console Welcome page.
1. Create a new staging directory in a working area.
2. Unzip the contents of
the patch file into this new directory (referred to as <patch_path> in the instructions below).
3. Log on to the WebSphere Administration console
where Select Federation was initially installed.
4. Expand Application
and click Enterprise Application in the left navigation pane.
5. Select the Select
Federation check box and click Stop.
Once the application is
stopped, make sure that the Select Federation check box is checked.
6. Click
uninstall to uninstall the application.
7. Back up the tfs.ear file in the $SF_HOME/sf_ear directory by renaming it to tfs.ear.org.
8. Copy the new <patch_path>/tfs.ear
file to the $SF_HOME/sf_ear directory.
9. Deploy the tfs application as
follows:
a.
Start the
IBM WebSphere server that
has the Administration console.
b.
Point your
browser to the Administration console.
You can do this by
clicking the Administration Console option in the First Steps
program or by entering the URL (typically in the /ibm/console of the administration port of the application
server).
c.
In the
left pane, expand the Applications container. Then click Install New
Application.
d.
In the
right pane, locate the Select Federation EAR (at $SF_HOME/sf_ear/tfs.ear), click Next.
e.
In the
next 4 screens (shown as steps 1 through 4 in the right pane), click Next
on all screens and then click Finish in the end.
f.
Click Save
to Master Configuration in the resulting screen, and click Save
again in the next screen.
g.
Click Enterprise
Applications in the left pane.
The new Select
Federation appears in the list in the right pane.
h.
Check the
box next to the line corresponding to Select Federation and click Start.
When the server starts,
a green arrow appears in the right pane. Select Federation will be running.
10. If your WebSphere
server is running, you need to stop and restart the WebSphere server.
For Windows:
stopServer.cmd
<server_name>
startServer.cmd <server_name>
For UNIX:
./stopServer.sh <server_name>
./startServer.sh <server_name>
11. Verify your updated deployment by doing the
following:
a.
Navigate
to the Select Federation Administration Console startup page.
b.
Click on Administration
Console to open the Administration Console login page and login.
c.
Verify
that you see the text Product Version: 7.0.0 build1 at the bottom of the
Administration Console Welcome page.
1. Create a new staging directory in a working area.
2. Unzip the contents of
the patch file into this new directory (referred to as <patch_path> in the instructions below).
3. Log on to the WebLogic Administration console.
4. Navigate to <domain>
→ Deployments → Applications → tfs in the left navigation pane.
5. Right-click on tfs and select delete tfs.. to
delete the application.
6. Back up the tfs.ear file in the $SF_HOME/sf_ear directory by renaming it to tfs.ear.org.
7. Copy the new <patch_path>/tfs.ear file to the $SF_HOME/sf_ear directory.
8. Deploy the tfs application as
follows:
a.
Open a
browser window and start the BEA WebLogic
Console for the domain on which Select Federation is to be deployed.
In a single server
configuration, the console is typically at the URL path /console in the server.
b.
In the
left pane, select the Applications container. Then click Configure a
New Application in the right pane.
c.
In the
next screen (Load Application or Components to Configure), follow the
two steps given on the Locate Application or Component to Configure page
as follows:
§
Upload the $SF_HOME/sf_ear/tfs.ear file.
§
Select the tfs.ear in the list seen at the bottom of the screen.
d. In the next screen (Configure
Application or Component), select the WebLogic server instance on which you wish to deploy
Select Federation and then click Configure and Deploy.
In the next screen, you
will see Select Federation being deployed and eventually see the status of the Activate
application tfs on
<server> as Completed.
9. If your WebLogic server is running, you
need to stop and restart the WebLogic
server:
For Windows:
stopWebLogic.cmd
startWebLogic.cmd
For UNIX:
./stopWebLogic.sh
./startWebLogic.sh
10. Verify your updated deployment by doing the
following:
a.
Navigate
to the Select Federation Administration console startup page.
b.
Click on Administration
Console to open the Administration console logon page and log on.
c.
Verify
that you see the text Product Version: 7.0.0 build 1 at the bottom of the
Administration console Welcome page.
1. Create a new staging directory in a working area.
2. Unzip the contents of
the patch file into this new directory (referred to as <patch_path> in the instructions below).
3. Log on to the WebLogic Administration console.
4. Click on deployments
in the Domain Structure panel in the left navigation pane.
5. Select the tfs.ear check box and
click Stop.
Make sure the check box
for tfs.ear is
selected.
6. Click delete to
delete the application.
7. Back up the tfs.ear file in the $SF_HOME/sf_ear directory by renaming
it to tfs.ear.org.
8. Copy the new <patch_path>/tfs.ear file to the $SF_HOME/sf_ear directory.
9. Deploy the tfs application as
follows:
a.
Start the WebLogic Administration server
for the Select Federation profile.
b.
For
Unix installations only: If Select Federation is installed as a user other than
root, then write permission should be granted to create the following
directory:
/var/opt/hpsupport
c.
Click on
the Lock and Edit button in the top-left navigation section of the
console.
d.
Click on Deployments
in the left pane on the Console.
e.
Click on
the Install button on the main pane of the screen.
f.
Navigate
to the sf-ear folder created by the Select Federation installation
in the WebLogic domain.
g.
Select tfs.ear and click the Next
button.
h.
Make sure
that the Install this deployment as an Application button is selected
and click Next to continue.
i.
Make sure
the following values are selected on this page and click Next to
continue:
§
Name: tfs
§
Security: DDOnly
§
Source
Accessibility: Use the default defined by the deployment descriptors.
§
Location: <location
of sf_ear>/tfs.ear
j.
Select the
following option:
Additional
Configuration: No, I will review the configuration later.
k.
Click the Finish
button to complete the deployment.
l.
Click on
the Activate Changes button that appears on the upper-left corner of the
screen.
m.
Select the
check box beside tfs
on the Deployments screen.
The State column shows tfs as Prepared.
n.
Click on
the Start button and select Service all requests.
o.
On the
confirmation page click Yes.
The State column now
shows tfs as Active.
The application is now
available for use.
10. If your WebLogic server is running, you
need to stop and restart the WebLogic
server:
For Windows:
stopWebLogic.cmd
startWebLogic.cmd
For UNIX:
./stopWebLogic.sh
./startWebLogic.sh
11. Verify your updated
deployment by doing the following:
a.
Navigate
to the Select Federation Administration console startup page.
b.
Click on Administration
Console to open the Administration Console logon page and log on.
c.
Verify
that you see the text Product Version: 7.0.0 build1 at the bottom of the
Administration console Welcome page.
Samples in the 7.00 SDK work on WebLogic 9.2. The instructions for deploying the samples on WebLogic 9.2 are the same as WebLogic 9.1.
You can visit the HP support web site at:
http://www.hp.com/go/hpsoftwaresupport
This web site provides contact information and details
about the products, services, and support that HP Software offers.
HP Software online
software support provides customer self-solve capabilities. It provides a fast
and efficient way to access interactive technical support tools needed to
manage your business. As a valued support customer, you can benefit by using
the support site to:
§
Search for knowledge documents of interest
§
Submit and track support cases and enhancement requests
§
Download software patches
§
Manage support contracts
§
Look up HP support contacts
§
Review information about available services
§
Enter discussions with other software customers
§
Research and register for software training
Most of the support areas require that you register as
an HP Passport user and sign in. Many also require an active support contract.
To find more information about support access levels, go to the following URL:
http://h20230.www2.hp.com/new_access_levels.jsp
To register for an HP Passport ID, go to the following
URL:
http://h20229.www2.hp.com/passport-registration.html
©Copyright 2002-2008 Hewlett-Packard
Development Company, L.P.
Confidential computer software. Valid license from HP required for possession, use or
copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software,
Computer Software Documentation, and Technical Data for Commercial Items are
licensed to the U.S. Government under vendor's standard commercial license.
The only warranties for HP products and services are
set forth in the express warranty statements accompanying such products and
services. Nothing herein should be construed as constituting an additional
warranty. HP shall not be liable for technical or editorial errors or omissions
contained herein.
The information contained herein is subject to change
without notice.
For information about third-party license agreements,
see the 3rd_party_license directory on the product installation CD-ROM.
§
Java™ and all Java based trademarks and logos are trademarks or registered
trademarks of Sun Microsystems, Inc. in the
§
Microsoft®, Windows®, and Windows XP® are
§
Oracle® is a registered trademark of Oracle Corporation. Various
product and service names referenced herein may be trademarks of Oracle
Corporation.
§
UNIX® is a registered trademark of The OpenGroup.