Cisco Cisco Unified Customer Voice Portal 11.0(1) User Guide

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

 

 

 

74 

Alternatively, to deploy a single new application, first use the function named “listAllNewApps” 
in the operations tab to get a list of new application names. Then use the “deployNewApp” 
function to deploy the desired application by name. 

The script for deploying a specific application is found in the 

admin

 folder of the application to 

be deployed. Windows users should use the script named 

deployApp.bat

 and Unix users should 

use the script named 

deployApp.sh

. The script for deploying all new applications at once is 

found in the 

admin

 folder of VXML Server. Windows users should use the script named 

deployAllNewApps.bat

 and Unix users should use the script named 

deployAllNewApps.sh

. 

VXML Server exposes two administrative functions to handle the removal of application(s) from 
memory at runtime. Determining which function to use will depend on the operating system and 
whether the application being removed is actively handling calls. 

The first method involves executing the release application function of the application to be 
removed. This prompts VXML Server to first suspend the application then remove it from 
memory when all the active callers at the time the function was executed, have naturally ended 
their sessions. It suspends the application first to prevent new callers from entering the 
application. Once all active callers are done visiting the application the folder of the application 
can be deleted (or moved) from the VXML Server 

applications

 folder. This function affects 

only a single application so if multiple applications are to be removed using this method, the 
administrator would have to execute this function for each application. 

Note that on the Microsoft Windows operating system, a user attempting to delete an application 
folder after the releaseApp function is called may be prevented from doing so by the operating 
system if the application references Java application archive (JAR) files placed within the 

java/application/lib

 or 

java/util/lib

 directories. This is due to the system keeping an 

open file handle for JAR files that will not be released until a garbage collection event occurs. As 
a result, the administrator will have to wait until the garbage collector activates before being able 
to delete the directory. The time to wait will be determined by how often garbage collection is 
run. A rule of thumb is that a high load system or one with a small amount of memory will 
encounter garbage collection often, a low volume system or one with a large amount of memory 
will take longer.  

The second method supports the ability to delete multiple applications at once. This time one 
must first delete (or move) the folders holding the desired applications to be deleted. After 
which, the flush all old applications function is executed and VXML Server will suspend then 
remove from memory all the applications that it no longer finds in the 

applications

 folder. As 

with the other method, the application is not removed from memory until all callers have ended 
their visits. 

There are certain issues with the second method: