Resolution:
Description:
============
When trying to migrate procedure versions using swutil PROC RELEASE, the procedure is released but cases are not migrated.

Environment:
============
o TIBCO iProcess Engine 11.1.x

Cause:
======
There are multiple causes.

1). Missing -m/-M flag or lack of ALL.

2). Incorrect syntax eg swutil PROC RELEASE &ltProcname> &ltversion> -m/-M instead of swutil PROC RELEASE &ltprocname> &ltversion> &ltcomment> [flags]. This can lead to the -m being displayed in the comment (as seen by plist -P &ltprocname>)

3). Failure to initialize the eai layer if using swutil PROC RELEASE ... ... -M

Resolution:
===========

1). Run the following:

plist -Pv &ltprocname>

plist -cvv &ltprocname>

2). Check whether the penultimate column contains the correct value for version for the cases.

3). Check sw_warn for BG errors on MIGRCASE or PStaffifc errors in sw_error.log.

4). Check environment variables such as library path and permissions if you see the folowing error:

the iPE user running the command needs read access to the .ear file
Pstaffifc:28030:28030:2::::swadmin:/proeai.c:81845:2369): 1866-Failed to load 'EAIJAVA' EAI Run-Time Plug-In library '/staffware/installs/ipe/11103al/lib/EAI_JAVA_i11_2_0_0.ear', error '/staffware/installs/ipe/11103al/lib/EAI_JAVA_i11_2_0_0.ear: cannot open shared object file: Permission denied'

5). Set debug and re-execute.

a). Create a new copy of the procedure version.

b). Run plist -Pv &ltprocname> again

c). DEBUG on UNIX iPE Server
DEBUG=ALL=255,F=7,f=7,TIME=ABS,FLAGS=FU

export DEBUG

d). DEBUG on Windows iPE server (32bit platform)
Find the following Key:

HKEY_LOCAL_MACHINE\SOFTWARE\Staffware plc\Staffware Server\Nodes\&ltnodename>

Create a string value called DEBUG

Set this to ALL=255,F=7,f=7,TIME=ABS,FLAGS=FU

e).  DEBUG on Windows iPE server (64bit platform)
Find the following Key:

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Staffware plc\Staffware Server\Nodes\&ltnodename>

Create a string value called DEBUG

Set this to ALL=255,F=7,f=7,TIME=ABS,FLAGS=FU

7) Rerun the command checking the syntax

8). Capture return code

a). Windows
echo %ERRORLEVEL%

b). Unix
echo $?

9). Send all outputs including the file sw_warn/sw_warn.log,sw_error/sw_error.log,staffifc??.log/Pstaffifc??.log

to Tibco Support call.

Attachments:
============
List the filename and description of any attachments that are a part of this KB article.

References:
===========
TIBCO iProcess Engine swutil and swbatch reference guide.

When trying to migrate procedure versions using swutil PROC RELEASE -m/-M, the procedure is released but cases are not migrated.