Appendix B: Template file (Tivoli Netcool/Proviso pre-v4.4.3 only)
IBM Tivoli Netcool/Proviso Cisco IP Telephony 2.4.0.0 Technology Pack 91
URI
The DataChannel UBA application needs to know where to find the bulk input files that the supported device
generates. Therefore, you must specify a Universal Resource Identifier (URI) for the location of the bulk input
files. To define this location, the Cisco IP Telephony Technology Pack provides a URI parameter in its
voip_cisco_ipt_sample_dc.cfg template file.
You must specify the URI for each CCM Publisher bulk adaptor configured in the dc.cfg file.
Note: The URIs that you specify in the dc.cfg file must match the URIs of each CCM Publisher data source
defined in the odbc.ini file.
Follow these guidelines when specifying a URI in the template or dc.cfg file:
Use Internet-standard URIs.
Specify the file protocol, FTP (File Transfer Protocol), or SFTP (secure FTP).
The file protocol is appropriate only when specifying a path on the same host computer.
When using the file protocol, specify a full absolute path after the initial file://. This results in three
slashes after the word file, because the full path must begin with a slash.
When using FTP or SFTP, use the following syntax:
ftp://<username>:<encrypted_password>@<hostname>//full/path/to/directory/specific_string
sftp://<username>:<encrypted_password>@<hostname>//full/path/to/directory/specific_string
where:
<username> specifies the user name that the server administrator assigned (using the ftp or sftp utility)
to the FTP or SFTP user. The FTP or SFTP user specifies this user name to gain access to the server on
which the technology pack is installed.
<encrypted_password> specifies the password that the server administrator assigned (using the ftp or sftp
utility) to the FTP or SFTP user. The FTP or SFTP user specifies this password to gain access to the
server on which the technology pack is installed. The password specified here should be the encrypted
password.
<hostname> specifies the host name of the server on which the bulk input files are located. These are the
files that the UBA parses.
specific_string refers to the string that ends an entry for the URI line.
Example:
UBA.1.1.VOIP_CISCO_IPT.CDRINPUT.URI=ftp://pvuser:CACCDHDBCCCJHCGL@KLPRO02Z7//opt/uba/cdrcmr/*
To use the sftp command, you must have an SSH client installed on the servers where the bulk input files are
located and where the DataChannel is running. Typically, an SSH client is installed by default on most UNIX
systems. For more information, see your operating system documentation or the sftp reference page.
Note that you cannot do the following:
Use an FTP client to connect to an SFTP server
Connect to an FTP server with a client that supports only SFTP
DB_USERNAME
Use the following guidelines to determine whether you have the correct value for the
UBA.<channel_number>.<collector_number>.DB_USERNAME parameter in the dc.cfg file: