Setting up "autologin" for the CA Workflow worklist

Products

• CA IT Asset Manager
• CA Software Asset Manager (CA SAM)
• ASSET PORTFOLIO MGMT- SERVER
• Activator
• eTrust ALERT
• eTrust ALERT for CICS
• ALERT
• Archiver
• ASM/ARCHIVE VSE-ESA OPTION
• ASM/Archive
• AutoAction
• AutoSys Job Management Adapter for AutoXfer
• Process Automation Manager
• Portal
• ARCserve Backup Client
• CICSORT
• Clipper
• COBOLVISION Analyzer
• CTO Distributed
• Dart
• Datesolver/2000
• Distribulink
• EUREKA:Object
• EPIC VM
• Enterprise
• Endevor for Unix
• Archiver Disk Option
• EPIC Backup
• EPIC Access Option
• EPIC SUPER SYS
• EPIC for CMS System
• EPIC TAPE MANAGEMENT
• eTrust Antivirus Gateway for CVP
• eTrust Content Inspection Gateway
• eTrust Content Inspection Gateway Option for MSP/ISA EE
• eTrust Antivirus Gateway for Netscape
• eTrust VPN Enterprise Edition
• FAQS VM
• FAQS Automated Systems Operation
• Global Subsystem (GSS)
• ANDYNE
• MAINFRAME MISCELLANEOUS
• Inventory Discovery Server
• ARS Resource Management
• JARS Resource Management ACC Option
• JOBDOC
• JOBWATCH
• Look
• MAZDAMON
• Service Management Affiliate Technology Partner Fee
• Service Management Basic Technology Partner Fee
• Metanet
• MF - MISC OLD CODES
• Omniguard for CICS
• Omniguard
• Opera
• Connect
• PREVAIL
• Paramount XP CAM FOR DIST SYS
• Paramount FOR NAVIGRAPH/HOST
• Research Planmacs Unlimited
• Project Planner
• Remote Console PREVAIL/XP-AUTOMATION PHASE 1
• Remote Console PREVAIL/XP AUTOMATION-RDF/SSM
• Raps
• Research Raveler
• Generic Non Product
• SOLVE:EPS
• Unicenter NetMaster Network Management for SNA
• Alexandria
• Sort System
• SPOOLMAN
• Storage Mainframe
• SYSTEM/SCHEDULER
• SYSTEM/SCHEDULER VSE-ESA OPTION
• System/Manager
• Tape/Manager VSE-ESA OPTION
• Output Management Document Server
• TNG Network and Systems Management Agent for CA-Datacom
• DFSMShsm Workstation
• Network and Systems Management UNIX SMTP
• Unicenter Management for Microsoft Exchange SMTP Option
• UNICENTER II
• Unicenter Network and Systems Management Database Performance Monitor Option
• UNICENTER OSM
• Database Command Center Mnt
• VM:DBA
• VM:DB Admin
• VM:DB Center
• VM:DB Developer
• VM:DB Editor
• VM:DB Monitor
• VM:DB Reorganizer
• VM:DB Reporter
• VM:DB Restore
• VM:DB REXX
• VM:DB SQLMAP
• VM:DB Suite
• VM:Migrate
• VM:Monitor
• VM:Notekeeper
• V/Solver
• VM:Webserver for Officevision
• VM:Webserver Secure
• VM:Webgateway
• VM:Webserver
• XMENU for z/VM
• VISION:COMBO for TSO
• VISION:DAGER
• VISION:ELEVEN
• VISION:EIGHTY
• VISION:Online
• VISION:IQ for Informix
• Automate
• CA Service Catalog
• SUPPORT AUTOMATION- SERVER
• CA Service Desk Manager - Unified Self Service
• CA Service Desk Manager
• CA Service Management - Asset Portfolio Management
• CA Service Management - Service Desk Manager

Issue/Introduction

Description

This document will go over how to enable the "autologin" feature for CA Workflow version 1.0 that is embedded with Unicenter Service Desk r11.2.

Solution

There is a minimum build version requirement for CA Workflow to be at 1.0.019 build 52. The current patch release (as of the writing of this document) for the CA Workflow embedded with Service Desk is build 59. We encourage you to apply the most current build of Workflow to your Service Desk installation.

There is also a requirement the EEM (eIAM) be attached to Active Directory, and that the users who will be accessing the worklist are added to the Service Desk application group within EEM.

In order to enable the "autologin" functionality for CA Workflow worklist, the web.xml file in the wl-web.war file must be modified.

You have two choices for making the modification. This can either be done via command line using the JAVA SDK, or the file can actually be modified directly within the archive using WinZip.

To use the command line, first you must install the 1.4.2 JDK. This cannot be done with a version of Java later than 1.4.2 - the most current archived release of 1.4.2 on the Sun site is 1.4.2_18.

Once this is installed, navigate to the $NX_ROOT/site/Workflow/Server/dist directory. Here you will see two war (web archive) files: processmanager.war and wl-web.war.

Create a new temp directory here so that you have a path of $NX_ROOT/site/Workflow/Server/dist/temp

Open a command window now and navigate to this temp directory. You will also need to know the directory path where the JDK was installed. The default path for a windows installation is c:\j2sdk1.4.2_18. The examples here will use that path. The Service Desk service will need to be stopped, so from here run pdm_halt -w

Once Service Desk is shut down issue the following command:

C:\j2sdk1.4.2_18\bin\jar -xvf ..\wl-web.war

Again you should only do this from an empty directory, the path above assumes you have created such an empty directory under $NX_ROOT/site/Workflow/Server/dist and are issuing the command from this new directory.

Going into Windows Explorer you will now see in this temp directory, all the files and folders extracted from the war file (see Figure 1):

<Please see attached file for image>

Figure 1:

Find web.xml and open it with a text editor and make the following modifications:

1. Remove the comment mark to uncomment the auto login filter
   
   
2. Add a comment mark after the "....Active Directory" (see Figure 2):
   
   

   <Please see attached file for image>

   
   
   Figure 2:
   
   
3. Remove the comment mark to uncomment the auto login filter mapping
   
   
4. Add a comment mark after the "......automatic login." (see Figure 3):
   
   

   <Please see attached file for image>

   
   
   Figure 3:
   
   Once the web.xml file has been modified and saved, issue the following command:
   
   C:\j2sdk1.4.2_18\bin\jar -cf wl-web.war *
   
   Again this command should be run only from the temp directory where the files were extracted. The asterisk after the file name is required to create the war file. Make sure there is a space between .war and the asterisk. A new file named wl-web.war will be created in this directory.
   
   You will need to rename the wl-web.war file that is currently in the $NX_ROOT/site/Workflow/Server/dist directory - make sure to rename it so that it no longer has a .war extension, otherwise it will be read as a valid web archive file and be deployed. We suggest renaming the file to wl-web.war.orig
   
   Copy the new wl-web.war file from $NX_ROOT/site/Workflow/Server/dist/temp into $NX_ROOT/site/Workflow/Server/dist (see Figure 4):
   
   

   <Please see attached file for image>

   
   
   Figure 4:
   
   Restart Service Desk and open a browser and go to http://machinename:port/wl where machinename is the servername where Service Desk is installed, and the port is the port number for Service Desk and CA Workflow - by default the port is 8080.
   
   The first time the jsp is getting compiled it may take a couple of minutes to complete the login process, but you will see that you are automatically logged into the worklist.
   
   The second choice is to modify the web.xml file directly within the .war file.
   
   Open $NX_ROOT/site/Workflow/Server/dist/wl-web.war with WinZip - do not extract it - and locate the web.xml file (see Figure 5):
   
   

   <Please see attached file for image>

   
   
   Figure 5:
   
   Right click on that file and open it with a text editor, and modify the file as was described above. Save the change to the file and then close the file.
   
   As soon as you close the file you will see the following (see Figure 6):
   
   

   <Please see attached file for image>

   
   
   Figure 6:
   
   Select yes, the archive will be reloaded and your changes saved to it.
   Close WinZip.
   
   Restart Service Desk and open a browser and go to http://machinename:port/wl where machinename is the servername where Service Desk is installed, and the port is the port number for Service Desk and CA Workflow - by default the port is 8080.
   
   The first time the jsp is getting compiled it may take a couple of minutes to complete the login process, but you will see that you are automatically logged into the worklist.

Environment

Release:
Component: ARGIS