Information in this document is subject to change without notice. The software described herein is furnished under a license agreement,
and it may be used or copied only in accordance with the terms of that agreement.
To order additional documents, U.S. and Canadian customers should call Customer Fulfillment at (800) 685-8225, fax (617) 229-9845.
Customers in other countries with a U.S. license agre eme nt ma y conta c t Custom er Fulfi llme nt via the above fax number. All other
international customers should contact their Sybase subsidiary or local distributor. Upgrades are provided only at regularly scheduled
software release dates. No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic,
mechanical, manual, optical, or otherwise, without the prior written permission of Sybase, Inc.
Sybase, the Sybase logo, AccelaTrade, ADA Workbench, Adaptable Windowing Environment, Adaptive Component Architecture,
Adaptive Server, Adaptive Server Anywhere, Adaptive Server Enterprise, Adaptive Server Enterprise Monitor, Adaptive Server
Enterprise Replication, Adaptive Server Everywhere, Adaptive Server IQ, Adaptive Warehouse, Anywhere Studio, Application
Manager, AppModeler, AP T W orkbench, AP T -Build, APT-Edit, APT -Execute, AP T -Translator , APT - Library, Backup Server , BizTracker ,
ClearConnect, Client-Library, Client Services, Convoy/DM, Copernicus, Data Pipeline, Data Workbench, DataArchitect, Database
Analyzer, DataExpress, DataServer, DataWindow, DataWindow.NET, DB-Library, dbQueue, Developers Workbench, Direct Connect
Anywhere, DirectConnect, Distribution Director, e-ADK, E-Anywhere, e-Biz Impact, e-Biz Integrator, E-Whatever , EC Gateway,
ECMAP, ECRTP, eFulfillment Accelerator, Embedded SQL, EMS, Enterprise Appl ication Studio, Enterprise Client/Server, Enterprise
Connect, Enterprise Data Studio, Enterprise Manager, Enterprise SQL Server Manager, Enterprise Work Architecture, Enterprise Work
Designer, Enterprise Work Modeler, eProcurement Accelerator, EWA, Financial Fusion, Financial Fusion Server, Gateway Manager,
GlobalFIX, iAnywhere, iAnywhere Application Alerts, iAnywhere Mobile Delivery, iAnywhere Mobile Document Viewer, iAnywhere
Mobile Inspection, iAnywhere Mobile Marketing Channel, iAnywhere Mobile Pharma, iAnywhere Mobile Sales, iAnywhere Pylon,
iAnywhere Pylon Application Server, iAnywhere Pylon Conduit, iAnywhere Pylon PIM Server, iAnywhere Pylon Pro, iAnywhere
Solutions, ImpactNow, Industry W arehouse S tudio, InfoMaker, Information Anywhere, Information Everywhere, InformationConnect,
InternetBuilder, iScript, Jaguar CTS, jConnect for JDBC, Mail Anywhere Studio, MainframeConnect, Maintenance Express, Manage
Anywhere Studio, M-Business Channel, M-Business Network, M-Business Server, MDI Access Server, MDI Database Gateway,
media.splash, MetaWorks, My iAnywhere, My iAnywhere Media Channel, My iAnywhere Mobile Marketing, MySupport, NetGateway, Net-Library, New Era of Networks, ObjectConnect, ObjectCycle, OmniConnect, OmniSQL Access Module, OmniSQL
To olkit, Open Biz, Open Cl ient , Open Client Connect, Open Client/ Server, Open Client/Server Interfaces, Open Gateway, Open Server,
Open ServerConnect, Open Solutions, Optima++, Orch estr ation Studio, PB- G en, PC A PT Execute, PC DB-Net, PC Net Library,
PocketBuilder, Pocket PowerBuilder, Power++, power.stop, PowerAMC, PowerBuilder, PowerBuilder Foundation Class Library,
PowerDesigner, PowerDimensions, PowerDynamo, PowerJ, PowerScript, PowerSite, PowerSocket, Powersoft, PowerStage,
PowerStudio, PowerTips, Powersoft Portfolio, Powersoft Professional, PowerWare Desktop, PowerWare Enterprise, ProcessAnalyst,
Rapport, RepConnector, Replication Agent, Replication Driver, Replication Server, Replication Server Manager, Replication Toolkit,
Report-Execute, Report Workbench, Resource Manager, RW-DisplayLib, RW-Library, S-Designor, SDF, Secure SQL Server, Secure
SQL Toolset, Security Guardian, SKILS, smart.partners, smart.parts, smart.script, SQL Advantage, SQL Anywhere, SQL Anywhere
Studio, SQL Code Checker, SQL Debug, SQL Edit, SQL Edit/TPU, SQL Everywhere, SQL Modeler, SQL Remote, SQL Server, SQL
Server Manager, SQL SMART, SQL Toolset, SQL Server/CFT, SQL Server/DBM, SQL Server SNMP SubAgent, SQL Station, SQLJ,
STEP, SupportNow, S.W.I.F.T. Message Format Libraries, Sybase Central, Sybase Client/Server Interfaces, Sybase Financial Server,
Sybase Gateways, Sybase MPP, Sybase SQL Desktop, Sybase SQL Lifecycle, Sybase SQL Workgroup, Sybase User Workbench,
SybaseWare, Syber Financial, SyberAssist, SyBooks, System 10, System 11, System XI (logo), SystemTools, Tabular Data Stream,
TotalFix, TradeForce, Tr ansact-SQL, Translation Toolkit, UltraLite, UltraLite.NET, UNIBOM, Unilib, Uninull, Unisep, Unistring, URK
Runtime Kit for UniCode, VisualWriter, VQL, WarehouseArchitect, Warehouse Control Center, Warehous e Studio, Warehouse
WORKS, Watcom, W atcom SQL, W atcom SQL Server, W eb Deployment Kit, Web.PB, W eb.SQL, WebSights, W ebV iewer , W orkGroup
SQL Server, XA-Library, XA-Server and XP Server are trademarks of Sybase, Inc. 05/04
Unicode and the Unicode Logo are registered trademarks of Unicode, Inc.
All other company and product names used herein may be trademarks or registered trademarks of their respective companies.
Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-7013
for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies.
Sybase, Inc., One Sybase Drive, Dublin, CA 94568.
Contents
About This Book............................................................................................................................ v
Creating directories for the class files ..................................... 22
Installing the Account Management portlet............................. 23
Verifying the Account Management portlet deployment.......... 24
Setting up Account Management for the pacuser................... 25
Creating the Account Management portlet for pacuser........... 26
Verifying deployment of the new and updated portlets ........... 26
Setting up the new portlets for pacuser................................... 27
Creating portlet pages for pacuser.......................................... 28
Index ............................................................................................................................................. 29
Upgrade Guideiii
Contents
iv
PATRIOTcompliance Starter Kit
About This Book
This book describes how to upgrade and configure products in the
PATRIOTcompliance Solution.
Audience
How to use this book
Related documents
Sybase certifications on
the Web
❖Finding the latest information on product certifications
Sybase Professional Services is the principal audience for this book.
This book contains the following chapters:
•Chapter 1, “Introduction,” briefly describes the P ATRIOT compliance
Starter Kit and its components.
•Chapter 2, “Upgrading to version 2.2,” provides detailed upgrade
instructions.
New Era of Networks Process Server 3.9.1 Installation Guide
New Era of Networks Process Server 3.9.1 Release Bulletin
TightLink Solution Server UpgradeNotes.htm
Technical documentation at the Sybase Web site is updated frequently.
1Point your Web browser to Technical Documents at
http://www.sybase.com/support/techdocs/
.
2Select Products from the navigation bar on the left.
❖Creating a personalized view of the Sybase Web site (including support
pages)
Upgrade Guidev
3Select a product name from the product list and click Go.
4Select the Certification Report filter, specify a time frame, and click
Go.
5Click a Certification Report title to display the report.
Set up a MySybase profile. MySybase is a free service that allows you to
create a personalized view of Sybase Web pages.
1Point your Web browser to
http://www.sybase.com/support/techdocs/.
Technical Documents at
Sybase EBFs and
software
maintenance
2Click MySybase and create a MySybase profile.
❖Finding the latest information on EBFs and software maintenance
1Point your Web browser to the Sybase Support Page at
http://www.sybase.com/support
.
2Select EBFs/Maintenance. Enter user name and pas swor d infor mati on, if
prompted (for existing Web accounts) or create a new account (a free
service).
3Select a product.
4Specify a time frame and click Go.
5Click the Info icon to display the EBF/Maintenance report, or click the
product description to download the software.
Conventions
If you need help
The following style conventions are used in this manual:
•The names of files and directories are shown in this font.
•Command names, command option names, utility names, and other
keywords are shown in
this font.
•Variables, or words that stand for values that you fill in, are shown in this
font.
•Database objects are shown in
this font.
Each Sybase install ation that has pur chased a support contract has one or more
designated people who are authorized to contact Syb ase Technical Support. If
you cannot resolve a probl em using the manuals or onlin e help, please have the
designated person contact Sybase Technical Support or the Sybase subsidiary
in your area.
viPATRIOTcompliance Starter Kit
CHAPTER 1
Introduction
This chapter introduces Sybase P A TRIOT compliance Solution to financial
institutions.
Upgrade Guide1
PATRIOTcompliance Solution overview
PATRIOTcompliance Solution overview
The Sybase PATRIOTcompliance Solution allows financial institutions to
automate name filtering, intra-day and historical transaction filtering, and
enterprise wide customer activity monitoring to meet the requirements of the
USA P A TR IOT (Uniting and Streng thening America by Providing App ropriate
Tools Required to Intercept and Obstruct Terrorism) legislation.
The PATRIOTcompliance Starter Kit provides the infrastructure components
needed for the Sybase PATRIOTcompl ia nce So lut i on, incl udi n g:
•New Era of Networks Business Process Integration (BPI) Suite
•New Era of Networks Adapter for Flat Files
•Sybase Enterprise Portal
•Tig htLi nk CIS
The PATRIOTcompliance Solution templates allow the installation and
configuration of the separate products into a single solution. These templates
include metadata to assemble the products, application server components, and
database stored procedures to perform complex, highly-specialized functions.
2PATRIOTcompliance Starter Kit
CHAPTER 2
Upgrading to version 2.2
This chapter tells you how to upgrade your system to version 2.2 of the
PATRIOTcompliance Solution.
HeadingPage
Overview4
Verifying system environment variables7
Upgrading the PATRIOT database8
Upgrading Process Server process definitions11
Upgrading formats12
Upgrading EAServer components13
Configuring Portlets20
Upgrade Guide3
Overview
Overview
This upgrade to the PATRIOTcompliance Solution includes an updated
ROLLUP version of the PATRIOT Compliance Starter Kit. Sybase
recommends that you install this updated Software Release as soon as possible.
This upgrade is distributed as a zip file and is availab le for download fr om the
EBFs/Maintenance page
Warning! Sybase strongly rec ommends that a backup of all components be
done before you begin this upgrade. You must re-create any customization of
the PATRIOT solution templates.
Issues addressed in this release
at http://www.sybase.com/downloads.
CR#Description
CR#332858Previous vers ions of PATRIOT Sta rter Kit sometimes all owed
users to log in more than once with th e same login name. Updates
to the portalinterface.properties allow you to restrict users to a
single login at a time.
This step is op tiona l an d not requ ired f or s ucce ssf ul de ploy ment.
CR# 332855Changes to security.properties allow you to set the number of
days, months or years that a password remains valid; the default
is 0, which means passwords are valid indefinitely.
Duration parameters are expressed in the <number> of days,
months, or years the pa ssword remain s vali d. Count beg ins fr om
the day you create or modify the passwo rd. Changing the
password via the Account Management portlet before the
expiration date resets the count.
EP Security locks users who fail to change their passwords
within set duration parameters out of the system.
CR# 327011Pat LoggedIn Users is a new portlet that identifies all users
currently logged into the system.
4PATRIOTcompliance Starter Kit
CHAPTER 2 Upgrading to version 2.2
CR#Description
CR# 333653PATRIOTcompliance Starter Kit 2.2 includes a script whi ch
creates a mechanism for customers who want to make their EP
instance use non-sa database logins . These logins include
sufficient permissions to let EP a pplications(s) connect to the
patriot database, portal interface, and search cache
Adding a non-sa user connection involves running a script,
ep_login.sql, that creates three new login names
PATRIOTdbConnection, PortalInterfaceCache, and
epSearchCache. You then open Jag uar Manage in EAserver to
add the actual connectio ns.
This step is optional and not re quired for suc cessful de ploy ment.
CR# 334386,
CR# 336723
Customers, employees, or external accounts may be placed on a
cleared list to allow their transactions to pass through the
PATRIOT Solution without being flagged as a hit. Use the Pat
Cleared List Adm portlet to administer the cleared list. In this
portlet, you can search entries, make entries, or flag entries as
inactive.
Changes to the
Pat Cleared List Admin portlet now allow you to
clear customers, employ ees, or external accounts from multiple
lists at the same time. A new column in the search list ide ntifie s
users who make changes to the cleared list.
CR# 334776Stop words are words that occur frequently in transactions and
are irrelevant to the suspec t search. The
portlet
is a new portlet which identifies how frequently certain
Stop Words Candidate
words appear in various lists. Use this portlet to identify poten tial
candidates for the stop words list.
CR# 328827,
CR# 323431
Use the
customer, country, or address with the search engine. Pat Search
Pat Search List portlet to look up a suspect, employee,
List returns a score that indicates the percent certainty for each
match.
Previous versions of the
Pat Search List portlet limited suspect
searches to name. Customers can now search for suspects by
country and address. Country and address check boxes now
appear just above the Search for Suspec t b ut t on. Country is the
default search criteria; to search by street address you must click
the Address button.
Upgrade Guide5
Overview
Contents of the 2.2 release
Refer to the descriptions of the files below for individual in stallation
instructions. Directory paths below are in UNIX notation. For Windows,
change the forward slashes to back slashes.
2Extract the PATRIOT EBF files into a temporary location.
The target directory of unzipping the EBF archive will be the installation
directory of PATRIOT (%PATRIOT% for Windows; $PATRIOT for
Solaris)
3Make sure you have ASE and EAServer up and running.
Verifying system environment variables
Follow these steps to verify or set the environment variables required for
configuration.
1Verify that the SYBASE environment variable is set. The SYBASE
environment variable is the root directory of Sybase applications. For
example, SYBASE=/software/sybase (Solaris) o r SYBASE=c:\Sybase
(Windows).
2Verify that the SYBASE_ ASE environm ent variable is set. This is the
directory under $SYBASE (Solaris) or %SYBASE% (Windows) where
Adaptive Server Enterprise has been installed. For example,
SYBASE_ASE=ASE-12_5.
3Verify that the SYBASE_ OCS environment variable is set. This is the
directory under $SYBASE (Solaris) or %SYBASE% (Windows) where
Open Client/Server has been installed. For example, SYBASE_OCS=OCS-12_5.
4Set the JAGUAR environment variable. This is the directory under
$SYBASE (Solaris) or %JAGUAR% (W indows 2000) where EAServer h as
been installed.
Solaris example: JAGUAR=/software/sybase/EAServer
Windows 2000 example: JAGUAR=c:\Sybase\EAServer
5Set the $JAVA_HOME (Solaris) or %JAVA_HOME% (Windows)
environment variable. This environment variable points to a directory
where a Java JDK is installed.
Upgrade Guide7
Solaris example: JAVA_HOME=$JAGUAR/jdk/jdk1.3
Upgrading the PATRIOT database
Wind ows example: JAVA_HOME=$JAGUAR\shared\sun\jdk\jdk.3
6Set the PATRIOT environment variable. This is the directory where you
initially copied the contents of the PATRIOTcompliance Starter Kit
Solution Template CD.
Solaris example: PATRIOT=$PATRIOT
Wind ows example: PATRIO T=%PATR IO T%
Upgrading the PATRIOT database
Release 2.2 includes scripts t hat allow you to upgrade th e PATRIOT database
(Patriotdb) and New Er a of Networ ks dat abase (NNS Ydb). Ther e are separ ate
instructions for Solaris and Windows-based installations.
Solaris
Windows
Use these instructions to upgrade your database on Solaris.
1Open a command window. Navigate to the
$PATRIOT/release2.2/database directory.
2Execute the PatriotDB2.2_Upgrade.sql script, with the follo win g syntax:
3Review and correct any errors in the output file.
Use these instruction to upgrade your database on Windows.
1Open a command window. Navigate to the %PATRIOT%\data base
directory.
2Execute the PatriotDB2.2_Upgrade.sql script, with the follo win g syntax:
3Review and correct any errors in the output file.
8PATRIOTcompliance Starter Kit
Modifying PATRIOT connection caches
PATRIOTcompliance Starter Kit 2.2 includes a script which creates a
mechanism for customers who want to make their EP instance use non-sa
database logins. These logins include sufficient permissions to let EP
applications(s) connect to the patriot database, portal interface, and search
cache.
CHAPTER 2 Upgrading to version 2.2
Adding a non-sa user connection involves running a script,
that creates three new login names PATRIOTdbConnection,
PortalInterfaceCache, and epSearchCache. You then open Jaguar Manager
in EAserver to add the actual connections.
This step resolves CR# 333653 is optional and not required for successful
deployment.
Executing the upgrade script
This section tells you how to execute the upgrade script. There are separate
instructions for Solaris and Windows-based installations.
Solaris
Use these instructions if you are upgrading a Solaris-based installation.
1Open a command window, and navigate to the
$PATRIOT/release2.2/database directory.
2Execute the ep_login.sql script, with the following syntax:
isql -S <ASE server name> -U sa -P <ASE_password> i ep_login.sql -o <outputfile>
3Review and correct any errors in the output file.
ep_login.sql,
Windows
Use these instructions if you are upgrading a Windows-based installation.
1Open a command window, and navigate to the
2Execute the ep_login.sql script, with the following syntax:
3Review and correct any errors in the output file.
Adding the connection caches
The next series of steps adds the connection properties for the new login
names.
Upgrade Guide9
%PATRIOT%\release2.2\database directory.
isql -S <ASE server name> -U sa -P <ASE_password> i ep_login.sql -o <outputfile>
Upgrading the PATRIOT database
❖Adding the PATRIOTdbConnection
1Connect to Jaguar Manager as jagadmin.
2Expand Jaguar Manager | Connection Caches.
3Right-click PATRIOTdbConnection, choose Connection Cache
Properties.
When the Connection Cache Properties sheet appears, the General tab is
in focus.
4In the User Name box, change the sa user name to patriotlogin.
5In the Password box, type password.
6Click Refresh, then click Ping to test the connection.
7Click OK to return to Jaguar Manager.
The Connection Cache Properties panel appears.
2In the User Name box, change the sa user name to portaliflogin.
3In the Password box, type password.
4Click Refresh, then click Ping to test the connection.
5Click OK to return to Jaguar Manager.
❖Adding the epSearchCache con nect ion
1Right-click epSearchCache and select Connection Cache Properties.
2In the User Name box, change the sa user name to epsearchlogin.
3In the Password box, type password.
4Click Refresh, then click Ping to test the connection.
5Click OK to return to Jaguar Manager.
6Shut down and restart Jaguar Server.
Non-sa user connection caches to the PATRIOT database lack the appropriate
authority to retrieve data from ASE sybsecurity database. Granting system
security officer role (sso_role) to the user of patriot database connection
resolves this issue. You must run the following procedure for the Pat Audit
Trail portlet to work properly.
10PATRIOTcompliance Starter Kit
CHAPTER 2 Upgrading to version 2.2
Although there is a work around, this issue has been logged in QTS as CR#
361596 and will be addressed in a future release.
❖Granting an sso_role to a patriot db connection user
1Open a command window, and run the following statements:
isql -S <ASE server name> -U sa -P <ASE_password>
2Run the following scripts:
use master
go
grant role sso_role to patriotlogin
go
3Shut down and restart Jaguar Server.
Upgrading Process Server process definitions
This procedure overwrites all process definitions and plug-ins. There are
separate procedures for Windows and Solaris based installations.
Windows
Solaris
Use these instructions if you are upgrading a Windows-based installation.
1Copy the contents of the %PATRIOT%\Re lease2.2\edl directory to
%SYBASE%\ProcessServer-3_9\bin\edl. This overwrites the set of
existing files.
2Open a command window , and change to the %SYBASE%\ProcessServer-
3_9\bin\edl directory.
3Run the following commands:
call EDLUtil put ..\edl\lPatriot.edl
call EDLUtil put ..\edl\pPostFilter.edl
Use these instructions if you are upgrading a Solaris-based installation.
1Copy the contents of the $PATRIOT/Release2 .2/ed l director y to
$SYBASE/ProcessServer-3_9/bin/edl.
2Open a command window, and change to the $SYBASE/ProcessServer-
3_9/edl directory.
3Run the following commands:
Upgrade Guide11
Upgrading formats
Upgrading formats
The standard money transaction and customer reco rd formats have changed for
this release.
The following files have been updated.
•custcomp.exp
•stdcustrecformats.exp
•stdcustrecformatscomp.exp
•stdmoneytransformats.exp
EDLUtil put ..\edl\lPatriot.edl
EDLUtil put ..\edl\pPostFilter.edl
•stdmoneytransformatscomp.exp
Importing the new formats
You will need to import the new formats. Make sure you set NNSY_ROOT to
the %SYBASE%\nnsy (Windows) or $SYBASE/nnsy (Solaris) directory.
Windows
Use these instructions if you are importing the for mats to a Windows-based
installation. Perform this step if you have not updated your formats.
1Create the directory %SYBASE%\nnsy\formats if it does not already exist.
2Copy the format files from the %PATRIOT%\Release2.2\formats\*
directory to the %SYBASE%\nnsy\formats directory.
3Open a command window, and change to the %SYBASE%\nnsy directory.
4Run the following commands:
Running the NNFie commands overwrites formats in your database and
generates conflict warni ngs. Beca use field names do not ch ange and old map s
are not affected, you can ignore these warnings.
Upgrading EAServer compon ents
A new version of the PATRIOT Act EJB and an update t o the jConnect files a re
included with this upgrade.
❖Deleting the existing PATRIOTAct package
Before you can upgrade to 2.2, you must remove the current package.
1Connect to Jaguar Manager as '
2Expand Jaguar Manager | Packages.
3Right-click PatriotAct, choose Delete Package, then click Yes to delete
the package.
4Expand Jaguar Manager | Servers | Jaguar | Installed Services.
5Right-click Loader, choose Remove Service, then click OK to remove
the loader.
Upgrade Guide13
jagadmin'
Upgrading EAServer components
6Right click Scheduler, choose Remove S ervice, then click OK to remove
Make sure the %JAGUAR%\Repository\Component\PatriotAct directory
(Windows) or $JAGUAR/Repository/Component/PatriotAct (Solaris)
directory does not exist. If it does, start Jaguar again and redo steps 1 - 7.
9Start Jaguar Server.
❖Deploying the new dispatcher.jar to Jaguar
Importing an EJB int o the Jaguar Service allows the component to register with
the application server.
1Expand Jagu ar Mana ger, right click Packages, point to Deploy, choose
EJB Jar.
2When the Deploy Wizard appears, click Browse, navigate to one of the
Deployment StrategyFull Deployment
Deployment Options• Prompt before ov erwriting objects
• Automatically generate EJB stubs and skeletons
• Use Interoperable Naming
4Click Next to deploy the file, then click Close to return to Jaguar Manager .
5Expand Jaguar Manager | Servers | Jaguar.
6Right-click Installed Packages, choose Install an Existing Package,
select PatriotAct, then click OK.
❖Creating the Scheduler component
Follow the steps in this section to create a Scheduler component.
1Expand Jaguar Manager | Servers | Jaguar | Installed Packages.
14PATRIOTcompliance Starter Kit
CHAPTER 2 Upgrading to version 2.2
2Right-click PatriotAct, choose New Component.
3When the Component Wizard appears, choose Define New Component,
click Next, and Next again.
4In the Component name box, type Scheduler, click Finish.
5When the Component Properties sheet appears, the General tab is in
focus. Modify the Java Class name to read
com.sybase.patriotact.filter.SchedulerImpl, then click OK to return to
Jaguar Manager.
6Expand the Scheduler component, right-click Interfaces, choose Add
Interfaces.
The Install Interface dialog appears.
7From the Available IDL Interfaces dro p do w n box , cho os e CtsServices.
Three CtsServices appear in the right pane.
8Select CtsServices::Generic Service, click Add, then click Install.
The Scheduler component is now available as part of the PatriotAct
PatriotAct/Scheduler from the list, then click OK to return to Jaguar
Manager.
❖Creating the Loader component
1Expand Jaguar Manager | Servers | Jaguar | Installed Packages.
2Right click PatriotAct, choose New Compo n e nt.
3When the Component W i zard app ears , choo se Define New Component,
click Next, then click Next again.
4In the Component Name box, type Loader, then click Finish.
5When the Component Properties sheet appears, the General tab is in
focus. Modify the Java Class name to read
com.sybase.patriotact.filter.LoaderImpl, then click OK to return to Jaguar
Manager.
6Expand the new Loader component, right-click Interfaces, select Add
7From the Available IDL Interfaces dro p do w n box , cho os e CtsServices.
Upgrade Guide15
Interfaces.
Upgrading EAServer components
Three CtsServices appear in the right pane
8Select CtsServices::Generic Service, click Add, then click Install.
2When the Connection Properties sheet appears, click the Transactions
tab, choose Not Supported
3Click the EJB Refs tab, do this:
In the EJBs referenced in code group, click ejb/NightlyFilter, then set the
Link Value to PatriotAct/NightlyFilter.
4Click the Resource Refs tab, do this:
In the Resource factories referenced in code group, set the Sharing
Scope of the jdbc/CacheName to shareable, then set the Resource Link
to PATRIOTdbConnection.
5Click OK to return to Jaguar Manager.
❖Setting the Loader component properties
1Right-click Loader, choose Component Properties.
2When the Connection Properties sheet appears, click the Transactions
tab, choose Not Supported.
3Click OK to return to Jaguar Manager.
❖Setting the NightlyFilter component properties
1Right-click NightlyFilter, choose Comp on ent Properties.
2When the Connection Properties sheet appears, click the Transactions
tab, choose Requires New.
3Click the Resource Refs tab, do this:
•In the Resource factories referenced in code g roup, set t he Sharing
Scope of the jdbc/CacheName to sharable, then set the Resource
Link to PATRIOTdbConnection.
• In the Resource factories referenced in code group, set the Sharing
Scopeof the j dbc/DBConnect ion to shareable, then set the Resource
Link to PATRIOTdbConnection.
4Click OK to return to Jaguar Manager.
❖Setting the Scheduler component properties
1Right-click Scheduler, choose Component Properties.
2When the Connection Properties sheet appears, click the Transactions
3Click OK to return to Jaguar Manager.
Upgrade Guide19
tab, choose Not Supported.
Configuring Portlets
❖Setting the TableClean component properties
1Right-click TableClean, choose Component Properties.
2When the Connection Properties sheet appears, click the Transactions
tab, choose Requires New.
3Click the Resource Refs tab, do this:
In the Resource factories referenced in code group, set the Sharing Scope of the jdbc/CacheName to shareable, then set the Re source Link
to PATRIOTdbConnection.
4Click OK to return to Jaguar Manager.
5Shutdown and restart EAServer.
Configuring Portlets
This section tells you how to install and configure the 2.2 portlets .
❖Setting single login properties
Previous versions of PATRIOT Starter Kit sometimes allowed users to login
more than once with the same login name. Updates to the
portalinterface.properties allow you to restrict users to a single login at a time.
1Back up the following files.
Note
Directory paths below are in UNIX notation. For DOS, change forward
slashes to back slashes; change $JAGUAR to %JAGUAR%.
If WinZip notifies you that you are about to overwrite existing files, click
Yes to confirm the file overwrite.
3Back up $JAGUAR/html/classes/portalinterface.properties.
4Use a text editor to open portalinterface.properties.
5Add the following properties to the end of the file:
4Select Import Portlet from Archive and press ENTER.
5Select Import Archived Portlets and then press
ENTER.
This step imports the portlets. Choose ALL to any overwrite question;
choose No to any create duplicate question. An Import Done message
notifies you when this process is complete.
6Select X and X to exit the PortalZipper tool.
7Shut down and restart Jaguar Server.
Solaris
Use these instructions in install the 2.2 portlets on Solaris.
1Copy the *.pz files from $PATRIOT/portlets to $SYBASE/PortalInterface-
Upgrade Guide21
2_5/bin.
Configuring Portlets
2With ASE and Jaguar Server running, open a command window, and
change to the $SYBASE/PortalInterface-2_5/bin directory.
3Run pz.sh with the following syntax:
pz.sh -H <ASE_hostname> -N <ASE_Port> -U
<ASE_username> -P <ASE_password> -F
PatriotPortlets22.pz.
4Select Import Portlet from Archive and press ENTER.
5Select Import Archived Portlets and then press
This step imports the portlets. Choose ALL to any overwrite question;
choose No to any create duplicate question. An Import Done message
notifies you when this process is complete.
6Select X and X to exit the PortalZipper tool.
7Shut down and restart Jaguar Server.
Creating directories for the class files
If the following directories do not exist, create these directories for the new
class files.
Note
Directory paths below are in UNIX notation. For Wi ndo ws, chang e forward
slashes to back slashes; change $JAGUAR to %JAGUAR%.
This section tells you how to install the Account Management portlet. There
are separate instructions for Windows and Solaris-based installations.
Windows
Use these instructions to inst all the Account Manage ment portlet o n Wi ndows.
1With ASE and Ja guar Server run ning, open a command window , and copy
%PATRIOT%\Portlets\PatAcctManagementPortlet.pz to
%SYBASE%\PortalInterface-2_5\bin.
2Change to the %SYBASE%\PortalInterface-2_5\bin directory.
3Run pz.bat with the following syntax:
4Select Import Portlet from Archive and press ENTER.
5Select Import Archived Portlets and then press
ENTER.
This step imports the portlets. Choose ALL to any overwrite question;
choose No to any create duplicate question. An Import Done message
notifies you when this process is complete.
6Select X and X to exit the PortalZipper tool.
7Change to %JAGUAR%\html\portal\html\v4 directory, and use an editor
to change the properties of the ilab_changeInfo.html and
ilab_changePWD.html files. In both files, change the line that reads:
8Change to the %JAGUAR%\html\classes\com\sybase\ilab\pi\pim\tasks
directory, and rename PIMControl.class to PIMControl.class.old
9Shut down and restart Jaguar Server.
Solaris
Use these instructions to install the Account Management portlet on Solaris.
1With ASE and Ja guar Server run ning, open a command window , and copy
$PATRIOT/Portlets/PatAcctManagementPortlet.pz to
$SYBASE/PortalInterface-2_5/bin.
2Change to the $SYBASE/PortalInterface-2_5/bin director y.
Upgrade Guide23
Configuring Portlets
3Run pz.sh with the following syntax:
pz.sh -H <ASE_hostname> -N <ASE_port_number> -F
PatAcctManagementPortlet.pz
4Select Import Portlet from Archive and press ENTER.
5Select Import Archived Portlets and then press
ENTER.
This step imports the portlet s. Choose ALL to any overwrite question. An Import Done message notifies you when this pro cess is complete.
6Select X and X to exit the PortalZipper tool.
7Change to the $JAGUAR/html/portal/html/v4 directory, and use an editor
to change the properties of the ilab_changeInfo.html and ilab_changePWD.html files. In both files, change the line that reads:
<jtf:setProperty name="IIOP_URL"
value="iiop://yongming-pc:9000"/>
to
<jtf:setProperty name="IIOP_URL"
value="iiop://<yourhost>:<yourport>"/>
8Change to the $JAGUAR/html/classes/com/sybase/ilab/pi/pim/tasks
directory, and rename PIMControl.class to PIMControl.class.old
9Shut down and restart Jaguar Server.
Verifying the Account Management portlet deployment
This step tells you how to test the Account Manager portlet.
1Start Internet Explorer and enter the URL:
http://<jaguar_hostname>:8080/.
2Log into Portal Interface using the user ID, pso, with the password
123qwe.
3Click the Admin link at the top of the page.
4On the Admin Entry Page, click Choose Portlets from the Admin
Portal Control.
5On the Choose Portlets panel, move the Account Management portlet
from the A vailable Portlets box to the Selected Portlets b ox, clic k Done.
6From the Customize drop down box, choose the PATRIOT Test page.
24PATRIOTcompliance Starter Kit
CHAPTER 2 Upgrading to version 2.2
The PATRIOT Test page should display with the new portlet accessible.
Setting up Account Management for the pacuser
To enable access to each of the PATRIOT portlets for pacuser, you need to
modify the properties for each portlet and include the PIUser Role as detailed
below. These instruction assume that you are logged in as ‘pso’.
1Select the Admin link on the Welcome bar at the top of the brow ser to
enter Administrative mode.
2From the Select a Page drop down box in the upper right-hand corner of
the page, select the PATRIOT Test page.
The PATRIOT Test page appears with the new Account Management
portlet accessible.
3For the Account Management portlet, do this:
•Click the Edit link in the title bar and modify the URL property from
iiop://yongming-pc:9000
to
iiop://<yourhost>:<yourport>
then click Done.
•From the Select a Page drop down box, select the PATRIOT Test
page to return to the Admin Entry Page.
•Select the P A TRIOT T est link in the snail trail to navigate back to the
PATRIOT Test page
•Select the icon located next to the Edit hyperlink in each of the portlet
title bars on the page.
•On the Window Properties panel, se lect the Edit Portlet Properties
link to display the Edit Portlet panel containing the portlet properties.
•In the Portlet Rights section, select the PIUser role from the Role
List and click the right arrow to move it to the Roles with Rights to
this Portlet list on the right.
4Log out of Portal Interface.
Upgrade Guide25
•Click Done.
Configuring Portlets
5Change to the %JAGUAR%\html\classes\com\sybase\ilab\pi\pim\tasks
directory (Windows) or
$JAGUAR/html/classes/com/sybase/ilab/pi/pim/tasks (Solaris) and
rename PIMControl.class.old to PIMControl.class.
6Shut down and restart Jaguar Server.
Creating the Account Management portlet for pacuser
Multiple portlet pages will be created for the PATRIOTcompliance Solution,
and each page includes a number of the portlets imported into the Portal
Interface.
1Start Internet Explorer and enter the URL:
http://<jaguar_hostname>:8080/
2Log into Portal Interface using the user ID pacuser with the password
pacuser.
3Click Add Page in the Portal Control. Name this page Account
Managment and click Done.
4When the Choose Portlets panel appears, select Account Management
from the A vailable Portlets box on the left and click the right arrow to
move each portlet to the Selected Portlets box on the right.
5Click Done to save the portlet page with the selected portlets.
6Log out of Portal Interface and close the browser.
Verifying deployment of the new and updated portlets
Test the newly deployed portlets.
1If you are not logged in as pso, start Internet Explorer and enter the URL :
http://<jaguar_hostname>:8080/, and log into Portal Interface with the
user ID pso and password 123qwe.
2Select the Admin link on the Hello, New Portal User bar at the top of the
page to enter the Admin Entry Page.
3From the Customize drop down box, choose the page you want to use to
test the portlets, PATRIOT Test, for example. Or you can create a new
page to test the portlets. Click Done.
26PATRIOTcompliance Starter Kit
4 On the Choose Po rtlets panel , choose the new and up dated portlet s from
the Available Portlets box and move them into the Selected Portlets box.
These include:
•Pat Logged In Users
•Pd Exp Notification
•Stop Words Candidate
5Click Done.
6From the Customize drop down box, choose the page where you added
the portlets, PATRIOT Test for example.
The test page appears with the portlets you selected.
Setting up the new portlets for pacuser
CHAPTER 2 Upgrading to version 2.2
This series of steps tell you how to grant pacuser access rights to the new and
updated portlets. This section assumes you are logged in as pso.
Note
The Pat Logged In Users portlet is intended for pso users only. Do not grant
access rights to this portlet to pacuser.
1On the Admin Entry Page, choose the test page, PATRIOT Test for
example, where you added the new portlets from the Customize drop
down box.
2When the test page appears, do this for each new portlet on the page.
•Click the icon next to the Edit link on the title bar, and when the the
Window Properties panel appears, click Edit Portlet Properties.
•On the E dit Portlet panel, in the Portlet Rights gro up, mov e
PIUserfrom the Role List into the Roles with Rights to this Portlet
box.
•Click Done.
•Choose the test page, PATR IOT Test for example, where you add ed
the new portlets from the Customize drop down box.
3Log out of Portal Interface.
Upgrade Guide27
Configuring Portlets
Creating portlet pages for pacuser
1If you are not log ged in as pacuser, start Internet Explorer , enter the URL:
http://<jaguar_hostname>:8080/, and log into Portal Interface with the
user ID pacuser and password pacuser.
2On the Home Page, click Add Page from the Portal Control, name the
page, click Done.
3On the Choose Portlets panel, move the appropriate portlets from the
Available Portlets box into the Selected Portlets box on the righ t. Click
Done.
Each Patriot portlet page should now be accessible from the Personalize
drop down box in the upper right-hand corner. Select each of these pages
to verify that the portlets have been installed and configured properly.
4Repeat steps 2-3 to add the appropriate portlets for each new portlet page
5Log out of Portal Interface and close the browser.
compliance solution 1
issues addressed in this release 4
Upgrade Guide29
Index
L
loader
component proper ties 19
creating 15
stubs and skeletons 16
loading 6
login prope rties 20
N
NightlyFilter
component proper ties 19
O
overview
compliance solution 2
upgrading 4
P
pacuser
account management portlet setup 25
creating account management portl et 26
creating portlet pages for 28
new portlet setup 27
PATRIOT database
modifying connection caches 9
upgrading 8
PATRIOTAct
stubs and skeletons 17
PATRIOTAct package
deleting 13
Portlets
account manageme nt 23, 24, 25, 26
class file directories 22
configuring 20
installing new portlets 21
login prope rties 20
new portlets and pacuser 27
pacuser pages 26
pacuser portlet pages 28
setting up pacuser 25
verifying depl oyment 24
verifying new port lets 26
preface v
Process Server
upgrade definitions 11
process server defin iti ons
importing 12
upgrading 11
R
release contents 6
S
scheduler
component properties 14, 19
creating 14
stubs and skeletons 16
scripts
execute upgrade 9
stubs and skeletons
loader 16
PATRIOTAct 17
scheduler 16
system environment
verify variables 7
T
TableClean
component properties 20
U
upgrade
execute scripts 9
Process Server definitions 11
version 2.1 3
upgrading
contents 6
database upgrade 8
30
PATRIOTcompliance Starter Kit
EAServer components 13
environmenatal variables 7
formats 12
issues addressed in this release 4
loading 6
modifying co nn e ction caches 9
overview 4
portlets 20
Process Server definitions 11
upgrading da tabase 8
V
variables
verify system environment 7
verify
system environment 7
version 2.1
upgrade 3
Index
Upgrade Guide31
Index
32
PATRIOTcompliance Starter Kit
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.