Cisco Cisco Customer Voice Portal Downloads User Guide
C
HAPTER
3:
A
DMINISTRATION
V
OICE
XML
S
ERVER
U
SER
G
UIDE
FOR
C
ISCO
U
NIFIED
C
USTOMER
V
OICE
P
ORTAL
R
ELEASE
4.0(1)
47
the application should be updated followed by resuming it from its suspended state. This
way, no caller will be in the system when the changes are made. The only disadvantage to
this approach is that it will make the application unavailable for a period of time as opposed
to a transparent change if the update feature alone is used. This may be a necessary tradeoff
considering the consequences.
way, no caller will be in the system when the changes are made. The only disadvantage to
this approach is that it will make the application unavailable for a period of time as opposed
to a transparent change if the update feature alone is used. This may be a necessary tradeoff
considering the consequences.
When the update occurs, the event created by the VoiceXML Server to send to any loggers
that are listening will reflect when the update script was run, not when it completed.
If an error occurs during the update process, e.g., due to an incorrectly configured XML file,
a description of the error is displayed to the console window and sent to any loggers listening
to the appropriate logger events and the update is cancelled.
to the appropriate logger events and the update is cancelled.
Suspending Applications
There are many situations when an application needs to be temporarily suspended. There could
be scheduled maintenance to the network, the voice application could have an expiration date
(say it runs a contest that must end at a specific time), or the application is to be turned off while
enterprise-wide improvements are made. There may also be situations where all applications are
to be put in suspension if modifications are being made that affect all applications. In each of
these situations, a caller would need to be played a designer-specified message indicating that the
application has been temporarily suspended, followed by a hang-up. This is preferable to simply
not answering or taking down the system, which would cause a cryptic outage message to be
played.
be scheduled maintenance to the network, the voice application could have an expiration date
(say it runs a contest that must end at a specific time), or the application is to be turned off while
enterprise-wide improvements are made. There may also be situations where all applications are
to be put in suspension if modifications are being made that affect all applications. In each of
these situations, a caller would need to be played a designer-specified message indicating that the
application has been temporarily suspended, followed by a hang-up. This is preferable to simply
not answering or taking down the system, which would cause a cryptic outage message to be
played.
First, the application designer defines the suspended message in the Application Settings pane in
Unified CVP VoiceXML Studio. When the suspend order is given, Unified CVP VoiceXML
Server produces a VoiceXML page containing this suspended audio message to all new calls
followed by a hang-up. Since the VoiceXML Server gracefully allows all calls currently on the
system to finish normally when the command was issued, existing callers are unaware of any
changes. Once all the old calls are completed and all new callers are receiving the suspended
audio message, the VoiceXML Server reports the application as being successfully suspended
for all callers. Only then is it safe for the administrator to perform the system maintenance that
required callers to be prevented from entering the application.
Unified CVP VoiceXML Studio. When the suspend order is given, Unified CVP VoiceXML
Server produces a VoiceXML page containing this suspended audio message to all new calls
followed by a hang-up. Since the VoiceXML Server gracefully allows all calls currently on the
system to finish normally when the command was issued, existing callers are unaware of any
changes. Once all the old calls are completed and all new callers are receiving the suspended
audio message, the VoiceXML Server reports the application as being successfully suspended
for all callers. Only then is it safe for the administrator to perform the system maintenance that
required callers to be prevented from entering the application.
The scripts for suspending and resuming applications are found in the
admin
folder of the
application to be suspended. Windows users should use the script named
suspendApp.bat
and
Unix users should use the script named
suspendApp.sh
. To resume the application, use the
script named
resumeApp.bat
or
resumeApp.sh
.
It is possible to suspend all applications at once by accessing a script found in the
admin
folder
of Unified CVP VoiceXML Server. Windows users should use the script named
suspendServer.bat
and Unix users should use the script named
suspendServer.sh
. To restore
all applications to their original status, use the script named
resumeServer.bat
or
resumeServer.sh
. Note that these scripts do not resume all applications; they simply restore the
administrator-specified status of each application. So if an application was already suspended
when the server was suspended, resuming the server leaves the application in a suspended state.
when the server was suspended, resuming the server leaves the application in a suspended state.