Cisco Cisco Customer Voice Portal 8.0(1) User Guide

Page of 156
C
HAPTER 
3:
 
A
DMINISTRATION
 
 
U
SER 
G
UIDE FOR 
C
ISCO 
U
NIFIED 
CVP
 
VXML
 
S
ERVER 
 
 
 
AND 
C
ISCO 
U
NIFIED 
C
ALL 
S
TUDIO
 
 
 
 
75 
 
If an application relies on files found within its folder at runtime, there may be problems with 
existing callers reaching a point where these files are needed and they will not be found.  
 
This process may not work on Microsoft Windows since Windows will not allow the deletion 
of a folder when resources within it are open. For example, the application loggers may have 
open log files located within the application’s 
logs
 folder. This may work if no loggers are 
used or the only loggers used are those that do not manage files stored in the 
logs
 folder.  
JMX Interface 
To delete an application using the JMX interface, use a JMX client connected to the server to 
navigate to the 
VoiceApplication/<APPNAME>/Command
 MBean, where 
APPNAME
 is the name of 
the application to update. The operations tab of this MBean will list a function named 
“releaseApplication”. Pressing this button will cause the application to be suspended and then 
removed from memory when all active callers visiting the application at the time the function 
was executed have completed. 
The administrator should be aware that there is no confirmation when this function is called, the 
application is suspended and removed from memory immediately once executed.  
Note that while the function returns immediately, the application will remain active if there were 
calls visiting the application at the time of the release. Only when all existing callers end the call 
will the application be removed from memory. To determine if there are active callers, use the 
status function. 
To delete all applications whose folders have been removed from the 
applications
 folder of 
VXML Server using the JMX interface, navigate to the 
Global/Command
 MBean and click on 
the function named “releaseAllOldApps” in the operations tab. The results will be displayed in a 
dialog box, listing each application deleted. As with the application-specific update, use the 
status function to determine when the callers finish their visits to the applications. 
Administration Scripts 
The scripts for deleting an application are found in the 
admin
 folder of the application to be 
updated. Windows users should use the script named 
releaseApp.bat
 and Unix users should 
use the script named 
releaseApp.sh
.  
The script will first ask for confirmation of the desired action to prevent accidental execution. To 
turn off the confirmation, pass the parameter “noconfirm”. By default, the script does not return 
to the command prompt until all callers are finished with their calls. Interrupting the countdown 
will not stop the release process. To turn off the countdown, pass the parameter “nocountdown”. 
If the countdown is interrupted or the script is passed the nocountdown parameter then the only 
way to determine how many callers are actively in the application is to execute the status script 
for the system.