NICE Recording 6.3 - Maintenance Manual
NICE Recording 6.3 - Maintenance Manual
NICE
Recording
MAINTENANCE MANUAL
Version: 6.3
Date: 25 April 2013
Copyright © 2013 by NICE Systems Ltd
All rights reserved. No part of this publication may be reproduced or
transmitted in any form or by any means, electronic or mechanical,
including photocopy, recording, or any information storage and retrieval
system, without prior written consent of NICE Systems Ltd.
Disclaimer
To the best of our knowledge, the information contained in this
document is the most accurate available at the time of publication.
Whilst every care is taken to ensure that the information in this document
is correct, no liability can be accepted by NICE Systems Ltd. for loss,
damage or injury caused by any errors in, or omissions from, the
information given.
Trademark Acknowledgements
Microsoft, Windows, Windows Server, and Internet Explorer are
trademarks or registered trademarks of Microsoft Corporation in the
United States and/or other countries.
5 Database ...............................................................................................24
5.1 Export ......................................................................................................... 24
5.2 Import ........................................................................................................ 24
9 SNMP traps.............................................................................................30
9.1 Daily health reporting messages ........................................................... 32
The system status menu provides all relevant details for system
maintenance, such as:
● Version information
● Recording status
● Available drive space on archive, server and satellite systems
● Archive status
● Active alarms (if any)
● Alarm history
● Full audit trail of recorded access
For recorder management, the ‘recorder status’ and ‘alarm status’ menus
supply all relevant details.
License information
Provides information about available licenses in the system. Licenses
loaded in a Parrot DSC card are presented in this panel. For each
available license the origin of the parrot DSC card, which satellite or server
Version information
The panels show version information for the installed recording services
and Parrot DSC cards for each installed server or satellite. For each
recorded ID a separate panel is shown.
If multiple Parrot DSC cards are installed, all cards are listed in this overview
for each recorded ID.
The status line shows the version number of the recorder application. In
addition, you can see the version number in Windows’ list of installed
programs.
Audio location status shows the hours of recording left on the recorder
hard drive together with the actual number of bytes and percentage left.
This location is used in FIFO mode. If the amount of free space reaches a
certain level (setup in the system installation menu), the oldest calls are
deleted to free disk space. The administrator must ensure that calls are
archived before this FIFO action takes place. Normally this is not a problem
as the local hard drive is able to store minimal 13.000 hours using GSM
compression (based on 80GB hard drive).
A separate database location status shows the available drive space for
the database. Be aware that database drive space is not controlled by a
FIFO mechanism if not shared with the audio location. Database drive
space must be maintained manually. If the database location is the same
as the audio location (default), the audio FIFO mode automatically frees
database space if needed.
For each archive location, the status screen shows the media type, status
of the location and medium, the processing state, and percentage of free
space (%).
When the media reaches its capacity, the recorder shows the archive
storage status in red colour and initiates an audible alarm on the recorder
chassis. This alarm is generated if the ‘Enable beeping on archive media
full’ option is selected from the ‘System Installations’ page. This situation
needs to be rectified to mute the alarm. For instance if the recorder
started the audible alarm due to the media reaching it’s capacity, a new
blank media needs to be inserted, to stop the alarm.
To view warnings and errors, choose “system status -> alarm status”
Depending on the capacity, you might also see the following warnings (if
applicable):
Error code 4009: is raised if the remaining available storage capacity is 20%
of the complete capacity, archiving continues. This indicates that the
amount of calls archived exceeds the capacity. To meet the needs of the
customer, you can expand the storage capacity of the pool by
reconfiguring it (which might need extra storage hardware).
The archive information for each medium is listed, including first and last
call on the medium as well as archive dates and media secure code.
When clicking on one of the lines in the media overview, all details are
presented in a separate box (shown above). From here archive media
details can easily be printed to a DVD label by pressing the Print button.
The Alarm status screen shows an overview of active alarms in the system.
Each alarm has a unique reference number, date/time, alarm level, status
and message.
An alarm that is active. No action has been taken yet to resolve this alarm.
The alarm could now either be Attended or be Cleared by system.
Attended alarm
Once the filter is applied, an extra icon appears in the right corner of the
application: “Attend and confirm filtered alarms”.
By clicking this icon, the system attends and confirms all the shown alarms
at once.
Cleared by system
An alarm that’s no longer active in NICE Recording 6.3 gets the status
cleared by system. Such alarms can be confirmed for clearance by
clicking:
● the icon; which confirms only that particular alarm
● the icon; which confirms all the “cleared by system” alarms at once
Alarms that are manually cleared get the status cleared and confirmed.
These alarms appear for another 24 hours in the alarm overview before
being moved to the alarm history screen. When clicking on one of the
alarm lines, the alarm details are presented.
The overview shows all state changes including date and service person
logged in to NICE Recording 6.3 when attending an/or clearing the alarm.
Each line represents a historical alarm including all details. Click the line for
additional alarm audit details such as dates for alarm status changes
including service person logged in to NICE Recording 6.3 when attending
an/or clearing the alarm.
To easily find certain historical alarms, the system provides filter facilities for
these alarms.
For every audit entry the time, user, action, users IP/Hostname, GUI section
and audited event details are logged. For call access events the involved
call ID is listed as well.
Date and time filter. Set a date and time from when audit trail events must
be shown. Show events older than the specified date and time only.
User filter. Show only the audit trail events for a specific user.
Call ID filter. Show only the audit trail events for a specific call.
The audit trail list could be exported to a csv-file for further reference. All
audit trail event columns are included in the exported file. When exporting,
all audit trail entries within the defined filter parameters are exported.
These are all audit trail events currently shown in the audit trail screen.
To check the status of the DSC-MOD card you can use the Parrot API
Maintenance tool.
Start the Parrot API Maintenance tool from the Windows Start menu:
Windows 2003: Programs\CyberTech\Parrot API\Maintenance Tool
Windows 2008: All Programs\CyberTech\Parrot API\Maintenance Tool
3.1 Lines
The ‘lines’ command shows the DSC-MOD-PCI lines on which digital
telephony signals are detected. This is convenient for checking that the
digital telephone lines are connected to the right channels.
Note:
● With some PBX installations (including ISDN2) in the idle state after a
certain time the activity on the line disappears and the “active” lines
are no longer displayed by the lines command. In this case you can
lift the receiver on the connected telephones to restore activity on
the lines.
● Analogue lines are only displayed as active when line voltage
exceeds the set detection level. See programming manual for details.
Type: lines
The number of lines can vary for each type of board and number of
modules:
Current line status
0123456789012345
AAAAAA..........
3.2 Stats
The ‘stats’ command gives you information on the DSC-MOD detection
and processing system. A number of parameters relating to the active lines
are displayed, such as the number of frame timeouts, checksum errors,
etc. The parameters are displayed for 4 lines at a time on the screen.
You can enter after the stats command the first of these 4 line numbers. For
example, stats 2 display lines 2, 3, 4 and 5.
Type: stats 2
The DSC-MOD gives a response such as the following:
on time 2 days 22:31:30
channel set 02 PBX 02 set 03 PBX 03 set 04 PBX 04 set 05 PBX 05
line state sync sync sync sync
restarts 1 0 2 0
frame to 2 6 3 3 4 4 1 1
line par err 0 1 1 2 0 1 0 2
pack sum err 0 0 0 0 0 0 0 0
ringbuf size 32000
ringbuf max 121 0 0 0 0 0 0 0
ringbug ovf 0 0 0 0 0 0 0 0
packbuf size 200 200 200 200 200 200 200 200
packbuf max 26 26 25 4 25 4 20 20
relay state off off off off
codec state off off off off
Explanation:
on time is the time since starting (resetting) the DSC-MOD-
PCI
channel the columns are divided into information from the
telephone (set) and the PBX for the various
channels
line state: shows whether the DSC-MOD-PCI is in “sync” with
PBX
restarts: indicates number of restarts occurred on the
various
channels since start-up
frame to (= frame timeout) this is the time in seconds since
processing the last digital package
line par err the number of parity errors on the line frames.
Pack sum err the number of checksum errors in the D-channel
messages
ringbuf size the buffer size (for all channels)
ringbuf max the maximum number of bytes in the buffer
3.3 ch_start
With the ‘ch_start’ command you can artificially send a start command to
the voice recorder. You can use this to check communication between
the DSC-MOD-PCI and the Recording System independently of any digital
telephone lines connected.
This simulates for the voice recorder, the start of an incoming call on line 2
with CLI 0725646544 and an outgoing call on line 1 with CLI “Test 252”. You
can check whether this call is correctly processed by the recorder.
3.4 ch_stop
The command ‘ch_stop’ issues a stop command to the voice recorder.
The format is:
ch_stop (line no.)
For example:
ch_stop 2
3.5 debug
Debug4000 indicates in real time the actions taking place on the lines,
such as start, stop, direction and number information. For example:
Type: debug 4000
Type: debug 0
Debug 0 takes you out of maintenance mode.
Example:
ch_start 2 I 0725646544
ch_start 1 O “Test 252”
For the voice recorder, this simulates the start of an incoming call on line 2
with CLI 0725646544 and an outgoing call on line 1 with CLI “Test 252”. You
can check whether this call is correctly processed by the recorder, as start,
stop and number information is shown in debug 4000 mode.
Note: If you’re not familiar with creating log files, consult NICE Recording
6.3 support desk for instructions. These log files are of high importance to
give adequate support services. Log files created wrongly are useless for
support.
Note: It’s important that the log file is created while reproducing the fault
situation. If a call direction problem appears, the log file must be created
while reproducing the problem. These log files are used to reproduce the
fault situation at the NICE Recording 6.3 Support desk.
The Parrot-DSC log file is created using the Parrot-DSC Maintenance tool.
This application is started from [Start->Programs->Parrot API-> Maintenance
Tool]. Select the Parrot-DSC card to connect to. The list of boards in the
system is shown in the NICE Recording 6.3 configuration overview. ‘System
Status, General Info, Version information for recorder x’. Each board is
listed separately.
Type: log_it all (for all channels) or log_it 0 5 (for specific channels).
The numbering of the Parrot-DSC channels start with 0 while the NICE
Recording 6.3 channels start with 1. If the channel number is not clear use
log_it all to make sure the right information is in the logfile.
0123456789012345
----------------
LLLLLLLLLLLLLLLL
The card dumps the configuration to the log file. This is a few pages of
data. After dumping the configuration the card is ready to reproduce the
fault situation.
All actions on the selected channels are stored in the log file. First make a
standard internal call for reference before you take the relevant actions to
be stored in the log file. Please repeat every action to have two entries in
the log files.
When the log file is finished, type log_it and close the capture file.
-> log_it all
To ceate a raw IP logfile using the maintenance tool use the command:
Ip_raw_log
The rules for creating the log as the same as for the log_it command. Make
sure the log file contains enough information for support. The output format
is Ethereal/Wireshark compatible. Compress the file using win-zip and send
to the NICE Recording 6.3 support desk.
5.1 Export
To export the NICE Recording 6.3 database, select ‘Export database
Settings’ from All Programs > CyberTech > Recorder > Database
Maintenance
5.2 Import
To import the NICE Recording 6.3 database, select ‘Import database
settings’ from:
ArchiveService
Archive log file is created by the Archiving Service. All archive-location
activities are logged in this file. For each new day a new file is created. The
date is included in the file name.
StorageService
All archive activities are logged in this file. For each new day a new file is
created. The date is included in the file name.
ControllerService
System status log file is created by the Controller Service. This file contains
all system emails, SNMP warnings and errors send. For each new day a new
file is created. The date is included in the file name.
DatabaseInterfaceClient
Communication log file is created by the Database Interface Client
service. This file contains all communication between Server/Satellite
systems.
Core Server systems don’t create this log file but Satellites and Server
systems do. For each new day a new file is created. The date is included in
the file name.
DatabaseInterfaceServer
Communication log file is created by the Database Interface Server
service. This file contains all communication between Server/Satellite
systems. Only Server and Core Server systems have this log file. For each
new day a new file is created. The date is included in the file name.
Weberror
IE Client log file created by IIS on the NICE Recording 6.3 (Core) Server. This
Web
Audit log file is created by the Web Interface. All user login, call search,
play, email, delete and download activities are logged, grouped for each
user. For each new day a new file is created. The date is included in the
file name.
ModularLicensing
License information in NICE Recording 6.3. For each new day a new file is
created. The date is included in the file name.
CTI_receiver
CTI controlled recording start, stop and information messages can be
logged to this file for support reasons. For each new day a new file is
created. The date is included in the file name.
DSC_Service
Parrot API start-up and initialization events are logged in this file. For each
new day a new file is created. The date is included in the file name.
When audio is first recorded by NICE Recording 6.3, it is stored on the local
hard disk, and is available for immediate playback via the web GUI. For
long term storage NICE Recording 6.3 uses removable media or network
locations.
This section describes the NICE Recording 6.3 archive media and how they
are used.
When the user is notified that the removable medium is filled they must
write the archive period (call archived (first/ last) on the media, see figures
below. Then replace the media with a new one. The archive period can
be found at system status/ recorder storage.
NICE Recording 6.3 SNMP messages contain the CyberTech Telecom B.V.
OID (1.3.6.1.4.1.23491).
Error: MIB-value field contains the error string sent via SNMPv1.
This trap message contains one string value that contains all trap
information. This error string is presented as follows:
Service State Change: Sent when a recorder service starts or stops. MIB-
value field contains string: ‘Service: <service name> started.’ Or ‘Service:
<service name> stopped.’
Health Report: Sent at the defined daily health reporting hour defined in
the Global Settings page.
CT Error Trap: MIB-value field contains the extended version of the error
message sent via SNMPv2c.
The CT Recording Solution CT5 installation CD contains the MIB file that
must be used to integrate NICE Recording 6.3 SNMP messages with a
SNMP monitoring system.
10021 Page file use. Total page file size used in system
in KB.
Value: Total memory, In use,
Available
System types: Core Server, Server,
Satellite and CTI Server.
10022 Virtual memory Virtual memory in system in KB.
use. Value: Total memory, In use,
Available
System types: Core Server, Server,
Satellite and CTI Server.
10023 Total number of Total number of system handles in
system handles in use.
use. System types: Core Server, Server,
Satellite and CTI Server.
10030 Free space for Free Space (absolute value in
system drive. GB) system drive
System types: Core Server, Server,
Satellite and CTI Server.
10031 Free space for Free Space (absolute value in
audio drive. GB) audiox (e.g. c:\audio1)
drive.
System types: Core Server and
Server.
10032 Free space for Free Space (absolute value in
database drive. GB) database drive
System types: Core Server and
Server.
A typical TDM based fixed-line network has an average MOS of 4.3 and
GSM networks average a MOS of between 2.9 and 4.1. If voice quality
were to drop by 1 MOS during a call, the average user would clearly hear
the difference. A drop of half a MOS is audible whereas a quarter of a
MOS is just noticeable.
Your systems will not have any detrimental impact on the Customer
Networks (does not hog available bandwidth)
Outline how you have ensured your systems are secure by rolling out
encryption.
Does the product come with some Industry Standards certification (eg EU,
Netherlands)
Version history
Date Version Remark
15-05-2008 5.3 Updated alarming appendix G with CTI 8003 messages.
Updated NIC order appendix M. Added TCT/IP binding
information for Passive VoIP recording.
* Manual version synchronised with product version for NICE Recording 6.3