Appendix B: Template file (Tivoli Netcool/Proviso pre-v4.4.3 only)

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:

IBM Tivoli Netcool/Proviso Cisco IP Telephony 2.4.0.0 Technology Pack

91

Page 95
Image 95
IBM R2E2 manual Uri, Dbusername