4-64
Cisco VISM Installation and Configuration Guide
Release 3.0, Part Number OL-2521-01 Rev. D0, June 2004
Chapter4 Configuring VISM Features
Configuring Additional VISM Features
When the call agent requests that an announcement is to be played toward the TDM network on an
unconnected endpoint, you can specify the codec to be used.
Another level of directories might be configured to group announce m ent files by la ngu age. T hes e
directories would be specified by the call agent (or when provisioning the VISM) as part of the
announcement file name. For example, the call agent might specify the announcement file name to be
english/ann1.au. If the file was encoded in G.729a and the prefix was /tftpboot, the file would reside at
/tftpboot/g729_a/english/ann1.au.
VISM Announcement Cache Management
VISM maintains an announcement cache in resident memory. When an announcement is requested to be
played, it is retrieved from the announcement file server and placed in the on-board announceme nt
cache. Subsequent requests for the same announcement do not require retrieval of the annou ncement file
from the announcement file server.
Note An announcement in one encoding is a different file than the same announcement in a different
encoding.
Announcement Expiry
You can provision an announcement aging policy. Once an announcement has aged (reached expiry) in
the on-board cache, it is refreshed—retrieved again from the announcement file server. This provides
you with the means to balance the cost of file server access with the time before an announcement
changed on the file server is propagated to the VISM. In addition, you can delete dynamic files from the
announcement cache at any time.
Permanent Announcements
You can provision permanent announcements for VISM. A permanent announcement is retrieved from
the announcement file server and installed permanently in the VISM announcement file cache.
Permanent announcements are excluded from aging ( and bei ng a utom at ic all y refr esh ed ) an d exc lude d
from being replaced if the announcement cache becomes full. Permanent annou nceme nts can o nly be
removed from the cache explicitly by using a CLI command. If VISM is reset or fails over to a standby
card, permanent announcements are retrieved as soon as the card becomes active. The announcement
encoding must be specified when provisioning or deleting permanent a nn oun ceme nts.
Use the CLI commands in Tabl e 4-8 to configure the announcement file system feature.
Table4-8 Announcement File System Feature CLI Commands
Command Description
addannpermanent Configures an announcement server file and associated codec type as
permanent.
cnfannagetime Configures the time that a nonpermanent announcement is to remain valid after
it is placed into the VISM announcement cache.
cnfanndn Designates an announcement file server domain name.
cnfannpathprefix Designates the main prefix directory TFTP path from which to retrieve
announcement files from the announcement file server.