MD110 Tech Guide Help
MD110 Tech Guide Help
MD110 Tech Guide Help
6
Technical Guide
Disclaimer
No part of this material may be reproduced in any form without the written permission of the copyright owner. The contents of this document are subject to revision without notice due to continued progress in methodology, design and manufacturing. Aastra shall have no liability for any error or damage of any kind resulting from the use of this document.
Table of Contents
Table of Contents Chapter 1 Key Information Chapter 1 Key Information i 1 1
Dynamic Network Administration..........................................................................1 Compatibility.............................................................................................1 D.N.A. Server...........................................................................................2 D.N.A. Support for Extensions..................................................................2 What You Will Find In This Help Guide.................................................................3 Related Publications.................................................................................4 Conventions Used in This Guide..............................................................4 Glossary................................................................................................................4
9 9
Description of Applications....................................................................................9 Limitations...........................................................................................................11 Add Component, Add Locale, Database Upsize, Reinstallation.............11 PPM Lite.................................................................................................11 OWS Screen Resolution.........................................................................11 SQL Server 2008 Security mode............................................................12 SQL Server 2008 Named Instances.......................................................12 Aastra Communication Assistant............................................................12 Extension Manager................................................................................12 Licenses..............................................................................................................13 Extension Manager................................................................................13 Personal Number...................................................................................13 OneBox Mailbox Integration................................................................................13 Integration of OneBox and D.N.A...........................................................13 OneBox Compatibility with Other Network Elements..............................15 Compatibility with Other Network Elements............................................17 Application Link...................................................................................................17 General Operations................................................................................17 Application Link and ACA.......................................................................18 Compatibility with Other Network Elements............................................18 Name Display in MD110......................................................................................18 Dial By Name Directory..........................................................................18 Time System Server............................................................................................19 Solidus eCare / D.N.A. Integration......................................................................20 LDAP Support in D.N.A.......................................................................................20 Other Interfaces...................................................................................................21 Directory Link.........................................................................................21 Extension Link........................................................................................21 D.N.A. CAAPI.........................................................................................22
Table of Contents
Change Log............................................................................................22 D.N.A. CTI..............................................................................................22 Mobile Executive.................................................................................................23 WAP Gateway........................................................................................23 Phone Setup...........................................................................................23 SNMP Agent.......................................................................................................25 The Monitored Objects...........................................................................26 Remote Data Monitor..........................................................................................27 Captured Filename.................................................................................28 Visitor Registration..............................................................................................29 Aastra Communication Assistant.........................................................................29
30 30
License handling with D.N.A. 5.6.........................................................................30 The order and information flow............................................................................30 Generating Fingerprint file...................................................................................31 The Web application............................................................................................31 Providing access to the application.....................................................................32 Support................................................................................................................32
33 33
About Pre-Installation..........................................................................................33 Pre-Installation Meeting .........................................................................33 PBX Hardware Requirements.............................................................................33 Configuration Options..........................................................................................34 Stand alone............................................................................................34 Single Server with Clients.......................................................................35 PC Hardware Requirements...............................................................................36 Server.....................................................................................................36 Client PC................................................................................................37 Server PC Windows Server 2008........................................................38 Configuration of IIS in Windows Server 2008.........................................39 Client PC Windows Vista Business.....................................................40 Additional Hardware Options..................................................................42 Hard Disk Requirements.....................................................................................42 Recommendation...................................................................................42 Server Disk Space Requirements.......................................................................42 Client Disk Space Requirements.........................................................................45 Software Requirements.......................................................................................46 Windows.................................................................................................46 SQL Server.............................................................................................46 Excel.......................................................................................................46 Internet Tools.........................................................................................46 Client/MD110 Connections for Operator Workstation..........................................47 Server/MD110 Connection for Operator Workstation..........................................47 Client/ MX-ONE Telephony Server Connections for Operator Workstation.....48 Server/ MX-ONE Telephony Server Connection for Operator Workstation.....49 Configuration Management Hardware Connections............................................49 Hardware Connections for Extension Manager...................................................50
ii
Table of Contents
52 52
SQL Server 2005.................................................................................................52 To install SQL Server 2008....................................................................52 Upgrading to SQL Server 2005..............................................................53 Security..................................................................................................53 Memory..................................................................................................53 Dependent Packages for SQL 2008....................................................................54 SQL Server 2005.................................................................................................54 To install SQL Server 2005....................................................................54 Upgrading to SQL Server 2005..............................................................55 Security..................................................................................................55 Memory..................................................................................................55 Unattended SQL Server Installation....................................................................56 Install SQL Server 2008 Standard Edition Unattended...........................56 Install SQL Server 2005 Standard Edition Unattended...........................57 Change SQL SA password.................................................................................57 Install SQL Server Service Pack.........................................................................58 SNMP Master Agent............................................................................................58
60 60
About Installation.................................................................................................60 Hardware Connections...........................................................................60 Software Installation...............................................................................60 Installation Checklists..........................................................................................60 Using the Checklists...............................................................................60 Application Suite Installation...............................................................................62 Installation Features...............................................................................62 Pre-Configured System..........................................................................62 Upgrading To D.N.A. 5.6.....................................................................................65 Upgrading from D.N.A. running on SQL Server 2000.............................66 Transferring D.N.A. from one computer to another................................66 Installing Enterprise License Server.......................................................67 Server Installation................................................................................................67 Auto-Run Installation..............................................................................67 Taskbar Installation................................................................................68 New Server Installation...........................................................................68 Installation Options.................................................................................72 Add Components....................................................................................73 Resize Database....................................................................................73 Client Installation.................................................................................................73 Auto-Run Installation..............................................................................74 Taskbar Installation................................................................................74 New Client Installation............................................................................74 Client Installation Options.......................................................................76 Silent Installation.................................................................................................77 Modifying the Setup (dnasuite.ini) File....................................................77 Installation Procedure.............................................................................78 Using the Setup Command....................................................................78 PPM Lite..............................................................................................................79
iii
Table of Contents
Installing with Auto-Run..........................................................................79 Installation Options.................................................................................80 Upgrade PPM Lite..................................................................................80 Post Installation......................................................................................80 PPMLite Installed on IIS 6.0...................................................................85 Aastra Communication Assistant.........................................................................89 Prerequisites..........................................................................................89 Installing with Auto-Run..........................................................................97 Installation Procedure.............................................................................98 Virtual Machine.......................................................................................98 Installation Options.................................................................................98 Upgrade Aastra Communication Assistant.............................................99 Post Installation Only if IIS 6.0 is used................................................99 Mobile Executive...............................................................................................101 Installing with Auto-Run........................................................................101 Installation Options...............................................................................102 Upgrade Mobile Executive....................................................................102 Post Installation Only if IIS 6.0 is used..............................................103 Outlook Integration............................................................................................105 Customizing Outlook Security Features...............................................107 D.N.A. Outlook Integration Logging......................................................123 Lotus Notes Integration.....................................................................................124 Installing Lotus Notes Integration Installation package on D.N.A. Server with Auto-Run.......................................................................................124 Installing D.N.A. Lotus Notes Integration Templates on Domino Server .............................................................................................................124 Setting up D.N.A. Lotus Notes Integration Templates..........................124 Installing D.N.A. Lotus Notes Integration on Notes Client....................129 Registry Value for Message Diversion Synchronization ......................130 Registry location...................................................................................130 COMPUTER or USER ID User Defined Fields.....................................130 Help......................................................................................................131 D.N.A. Client Installation on Windows XP.........................................................131 Successful Configuration......................................................................131 Unsuccessful Configuration..................................................................132 D.N.A. Service Pack Installation........................................................................133
135 135
Server Installation..............................................................................................135 Server Installation.................................................................................135 Pre-requisites.......................................................................................135 Installation Options...............................................................................136 Registration Information.......................................................................136 Virtual Directory....................................................................................136 ApplicationLink Configuration...............................................................136 Number of Sites....................................................................................137 Site Configuration.................................................................................137 Summary Information...........................................................................137 Configurations......................................................................................137 Post Installation Only if IIS 6.0 is used..............................................141 Client Installation...............................................................................................143 Installation Options...............................................................................144
iv
Table of Contents
Configurations......................................................................................145 Client Update....................................................................................................145 File Version Comparison......................................................................146 Client Installation Download and Update..............................................146 Compatibility.........................................................................................146
147 147
Performance Enhancements.............................................................................147 Creating More Available Memory......................................................................147 Operator Workstation Supervisor......................................................................148 RDS Performance.............................................................................................148 LDB Integrity Check Feature................................................................148 Reduce I/O Completion Ports in Large Systems..................................149 Enable/Disable Incremental LDB Updates from DMG..........................149 Configure RDS to Use Fewer SQL Connections..................................150
151 151
Facilities and Services.......................................................................................151 Administrative Tools..........................................................................................153 Changing Users, Servers, and Passwords........................................................155 Registry.............................................................................................................156 Registry Settings..................................................................................156 Server Identification..............................................................................157 Maintenance......................................................................................................157 SQL Database......................................................................................157 Logging Facilities Server......................................................................158 Short Message Service.....................................................................................158 Limitations............................................................................................159 Short Message Service Standby..........................................................159 Local Database Compression...........................................................................159 GICI Connection................................................................................................160 Message Diversion and Secondary and/or Shared Extension..........................160
163 163
Archival Backup.................................................................................................163 Temporary Workspace.........................................................................163 Automatic Extraction.........................................................................................163 Performance Data Manager Operations...............................................164 Two Ways to Start the Extraction Process...........................................164 The Data Extraction Command............................................................164 Clock Synchronization..........................................................................165 Extraction Process...............................................................................165 Skip Nodes for Polling..........................................................................165 Extend Polling Time..............................................................................166 Presentation Manager.......................................................................................166 Operational Requirements....................................................................166
Table of Contents
Traffic Measurement Reports...............................................................166 Preserving Edited Reports....................................................................166 Database Utility.................................................................................................166 Options.................................................................................................166 Capacity and Limitations......................................................................167
168 168
Log Files............................................................................................................168 D.N.A. Server Installation Logs............................................................168 D.N.A. Client Installation Logs..............................................................168 ACA Installation Logs...........................................................................168 ACC Client Installation Logs.................................................................168 Mobile Executive Installation Logs.......................................................168 PPMLite Installation Logs.....................................................................168 Event Log Messages.........................................................................................169 Technical Support.............................................................................................182 Before Contacting Technical Support...................................................182 Reporting Your Problem....................................................................................182 Problem Description.............................................................................183 PBX......................................................................................................183 Operating System Information (mark all that apply).............................183 Configuration........................................................................................183 Network Protocol (mark all that apply)..................................................183 PC........................................................................................................183 D.N.A. Applications..............................................................................184 Directory Manager.............................................................................................184 Aastra Communication Client............................................................................187 Extension Manager...........................................................................................190 Operator Workstation........................................................................................196 OWS Supervisor................................................................................................198 Deployment Scenario 1:.......................................................................199 Deployment Scenario 2:.......................................................................200 Performance Data Manager..............................................................................201 Performance Presentation Manager..................................................................204 Essential Requirements........................................................................204 Report Limitations................................................................................205 General PPM Problems........................................................................205 Remote Data Server..........................................................................................206 Mobile Executive...............................................................................................206 Aastra Communication Assistant.......................................................................207 Call Handling problems........................................................................207 Personal Number problems..................................................................208 Trace....................................................................................................208 Service.................................................................................................209 Header Error.........................................................................................209 Fields are Disabled...............................................................................211 Slow to logon........................................................................................212 Outlook Integration & Lotus Notes Integration...................................................212 Outlook or Lotus Notes Integration would not start...............................212 Outlook or Lotus Notes Integration would not logon to the DNA Server .............................................................................................................212
vi
Table of Contents
Diversion information does not match between Outlook or Lotus Notes Integration and DNA.............................................................................212 DNA Outlook Integration and Calendar Conflicts.................................212 Troubleshooting with Remote Data Monitor.........................................213
214 214
Report Generation.............................................................................................214 Directory Manager Database Organization.......................................................215 Extension Manager Database Organization......................................................220 PDM Database Organization.............................................................................235 Operator Workstation Data................................................................................236 Directory Assistance Databases...........................................................236 Operator Workstation Configuration.....................................................236
238 238
Extension Manager...........................................................................................238 MD Support Utility.............................................................................................240 Performance Data Manager..............................................................................243 MD Support Command Line Synchronization...................................................244 Command Line Syntax.........................................................................244
247 247
Directory Manager.............................................................................................247 D.N.A. Server....................................................................................................248 Extension Manager...........................................................................................248 Operator Workstation........................................................................................249 Remote Data Server..........................................................................................252 Serial Communications Server..........................................................................253 Performance Data Manager..............................................................................254 D.N.A. Application Suite....................................................................................254 .............................................................................................................255 MD110..................................................................................................255 Registry................................................................................................256 ClockSync............................................................................................257 SNMP...................................................................................................257 Export...................................................................................................257 Aastra Communication Assistant.......................................................................258
259 259
Networking (SNMP) Access Agent....................................................................259 Web Site Security..............................................................................................264 Windows 2000 Server and Windows Server 2003...............................265
vii
Table of Contents
Setup D.N.A. Web Applications on Windows 2003 and IIS 6.0.........................265 Configurations setup automatically by D.N.A. installation ....................265 Configurations to Run D.N.A. Web Applications in Worker Process Isolation Mode......................................................................................265 D.N.A. Server and IIS 6.0 Server on Different Machines......................272 D.N.A. Port Assignments...................................................................................273 D.N.A. 5.6.............................................................................................273 Aastra Communication Assistant.......................................................................276 To setup end users Web browser........................................................276 To setup Aastra Communication Assistant user account.....................276 To configure Aastra Communication Assistant Server.........................276 Personal Contact Search .....................................................................280 Aastra Communication Client............................................................................283 ACC Port Usage...................................................................................283 Changing the default language setting for ACC...................................283 Using ACC with a Virtual Private Network (VPN).................................283 Monitor Feature Access for ACC..........................................................284 Restricting Display of External Numbers..............................................284 User ID and Password for ACA, ACC, and DME...............................................285 D.N.A. Directory Configuration.............................................................285 D.N.A. Directory Manager....................................................................285 User ID.................................................................................................285 Password..............................................................................................285 Operator Workstation........................................................................................285 Improving the Performance of OWS.....................................................285 E-mail Integration.................................................................................286
287 287
Voice System Interface.....................................................................................287 Setting Up Communications and Configuration Parameters................287 The VSI Protocol..................................................................................287 Capacities and Limitations....................................................................289 Time System Server..........................................................................................290 Interface...............................................................................................290 Protocols..............................................................................................290 FLEXIM Protocol..................................................................................291 General Protocol..................................................................................297 CTR Protocol........................................................................................299 TIMECON Protocol...............................................................................305 Exchange Interface..............................................................................306 Message Types.................................................................................................306 IVR/Voice System to VSI Messages.................................................................306 IVR/Voice System from VSI Messages.............................................................308
312 312
Directory Security..............................................................................................312 Services and Accounts/Rights...........................................................................314 ODBC Connection.............................................................................................316 Files Copied to Other Directories......................................................................317
viii
Table of Contents
ix
Compatibility
This release of the D.N.A. Application Suite is compatible with: Windows 2003 with Service Pack 1, Windows 2003 Server R2, and Windows Server 2008. Note: It is assumed that both the D.N.A. server and D.N.A. clients are in the same domain. If D.N.A. clients exist in other domains, then domain trust relationships must be established. Please refer to your Windows documentation for more details. Windows XP Professional with Service Pack 2, and Windows Vista Business with Service Pack 1. MD110 PBX release BC12 MX-ONE Telephony Switch MX-ONE Telephony Server 2.0 MX-ONE Telephony Server 3.0 MX-ONE Telephony Server 3.1 MX-ONE Telephony Server 3.2 Microsoft SQL Server 2005 Microsoft SQL Server 2005 Express Edition Microsoft SQL Server 2008 Microsoft SQL Server 2008 Express Edition Microsoft Internet Information Server 6.0 and 7.0 Office 2003 Service Pack 2 and Office 2008.
Key Information
ApplicationLink 4.0 CT Adapter, ZAT 505 120/1 Extender Keyboard, KDT 252 001/02 D.N.A. Access Agent and SNMP application Microsoft Internet Explorer 5.5 or later Netscape 4.x, 6.x, and 7.x Notes 4.6.7, 5.0.2B and later, 6.0.x, and 6.5. Roaming User feature supported from Notes 6.0.1 is not supported by D.N.A. Notes Integration.
D.N.A. Server
The D.N.A. Server lets you administrate the D.N.A. Application Suite users. It also contains different utilities to set up the connection with PBX nodes. The central component of a D.N.A. Installation is the Remote Data Server (RDS). RDS maintains network database synchronization among all PBX nodes, the D.N.A. SQL Server, and D.N.A. Local Databases. Some of the most important database support functions are: Message Diversion Synchronization with the PBX. Message Waiting Synchronization that updates the Voice System Interface configuration utility. Application-to-Application Interactive Updates. Security and Licensing Support. D.N.A. Distributed Database Synchronization. Photo Storage and Retrieval for Operator Workstation and Directory Manager. Data File Storage and Retrieval Templates for Performance Manager and Extension Manager. Configuration File Storage and Retrieval for Operator Workstation and OCX. Administrative Task Scheduling. A tool to set up the Voice System Interface. A tool to upload directory information into MD110 phone displays. A tool to specify the replication between multiple D.N.A. Servers.
Technical Guide
MX-ONE 3.0 * * -
NOTE: Equipment change is not allowed for Digital/Digital POTS extension types, since KSEXC command is removed in MX-ONE 3.0 release. + = full support * = restricted support - = no support
Key Information
Maintenance - Describes tasks that should be performed periodically to ensure proper operation of your applications. Troubleshooting - Describes how to resolve problems that may occur. Application Data - Report generation, data organization, and populating directory assistance databases. MML Commands - Tables of commands for Extension Manager, MDS Utilities, and Performance Data Manager. Frequently Asked Questions - Provides answers to some basic questions regarding D.N.A. Configuration - Describes other configuration items such as D.N.A. Agent Access module, Web site security and certificate request. VSI and TSS - Describes the Voice System Interface between an IVR system and D.N.A., as well as the optional Time System Server. Security - Describes D.N.A. Directory security, Service and Accounts/Rights, ODBC connection, Files copied to other directories, Database permissions, Registry location and permissions.
Related Publications
In addition to the "D.N.A. Technical Guide," getting started guides are available for the following products. Operator Workstation Extension Manager Directory Manager Performance Manager Mobile Executive
Glossary
Refer to the descriptions in this section for help with understanding terms used in this guide. Alarm Unit (ALU) - MD110 circuit board that handles PBX alarm input/output. Backup Domain Controller (BDC) - A Windows configuration option. Call Origin Group - A group number defined for an operator that serves a unique call type, such as internal calls, public trunk calls, tie lines, and DID lines. An operator can be assigned to several different call origin groups.
Technical Guide
Client - A PC in a network installation that is connected to a server PC and accesses data on the server when running applications. In a D.N.A. network installation, the SQL database and the D.N.A. Server reside on a server PC, and one or more client PCs run applications that access the data on the server. For a stand-alone installation, the server and the client are the same PC. COM Port - An RS-232C serial communication interface on a PC that allows direct connection to another PC or an MD110 with a cable or indirect connection using a modem or TAU. Computer Supported Telephony Application (CSTA) - Supports Computer Telephony Integration (CTI) between the Distributed Network Architecture (D.N.A.) environment and the PBX. Computer Telephony Adaptor (CT Adapter) - Enables an Operator Workstation (OWS) PC to connect to the PBX to perform call handling. DigiBoard - A communications port multiplexor that adds COM ports to a PC. Directory Manager (DMG) - A D.N.A. application that allows administrative personnel to manage subscriber directory entries. Includes capabilities for adding, modifying, and deleting subscriber directory records. D.N.A. Applications - The set of software applications that run on PC clients and are used in combination with one or more PBXs to manage telecommunications operations. D.N.A. Mobile Executive (DME) - The D.N.A. Mobile Executive enables the user to access some of the D.N.A. Application Suite features via WAP enabled devices. The features supported are directory search, click to dial a phone number from search result, retrieve short messages, set message diversion, activate personal number profile, and manual dial. However, the features supported are dependent upon device type. D.N.A. Notes Integration (DNI) - Provides a client-side bi-directional integration to synchronize the message diversions between the Lotus Notes Calendar and D.N.A. server. The templates are supported to provide the needed fields to schedule a message diversion from Lotus Notes. D.N.A. Outlook Integration (DOI) - Provides a client-side bi-directional integration for synchronizing message diversions between Microsoft Office Outlook Calendar and the D.N.A. server. DOI invokes the Outlook Calendar appointment window with a message diversion reason code placed in the fixed calendar fields, to schedule the message diversion from Outlook. D.N.A. Server - D.N.A. platform services and utilities that reside on the server and act as the intermediary between all D.N.A. applications and databases. Aastra Communication Assistant (ACA) - A browser-based GUI end user application that provides the capabilities for directory search, message diversion, personal number profile, diversion, short messages, and call handling features. E&M Signaling Device - Electronic interface between the PBX and recorded voice announcement (RVA) equipment. See also Voice Server Unit (VSU). Extension Line Unit (ELU) - The board in an MD110 that connects to physical subscriber telephones. Extension Manager (EMG) - A D.N.A. application for managing PBX telephone data and extensions. Includes capabilities for administration of telephone and data extensions, messaging, and other PBX elements.
Key Information
General Information Communications Interface (GICI) - The logical interface for the ICU or NIU board in the PBX. Graphical User Interface (GUI) - The user interface presented by D.N.A. applications and management utilities. Hardware Compatibility List (HCL) - A list of hardware tested and verified to work with Windows. The list is available at http://www.microsoft.com/hcl. Information Computer Unit (ICU) - The board in an MD110 BC9 and earlier used for interception and message waiting services. Replaced by the NIU in BC10. Input/output Processor Unit (IPU) - A board in an MD110 that enables external devices to communicate with the MD110. Integrated Digital Network Exchange (IDNX) - For ISDN networks, the IDNX uses routing access information to enhance PBX performance. This unit helps achieve efficient bandwidth utilization, high network reliability and availability, and control over the usage of network resources. Integrated Services Digital Network (ISDN) - ISDN uses a 64 kbit/s channel for transmitting digitally coded speech and data. This digital medium is normally used for circuit-switched connections, packet-switched connections, and semipermanent connections. The complete digital interface (2B+D) consists of two Bchannels for speech/data and one D-channel for signaling. Each MD110 Line Interface Module (LIM) supports up to 240 individual external ISDN lines. Lightweight Directory Access Protocol Service (LDAP) - Directory lookup and modification services for LDAP clients accessing the directory databases. Local Area Network (LAN) - A computer network based on one or more centralized server PCs and one or more locally or remotely connected client PCs. Man-Machine Language (MML) - Command interface for PBX controls. MD110 - The Aastra PBX. MD Support (MDS) - A D.N.A. administrative utility that synchronizes PBX configuration data with D.N.A. application databases. Additional capabilities include synchronization connections for serial, Telnet, and Serial Communications Services. Also called MD110 Support. Modem Modulator / demodulator. A communications device that converts digital information from computers into analog electrical signals that can be transmitted over telephone lines and vice versa. A modem may be used to connect a PC to a remote PBX. Modem/Loop Extender - Communications adapter that enables the connection of a PC to a remote (150 feet or more away) MD110 ICU, IPU, or NIU. MX-ONE TSW MX-ONE Telephony Switch. This is equivalent to the BC13 release. MX-ONE TSE MX-ONE Telephony System - Telephony Server. Network Interface Unit (NIU) - MD110 I/O Board interface supporting V.24, Ethernet, and SCSI communications. An NIU V.24 port configured as a network port (Ethernet) provides Telnet service via logical network / MML ports. Up to six logical network / MML ports can be initiated on an NIU. The NIU serves as an alternative to the Input/Output Processor (IPU) interface. Windows File System (NTFS) The Windows file system.
Technical Guide
Operator Workstation (OWS) - A D.N.A. application that enables operators to manage PBX telephone traffic through subscriber databases. Performance Data Manager (PDM) - See Performance Manager. Performance Manager (PMG) - The D.N.A. application that is used to collect traffic data and generate reports. Performance Manager actually consists of two applications: Performance Data Manager (PDM), and Performance Presentation Manager (PPM). PDM is used to extract traffic measurement data from one or more PBX nodes, and PPM is used to generate reports based on data extracted by PDM. Performance Presentation Manager (PPM) - See Performance Manager. Performance Presentation Manager Lite (PPM Lite) - A Web-based application that provides a sub set of the PPM functionality by providing the user with a limited number of reports which may be viewed with a browser. Primary Domain Controller (PDC) - A Windows configuration option. Private Branch Exchange (PBX) - Telephone switching system that supports a private community of subscribers, typically a business environment. Usually managed from a central operator console, PBXs interconnect internal subscribers to one another, and to other subscribers in the public network. Also known as Private Business Exchange and Private Automated Business Exchange (PABX). Remote Data Server (RDS) - D.N.A. Server Utility that allows you to configure the Remote Data Server for D.N.A. database and application support roles, including network database synchronization between PBX nodes, the D.N.A. SQL Server, and D.N.A. Local Databases (LDBs). Serial Communications Server (SCS) - D.N.A. Server Utility that allows you to manage direct, Telnet, SCS, and third party serial communications port settings. Server - The central PC for a D.N.A. network installation. In a network installation, the SQL database and the D.N.A. Server software reside on a server. One or more client PCs may run D.N.A. applications that access the data on the server. The server acts as a database "referee," providing data security, centralized file access, management services, and controlling ID master files and external subscriber directories. For a stand-alone installation, the server and the client is the same physical PC. Stand-alone - An installation of D.N.A. applications on a single PC instead of a network of PCs. In a network installation, the SQL database and the D.N.A. Server reside on a server PC, and one or more client PCs run D.N.A. applications that access the data on the server. In a stand-alone installation, all of these elements (SQL database, D.N.A. Server, and D.N.A. applications) are installed on a single PC. Terminal Adapter Unit (TAU) - Terminal Adapter Unit, a device that enables connection of a PC to a remote MD110. Replaced by the CT-adapter. Time System Server (TSS) Configuration - An optional D.N.A. module that allows connection to an external time monitoring system. Through this interface, diversions can be entered in the time monitoring system and registered in the D.N.A. directory database. TSS also allows control signals for message waiting indications to be sent from D.N.A. to the time monitoring system. Trunk Manager (TRM) - Enables you to assign easily recognizable names to incoming trunks for efficient operator identification and routing.
Key Information
Voice Server Unit (VSU) - Line Interface Module (LIM) hardware for storing voice messages. Voice System Interface (VSI) - An optional D.N.A. module that allows voice mail integration. VSI acts as a compatibility interface between the PBX and Voice Message Processing Systems. Capabilities include call diversion options, support for Message Waiting Indicators (MWI), and increased reliability of voice processing operations. WAP - Wireless Application Protocol. Wide Area Network (WAN) - Inter-office private communication network.
Chapter 2 Applications
Description of Applications
The D.N.A. application suite is an integrated set of applications that allow you to operate and manage your PBX communications resources from stand-alone or networked PCs. The application suite includes the following applications. Application D.N.A. Server * Description The operational and administrative platform for the D.N.A. utilities and data structures. Includes system configuration and maintenance utilities for supporting D.N.A. applications. Localized into the following languages: French | German | Spanish Directory Manager (DMG) OWS support and administrative application that enables you to add, modify, and delete D.N.A. Directory entries. ** Localized into the following languages: Danish | Dutch | Chinese (Simplified) | Finnish | French | German | Italian | Norwegian (Bokmal) | Spanish | Swedish Operator Workstation (OWS) ** Localized into the following languages: Danish | Dutch | Chinese (Simplified) | Finnish | French | German | Italian | Norwegian (Bokmal) | Spanish | Swedish Extension Manager (EMG) D.N.A. application for management of PBX telephone data (extensions, extension groups, equipment assignments, and other resources). ** Localized into the following languages: Dutch | French | German | Spanish Performance Manager (PMG) A traffic measurement and reporting application for network performance analysis. Allows analysts and administrators to capture traffic data and generate D.N.A. traffic management application. Allows operators to access D.N.A. Directory subscriber information and route telephone traffic.
Applications
Application **
Description reports. This application consists of Performance Data Manager (PDM), and Performance Presentation Manager (PPM), two separate applications. PDM extracts traffic measurement data from one or more PBX nodes. PPM creates reports from data extracted by PDM. Localized into the following languages: French | German | Spanish
This application provides directory services to a corporate-wide phone directory on a corporate intranet or to external customers on the internet. You can search a phone directory with your web browser. No other plug-ins are necessary. In addition to the searching the corporate phone directory, Aastra Communication Assistant allows you to send and receive short text messages, set and view message diversion, and make calls. Localized into the following languages: Danish | Dutch | Chinese (Simplified) | Finnish | French | German | Italian | Norwegian (Bokmal) | Spanish | Swedish
Aastras IP-based software telephony client. ACC offers IP based business class telephony along with directory search, message diversion and personal number management. Localized into the following languages: Danish | Dutch | Finnish | French | German | Italian | Norwegian (Bokmal) | Spanish | Swedish
PPM Lite **
An Internet Server-based version of Performance Presentation Manager. The application is installed as a Web site. Users point their browsers to the PPM Lite server and log on to view traffic analysis reports. Localized into the following languages: French | German | Spanish
A WAP application allowing users to access the D.N.A. directory, Message Diversion and Personal Number functions via a WAP enabled device like a cellular phone. Localized into the following languages: Danish | Dutch | Finnish | French | German | Italian | Norwegian (Bokmal) | Spanish | Swedish
*
10
Applications
** Available in GUI, online Help, and as electronic Getting Started Guide (Getting Started Guide for DMG, EMG and PMG are in English only). *** Available in GUI and electronic Getting Started Guide Note: All applications are offered in English.
Limitations
Add Component, Add Locale, Database Upsize, Reinstallation
If a component, locale, server database upsize, or reinstallation is needed, these actions must be performed from Control Panel > Add/Remove instead of the CD-ROM (media kit). The side effect of performing the above mentioned activities from the CD-ROM, is that the service pack version information in the About Boxes will be incorrect.
PPM Lite
Observe the following requirements for reliable PPM Lite operation. PPM Lite will not function properly without a session state. The Session Timeout feature for your PPM Lite website must not be disabled. PPM Lite output must be viewed using monitors with minimum display capabilities of 256 colors, and 800 x 600 resolution.
11
Applications
Screen resolution
If screen resolution is set higher than 1280 x 1024, the background image will tile when the browser window is maximized, or made large enough to display more than 1280 x 1024 pixels inside the window.
Outlook integration
When configuring the Outlook integration in Aastra Communication Assistant, the Microsoft Transaction Server Package user must have Administrator privileges on the Aastra Communication Assistant server computer.
Extension Manager
When Extension Manager is used as a service by ACA, ACC, DME, or ExtLink to update Personal Number, it cannot be run as an application on the D.N.A. server. The Extension Manager application must be run from another machine.
12
Applications
Licenses
Extension Manager
Extension Manager provides the capability to view available licenses for MD sale objects. To view this from Extension Manager, select the Properties menu and then select the License tab. A list of sale objects information, including whether licenses are available, will be displayed. If trial licenses are used, the expiration date will also be displayed in the dialog. Extension Manager interacts with licenses by allowing or disallowing certain sale objects to be initiated, changed, or deleted. Note: If you have modified a license file in the MD with new values for certain objects (e.g., updating a Personal Number license from a Trial license of 0 to 100 new licenses), use MD Support to synchronize the D.N.A. Database with the updated license information. A full synchronization is not required, only a feature that includes the updated license information (e.g., Operator Message Diversion).
Personal Number
Personal Number is the only PBX feature that requires licenses in ACA and ACC. There are different types of Personal Number licenses supported in PBX. ACA and ACC check licenses in the following sequence: 1. If a Trial license is not activated, or already expired, all Personal Number users will be allowed up to five profiles. 2. If a Trial license is activated, and not expired, ACA and ACC will check for the existence of a Personal Number license. All Personal Number users will be allowed up to five profiles, if the Personal Number license is activated. However, ACA and ACC will not check for the license limit and will rely on the PBX to reject the Personal Number initiation if the license limit is reached. 3. If a Trial license and Personal Number license are not activated, ACA and ACC will check for Repeated-Individual-Diversion (RID) license. If it is set, all Personal Number users will be allowed one profile. 4. If there is no Trial license, Personal Number license, or RID license activated, all Generic extensions (including cordless extensions, IP extensions, and mobile extensions) will be allowed one profile.
13
Applications
OneBox Controls
OneBox mailbox integration allows you to configure the following basic mailbox attributes. Extension Callout Capabilities Local or Long Distance Enabling/Disabling of Message Waiting Indicators
14
Applications
Message Retention Duration Message Clearing Options Set-up of Tutorial Prompts Desktop Options on OneBox Message Manager
15
Applications
Through the Telephone User Interface (TUI) of OneBox An Operator using D.N.A. Operator Workstation can initiate a diversion for any subscriber.
Note: Communication between OneBox and the D.N.A. Server requires a serial link.
16
Applications
Messages left in mailboxes are available to mailbox users through normal Voice Mail services. When a caller chooses the "transfer to operator" option, and the call is forwarded from OneBox to the PABX Operator, the original called extension is displayed for the operator. The operator can also retrieve the diversion reason from the D.N.A. Database. The OneBox Telephone User Interface (TUI) is the only means of initiating message diversions from a remote location, without having access to a PC. This integration is available for D.N.A. Directory Manager.
Application Link
MD110 Application Link is a software interface for Computer Telephony Integration. It provides a command and status link between the MD110 and the D.N.A. computer. Application Link allows computer controlled call management. Application Link supports applications provided by computer vendors, by Aastra, or applications developed directly by D.N.A. customers.
General Operations
Using a D.N.A. PC as a telephone console, users can send telephony requests from the PC to the switch through MD110 Application Link. The D.N.A. PC can also receive MD110 events as well as A-party and B-party information through the MD110 Application Link. This information can be used by the computer to route the call or call-related data to a computer display.
17
Applications
Through its Computer Supported Telephony (CSTA) based interface, MD110 Application Link supports a variety of Application Programming Interfaces (APIs), including Dialogic's CT Connect, IBM's Call Path, Novell's TSAPI and Tandem's CAM. MD110 Application Link also supports Microsoft's TAPI via its proprietary protocol. Any MD110 Application Link can be configured to support either CSTAbased API's or TAPI, however one server cannot support both.
18
Applications
19
Applications
20
Applications
D.N.A. includes LDAP Server in the D.N.A. Server and an LDAP Client in the Operator Workstation. The OWS can search any LDAP Server for subscriber information and any LDAP Client (i.e., an Internet browser) is able to search the Directory Manager data through the D.N.A. LDAP Server.
Other Interfaces
Directory Link
The Directory Link interface allows non-D.N.A. applications to modify D.N.A. Directory data. Directory Link can be thought of as a DMG client without a user interface. Directory Link accesses and modifies directory databases through the database API library, and communicates with other DMG and OWS clients through RDS. Directory Link specifications are available for interested Aastra Partners through the Aastra Partner Program.
Extension Link
Extension Link is a real-time interface to the Extension Manager (EMG) application. Extension Link manages PBX extensions and facilities, and is designed to make EMG features reusable for customized configuration management applications. Extension Link specifications are available for interested Aastra Partners through the Aastra Partner Program.
21
Applications
D.N.A. CAAPI
The D.N.A. Call Accounting Application Programming Interface (CAAPI) enables Third-party Call Accounting Applications to utilize Directory Manager data. Directory Manager generates a file containing an extract of the DMG data. Call accounting applications can now import these data on a scheduled basis from a single point-of-entry. D.N.A. CAAPI is compatible with the following Network Elements MD110 or MX-ONE
Change Log
The Directory Change Log allows directory data changes to be collected by external applications like Call Accounting Packages, desktop applications, or other Aastra CTI applications. With previous D.N.A. releases it was necessary to re-import all data after adds/moves/changes. With D.N.A, only changed data is imported. The Change Log is a client component of the Remote Data Server (RDS) that sequentially records all Directory Manager and Directory Link modifications made to the Directory Database.
D.N.A. CTI
This schematic summarizes most D.N.A. CTI Interworking capabilities and illustrates the central role of the D.N.A. Directory.
22
Applications
Mobile Executive
This section contains the administrator issues for the Mobile Executive. If you are using Aastra D4 IP phone only, you can ignore the followings and use MD document for phone configurations.
WAP Gateway
If you use your mobile operator's WAP-service, you will probably have to open up your company's firewall to accept and route WAP-traffic to your Mobile Executive server. If you set up your own WAP-gateway and dial-in connection, you open a "hole" where a potential hacker could sneak in. Many companies will probably not allow this, so to strengthen security, the RAS-server could, for example, be put on a separate LAN segment that is separated from the real company-intranet with a firewall (this is just one way to increase security, there are more).
Phone Setup
Setting up a WAP phone is telephone specific, however, the following information is required for all phones. A phone number (to the company's or your mobile operator's RAS-server). Username and password (to log on to the RAS-server). The address of the WAP-gateway (IP-address). Username and password for the WAP-gateway (if used). The user needs the address for the Mobile Executive server. To log on to Mobile Executive the user needs a username and a password. When users have entered this information to their phones they are ready to use WAP.
Click to Dial
This Call Handling feature can only be enabled if Mobile Extension features are activated. To enable the click to dial feature, complete the following steps: 1. 2. 3. 4. Turn on the Call Handling License. Open the Aastra Communication Assistant Configuration Utility. Define the ApplicationLink Server. Define the access to outside lines for local and long distance calls.
Note: When the user logs on, the primary extension must be a mobile extension.
23
Applications
2. Select one of the available profiles, select 4 Access on the WAP Settings menu, select 1 Access Type on the Access menu, and set the Access Type to GSM Data.
3. Return to the Access menu, select 3 Service Center, and enter your Service Center number.
4. Return to the Access menu, select 4 GSM Data, select 1 Phone number on the GSM Data menu, and enter the number of the modem pool used to the WAP Gateway. GSM stands for Global System for Mobile Communications.
5. Return to the GSM Data menu, select 2 Dial Type, and set the Dial Type to Analog.
24
Applications
6. Return to the GSM Data menu, select 3 User ID, and enter the user's ID.
7. Return to the GSM Data menu, select 4 Password, and enter the user's password.
8. Return to the Access menu, select 5 Gateway, select 3 Data Access on the Gateway menu, and enter the IP Address of the WAP Gateway server.
SNMP Agent
SNMP Agent comes with Windows 2000, but is not part of the Typical Installation. To make the SNMP agent for D.N.A. work you must do two things, install D.N.A. and install the Windows master agent. You must have administrator privileges to perform this installation. SNMP is actually a DMI agent that emulates an SNMP agent. The following diagram shows an overview of the different components.
25
Applications
as_dmi.exe
This is the central repository for the status information. The applications store their current status here and DMI picks it up from here. This component is a singleton. That means that there should only be one instance of it running on the machine, all applications (running on this machine) plus asdmi.exe connect to the same object.
asdmi.exe
This component is the glue that actually makes this into a DMI agent. Its instantiated by the CIMgr (i.e., it comes and goes with it) and there is only one at a time on each machine.
26
Applications
NT SNMP
This is the Windows master agent. Its function is to route SNMP requests to the correct DLL. Its functionality is built on installable sub-agents contained within DLL files that are loaded when the master agent is started (as a Windows service). The Registry entries for NT SNMP can be seen under HKLM\System\CurrentControlSet\Services\SNMP.
Dmi2snmp
This is both a DMI management application and an SNMP sub-agent. It performs this double duty as the middle layer that maps SNMP requests to DMI calls and transforms DMI events into SNMP traps. It has no user interface and no configuration, its just loaded by the master agent when it starts and then does its job quietly. The Registry keys for Dmi2snmp can be seen under HKLM\SOFTWARE\Intel\DMI 2.0 to SNMP Mapper.
RDM saves and restores the window size and position in the Registry. By default RDM connects with RDS on the D.N.A. server. If you want to monitor a different service and/or server, select the File > New menu item.
27
Applications
RDM can be launched with command line arguments to connect with any server and service (except "Other"), making it possible to connect very quickly using a batch file or a command line submitted via Start/Run.... Here is the command line syntax: "/server n servername" where "n" is the index of the desired D.N.A. service to be monitored, as listed in the dialog displayed by the File > New menu item. 0) 1) 2) 3) 4) 5) LDAP LDS RDS SCS TSS VSI
The server name defaults to the D.N.A. server machine name unless RDM is already connected to a different machine when the dialog is displayed. In that case, just clear the server name combo box to get back to the D.N.A. server.
Captured Filename
The suggested capture filename concatenates the server name, service name, year number, month number and day number with ".log" as the extension. For example: "DnaServer.log" RDM supports the "auto-capture" command line switch "/ac". To run RDM monitoring RDS on the D.N.A. Server and capture the log file with the automatically generated name, place this batch file "RDM.bat" in the Startup folder for the appropriate user ID: start rdm /ac If there are other services you wish to log, add them to the batch file as well. For example to log SCS:
28
Applications
Visitor Registration
Customers can use Visitor Registration to have visitors to a facility register in the lobby. The Visitor Registration dialog box is opened from the Start menu. Start4Programs4D.N.A. Application Suite4Visitor Registration The Visitor Registration dialog box provides edit boxes for Visitor Name, Contact Person, Extension, and Keyword. The Extension field defaults to the contact persons extension, but can be changed. Visitor information is registered with the Add button and unregistered with the Delete button. The Refresh button updates the dialog box fields with the latest information from the database. Visitor information can be printed with the Print... button. Visitor data can also be entered, changed, or deleted in Directory Manager. Visitor entries are distinguished from permanent subscribers on the Options tab of the View/Update Subscriber dialog. A check in the "Show in Visitor Registration" box indicates the selected subscriber is a visitor, and the name will appear in the Visitor Name drop-down list in Visitor Registration. The absence of a check mark means this is a permanent subscriber who may act as a Contact Person and is therefore listed in the Contact Person drop-down list in Visitor Registration.
29
30
License Administration
The Unique Pick Numbers (UPNs) are used in the License Web application described below to uniquely identify the purchased licenses. To access the ordered licenses, a user Id and password are needed to the License Web application and the unique pick numbers generated for each of the ordered licenses. The unique pick numbers are delivered through e-mail to a pre-defined email address. The unique pick numbers can then easily be re-distributed to the persons that need the unique pick number to be able to generate the license file for a specific D.N.A. system.
31
License Administration
Support
For support, please contact your Aastra partner.
32
Chapter 4 Pre-Installation
About Pre-Installation
Before installing D.N.A. Application Suite components, perform checks and preparations necessary for a smooth and successful completion. Specifically, make certain you perform the following: 1. 2. 3. 4. Conduct a pre-installation meeting with the customer. Verify that all PC hardware requirements have been addressed. Verify that all software requirements have been addressed. Verify that all PBX requirements have been addressed.
Pre-Installation Meeting
You can avoid many common D.N.A. installation problems by including at least one pre-installation meeting in your preparations. Use this meeting to coordinate your plans with the customer well in advance of the actual installation. The following manuals could be useful for Installation. Windows System Guide MD110 Customer Library SQL Server Books Online (BOL)
Pre-installation Checklist
Aastra provides a Pre-Installation Checklist to help with installation planning. Use this checklist to identify and verify the all-responsible persons and essential D.N.A. components.
33
Pre- Installation
Note: For MX-ONE, since only Ethernet connection is available, use NIU for connection option in EMG/MDS. Extension Manager, MD Support, and Performance Data Manager can optionally utilize Access Agent devices for extended communications. For MD110, BC12.1 and above are supported. BC9 is only available for synchronization from MD Support (not for Extension Manager or Performance Manager). For OWS, the following phone types are supported: DBC222, DBC223 and DBC225.
Configuration Options
D.N.A. Application Suite consists of flexible products that can be used in a wide range of configurations. For purposes of this help guide, however, the general configuration options are explained in the following table. Configuration Options Explanation Network vs. stand-alone In a network installation, D.N.A. applications are spread across multiple PCs. One PC (the server) includes the SQL database server and D.N.A. Server software. One or more other PCs (clients) are connected to the server and are used to run the applications. If desired, the server can also be set up as a client that runs applications. In a stand-alone installation, the SQL database server, D.N.A. Server software, and D.N.A. client applications are all installed on a single PC, and there are no connected PCs used to run applications. The standalone PC is set up as both the server and the client for all applications. Single node vs. multi-node Each D.N.A. installation can support one node or multiple nodes. Both network and stand-alone installations can be set up as single node or multi-node.
Stand alone
The following diagram represents a stand-alone installation of an Operator Work Station together with Directory Manager.
34
Pre-Installation
The stand-alone PC contains Microsoft Windows (Windows Server 2003 or Windows 2008 Server), the D.N.A. Server, and the Operator Workstation and Directory Manager applications. The Operator Workstation voice connection to MD110 is by means of a CT adapter via ELU28. In order to provide diversion information to and from the Operator Workstation, the D.N.A. server is connected to the MD110 NIU via TCP/IP.
The D.N.A. Server contains Microsoft Windows (Windows Server 2003 or Windows 2008 Server), Microsoft SQL Server, and the D.N.A. Server application. The D.N.A. Server and the MD110 Access Agent are connected via the LAN and TCP/IP. Direct communication between the server and the PBX is necessary to transmit diversion information. All other communication is done through the clients. The Extension Manager and Performance Manager Clients communicate with the PBX via the same physical interface: Extension Manager to make adds, moves and changes in the PBX, Performance Manager to set up measurements in the PBX. Updates of the Extension Manager or Performance Manager Database are transferred from the PBX to the Client and from there to the server database. The call data records (CDRs) are transferred to the Client running the call accounting application via V.24 (as shown in this illustration) or via TCP/IP. The call account application also communicates with the D.N.A. Server via the LAN to get the directory information (like Names, Departments, Cost centers etc.).
35
Pre- Installation
PC Hardware Requirements
This section lists basic hardware requirements for D.N.A. server and client PC installations of up to 500 extensions and < 1000 directory size.
Server
Each PC that will be configured as a D.N.A. server should meet the following requirements. This recommendation includes D.N.A. server, DME server, Aastra Communication Assistant (ACA) server, and ACC server. For larger installations, more memory and faster CPU may be required for satisfactory operation (dependent upon specific D.N.A. installation). Component PC/CPU Memory Minimum Requirement Pentium IV, 2.4 Ghz (or better) 512 Mbytes RAM
Operating System Windows Server 2003 or Windows 2008 Server Monitor and Card 1024 x 768 monitor and video card resolution Mouse CD-ROM COM Ports Microsoft-compatible two-button mouse. Required for server PC only. Communications port requirements are based on which applications will be installed. A DigiBoard or COM port adapter may be used if additional COM ports are needed. For Event Manager, only ports COM1-COM4 are supported. Printer Ports Sound Board IEEE-488 parallel port for printer (LPT1). Server (optional), OWS client (recommended for Visually Impaired option). Server (optional), OWS client (recommended for Visually Impaired option).
Speakers
Specific Requirements
Platform 1 COM port/PBX (used for diversion information). Not applicable if the D.N.A. Access Agent or NIU is used. 1 COM port/Time system. 1 COM port/Voice mail. Database size: 20 Mbytes.
36
Pre-Installation
DMG
Database size: 45 Mbytes for the first 2000 subscribers. 2.5 Mbytes for each additional 500 subscribers. 10 Kbytes / photo (2.5 cm x 1.5 cm in 256 colors). 1 COM port for PBX connection (if using serial interface) Not applicable if D.N.A. Access Agent or Ethernet connection is used. Database size: 6 Mbytes/PBX. 15 Mbytes per 500 extensions + 7.5 Mbytes. 1 COM port for CT adapter. 1 COM port for OWS keyboard (optional). Disk drive (memory) requirement 3 MB per 1000 directory entries 1 COM port for MD110 connection (PDM). Not applicable if the D.N.A. Access Agent or NIU is used. Primary database size: 9 Mbytes/month + 19 Mbytes (for 20 measurements). Auxiliary database size: 9 Mbytes/month + 10 Mbytes (for 20 measurements). Archive files: 4 Mbytes/month.
EMG
OWS
PMG
Client PC
Each PC that will be configured as a D.N.A. client should meet the following requirements. This recommendation includes PMG, DMG, EMG, ACC, OWS and OWS Supervisor. For larger installations with larger directory size and merging of the directory, more RAM is required for the OWS client machine. Component PC/CPU Memory Minimum Requirement Pentium III, 800 Mhz (or better) 256 Mbytes RAM (or better)
Operating System Windows XP Professional, Vista or Windows Server 2003, Windows Server 2008. Monitor and Card Mouse CD-ROM COM Ports 1024 x 768 monitor and video card resolution Microsoft-compatible two-button mouse. N/A Required for server PC only. Communications port requirements are based on which applications will be installed. For Event Manager, only ports COM1-COM4 are supported. IEEE-488 parallel port for printer (LPT1).
Printer Ports
37
Pre- Installation
OWS client (recommended for Visually Impaired option). OWS client (recommended for Visually Impaired option).
Specific requirements
Platform DMG EMG No specific requirements. No specific requirements. 1 COM port for PBX connection (for serial interface). Not applicable if the D.N.A. Access Agent or Ethernet connection is used. 1 COM port for CT adapter. 1 COM port for OWS keyboard (optional). 1 COM port for PBX connection (PDM). Not applicable if the D.N.A. Access Agent or NIU is used.
OWS
PMG
Operating System Windows Server 2008 (32-bit only for D.N.A installations) Hard Disk Monitor and Card Mouse DVD-ROM COM Ports 40 GB hard drive with at least 15 GB of available space 1024 x 768 monitor and video card resolution Microsoft-compatible two-button mouse. N/A Required for server PC only. Communications port requirements are based on which applications will be installed. For Event Manager, only ports COM1-COM4 are supported.
38
Pre-Installation
Printer Ports
5. For Web Server (IIS) add the following Role Services. Common HTTP features Application Development Management Tools (IIS 6.0 Compatibility)
39
Pre- Installation
6. When Role services are selected for both Application Server and Web Server (IIS), see to that the sub features are also selected under them.
Operating System Windows Vista Business (32-bit only for D.N.A installations) Hard Disk Monitor and Card Mouse DVD-ROM COM Ports 40 GB hard drive with at least 15 GB of available space 1024 x 768 monitor and video card resolution Microsoft-compatible two-button mouse. N/A Required for server PC only. Communications port requirements are based on which applications will be installed. For Event Manager, only ports COM1-COM4 are
40
Pre-Installation
supported. Printer Ports Sound Card Speakers IEEE-488 parallel port for printer (LPT1). OWS client (recommended for Visually Impaired option). OWS client (recommended for Visually Impaired option).
41
Pre- Installation
Specific Requirements
OWS
PMG
Additional hardware that can be installed on a PC includes Ethernet adapter, tape drive, and serial port adapter (or DigiBoard). To install the hardware, follow the manufacturer installation instructions to set the IRQ and I/O address. You may need to run setup programs from the vendor to configure the hardware. IRQ and I/O addresses must be unique for each port and hardware device.
Recommendation
For the best reliability, Aastra recommends that you use the Windows NT File System (NTFS). If you are supporting a large system requiring data redundancy, you may use any of Windows RAID software implementations. However, if you choose to employ a hardware RAID solution, make sure it is on the Windows hardware compatibility list (HCL).
42
Pre-Installation
Application
Caching for GUI Execution Local DB Memory map Log Files files (1MB / 1000) x Total extensions on all nodes x 15 [See D.N.A. Server note]
D.N.A. Server 60 MB for executable executable size files 200 MB for client installation and other files
Photos
N/A
10 KB per 2.5 cm x 1.5 cm N/A (1" x ") photo in 256 colors Customer dependent N/A
N/A
N/A
N/A
N/A
N/A
9 MB
DIRDBDAT -for fewer than 1 MB 2000 subscribers = [20 MB] -For more than 2000 subscribers = [20 MB + 1 MB/200 x (No. of subscribers - 2000)] DIRDBLOG -for fewer than 200 subscribers = [25 MB] -For more than 2000 subscribers = [25 MB + 1MB/200 x (number of subscribers - 2000)]
Extension Manager
14 MB
1 MB per 17 KB x No. 1000 of Nodes subscriber EMGDBLOG = 4 MB x no. s of Nodes + Total extension of all nodes/100 x 2 MB [See note (2)] N/A 6 MB/1000 N/A subscriber s 1 MB/1000 subscriber s
7 MB
7 KB per logged-in User ID Archive files - 4 MB per node per month Logs - 2 MB per node
5.5 MB
For minimum 20 measurements: PDMDAT - 10 MB + 9 MB x (primary month + auxiliary month) PDMLOG - 21 MB (if
43
Pre- Installation
Application
Executable SQL Database auxiliary is used) or 11 MB (if auxiliary is not used) + 9 MB x (primary month + auxiliary month) Database device size will be increased based on the number of Active Measurements (e.g., 30-40 = base size x 2) 50-60 = base size x 3
Aastra 6.5 MB Communicatio n Client Mobile Executive 28 MB 12 MB/1000 subscriber s (share with ACA if co-exists)
PPM Lite Notes 4.6 installation Notes 5.0 installation Notes 6.0 installation
14 MB 16 MB 30 MB 7 MB
*N/A = does not apply Notes: D.N.A. Server Assume that MDS is used not more than 15 days per month and the following month the log file is overwritten. Extension Manager Site# database in EMGDBDAT = 6 MB + Extension of the node# / 100 x 3 MB Site# database in EMGDBLOG = 4 MB + Extension of the node# / 100 x 2 MB Assume 20 KB per log file per day and there are 31 log files in a month and EMG is used everyday. The following month the log file will be overwritten.
44
Pre-Installation
Directory Manager
9 MB
N/A
N/A
Extension Manager
14 MB
N/A
Aastra 37 MB Communication Client Operator Workstation Performance Manager Notes 4.6 Notes 5 Notes 6 7 MB N/A 6 MB/1000 subscribers 1 MB/1000 subscribers N/A 7 KB per logged-in User ID 2 MB per node
5.5 MB
N/A
5 MB 5 MB 5 MB
45
Pre- Installation
Note - Extension Manager: Assume 20 KB per log file per day and there are 31 log files in a month and EMG is used everyday. The following month the log file will be overwritten.
Software Requirements
Windows
The following are supported: Windows XP Professional (with Service Pack 2), Windows Server 2003 (with Service Pack 1) and Windows Vista Business. Microsoft SQL Server * 2005 Express Engine, Microsoft SQL Server 2005, Microsoft SQL Server 2008 and Microsoft SQL Server 2008 Express Edition. Important! You must have 100 MB free disk space on each server or client PC in order to run the D.N.A. installation program.
SQL Server
D.N.A. applications use Microsoft SQL Server 2005, Microsoft SQL Server 2005, Express Engine, Microsoft SQL Server 2008 or Microsoft SQL Server 2008 Express Edition. If a database application does not exist on the server, the D.N.A. application suite installation program prompts you to choose between Microsoft SQL Server 2005/2008 for General Latin. Important! DNA 5.6 does not support SQL Server 2000 edition.
Excel
If you are installing Performance Presentation Manager, then Excel 2003 or Excel 2002 with SP2 or later must be installed on each PC where Performance Presentation Manager will be installed. Refer to the Microsoft Excel documentation for installation instructions.
Internet Tools
PPM Lite, Aastra Communication Assistant, Mobile Executive, ACC Server and Personal Assistant must be installed on a server containing Microsoft Internet Information Server (IIS 7.0 for Windows Server 2008, or IIS 6.0 for Windows Server 2003). PPM Lite and Aastra Communication Assistant work with Internet browser Microsoft Internet Explorer 6.0 or later. Warning: PPM Lite will not function properly without a session state. The Session Timeout feature for your PPM Lite website must not be disabled.
46
Pre-Installation
Direct/Local Connection
47
Pre- Installation
Remote Connection Through Public Switched Telephone Network (PSTN) After connecting the server PC to the MD110, initialize the GICI port on the ICU board as described in the MD110 documentation.
48
Pre-Installation
2. Enter the PBX Server Name or IP address and the TCP Port of the MX-ONE Telephony Server. 3. Connect the Operator Media Device (OMD) in the LAN. Provide the Telephony Server and the Software server IP address in the Network setting of the OMD phone. 4. Close the OWS application and launch it again. 5. Operator Extension logon dialog is prompted after OWS is logged in. Provide the Operator Extension and password defined in the Telephony Server to register the OWS Application. 6. Logon the OMD phone with the same extension and password. OMD phone is also registered in the Telephony Server.
49
Pre- Installation
50
Pre-Installation
Make a direct connection by connecting an RS-232 cable between a COM port on the client PC and the IPU board on the MD110. TCP/IP LAN connection is achieved through an access agent connected to an IPU board. For a remote connection, the client PC is connected to a TAU or modem that connects to a TAU or modem on the MD110. For MX-ONE, only Ethernet connection is supported, so the option selected in EMG/MDS must be NIU. The following schematics show connection configurations for direct and remote communication.
51
52
SQL Installation
10) On the Components to Install page, select the components for your installation. A description for each component group appears in the Components to be Installed pane when you select it. To install individual components, click Advanced. Otherwise, click Next to continue. 11) Note: When installing SQL Server 2008 or SQL Server 2008 Express Edition for the D.N.A. Application Suite, you must have the SQL Server Database Services component installed. 12) If you clicked Advanced on the previous page, the Feature Selection page is displayed. On the Feature Selection page, select the program features to install using the drop-down boxes. To install components to a custom directory, select the feature and then click Browse. 13) 14) On the Instance Name page, select a default or named instance for your installation. On the Services Accounts screen, select the Use the Local System account option and click Next >.
15) On the Authentication Mode page, choose the authentication mode as Mixed Mode. Enter and confirm a strong password for the sa login. To proceed, click Next. 16) On the Collation screen, select SQL Collations and select Dictionary order, case-sensitive from the Sort Order drop-down list and click Next >. 17) 18) Click Next > on the Ready to Install Dialog to proceed to the Setup Process dialog. When the installation completes, click Exit on the Microsoft SQL Server options page.
Security
For security reasons, you should change the default sa Login ID and blank password of MS SQL Server. 1) In the Service Manager window, open the registered D.N.A. Servers tree and the Logins tree. 2) 3) Double-click on sa to open the Manage Logins dialog box. Change the Login Name and Password and click Modify.
Note: After changing the "sa" password, also change your "Login ID Password" for the registered D.N.A. Server in SQL Enterprise Manager. You can do this by right-clicking the Server Name.
Memory
SQL Server 2008 is configured dynamically. However, memory should be limited to for SQL Server use. To set a maximum value for memory (Enterprise Manager) 1) Expand a server group. 2) Right-click a server. 3) Click Properties. 4) Click the Memory tab. 5) In the memory box, select maximum size (MB), and slide it to the desired position.
53
SQL Installation
SQL Installation
6. On the SQL Server Component Update page, Setup installs software required for SQL Server 2005. For more information about component requirements, click the Help button at the bottom of the page. To begin the component update process, click Install. To continue after the update completes, click Finish. 7. On the Welcome page of the SQL Server Installation Wizard, click Next to continue. On the System Configuration Check (SCC) page, the installation computer is scanned for conditions that may block Setup. For information about configuration check items, click Help at the bottom of the page or see Check Parameters for the System Configuration Checker. 8. On the Registration Information page, enter information in the Name and Company text boxes. To continue, click Next. 9. On the Components to Install page, select the components for your installation. A description for each component group appears in the Components to be Installed pane when you select it. To install individual components, click Advanced. Otherwise, click Next to continue. Note: When installing SQL Server 2005 or SQL Server 2005 Express Edition for the D.N.A. Application Suite, you must have the SQL Server Database Services component installed. 10. If you clicked Advanced on the previous page, the Feature Selection page is displayed. On the Feature Selection page, select the program features to install using the drop-down boxes. To install components to a custom directory, select the feature and then click Browse. 11. On the Instance Name page, select a default or named instance for your installation. 12. On the Services Accounts screen, select the Use the Local System account option and click Next >. 13. On the Authentication Mode page, choose the authentication mode as Mixed Mode. Enter and confirm a strong password for the sa login. To proceed, click Next. 14. On the Collation screen, select SQL Collations and select Dictionary order, case-sensitive from the Sort Order drop-down list and click Next >. 15. Click Next > on the Ready to Install Dialog to proceed to the Setup Process dialog. 16. When the installation completes, click Exit on the Microsoft SQL Server options page.
Security
For security reasons, you should change the default sa Login ID and blank password of MS SQL Server. 1) 2) 3) In the Service Manager window, open the registered D.N.A. Servers tree and the Logins tree. Double-click on sa to open the Manage Logins dialog box. Change the Login Name and Password and click Modify. Note: After changing the "sa" password, also change your "Login ID Password" for the registered D.N.A. Server in SQL Enterprise Manager. You can do this by right-clicking the Server Name.
Memory
55
SQL Installation
SQL Server 2005 is configured dynamically. However, memory should be limited to for SQL Server use. To set a maximum value for memory (Enterprise Manager) 1) 2) 3) 4) 5) Expand a server group. Right-click a server. Click Properties. Click the Memory tab. In the memory box, select maximum size (MB), and slide it to the desired position.
56
SQL Installation
b) Specify the SQL Collation in the section SQLCOLLATION = SQL_Latin1_General_Cp1_CS_AS_KI_WI During D.N.A Server installation 1) At the Database Application Selection dialog box, select Microsft SQL Server 2008. 2) At the Database Application Installation Configuration dialog box, enter (or browse for) the destination path of SQL Server files. Enter (or browse for) the location of the SQL Server installation files. Enter the location of your SQL Server configuration file. This is where the modified setup_std_template.iss with your SQL CD key is defined. Leave SQL Server CD Key as blank. Note: A hard-coded password, Aastra123 is assigned to the sa login in setup_std_template.ini, because sa login should never have a blank password (for security reasons). You should change this password at your earliest opportunity. Please refer to Change SQL SA password for details.
57
SQL Installation
1. If 2005/2008 is used you can use SQL Server Management Studio to change the password. You can also do it via command line as below. Note: If you use D.N.A. DBCP utility for database backup, you must run DBCP to backup your databases again after sa password change. This is because backup files created with the old sa password cannot be restored with the new sa password.
58
SQL Installation
23. Make sure Send Authentication Trap is checked, that public has READ CREATE rights, and that Accept SNMP Packets from Any Host is checked. These settings are good starting points since they dont put many restrictions on the SNMP traffic. When you feel comfortable with the SNMP configuration, feel free to change them. 24. Click OK to save these settings. Remember to stop and re-start the SNMP service to make the settings active.
59
Hardware Connections
You must perform or verify installation of all necessary communications and signaling connections before proceeding to software installation.
Software Installation
Server Installation. For a D.N.A. Server installation, all server software is installed on one PC, and the client software is then installed on one or more PCs connected to the server. Client Installation. Client software can be installed from a network D.N.A. Server or directly from a D.N.A. software CD-ROM inserted in the client PC's CDROM drive.
Installation Checklists
This section provides checklists for D.N.A. server and client workstation installation. Use these checklists to assist in installing D.N.A. Application Suite Version components.
60
D.N.A. Installation
Pre-installation Checklist
Use this pre-installation checklist to verify and identify all hardware and software components before beginning the installation process.
Installation Profile
List the customer identity along with all software and hardware components to be included in this installation. Customer: Hardware Server: _____________________________________________ _____________________________________________ _____________________________________________ _____________________________________________ Software D.N.A.: Software PBX: _____________________________________________ _____________________________________________ Responsible Contact: _____________________________________________
Number of client PC's: _____________________________________________ Installation Eng. D.N.A.: _______________________________________ Installation Date: _____________
Windows Server 2003, Standard or Enterprise -or- Windows Server 2008, Standard or Enterprise Windows XP Professional + SP 2 -or- Windows Vista Business Windows SQL Server 2005 Windows SQL Server 2005 Express Windows SQL Server 2008 Windows SQL Server 2008 Express D.N.A. Access Agent: Base System Version R___ V__.__.__ Date: ______________
c c c c c c
61
D.N.A. Installation
Product ID EMG:
__________________,
Installation Features
New installation features for D.N.A. include: Customizable System The application licenses must be enabled through Enterprise License Manager and user privileges through User Configuration. The node information such as node name, communication method, etc. must be set through MD110 Support. The user-defined fields in the Directory database must be defined through Directory Configuration. Pre-configured System The installation defines users and privileges and configures the node information and communication with the PBX. The desired user-defined fields for Directory Manager will also be defined. Application licenses are enabled through Enterprise License Manager. Note: The pre-configured system does not support the configuration of communication with the MX-ONE. Silent Installation You may use the graphical D.N.A. setup.exe interface, or the "Silent Installation" method supported by a preconfigured .ini file. (Silent Installation only applies to client installations.)
Pre-Configured System
You can use a pre-configured installation file (dna.cfg) to retrieve system information and make the installation automatic. The dna.cfg file contains default settings for pre-configured information that you can edit for your installation. The installation program prompts you for the location and file name. In addition, the installation program validates the pre-configured information file to make sure all required information is defined correctly.
62
D.N.A. Installation
Administrator Account All application with pre-defined (highest privilege) privileges are assigned. Regular User Account The desired application with associated predefined privilege (highest privilege) will be assigned.
MD110 Communications
Node Information All information associated with a node can be defined. For example, Node name, BC release, MD password. Communication with MD110 Your choice of communication with the MD110 can be defined. For example, Direct, Modem, IPU and NIU. The Registry settings are loaded to the client system for all installed applications that requires the MD110 interface, such as MD Support, Extension Manager, and PDM.
GICI Configurations
You can specify GICI configuration methods, including Direct, Telnet, and NIU.
63
D.N.A. Installation
phonesetup1=6632 ;sample of MDS direct connection. ASB501Release=8(BC10),9(BC11),or 10(BC12.1) [MDSConfiguration2] Enable=1 ConnectionType=DIRECT SiteName=Test Direct NIU_Password=HELP IPU_Password=HELP NIULoginUserName=MDUSER ASB501Release=8 Port=2 ;sample of MDS telnet connection. ASB501Release=8(BC10),9(BC11),or 10(BC12.1) [MDSConfiguration3] Enable=1 ConnectionType=TELNET TelnetSetup1=195.150.112.120,4,,, TelnetSetup2=195.150.101.182,3,agent,password, SiteName=Test Telnet NIU_Password=HELP IPU_Password=1HELP NIULoginUserName=MDUSER ASB501Release=8 [GICIPortConfiguration1] Enable=1 PortName=test direct ConnectionType=DIRECT DNFillerCharacter=@ InformationSystemID=00 MaxDNLength=5 MaxTerminalID=2 BaudRate=9600 DataBits=8 StopBits=1 Parity=1 FlowControl=0 OutputTimeDelay=50 Port=COM2 [GICIPortConfiguration2] Enable=1 PortName=test niu ConnectionType=NIU
64
D.N.A. Installation
DNFillerCharacter=A InformationSystemID=00 MaxDNLength=5 MaxTerminalID=2 NIUPortID=12345 [GICIPortConfiguration3] Enable=1 ConnectionType=TELNET PortName=test telnet DNFillerCharacter=@ InformationSystemID=00 TelnetAddress=195.150.113.98 TelnetAccount=abcd TelnetPassword=test OutputTimeDelay=100 DNFillerCharacter=64 InformationSystemID=00 MaxDNLength=8 MaxTerminalID=2 [UserPrivileges] Enable=1 tstusr=test user;test user description;USER;MDS,1,2,3;PCOPI tstusr2=test user2;test user2 description;all,3 [UserDefinedFields] Enable=1 ;Number of Profile fields is even number from 8 to 20 NumberProfileFields=14 Profile1= Prof Assistant,6, Yes, Assistant Profile2= Prof Cost_Center, 1, No,None Person1 = Person Home, 43, Yes, HOME Confidential1 = Conf password, 53 Department1 = My department, 31, NONE External1 = My external, 3, MAIL Function1 = function Cellular number, 38, Yes, CELLULAR Room1= room Secretary Name, 6, NO, SECRETARY Information1 = My info, 29, yes, NONE
65
D.N.A. Installation
To apply D.N.A. 5.6 to your existing D.N.A. system you will need to upgrade using the new CD containing D.N.A. 5.6. DNA 5.5 version can only be upgraded to DNA 5.6. Upgradings from DNA 5.3 or DNA 5.4 versions to DNA 5.6 version is not recommended. There are basically two different environments of older D.N.A. systems. 1. D.N.A. 4.1 / 5.0 / 5.1 running on either SQL Server 7.0 or MSDE 2. D.N.A. 5.0 / 5.1 / 5.2 / 5.3 / 5.4 running on SQL Server 2000 or MSDE 2000 3. DNA 5.4 / 5.5 running on SQL Server 2000 or 2005 For any scenario it is strongly recommended to backup the older system before starting the upgrade.
Upgrade D.N.A. Server and SQL Server on your current D.N.A. Server computer
The upgrading of SQL Server and D.N.A. should always be carried out on the computer that is currently running the D.N.A. system. If you later want to move your D.N.A. installation from one computer to another, you must ensure that the two computers are on the same network and are able to use named pipe connections between them.
66
D.N.A. Installation
Server Installation
D.N.A. application setup now recommends which applications to install and where to install them. For example, you will probably want to choose the Typical option in the installation wizard, which installs all D.N.A. applications. Alternatively, you may choose the Custom option that allows you to select individual applications to include in the installation, omitting those you do not want. The D.N.A. Server installation process installs the D.N.A. operating platform, all applications (except Aastra Communication Assistant, Mobile Executive, PPM Lite, Lotus Notes, and Outlook Integration), and all administrative tools on your Windows Server PC. Windows Workstation client PCs may then connect to this server to install D.N.A. applications and support utilities.
Auto-Run Installation
Insert the D.N.A. CD in the CD-ROM drive. If supported by your PC, auto-run will activate the installation program and you will be presented with the following auto-run options.
67
D.N.A. Installation
Install Application Suite Install Aastra Communication Assistant Install Lotus Notes Integration 4.6 Install Lotus Notes Integration 5.0 Install Lotus Notes Integration 6.0 Install PPM Lite Install Mobile Executive Install ACC Server View Technical Guide View Release Notes Exit
Taskbar Installation
Use this procedure to install from the CD-ROM on a PC that does not support auto-run. 1. Insert the installation CD. 2. Click Start, Run on the Windows taskbar. 3. Type the network path to the desired setup program (for example, installing from CD, type: d:\dna\setup.exe. Alternatively, use the Browse button to browse to the appropriate setup.exe program file. 4. Click the Server installation option button and follow the instructions from the installation wizard.
Note: When trying to install DNA 5.6 on a computer running SQL 2000 Server, the below message will be displayed:
Note: The Preparing to install dialog box displayed during ACC Server installation contains a reference to ECC Server. This reference can be disregarded.
68
D.N.A. Installation
Server Installation Wizard This table lists the screens and prompts displayed when you perform a new installation. Wizard Screen and Options Welcome Explanation Overview of what the installation will accomplish, instructions for closing other applications, copyright warnings. Choose whether the PC you are setting up will be a D.N.A. Server or Client. The server installation creates a \\dna_s directory containing selected applications. The client installation places selected applications in a \\dna_c directory and assigns the connected server as the local server. This screen is displayed only when SQL Server is not installed.
Database Server Language Collation General Latin Simplified Chinese Database Application Selection
If installation cannot detect a database engine and General Latin was selected on the Database Server Language Collation screen, this page is displayed. You must have licensed SQL Server if you choose the SQL Server 2008 Microsoft SQL Server option. Microsoft SQL Server SQL Server 2008 Express 2008/2005 Express Edition is provided by the D.N.A. Installation. SQL Server 2005 SQL Server 2005 Express
69
D.N.A. Installation
Explanation
This page is displayed when the installation cannot detect SQL Server and Windows Server 2003 or Simplified Chinese was selected on the Database SQL Server 2008 Express Server Language Collation screen. You must have a licensed SQL Server if you choose the Microsoft SQL Server option. Microsoft SQL Server 2008/2005 SQL Server 2008 Express Edition is provided by the D.N.A. Installation.
Database Application Installation Configuration Destination Path Installation Files Configuration File Enter or browse for the destination of SQL Server files. Enter or Browse for the location of the SQL Server setup files. Enter the location of the SQL Server configuration file. The D.N.A. Installation displays the default configuration file provided by the installation package. Enter the SQL Server CD Key if required. Enter your name and company. Click Yes if the registration is correct. Enter a password for the Database Administrator (sa) account if desired.
CD Key User Information Registration Confirmation Database Application Administrator Password Nodes and Extensions for Database
Select from 1-256 nodes and 500 to 200,000 extensions for your network. This information is used to determine the amount of disk space needed for the Number of Nodes (drop-down installation. You may change these options. list) Total Number of Extensions (drop-down list) Select Installation Method Choose Typical to install all available D.N.A. components (applications, databases, and D.N.A. Server support utilities and components). Choose Custom to select specific components to install.
Typical
Custom Select Components This screen is displayed when you select Custom on the Select Installation Method page. Check the components you want to install in the list. This screen is displayed when running a Custom Installation. Select the language of your choice from the list. The Typical Installation automatically installs
Locale Support
70
D.N.A. Installation
Explanation English, and local support if the Regional Settings of the PC are supported. Note: In EMG application the phone layout will still be displayed in English. A French version is available on the CD under the directory (\dna\locale\Emg\French\DEF\French). When installation has completed you can copy these files locally to directory (DNA_S\EMG\DEF).
OWS Level Selection Professional Basic Centrex Extension Per Node Performance Manager Databases Setup
Choose Professional for fully configurable Operator Work Station interface and options. Choose Basic for no configurable options and no remote search capabilities. Select Centrex for a BSS (service provider) configuration.
Click the Change button to change the number of extensions for a selected node. Allows you to choose database sizes for primary and auxiliary databases, and for storing active measurements.
DNA PreConfiguration Option This option can be skipped. To use this option, enter the full path name of the pre-configuration file or browse to it. Check Run MD Support synchronization if you want installation to start MD110 data synchronization after installation is completed. Choose Destination Location Click Next > to accept the default folder for your installation, or click the Browse button to select another. Data Files and Log Files Locations RDS Scheduled Jobs Start Copying Files Accept or choose locations for D.N.A. SQL database components. Use this screen to change the location of Log and Data files if desired. Select or unselect tasks that will be scheduled for automated execution after the installation completes. Review a comprehensive summary of your installation choices. Click Next > to begin the installation process based on your choices. Click Back to change your selections before proceeding. Click Cancel to abort the installation. D.N.A. Application Suite installation launches Enterprise License Manager installation. Click Next > to continue.
71
D.N.A. Installation
Wizard Screen and Options Choose License Server Auto-discover license server(s) Manually specify a host Install license server locally Auto-discovering license servers
Explanation Choose your license server host among three options. Choose Auto-discover to list all the Enterprise license servers in your network. You can also specify the host that contains a license server and also define the port number. The third choice is to install license server on the local machine.
This screen is displayed when Auto-discover is selected. All hosts on the network that contain the license server will be displayed. The server with permanent license will be listed first. After the installation has finished, this screen displays a list of the D.N.A. components installed. It also displays any problems encountered during the installation. Choose Yes, I want to restart my computer now to restart your PC and complete the installation process. Choose No, I will restart my computer later to close the installation program and restart the PC later.
Summary Installations
Setup Complete
Installation Options
At any time after D.N.A. server software has been installed, you may use the Auto-Run or Taskbar installation methods to add, re-configure, and remove components using the following options. Option Add Components Explanation Allows you to add D.N.A. components not already installed. Installs new language capabilities to installed components. Note: In EMG application the phone layout will still be displayed in English. A French version is available on the CD under the directory (\dna\locale\Emg\French\DEF\French). When installation has completed you can copy these files locally to directory (DNA_S\EMG\DEF). Allows you to repeat the last installation to restore missing or corrupted files. Deletes all installed D.N.A. components. (You may also perform this task using Add/Remove Programs from the Windows Control Panel.) Allows you to change the number of nodes, extensions,
Install Locale
Reinstall
Remove All
Resize Database
72
D.N.A. Installation
Option
Add Components
On the D.N.A. Setup dialog box, select Add Components. You will encounter the following dialog boxes when adding D.N.A. components to an existing installation. Select Components Lists components available to be added. Locale Support Select language support for the new applications. Database Application Administrator Password Data Files and Log Device Locations Start Copying Files Summary Installations Setup Complete Setup program has performed the requested upsizing tasks. Click Finish. The system will now restart to complete the installation.
Resize Database
You will encounter the following dialog boxes when resizing D.N.A. components in an existing installation. On the D.N.A. Setup dialog box, select Resize Database. Nodes and Extensions for Database Upsizing Components Lists components eligible for upsizing. Upsizing Extension Per Node Allows you to change node and extension quantities. Upsizing [Application ...Setup] SQL Administrator Password Start Copying Files Summary Installations Setup Complete Setup program has performed the requested upsizing tasks. Click Finish.
Client Installation
The latest D.N.A. installation application improves the installation process. It now recommends which applications to install and where to install them. For example, youll probably want to choose the Typical option in the installation wizard, which installs all the D.N.A. applications available on the selected D.N.A. server. Alternatively, you may choose the Custom option that allows you to select individual applications to include in the installation, omitting those you do not want.
73
D.N.A. Installation
Important! If you are installing an instance of D.N.A. Client on Windows XP, refer to D.N.A. Client Installation on Windows XP.
Auto-Run Installation
Use this procedure to install from CD-ROM on a PC that supports auto-run. Insert the D.N.A. CD in the CD-ROM drive. If supported by your PC, auto-run will activate the installation program and you will be presented with the following auto-run options. Install Application Suite Install Aastra Communication Assistant Install Lotus Notes Integration 4.6 Install Lotus Notes Integration 5.0 Install Lotus Notes Integration 6.0 Install PPM Lite Install Mobile Executive Install ACC Server View Technical Guide View Release Notes Exit 1. Select Install Application Suite. 2. Click the Client installation option button and follow the instructions from the installation wizard.
Taskbar Installation
Use this procedure to install from the network, or from CD-ROM on a PC that does not support auto-run. 1. If you are installing from a network location, connect to it. If you are installing from CD-ROM, insert the installation CD. 2. Click Start, Run on the Windows taskbar. 3. Type the network path to the desired setup program (for example, installing from CD, type: d:\dna\setup.exe; installing from network, type: d:\dna_s\mrs\InstallationFiles\ClientInstallation\setup.exe). Alternatively, use the Browse button to browse to the appropriate setup.exe program file. 4. Click the Client installation option button and follow the instructions from the installation wizard.
74
D.N.A. Installation
This screen is displayed when you install from the CD. Choose whether the PC you are setting up will be a D.N.A. Server or Client. The client installation places selected applications in a \\dna_c directory and assigns the connected server as the local server. Enter your name and company. Click Yes if the registration is correct. This screen is displayed when installing from a CD. Enter the network name of the D.N.A. server you wish to use as your installation source. Be sure to select a server that contains the same version of D.N.A. you are installing and all the components you need to install.
Select Installation Method Choose Typical to install all the components installed on the server. Choose Custom to select specific components installed on the server. Custom Select Components This screen is displayed when you select Custom on the Select Installation Method page. Check the components you want to install in the list. This screen is displayed when running a Custom Installation. Select the language of your choice from the list. The Typical Installation automatically installs English, and local support if the Regional Settings of the PC are supported. Note: In EMG application the phone layout will still be displayed in English. A French version is available on the CD under the directory (\dna\locale\Emg\French\DEF\French). When installation has completed you can copy these files locally to directory (DNA_S\EMG\DEF).
Typical
Locale Support
75
D.N.A. Installation
Wizard Screens and Options OWS Level Selection Professional Basic Centrex Choose Destination Location
Explanation Choose Professional for fully configurable Operator Work Station interface and options. Choose Basic for no configurable options and no remote search capabilities. Select Centrex for a BSS (service provider) configuration.
Click Next > to accept the default folder for your installation, or click the Browse button to select another. Review a comprehensive summary of your installation choices. Click Next > to begin the installation process based on your choices. Click Back to change your selections before proceeding. Click Cancel to abort the installation. After the installation has finished, this screen displays a list of the D.N.A. components installed. It also displays any errors encountered during the installation. Choose Yes, I want to restart my computer now to restart your PC and complete the installation process. Choose No, I will restart my computer later to close the installation program and restart the PC later.
Summary Installations
Setup Complete
76
D.N.A. Installation
Reinstall
Repeats the latest installation to restore missing files and / or settings. Deletes all installed D.N.A. components. (You may also perform this task using Add/Remove Programs from the Windows Control Panel.)
Remove All
Silent Installation
You may now offer customers file-directed D.N.A. client installation assistance without being present at the installation site. This installation feature supports client New Installation, Re-installation, and Add Component options. Client Un-install is NOT supported. Note: Your users can run silent client setup from the D.N.A. Application Suite CD-ROM or from a local D.N.A. server. For the CD-ROM method, however, you must maintain an input file such as dnasuite.ini and use it as the input file for running the setup. The installation process gets system setup information from a .ini file created by the system administrator. The administrator provides approved installation parameters via a configuration (.ini) file. The client PC user can then initiate the installation. The installation will proceed automatically without further intervention.
ServerName=
LaunchEXE=ADO\MDAC_T You must include the '/Q' switch to run YP.EXE, /Q, /C:"setup ADO in quiet mode. /QNT",WAIT [OWS] Install=1 Level=Professional Set to 1 to install, 2 to not install* Level options are: Professional for fully configurable Operator Work Station interface and options; Basic for no configurable options and no remote
77
D.N.A. Installation
dnasuite.ini Statement
Set to 1 to install, 2 to not install* Set to 1 to install, 2 to not install* Set to 1 to install, 2 to not install* * You can only install components that have been installed on the connected D.N.A. Server.
Installation Procedure
At the client PC, the installer performs the following steps. 1. From the taskbar and click Start, Programs, Command Prompt. The Command Prompt window will be displayed. 2. To get command prompt help, type: command SETUP /? 3. At the client PC, use the following setup command to execute the file-driven installation (see details on SETUP command below). SETUP.EXE silent ini=full path of dnasuite.ini
SETUP.EXE silent ini=[full path You can only install components of dnasuite.ini] that have been installed on the connected D.N.A. Server. SETUP.EXE silent reinstall Parameter ini=filename.ini is not needed. The setup will process using the current installed .ini file settings. You can only install components that have been installed on the connected D.N.A. Server.
Re-install
Add Components
SETUP.EXE silent add ini=[full Setup will add components that path of dnasuite.ini] have been flagged Install=1 You can only add components that have been installed on the
78
D.N.A. Installation
PPM Lite
The basic D.N.A. Server client must be installed before you can install PPM Lite. This section explains installation requirements and procedures for Performance Presentation Manager Lite (PPM Lite). No installation steps are necessary for PPM Lite clients. Users simply point their browsers to a PPM server and enter their user ID and password. Warning: PPM Lite will not function properly without a session state. The Session Timeout feature for your PPM Lite website must not be disabled.
79
D.N.A. Installation
Note: Installing application files to Inetpub\wwwroot is not allowable, per Microsofts recommendation. 1. When the installation completes, choose Yes, I want to restart my computer now. The system will shutdown, restart, and the installation will be complete.
Installation Options
The PPM Lite installation provides Reinstall and Remove All options. Remove All can run from CD and Control Panel. Option Reinstall Explanation Allows you to repeat the last installation to restore missing or corrupted files. Deletes all installed PPM Lite components. (You may also perform this task using Add/Remove Programs from the Windows Control Panel.)
Remove All
Post Installation
Secure PPMLite Date/Time Format
The PPMLite date/time format is based on System Default Locale setting where PPMLite is installed. To secure the PPMLite date / time format, place PPMLite.dll in an MTS / COM+ package with a fixed user identity. Please follow the procedures below to setup PPMLite.dll as an MTS/COM+ package. 1. Log on the system where PPMLite is installed with the account that PPMLite.dll component will run under. 2. Configure the desired system default locale. Configure the locale for the user to be the same as the system default. Note: The locale for the system default and the local user must be the same. 3. Launch Component Services. Access Component Services via: Start4 Settings4 Control Panel4 Administrative Tools4 Component Services
80
D.N.A. Installation
4. Create a new COM+ application for PPMLite via the COM Application Install Wizard 5. Right-click on COM+ Application | select "New Application" to start the COM application install wizard | select "Create an empty application" | click Next >.
81
D.N.A. Installation
7. Select "This user" and enter the account name and password. PPMLite will use the system default locale settings for this particular account.
82
D.N.A. Installation
Note: If IIS 6.0 is used, select the User identity that PPMLitePool is running under. Refer to PPMLite Installed on IIS 6.0 for more information.
8. Click Finish. 9. Create a new component for PPMLite via COM Component Install Wizard. 10. Select the newly created COM+ Application "PPMLite" | Right-click the Component | Select New4Component to start the wizard | click Next >.
83
D.N.A. Installation
11. Select Import component(s) that are already registered and click Next >.
12. Select PPMLite.CRegAPI and PPMLite.WebReports as the components to import and click Next >.
84
D.N.A. Installation
85
D.N.A. Installation
In the Identity tab, select the second radio button (Configurable) and specify the custom user identity that was created earlier in step 1. Enter the assigned password and click OK. You will then be asked to reconfirm the password. Enter the password and click OK again. Verify that the application pool has been started by refreshing the IIS Manager view (i.e., click on the Action menu and then Refresh). A started application pool will have an icon with green arrows overlaid on top. A pool that has not been started will have a red x overlaid on top of the icon (possible cause could be that an incorrect password was entered). Please ensure it is running properly. 4. Assign PPMLite Virtual Directory to Application Pool In the IIS Manager under the PPMLite virtual directory, right-click and select Properties. Under the Virtual Directory tab, in the Application Settings section, select the PPMLitePool option from the Application Pool dropdown list. 5. Assign Anonymous Identity Virtual Directory Go to the Directory Security tab. Under the Authentication and access control section, click Edit. An Authentication Methods dialog will appear. Check the Enable anonymous access checkbox and enter the AastraWeb user created in step 1. Enter a valid password, and also ensure that the bottom checkboxes are unchecked.
Click OK until all dialog boxes have disappeared 6. Create COM+ Package for PPMLite.dll if not created yet. If created already, proceed to step 6. Note: Reference previous section, Ensure PPMLite Date/Time Format for information on how to setup PPMLite.dll as a COM+ package. In the Control Panel under Administrative Tools, open the Component Services MMC snap-in. In the left hand tree, open: Component Services4Computers4My Computers4COM+ Applications Right-click on COM+ Applications and select New Follow the Wizard instructions and click Create an Empty Application Enter a name such as PPMLite, and keep the 2nd radio button selected (Server Application). Click Next >. For the application identity, select the This User: option and enter the user account and password that was created earlier in step 1, into the edit boxes. Click Next >. In the Roles section, click the Add Role button. Enter a new role name, such as PPMLite Role. Click OK4Next >. Proceed to step 7 7. Add AastraWeb user to Role In the Control Panel under Administrative Tools, open the Component Services MMC snap-in. In the left hand tree, open: Component Services4Computers4My Computers4COM+ Applications4PPMLite4Role Right-click on Role and select New4Role >. Enter the role name, such as PPMLite Role, and click OK.
86
D.N.A. Installation
In the left hand tree, open: PPMLite Role4Users Right-click on Users and select New4User > Add the AastraWeb user to the PPMLite Role and click OK 8. Set modify/write directory permission for the AastraWeb user Set the root of your Windows drive to give modify/write access to the AastraWeb user. This is done in Windows Explorer by right clicking on the drive, selecting Properties, selecting the Security tab, then adding AastraWeb to the list with modify/write privileges. 9. Reset IIS Go to command prompt and execute iisreset to stop and restart IIS.
87
D.N.A. Installation
Go to the Directory Security tab. Under the Authentication and access control section, click Edit. An Authentication Methods dialog will appear. Check the Enable anonymous access checkbox and enter the AastraWeb user created in step 1. Enter a valid password, and also ensure that the bottom checkboxes are unchecked.
Click OK until all dialog boxes have disappeared 6. Create COM+ Package for PPMLite.dll if not created yet. If created already, proceed to step 7. Note: Reference previous section, Ensure PPMLite Date/Time Format for information on how to setup PPMLite.dll as a COM+ package. In the Control Panel under Administrative Tools, open the Component Services MMC snap-in. In the left hand tree, open: Component Services4Computers4My Computers4COM+ Applications Right-click on COM+ Applications and select New Follow the Wizard instructions and click Create an Empty Application Enter a name such as PPMLite, and keep the 2nd radio button selected (Server Application). Click Next >. For the application identity, select the This User: option and enter the user account and password that was created earlier in step 1, into the edit boxes. Click Next >. In the Roles section, click the Add Role button. Enter a new role name, such as PPMLite Role. Click OK4Next >. Proceed to step 7 7. Add the domain user created in step 1 to Role In the Control Panel under Administrative Tools, open the Component Services MMC snap-in. In the left hand tree, open: Component Services4Computers4My Computers4COM+ Applications4PPMLite4Role Right-click on Role and select New4Role >. Enter the role name, such as PPMLite Role, and click OK. In the left hand tree, open: PPMLite Role4Users Right-click on Users and select New4User > Add the domain user crated in step 1 to the PPMLite Role and click OK 8. Set modify/write directory permission for the domain user. Set the root of your Windows drive to give modify/write access to the domain user created in step 1. This is done in Windows Explorer by rightclicking on the drive, selecting Properties, selecting the Security tab, and then adding the domain user created in step 1 to the list with modify/write privileges. 9. Reset IIS Go to command prompt and execute iisreset to stop and restart IIS.
88
D.N.A. Installation
Note: If for any reason a domain account cannot be used, please reference MSDN article 176380, How To Use ASP with a SQL Trusted Connection with Guest Account: http://support.microsoft.com/kb/176380/EN-US/
Prerequisites
The following are the requirements for Aastra Communication Assistant.
Call Controls
For the Call Handling license, Application Link 4 must be installed for BC 10, BC 11, and BC12. You must also install the CSTA32.dll version 4 on the ACA server. For best viewing, the PC Display settings should be set to 32K colors or higher. For ACA call handling setup procedures, IIS users should have Administrative privileges.
89
D.N.A. Installation
Select Chinese (PRC) for standards and formats and China for Location. Click the Advanced tab and go to step 4. If these options are unavailable, click the Languages tab to install the language files (see step 3).
90
D.N.A. Installation
Select Install files for East Asian languages and click OK to install the language files. Have the Windows installation CD available for file copy. Click the Advanced tab after files are installed.
91
D.N.A. Installation
Select Chinese (PRC) for Language for non-Unicode programs, check the Apply all settings to the current user account and to the default user profile checkbox, and then click OK.
92
D.N.A. Installation
Windows Server 2003 1. Start4Settings4Control Panel4Regional and Language Options to open the Regional and Language Options dialog.
93
D.N.A. Installation
2. Select Chinese (PRC) for standards and formats and China for Location. Click the Advanced tab and go to step 4. If these options are unavailable, click the Languages tab to install the language files (see step 3).
94
D.N.A. Installation
3. Select Install files for East Asian languages and click OK to install the language files. Have the Windows installation CD available for file copy. Click the Advanced tab after files are installed.
95
D.N.A. Installation
4. Select Chinese (PRC) for Language for non-Unicode programs, check the Apply all settings to the current user account and to the default user profile checkbox, and then click OK.
96
D.N.A. Installation
97
D.N.A. Installation
Install PPM Lite Install Mobile Executive Install ACC Server View Technical Guide View Release Notes Exit Select Install Aastra Communication Assistant to install from the Auto-Run interface.
Installation Procedure
Important! If you're using a virus-protection utility, disable it before you run the D.N.A. Setup program. In addition, close the control panel and any open Windows applications.
Virtual Machine
Aastra Communication Assistant requires the Java Virtual Machine software on your computer. You can download it from http://java.com.
Installation Options
The Aastra Communication Assistant installation provides Reinstall and Remove All options. Remove All can run from CD and Control Panel. Option Reinstall Explanation Allows you to repeat the last installation to restore missing or corrupted files. Deletes all installed Aastra Communication Assistant components. (You may also perform this task using Add/Remove Programs from the Windows Control Panel.)
Remove All
98
D.N.A. Installation
99
D.N.A. Installation
In the Performance tab, un-check "Shutdown worker process after being idle for 20 minutes and check Enable CPU monitoring (to Max). For CPU use 100, and refresh CPU usage in 5 minutes increments. In the Identity tab, select the second radio button (Configurable) and specify the custom user identity that was created earlier in step 1. Enter the assigned password and click OK. You will then be asked to reconfirm the password. Enter the password and click OK again. Verify that the application pool has been started by refreshing the IIS Manager view (i.e., click on the Action menu and then Refresh). A started application pool will have an icon with green arrows overlaid on top. A pool that has not been started will have a red x overlaid on top of the icon (possible cause could be that an incorrect password was entered). Please ensure it is running properly. 4. Assign Ericom Virtual Directory to Application Pool In the IIS Manager under the Ericom virtual directory, right-click and select Properties. Under the Virtual Directory tab, in the Application Settings section, select the ACAPool option from the Application Pool dropdown list. 5. Assign Anonymous Identity Virtual Directory Go to the Directory Security tab. Under the Authentication and access control section, click Edit. An Authentication Methods dialog will appear. Check the Enable anonymous access checkbox and enter the AastraWeb user created in step 1. Enter a valid password, and also ensure that the bottom checkboxes are unchecked. Click OK until all dialog boxes have disappeared
6. Reset IIS Go to command prompt and execute iisreset to stop and restart IIS. Note: If for any reason a domain account cannot be used, please reference MSDN article 176380, How To Use ASP with a SQL Trusted Connection with Guest Account: http://support.microsoft.com/kb/176380/EN-US/
100
D.N.A. Installation
In the Performance tab, un-check "Shutdown worker process after being idle for 20 minutes and check Enable CPU monitoring (to Max). For CPU use 100, and refresh CPU usage in 5 minutes increments. In the Identity tab, select the second radio button (Configurable) and specify the domain user account that was created earlier in step 1. Enter the assigned password and click OK. You will then be asked to reconfirm the password. Enter the password and click OK again. Verify that the application pool has been started by refreshing the IIS Manager view (i.e., click on the Action menu and then Refresh). A started application pool will have an icon with green arrows overlaid on top. A pool that has not been started will have a red x overlaid on top of the icon (possible cause could be that an incorrect password was entered). Please ensure it is running properly. 4. Assign Ericom Virtual Directory to Application Pool In the IIS Manager under the Ericom virtual directory, right-click and select Properties. Under the Virtual Directory tab, in the Application Settings section, select the ACAPool option from the Application Pool dropdown list. 5. Assign Anonymous Identity Virtual Directory Go to the Directory Security tab. Under the Authentication and access control section, click Edit. An Authentication Methods dialog will appear. Check the Enable anonymous access checkbox and enter the AastraWeb user created in step 1. Enter a valid password, and also ensure that the bottom checkboxes are unchecked.
Click OK until all dialog boxes have disappeared 6. Reset IIS Go to command prompt and execute iisreset to stop and restart IIS. Note: If for any reason a domain account cannot be used, please reference MSDN article 176380, How To Use ASP with a SQL Trusted Connection with Guest Account: http://support.microsoft.com/kb/176380/EN-US/
Mobile Executive
The basic D.N.A. Server client must be installed before you can install Mobile Executive. This section explains installation requirements and procedures for Mobile Executive. Mobile Executive is installed on an Internet server. Even though the Internet server and the D.N.A. server can be on the same machines, we recommend they be on separate machines for better performance. In addition, Internet servers are periodically taken down for maintenance. Warning: Mobile Executive will not function properly without a session state. The Session Timeout feature for your Mobile Executive website must not be disabled.
101
D.N.A. Installation
Install Lotus Notes Integration 4.6 Install Lotus Notes Integration 5.0 Install Lotus Notes Integration 6.0 Install PPM Lite Install Mobile Executive Install ACC Server View Technical Guide View Release Notes Exit Select Install Mobile Executive to install from the Auto-Run interface. Important! If youre using a virus-protection utility, disable it before you run the D.N.A. Setup program. Also, close the control panel and any open Windows applications.
Installation Options
The Mobile Executive installation provides Reinstall and Remove All options. Remove All can run from CD and Control Panel. Option Reinstall Explanation Allows you to repeat the last installation to restore missing or corrupted files. Deletes all installed Mobile Executive components. (You may also perform this task using Add/Remove Programs from the Windows Control Panel.)
Remove All
102
D.N.A. Installation
You will get a warning message to inform you that the application files will be moved to a new location instead of \Inetpub\wwwroot and you will be prompted to choose a desired destination. This change is subject to the recommendation of the latest version of Microsoft IIS.
103
D.N.A. Installation
6. Reset IIS Go to command prompt and execute iisreset to stop and restart IIS.
Click OK until all dialog boxes have disappeared 6. Reset IIS Go to command prompt and execute iisreset to stop and restart IIS.
104
D.N.A. Installation
Note: If for any reason a domain account cannot be used, please reference MSDN article 176380, How To Use ASP with a SQL Trusted Connection with Guest Account: http://support.microsoft.com/kb/176380/EN-US/
Outlook Integration
The D.N.A. Outlook Integration (DOI) provides a bi-directional Integration between the Microsoft Office Outlook Calendar and D.N.A. Directory Calendar. This allows D.N.A. Directory Subscribers using Outlook's Calendar to synchronize the message diversion information with other D.N.A. applications through the D.N.A. Remote Data Server (RDS). Several pre-installation tasks must be completed before installing and running Outlook Integration. Usually these tasks are completed after D.N.A. server installation. 1. Before Installation, Microsoft Outlook 2000 or greater must be installed on the system. If Outlook is not installed, the installation process will report an error. Outlook Integration does not need the exchange server. 2. Use the MD110 Support utility to synchronize Operator Message Diversion for All applications on the D.N.A. server. 11. Use the RDS Configuration utility to set Default Diversion Duration and Default Diversion Stop Time for all Message Diversion Reason Codes on the D.N.A. server. 12. Use the RDS Configuration utility to configure a GICI/CSTA Port. 13. Use the Directory Configuration Utility to add a Person UDF of type Computer to the database. 14. Use Directory Manager to add the Outlook computer name information to D.N.A. Directory. Outlook Integration needs to be installed on both client and server machines.
105
D.N.A. Installation
When the synchronization interval occurs, DOI will determine whether the calendar entry was created via DOI or not, based on the message diversion reason code from the Subject field (default) or Body Text (determined by Registry setting). Refer to Registry Values for Message Diversion Synchronization for details. The message diversions from the D.N.A. server are called "Message Diversion from DNA Server." DOI will not go through these message diversions, since they are already in the D.N.A. server database. DOI then sends the message diversions to the RDS (D.N.A. server process), which in turn adds or removes them from the D.N.A. server database. The process "dnamsgdv.exe" is always assigned low priority (to avoid flickering, etc.), when starting the DOI, or at synch interval.
SynchInterval. This Registry key value is used to define the data synchronization period. The DOI will poll the new changes made from Outlook and send to D.N.A. Server based on SynchInterval. By default the value is set to 120 seconds (=78 Hex value). Message Diversions from D.N.A. server are sent instantly to the DOI client and are not affected by the SynchInterval value. DiversionDays. This Registry key value is used to define the number of days future message diversion information is displayed. Outlook will retrieve this setting whenever data synchronization occurs. By default the value is set to 15 days. If the value is > 31 days, it will be treated as 31 days. If value is < 3 days, it will be treated as 3 days. The number of days includes the current day (e.g., 15 days means today plus the next 14 days). Also: GetDivCodeFromSubject. This Registry value is used to get the message diversion reason code from the Subject field if set to 1 (default); otherwise message diversion reason code is retrieved from Body Text. Regardless of Registry settings, the message diversion reason code must be at the beginning of the Subject or Body Text field. By using Body Text field, the Subject can be used for more meaningful information about the appointment. However, the performance will be better if Subject field is used. Prior to D.N.A. 5.2, the GetDivCodeFromSubject is set to 0 by default, which means that the message diversion reason code is retrieved from Body Text. Starting from DOI 5.2, the GetDivCodeFromSubject is set to 1 and reason code is retrieved from Subject field by default. For existing users, this setting remains the same after upgrade to 5.6.
106
D.N.A. Installation
This value is set to 0 by default, which requires you to link a computer name (UDF type Computer) with a DMG subscriber. Setting this value to 1 changes Outlook Integration from using the PC name as the identity reference, to using the Windows user login name as the identity for Outlook calendar diversion settings. The advantage of using the Windows user login name is that it allows you to use a Person UDF of type User ID instead of type Computer. This makes Outlook Integration more flexible and easier to manage. After changing this Registry key, stop and restart the D.N.A. RDS service. It may take a few minutes for RDS to repopulate the local database. You can then use the Directory Configuration utility to add a UDF of type User ID, and then Directory Manager to add the Outlook user ID information to the D.N.A. Directory.
107
D.N.A. Installation
2. Extract the files by double clicking Admpack.exe. This package consists of the following 4 files: OutlookSecurity.oft, an Outlook template that enables you to customize the security settings on the Microsoft Exchange server. Hashctl.dll, the file for the Trusted Code control, a tool used by the template to specify trusted COM add-ins. Comdlg32.ocx, control that provides a user interface for selecting the trusted COM add-in. Readme.doc, a document that provides information on the values and settings available in the template and describes how to deploy the new settings on Exchange Server. 3. Install and Register Trusted Code controls: Copy Hashctl.dll and Comdlg32.ocx extracted from Security Feature Administrative Package to <windir>\system32 on Administrative system. Register files: Start DOS command prompt Enter regsvr32 hashctl.dll and hit Enter Enter regsvr32 Comdlg32.ocx and hit Enter Exchange Server 2000 1. Download Outlook 2000 SR-1a Security Update Administrative (Admpack.exe) from http://www.microsoft.com/office/ork/2000/appndx/toolbox.htm#secupd 2. Extract the files by double clicking Admpack.exe. This package consists of the following 3 files: OutlookSecurity.oft, a template used for creating security settings. outlk9.adm, an Auto Distribution Manager (ADM) updated system policy. Readme.txt, a document that provides information on the values and settings available in the template and describes how to deploy the new settings on Exchange Server.
108
D.N.A. Installation
1. Click Start 4 Programs 4 Microsoft Exchange 4 System Manager to open the Exchange System Manager dialog.
109
D.N.A. Installation
2. Open Folders, then right-click Public Folders and select New 4 Public Folder. Create a new folder by entering Outlook Security Settings in the Name field, then click Apply, followed by the OK button in Properties dialog.
110
D.N.A. Installation
3. Configure the newly created Outlook Security Settings public folder by right-clicking it. Select Properties to open the Outlook Security Settings Properties dialog.
111
D.N.A. Installation
112
D.N.A. Installation
5. Define who can access the Outlook Security Setting public folder by selecting Default name, and then change the Roles from Author to Reviewer (in the Roles drop-down list). Click OK to save and close the dialog.
113
D.N.A. Installation
1. Click OutlookSecurity.oft extracted from Security Feature Administrative Package to open the Select Folder dialog.
2. Select Outlook Security Settings folder that created on the Exchange Server. Click OK button to open the template in Compose mode.
114
D.N.A. Installation
3. From the menu bar, select Tools 4 Forms4 Publish Form As to open the Publish Form As dialog.
4. From the Look In drop-down list, select Outlook Folders and click the Browse to open the Go to Folder dialog. Select Outlook Security Settings from Public Folder and click OK.
115
D.N.A. Installation
5. Enter Outlook Security Form in the Display Name field, and the Form Name field will be filled in with Outlook Security Form automatically. Click Publish to publish the security template in the Security Settings folder and return to the Default Security Settings Description window.
116
D.N.A. Installation
6. Select File from the menu bar, and then click Close to close the template.
117
D.N.A. Installation
1. To check or change Cached Exchange Mode: Navigate to Tools 4 E-mail Accounts Ensure that the radio button next to View or change existing e-mail accounts is selected, then click Next >. Highlight your Exchange server account and then click Change. Uncheck Use Cached Exchange Mode to turn it off (i.e., disable the feature). Logon to the Exchange administrator account. 2. Expand Public Folders 4 All Public Folders and select the Outlook Security Settings folder.
3. Click the down-arrow key next to the New button on the tool bar, and then click Choose Form
118
D.N.A. Installation
4. Select Outlook Folders from the Look In drop-down box, and then click the Browse button.
5. Select Outlook Security Settings from All Public Folders and then click OK.
119
D.N.A. Installation
6. Verify that the Display name: field shows Outlook Security Form in the Choose Form dialog and click Open.
7. Create either a default security setting or custom settings for a specific set of users: Select Default Security Settings for All Users to allow all Outlook users to use this security form. -orSelect Security Settings for Exception Group and enter the name in the Security Group Name field. Also type the name of each user requiring the custom security settings in the Members box. The names entered must be separated with a semi-colon (;).
120
D.N.A. Installation
8. Specify settings as follows: Automatically approve When executing a custom action via Outlook object model Automatically approve When accessing the ItemProperty of a control on an Outlook custom form
121
D.N.A. Installation
9. Open the Programmatic Settings tab and specify the settings as follows: Automatically approve When sending terms via Outlook object model Automatically approve When accessing the address book via Outlook object model Automatically approve When accessing address information via Outlook object model Automatically approve When responding to meeting and task requests via Outlook object model Automatically approve When executing Save As via Outlook object model
122
D.N.A. Installation
10. Save the Security Settings by selecting File from the menu bar, then clicking Save. Administrator may or may not be prompted to enter the Password for credentials depending on the Windows version used.
11. Close the Custom Security Setting dialog by selecting File from the menu bar, then clicking Close.
with DWORD type, and value = 1 For D.N.A. 5.6 systems with DOI installed, please re-install the D.N.A. Outlook Integration installation distributed with D.N.A. 5.2 SP1 or later, to setup this Registry key.
123
D.N.A. Installation
124
D.N.A. Installation
Sub template (support Notes 4.6, 5.0, and 6.0) For customers who have their own customized Mail form or prefer to use standard mail form, sub template should be used to link with the standard or customized Mail form. D.N.A. provided modified Mail template (support Notes 4.6 and 5.0) For customers who have no preference of the form used, the modified Mail template provided by D.N.A. can be used.
In Filename text field, enter mail46.ntf or your customized template file name and click the Open button. 3. Open DNI template From the menu bar, choose File4Database4Open to open the Open Database dialog box.
In Filename text field, enter dni46sub.ntf or your customized template file name and click the Open button. 4. Link form: From the DNA Template English v4.6 window, double-click the DNA Template icon in the left frame. Click Design to list the Design pane. Click Forms to list the forms in database. From the Forms list pane (right frame), select the AbsenceCode form and choose Edit4Copy from the menu bar. From Mail (R4.6) or your customized template window, double-click on Mail (R4.6) or your customized template icon in the left frame. Click Design to list the Design pane. Click Forms to list the forms in database.
From the menu bar, choose Edit4Paste. 5. Link view: From the DNA Template English v4.6 window, click Views in the Design pane (left frame). From the Views list pane (right frame), select (DiversionCode) view and choose Edit4Copy from the menu bar. From Mail (R4.6) or your customized template window, click Views to list the views in database.
From the menu bar, choose Edit4Paste. 6. Link sub-form: From DNA Template English v4.6 window, click Subforms in the Design pane (left frame).
125
D.N.A. Installation
From the Sub-forms list pane (right frame), select the AastraDNI sub-form and choose Edit4Copy from the menu bar. From Mail (R4.6) or your customized template window, click Subforms to list the subforms in database.
From the menu bar, choose Edit4Paste. 7. Insert DNI sub-form to Calendar form: From Mail (R4.6) or your customized template window, double-click Calendar Entry form in the Forms list pane (right frame). Click the spot in the Calendar Entry form that you want the sub-form to be inserted to. From the menu bar, choose Create4Insert Subform to bring up the Insert Sub-form dialog.
Select Aastra DNI from the Insert Sub-form list box and click the OK button to insert the selected sub-form to the Calendar Entry form. 8. The updated mail template will take effect from the next day automatically. Use D.N.A. Provided Mail Template 1. Start up Lotus Notes 2. Inherit the mail database design for each individual user from DNI template From menu bar, choose File4Database4Open to open the Open Database dialog box. Select the clients mail template (e.g., psmith.nsf for Peter Smith) and click the Open
Click the Design icon to go to the Design page. Check the Inherit design from template and change the Template name text field to DNI template name (e.g., "dni46(s)" for English version). 3. Repeat step 2 for all other users 4. The new template will take effect from the next day automatically.
126
D.N.A. Installation
3. Open standard or customized Mail template From menu bar, choose File4Database4Open to open the Open Database dialog box. Select the server (Server Name/Certifier, e.g., bt-inv1247/domino50) in the Server combo-box.
Select Mail [R5.0] or your customized database in Database list box. Click the Open button. 4. Open DNI template From menu bar, choose File4Database4Open to open the Open Database dialog box. Select the server (Server Name/Certifier, e.g., bt-inv1247/domino50) in the Server combo-box.
Select DNA Template English v5.0 in the Database list box. Click the Open button. 5. Link form: Select DNA Template English v5.0 database from the Design pane (left frame). Click Forms to list the forms in database. From the Form list Work pane (right frame), right-click on the AbsenceCode form and select Copy. Select Mail [R5.0] database or your customized database from the Design pane (left frame). Click Forms to list the forms in database.
Right-click the Form list Work pane (right frame) and select Paste. 6. Link view: Select DNA Template English v5.0 database from the Design pane (left frame). Click Views to list the views in database. From the View list Work pane (right frame), right-click [AastraDiversionCode] view and select Copy.
Select Mail [R5.0] database or your customized database from the Design pane (left frame); click Views to list the views in database. Right-click the View list Work pane (right frame) and select Paste. 7. Link sub-form: Select DNA Template English v5.0 database from the Design pane (left frame). Click Resources and then click Subforms to list the sub-forms in database. From the Subform list Work pane (right frame), right-click AastraDNI sub-form and select Copy.
Select Mail [R5.0] database or your customized database from the Design pane (left frame). Click Resources and then click Subforms to list the sub-forms in database. Right-click the Sub-form list Work pane (right frame) and select Paste. 8. Insert DNI sub-form to Calendar form: Select Mail [R5.0] database or your customized database from the Design pane (left frame) and click Forms to list the forms in database. From the Form list Work pane (right frame), double click on the Calendar Entry form to bring up the Calendar Entry form. Click the spot in the Calendar Entry form that you want the sub-form to be inserted to. From the menu bar, choose Create4Insert Subform to bring up the Insert Sub-form dialog box.
Select Aastra DNI from the Insert Sub-form list box and click the OK button to insert the selected sub-form to the Calendar Entry form. 9. The updated mail template will take effect from the next day automatically.
127
D.N.A. Installation
Use D.N.A. Provided Mail Template 1. Start up Lotus Notes 2. Copy DNA template file from local to server From menu bar, choose File4Database4Open to open the Open Database dialog box. Select Local in the Server combo-box. Click Browse button to select dni50s.ntf template file. Click Open. From menu bar, choose File4Database4New Copy to open the Copy Database dialog box.
Select the server (Server Name/Certifier, e.g., bt-inv1247/domino50) in Server combobox and click the OK button. 3. Inherit the mail database design for each individual user from DNI template From menu bar, choose File4Database4Open to open the Open Database dialog box. Select the server (Server Name/Certifier, e.g., bt-inv1247/domino50) in the Server combo-box. Select the clients mail template (e.g., jsmith.nsf for John Smith).
Click the Design icon to go to the Design page. Check Inherit design from template and change the Template name text field to DNI template name (e.g., DNI English v5.0 for English version). 4. Repeat step 3 for all other users 5. The new template will take effect from the next day automatically.
Select the server (Server Name/Certifier, e.g., bt-inv1247/domino60) in the Server combo-box and click the OK button. 3. Open standard or customized Mail template From menu bar, choose File4Database4Open to open the Open Database dialog box. Select the server (Server Name/Certifier, e.g., bt-inv1247/domino60) in the Server combo-box.
Select Mail [R6] or your customized database in Database list box. Click the Open button. 4. Open DNI template From menu bar, choose File4Database4Open to open the Open Database dialog box.
128
D.N.A. Installation
Select the server (Server Name/Certifier, e.g., bt-inv1247/domino60) in the Server combo-box.
Select the DNA Template English v6.0 in Database list box. Click the Open button. 5. Link form: Select the DNA Template English v6.0 database from the Design pane (left frame). Click Forms to list the forms in database. From the Form list Work pane (right frame), right-click the AbsenceCode form and select Copy. Select Mail [R6] database or your customized database from the Design pane (left frame). Click Forms to list the forms in database.
Right-click the Form list Work pane (right frame) and select Paste. 6. Link view Select the DNA Template English v6.0 database from the Design pane (left frame). Click Views to list the views in database. From the View list Work pane (right frame), right-click on [AastraDiversionCode] view and select Copy.
Select the Mail [R6] database or your customized database from the Design pane (left frame); click Views to list the views in database. Right-click the View list Work pane (right frame) and select Paste. 7. Link sub-form: Select DNA Template English v6.0 database from the Design pane (left frame). Click Shared Code and then click Subforms to list the sub-forms in database. From the Subform list Work pane (right frame), right-click on the AastraDNI sub-form and select Copy.
Select the Mail [R6] database or your customized database from the Design pane (left frame). Click Shared Code and then click Subforms to list the sub-forms in database. Right-click the Sub-form list Work pane (right frame) and select Paste. 8. Insert DNI sub-form to Calendar form: Select Mail [R6] database or your customized database from the Design pane (left frame) and click Forms to list the forms in database. From the Form list Work pane (right frame), double click on the Calendar Entry form to bring up the Calendar Entry form. Click the spot in the Calendar Entry form where you want the sub-form to be inserted. From the menu bar, choose Create4Resource4Insert Subform to bring up the Insert Subform dialog.
Select Aastra DNI from the Insert Subform list box and click the OK button to insert the selected sub-form to the Calendar Entry form. 9. The updated mail template will take effect from the next day automatically.
129
D.N.A. Installation
2. Choose installation option Lotus Notes Client Installation and the desired language to install D.N.A. Integration software on a Lotus Notes client machine into the \\\Notes directory.
Registry location
Notes 4.6 - HKLM\SOFTWARE\Ericsson\Integration\Lotus\ Notes 5.0 - HKLM\SOFTWARE\Ericsson\Integration\Lotus50\ Notes 6.0 - HKLM\SOFTWARE\Ericsson\Integration\Lotus60\ SynchInterval. This Registry key value is used to define the data synchronization period. The DNI will poll the new changes made from Lotus Notes and send to D.N.A. Server based on SynchInterval. By default the value is set to 120 seconds (=78 Hex value). Message Diversions from D.N.A. server are sent instantly to the DNI client and are not affected by the SynchInterval value. DiversionDays. This Registry key value is used to define the number of days future message diversion information is displayed. LNI will retrieve this setting whenever data synchronization occurs. By default the value is set to 3 days. If the value is > 31 days, it will be treated as 31 days. If value is < 3 days, it will be treated as 3 days. The number of days includes the current day (e.g., 3 days means today plus the next two days).
3. Stop and restart the D.N.A. RDS service. 4. Run the Directory Configuration utility to add a non-shareable UDF of type USER ID. 5. Run Directory Manager and add the Windows user ID information to the D.N.A. Directory.
130
D.N.A. Installation
Help
After installation to a Lotus Notes Client Machine, the D.N.A. Lotus Notes Integration User Help can be accessed using the Start menu from the same program group as D.N.A. Integration. For example: Programs4Lotus Notes4D.N.A. Integration Help
Successful Configuration
After D.N.A. is successfully installed, these settings can be changed to any desired configuration.
131
D.N.A. Installation
To change settings, go to the Control Panel and select Regional and Language Options. Click the Languages tab and go to Details in the Text Services and Input Languages window.
Unsuccessful Configuration
This is not an exhaustive list of unsuccessful configurations. 1. When more than one keyboard layout is installed:
132
D.N.A. Installation
133
D.N.A. Installation
Add component (DMG, EMG, OWS, or PMG) to the existing D.N.A. server or client. You must reapply the service pack even it has been installed before. Add new D.N.A. client Re-install D.N.A. server or client from CD or Control Panel Re-install ACA, DME, or PPMLite from CD or Control Panel Add ACA, DME, or PPMLite to an existing D.N.A. system regardless of whether the service pack has been applied previously. D.N.A. service packs may contain fixes for ACA, DME, and PPMLite, However, these applications come with a separate installation package on the media kit. There are two ways to upgrade them to the latest service pack after they are installed. The first method is preferred. 1. Apply serviced pack only once - Install D.N.A. server or client - Install ACA, DME, or PPMLite - Install D.N.A. service pack 2. Apply service pack twice - Install D.N.A. server or client - Install D.N.A. service pack - Install ACA, DME, or PPMLite - Install D.N.A. service pack again to apply ACA, DME, or PPMLite fixes
134
Server Installation
The server installation is installed on the IIS server machine. It can be installed from CD-ROM or from the network. Warning: An administrator privilege is required for Server installation.
Installation Wizard
A step-by-step wizard guide is provided to help the user to go through the installation procedures. This wizard will prompt all necessary questions with default values and capture all information and the installation can then be run without an attendant.
Pre-requisites
Existence of D.N.A. Server Component
The D.N.A. Server Component is an essential component for the ACC application. This means if the D.N.A. Applications Suite server version shares the same system with IIS Server, the D.N.A. Server Component must be installed first. If D.N.A. Application Suite and IIS Server are on different systems, then the D.N.A. Server Component client version must be installed on the IIS Server first. The ACC Server installation will check the existence of D.N.A. Server Component. An error message is displayed and installation is then aborted if D.N.A. Server Component does not exist. Note: ACC requires the SYSTEM user account to set or change Personal Number. For further information, refer to Configuration for Personal Number access in the Configuration section.
Existence of IIS
The ACC Server installation will check the existence of IIS 5.0 or later. An error message is displayed and installation is then aborted if IIS 5.0 or later does not exist.
135
ACC Installation
Installation Options
There are various installation options supported and the available installation options are detected automatically based on first time installation or if the ACC has been installed before.
New Installation
The installation program performs as a first time installation if ACC was not previously installed.
Reinstallation
This option is available if the current product version of ACC installation is detected. All necessary information is retrieved from the Registry or other sources and no question is asked. The installation program reinstalls the product and updates the system configurations accordingly. During the reinstallation process, the Ecc.cfg will not be updated in order to preserve the locale specific settings that are changed by the System Administrator. Warning: Due to a limitation with InstallShield, if the installation files are stored on a network drive, the user must map the network drive to a local drive prior to invoking the Reinstallation process. Note: If you are reinstalling and your current version is D.N.A. 5.1 or prior, there is a new Registry value that must be configured. It is contained in the configuration file ACC_Update.cfg. Please ensure that the access code for Diversion Bypass is correct (i.e., replace the value 1 with the Diversion Bypass code for your market).
Uninstall
This option is available if a current version of ACC is detected. The user is prompted for confirmation of un-installation. All the installed components (including application files, Registry keys, Registry values, etc.) are removed when confirmation has been given.
Registration Information
For the first time installation (new installation), the User Name and Company Name are prompted and information is stored in the Registry.
Virtual Directory
The installation program will detect the D.N.A. application suite location and create two virtual directories ACC and a virtual directory associated with a sitename. The number of virtual directories depends on the Number of Sites configured. All files including ASP pages, locales, the client web-installation program, and the installation configuration file are installed in the selected directory. The target directory is stored in the Registry.
ApplicationLink Configuration
The installation program will prompt the user for the ApplicationLink server name and port number (defaults to 2555) for each of the defined PBX nodes. This dialog box will also be displayed during reinstallation if there are not any nodes defined for ApplicationLink configuration. The collected information is stored in the ecc.cfg configuration file for client installation to use.
136
ACC Installation
Note: If you need to rename or add/remove ApplicationLink servers later, reinstall ACC Server. This will update the ApplicationLink configuration information in the ecc.cfg configuration file on the server, and the clients will automatically retrieve this updated information the next time ACC is run.
Number of Sites
This dialog has been added to ACC server 1.4 to support ACC multisite installation.The installation program will prompt the user for the Number of Sites to be configured during the ACC server installation.
Site Configuration
This dialog has been added to ACC server 1.4 to support ACC multisite installation. The installation program will prompt the user for Site configuration information including Site Name (defaults to one site), AutoGKDiscovery ON/OFF, Gatekeeper Address, Backup Gatekeeper Address and Key Stroke Delay for each of the site. The Key Stroke Delay defaults to 180. If AutoGKDiscovery is set to ON, the Gatekeeper Address and Backup Gatekeeper Address options are disabled. The information provided for each site in this dialog is stored in the Ecc.cfg file of that site specific folder and will be loaded to the ACC client system during the ACC client installation.
Summary Information
For a first time installation (new installation), all the user options and selections are listed for verification before copying the files and setting up the systems. The user can change the selections if desired. The installation runs without attendant after this point.
Configurations
Registry Setting
The application key \ECC is created under
HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson. All the sub-keys or Registry values
associated with ACC must be under the \ECC key. No Registry values are allowed under the Ericsson key directly. The same rules also apply to the other Registry hives. The following standard Registry values are created under
HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson\ECC\CurrentVersion:
InstallDateServer the date that installation is performed CompanyName UserName ProductNameServer the official complete product name ProductVersion the product version number TargetDirectoryServer the target directory where application files are stored NumberOfSites Number of Sites configured. The following registry values are created under HKEY_LOCAL_MACHINE\Software\Ericsson \ECC:
137
ACC Installation
ECC_Site1,ECC_Site2 ... ECC_Siten where n is the number of sites configured and each registry value will have the name of a site.
Client Configurations
ECCClient.ini The ACC Server Name is stored in ECCClient.ini. Each site specific folder has its sitename stored in the ECCClient.ini file. This file is included in the ACC Client installation CAB file by repacking the CAB file during ACC server installation run time. This is to prevent the ACC client installation from querying the user for the info. Ecc.cfg Some of the features in ACC require the configuration of market dependent parameters. These should be updated in the installation configuration file Ecc.cfg, to match the specific installations configuration. Be sure to only change the access code digits, and not any of the other format characters. The Ecc.cfg file will, by default, be found in the virtual directory Sitename, located in the default website location (\dna_s\ or \dna_c\). The options configured in Ecc.cfg will be set at each ACC client installation in the ACC client machines Windows Registry. Note that when the ACC server is re-installed, the installation program will overwrite the existing ECC.cfg so that the changes made by the ACC administrator will not be preserved. The ACC multisite installation allows us to configure the values of AutoGKDiscovery, Gatekeeper, Gatekeeper_Backup, and Key Stroke Delay for each site.The values configured for each site are stored in the ECC.cfg file of that site specific folder.
The values that must be configured include: AudioCodec=729 Replace the digits 729 with the appropriate selection as follows. The options are: 711: G.711 Codec 7231: G.723 Codec 729: G.729 Codec 729ab: G.729a or G.729 Codec AutoGKDiscovery = 0 Set to 1 to enable or 0 to disable the Automatic Gatekeeper Discovery option AutoGKDiscovery_Backup=0 Set to 1 to enable or 0 to disable the Automatic Gatekeeper Discovery option for the backup gatekeeper BypassDiversionFmt=*1*%s# Replace the digit 1 with the appropriate market code for the dialling procedure to bypass diversion CallGroupPickUpFmt=xx Replace the xx with the Call Group pickup access code that is set in the PBX. Once this value is updated, the new value will be set at each ACC client installation in the ACC client machines Windows Registry.
138
ACC Installation
CancelAllCallbackFmt=#6# Replace the digit 6 with the appropriate market code for the dialling procedure to cancel all callbacks CancelIndCallbackFmt=#6*%s# Replace the digit 6 with the appropriate market code for the dialing procedure to cancel individual callbacks CancelManualMsgWaitingFmt=#31# Replace the digits 31 with the appropriate market code for the dialling procedure to cancel Manual Message Waiting DNAIIS=BT-PCA This entry indicates the name of the D.N.A. IIS Server, and will be set automatically by installation. DNAServerName=BT-PCA This entry indicates the name of the D.N.A. Server, and will be set automatically by installation. Gatekeeper = 138.85.0.0 Set to the IP address of the PBX gatekeeper Gatekeeper_Backup=138.85.0.0 If the clients will use a backup gatekeeper, set to the IP address of the backup gatekeeper GatekeeperID=LIM1 If your installation is using Automatic Gatekeeper Discovery, replace LIM1 with the identifier for the PBX Gatekeeper to which the client will connect GatekeeperID_Backup=LIM2 If the clients will use a backup gatekeeper, and use Automatic Gatekeeper Discovery to connect to the backup gatekeeper, replace LIM2 with the identifier for the backup gatekeeper to which the client will connect. GatekeeperPollFlag=0 Set to 1 to enable polling of the gatekeeper or 0 to disable (Refer to the ACC Users Guide for more information on gatekeeper polling) GatekeeperPollRate=60 Set to the frequency rate of the polling in number of seconds. The minimum is 30 seconds. LocalAreaCode=714 Set to the local area code. When the user enters a TAPI format dialling string, ACC uses this parameter to determine if the user is making a local call or not. If the call is not local, then ACC will prepend PrefixLongDistance to the dialing string. LocalCountryCode=1 Set to the country code. When the user enters a TAPI format dialling string, ACC uses this parameter to determine if the user is making an international call or not. If the call is international, then ACC will prepend PrefixInternational to the dialing string. PortDNAIIS=80 Set to the destination port number used to access the D.N.A. IIS Server. PortCallSignal=0 This is the source port number used for H.323 call control messages. If the value is 0, a port will be assigned dynamically. Only modify this value if you need to run simultaneous H.323 clients on one machine (such as ACC and NetMeeting) and there is a conflict, or due to restrictions on your network. Note that the destination port is either set to a well-known port, 1720, or specified by the gatekeeper and its not configured by ACC.
139
ACC Installation
PortRAS=0 This is the source port number used to register with the gatekeeper. If the value is 0, a port will be assigned dynamically. Only modify this value if you need to select a specific port for registration due to restrictions on your network. Note that the destination port is a well-known port, 1719, designated for gatekeepers and it is not configured by ACC. PortRTP=0 This is the source port number used for voice data packets. If the value is 0, the default port will be used, which is 2326. Only modify this value if you need to select a specific port due to restrictions on your network. Note that the destination port is specified by the other party and its not configured by ACC. PrefixInternational= To have ACC automatically prepend a prefix number(s) for international calls, set this value to the appropriate prefix. PrefixLocal= To have ACC automatically prepend a prefix number(s) for local calls, set this value to the appropriate prefix. PrefixLongDistance= To have ACC automatically prepend a prefix number(s) for long distance calls, set this value to the appropriate prefix. ScanAdapters=0 Set this value to 1 for ACC to automatically attempt to register with the gatekeeper on all network adapters visible to ACC. If ACC fails to register with the gatekeeper on the default network adapter (the first adapter which appears in the Adapter list of the ACC Network Setup dialog), it will continue connection attempts to the gatekeeper using the other defined network adapters, until it successfully connects, or all adapters fail to connect. Note that if ACC is configured to use a specific network adapter (i.e., Use Selected Network Adapter is checked in the ACC Network Setup dialog) or if ACC is configured to use a VPN with Network Address Translation (i.e., Using VPN with Network Address Translation (NAT) is checked in the ACC Network Setup dialog, or UsingVPNwithNAT is set to 1 in the ACC.cfg configuration file), the ScanAdapters value will be ignored. StatusLog=1 Set to 1 to enable or 0 to disable the output of the Ecc.log file. The Ecc.log records all the H323 messages sent to and received from the gatekeeper. UseGatekeeper = 1 Set to 1 to enable use of the gatekeeper or 0 to disable UseGatekeeper_Backup=0 Set to 1 to enable the user of a backup gatekeeper for the user, or set to 0 to disable UsingVPNwithNAT=0 Set this value to 1 if the gatekeeper connection is made through a Virtual Private Network which includes a Network Address Translator. For more details, refer to "Using ACC with a Virtual Private Network (VPN)" in the Configuration section.
140
ACC Installation
VPNClientIPAddress=138.85 If the UsingVPNwithNAT flag is set, ACC will attempt to retrieve the VPN Client IP Address from the system automatically. If more than one IP address is retrieved from the system, ACC will select the first one that matches VPNClientIPAddress. Since the last octet of the VPN client IP address is likely to be changed every time when the user logs on to the VPN, it is recommended that you set up only the first 2 or 3 octets of the IP address in this variable so that the user doesnt have to update this variable constantly whereas ACC is still able to select the correct address based on this variable. For more details, refer to "Using ACC with a Virtual Private Network (VPN)" in the Configuration section. AutoAnswer=0 Set to 1 to answer incoming calls automatically or set to 0 to answer manually from incoming dialog. AutoAnswerDelay=3 Set to 3 to play ring tone for 3 sec before answering automatically using AutoAnswer option. HighPriority=1 Set to 1 to run ACC with High Priority. If this option is not set, ACC runs with Normal Priority. Version.cfg A configuration file containing the version number is maintained by the installation program and stored on the ACC server. FileVersion - ACC file version number ServicePackVersion Service Pack number for About Box use
Uninstall Access
The standard uninstall access is set via Control Panel / Add Remove Program function. In addition, the uninstall may also be accessed through CD-ROM or network shared-point.
Post Installation
The ACC server installation creates the ACC folder and the ACC_Sitename folder for all the sites configured during the ACC server installation in either the DNA_S or DNA_C folder.
141
ACC Installation
Create a new user such as AastraWeb account. This account can be used for other Aastra Web applications as well. Add the AastraWeb account to the Users and IIS_WPG account groups on the ACC server. 2. Create a custom Application Pool In the IIS Manager, right-click on Application Pools, select New, then Application Pool A pop-up dialog will appear, prompting you for the application pool ID. Use a name such as ACCPool and select the first radio button that uses the default settings. 3. Customize the Application Pool Right-click on ACCPool and select Properties In the Recycling tab, un-check "Recycle worker processes" In the Performance tab, un-check "Shutdown worker process after being idle for 20 minutes and check Enable CPU monitoring (to Max). For CPU use 100, and refresh CPU usage in 5 minutes increments. In the Identity tab, select the second radio button (Configurable) and specify the custom user identity that was created earlier in step 1. Enter the assigned password and click OK. You will then be asked to reconfirm the password. Enter the password and click OK again. Verify that the application pool has been started by refreshing the IIS Manager view (i.e., click on the Action menu and then Refresh). A started application pool will have an icon with green arrows overlaid on top. A pool that has not been started will have a red x overlaid on top of the icon (possible cause could be that an incorrect password was entered). Please ensure it is running properly. 4. Assign ACC Virtual Directory to Application Pool In the IIS Manager under the ACC virtual directory, right-click and select Properties. Under the Virtual Directory tab, in the Application Settings section, select the ACCPool option from the Application Pool dropdown list. 5. Assign Anonymous Identity Virtual Directory Go to the Directory Security tab. Under the Authentication and access control section, click Edit. An Authentication Methods dialog will appear. Check the Enable anonymous access checkbox and enter the AastraWeb user created in step 1. Enter a valid password, and also ensure that the bottom checkboxes are unchecked. Click OK until all dialog boxes have disappeared
6. Reset IIS Go to command prompt and execute iisreset to stop and restart IIS.
142
ACC Installation
ACC Server will need to access data on the D.N.A. server, which means ACC Server needs to be properly authenticated on the D.N.A. server with a domain user account. Add this domain user to the IIS_WPG account group on the ACC server. 2. Create a custom Application Pool In the IIS Manager, right-click on Application Pools, select New, then Application Pool A pop-up dialog will appear, prompting you for the application pool ID. Use a name such as ACCPool and select the first radio button that uses the default settings. 3. Customize the Application Pool Right-click on ACCPool and select Properties In the Recycling tab, un-check "Recycle worker processes" In the Performance tab, un-check "Shutdown worker process after being idle for 20 minutes and check Enable CPU monitoring (to Max). For CPU use 100, and refresh CPU usage in 5 minutes increments. In the Identity tab, select the second radio button (Configurable) and specify the domain user account that was created earlier in step 1. Enter the assigned password and click OK. You will then be asked to reconfirm the password. Enter the password and click OK again. Verify that the application pool has been started by refreshing the IIS Manager view (i.e., click on the Action menu and then Refresh). A started application pool will have an icon with green arrows overlaid on top. A pool that has not been started will have a red x overlaid on top of the icon (possible cause could be that an incorrect password was entered). Please ensure it is running properly. 4. Assign ACC Virtual Directory to Application Pool In the IIS Manager under the ACC virtual directory, right-click and select Properties. Under the Virtual Directory tab, in the Application Settings section, select the ACCPool option from the Application Pool dropdown list. 5. Assign Anonymous Identity Virtual Directory Go to the Directory Security tab. Under the Authentication and access control section, click Edit. An Authentication Methods dialog will appear. Check the Enable anonymous access checkbox and enter the AastraWeb user created in step 1. Enter a valid password, and also ensure that the bottom checkboxes are unchecked.
Click OK until all dialog boxes have disappeared 6. Reset IIS Go to command prompt and execute iisreset to stop and restart IIS. Note: If for any reason a domain account cannot be used, please reference MSDN article 176380, How To Use ASP with a SQL Trusted Connection with Guest Account: http://support.microsoft.com/kb/176380/EN-US/
Client Installation
The client installation is a self-extracting file that can be accessed by the user through an internet/intranet website. The user needs to go to the applicable Web page and find the package to download, extract, and begin the installation. The default virtual URL to install the ACC client is http://<EccServer>/ sitename.
143
ACC Installation
Installation Options
There are various installation options supported. The available installation options are detected automatically based on first time installation or if ACC has been installed.
New Installation
The installation program performs as a first time installation if there is no ACC installed before.
Reinstallation
This option is available if the current product version of ACC installation is detected. All necessary information is retrieved from the Registry or other sources and no question is asked. The installation program reinstalls the product and updates the system configurations accordingly.
Uninstall
This option is available if a current version of ACC is detected. The user is prompted for confirmation of un-installation. All the installed components (including application files, Registry keys, Registry values, program groups, short-cut keys, etc.) are removed when confirmation has been given.
License Agreement
For a first time installation (new installation), the License Agreement is displayed.
Registration Information
For a first time installation (new installation), the User Name and Company Name are prompted and information is stored in the Registry.
File Destination
For a first time installation (new installation), the default destination \Program Files\Ericsson\ECC is prompted. The user can change the target directory if desired through the standard directory selection browsing. All files are installed in the desired directory and target directory is stored in the Registry.
Summary Information
For a first time installation (new installation), all the user options or selections are listed for verification before copying the files and setting up the systems. The user can change the selections if desired. The installation runs without an attendant after this point.
144
ACC Installation
Configurations
Registry Setting
The application key \ECC is created under
HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson. All the sub-keys or Registry values
associated with ACC must be under the \ECC key. No Registry values are allowed under the Ericsson key directly. The same rules also apply to the other Registry hives. The following standard Registry values are created under
HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson\ECC\CurrentVersion:
InstallDateClient the date that installation is performed CompanyName UserName ProductNameClient the official complete product name ProductVersion the product version number TargetDirectoryServer the target directory where application files are stored NumberOfSites Number of sites to be configured. The following standard registry values are created under HKEY_LOCAL_MACHINE\Software\Ericsson \ECC: ACC_Site1,ACC_Site2 ... ACC_Siten where n is the number of sites configured and each registry value will have the name of a site.
Client Configurations
All the configuration settings are retrieved from the configuration file stored on the server and then saved in the client Registry. User specific Registry values are stored in HKEY_CURRENT_USER\Software\Ericsson\ECC.
Uninstall Access
The standard uninstall access is set via Control Panel / Add Remove Program function. In addition, the un-installation can also be accessed through CD-ROM or network shared-point.
Client Update
The client update is required to make sure the ACC user is always using the latest application.
145
ACC Installation
Compatibility
The ACC Server installation must: Windows Server 2008 -orWindows Server 2003 Install on IIS 7.0 or 6.0 Install on D.N.A. 5.6 server or client Distribute on CD-ROM The ACC Client installation must: Windows XP Professional + SP2 -orWindows Vista Business Run with IE 5.5 or later and Netscape 4.x, 6.x, or 7.x
146
Chapter 8 Performance
Performance Enhancements
This section introduces steps you can take to improve D.N.A. performance, following system installation. Some of the improvements covered include: Creating more available memory (RAM) Improving OWS Supervisor performance Improving RDS performance Note: Not all of these performance remedies may apply to your situation. You must evaluate these options individually, with respect to your system requirements, system stability, and your own technical capabilities.
147
Performance
RDS Performance
This section provides the following performance remedies and enhancements for the Remote Data Server (RDS). Enable/Disable Local Database Integrity Check Reduce I/O Completion Ports in Large Systems Enable/Disable Incremental LDB Updates from DMG Configure RDS to Use Fewer SQL Connections. Note: If you choose to change any of the following Registry values, you must stop and restart RDS to have the change take effect.
148
Performance
After each change in Directory Manager, RDS will run an integrity check of the master local database files. If this check is successful, the changes will be synchronized to all client LDBs. This causes RDS to repopulate corrupted local databases whenever it detects DMG updates. This helps prevent corrupted server LDBs from being distributed to client PCs. Important! The disadvantage of enabling this integrity check will be a performance degradation of the server.
The default setting for this flag is 1 (i.e., use multi-threaded client connections). For installation sites with more than 50 D.N.A. client installations, it is recommended that this flag be set to 0 (i.e., use I/O completion ports instead). For example, in a large system (more than 50 clients), RDS may run 410 threads at normal operation and 650 threads during peak times. With this change, RDS will run at 20 threads at normal operation and 260 threads during peak time. This should improve your server performance.
=0: No incremental updates are sent to LDBs. Also, when DMG moves a department, it will not start a repopulation of the related LDB tables. Only scheduled updates will repopulate the LDB with the latest changes. =1: This is the default setting. The LDBs are updated immediately after a DMG change to the SQL database. Note: This setting also makes the following additional Registry key relevant:
HKLM\SOFTWARE\Ericsson\RemoteDS\Manager\LDBFastSyncFactor
The key value is used to indicate the threshold (percentage) of database change which triggers theFast LDB Synchronization process. It can be set manually or via a spin-box in the GUI. =2: This option enables incremental updates (this is small work for RDS), but with the condition to ignore any updates that force RDS to fully repopulate the LDB. Therefore, when DMG moves or changes the name of a department, RDS will not start the repopulation of related tables. This task is left to the scheduled nightly repopulation routine.
149
Performance
The above settings only effect DMG changes. So if you select configure RDS for maintenance repopulation, it will execute based on the current EnableIncrementalLDBUpdates setting. If you choose to change this flag, you must stop and restart the RDS Service to have the changes take effect.
This flag is set to default to 0 (Disabled). To activate this option, set the flag to 1 (Enabled). If you choose to change this flag, you must stop and restart the RDS Service to have the changes take effect.
150
151
D.N.A. Server
Voice System Interface (VSI) - An ASCII protocol that provides the D.N.A. Voice System Interface to an external third party Integrated Voice Response (IVR) system. The VSI module allows voice mail integration and acts as a compatibility interface between the PBX and Voice Message Processing Systems. Capabilities include call diversion options, support for Message Waiting Indicators (MWI), and increased reliability of voice processing operations. PBX Service The PBX Service provides access and control over the signaling channel by which the PBX and OWS communicate. Although present on the D.N.A. server, it is only necessary that it run when using OWS or configuring the OWS telephone parameters. Serial Communications Server (SCS) The D.N.A. Server Utility that allows you to manage direct, Telnet, SCS, and third party serial communications port settings. Clock Synchronization Service The Clock Synchronization service (Clock Synch) sets the system clocks of client machines to match the time setting on the server. This allows all machines in the network to have their clocks set to the same value. This is particularly useful when using the Performance Data Manager, because it avoids gathering data with incorrect time stamps. LDAP A Windows service that provides an LDAP client (i.e., an Internet browser) to search and modify the D.N.A. directory. IP Service A Windows service that acts as an interface between Application Link and ACA to allow ACA users to access the call features such as Make call, Answer call, Hang up call, Conference call, Transfer call, Send DTMF tone, etc. These support resources are maintained and operated by network administrative and technical specialists. The following diagram illustrates the interaction between these D.N.A. client and server support resources.
152
D.N.A. Server
Administrative Tools
Administrative tools installed with the D.N.A. Server platform and with individual applications support various system configuration operations. The D.N.A. installation process automatically installs these tools. The following table explains how these utilities are used.
How It Is Used
Installed On
Allows you to configure the Remote Data Server Server for D.N.A. database and application support roles, including network database synchronization between PBX nodes, the D.N.A. SQL Server, and D.N.A. Local Databases (LDBs). Provides controls for assigning and managing user descriptions and corresponding application access privileges. Server
User Configuration
TSS Configuration
Use the D.N.A. Time System Server Server Configuration Utility to set up and maintain communications and translation settings for Diversion and Message Waiting features. Use this D.N.A. Server administrative tool Server to build and maintain a list of database servers accessible on the network. The Serial Communications Server Utility Server and allows you to manage direct, Telnet, SCS, Client and third party serial communications port settings. Allows you to display D.N.A. license information. The MD110 Support Utility allows you to perform initial MD110 node configuration and data extraction for the D.N.A. OWS, EMG, PMG and applications. Server
SCS Configuration
License Viewer
MD110 Support
Directory Configuration
Enables you to define the user-defined Server fields for directory database that best meet the needs of organizations they support.
LDAP Configuration The LDAP Configuration Utility enables Server you to configure the Lightweight Directory Access Protocol (LDAP) Server from anywhere on the network. It also allows
153
D.N.A. Server
Tool
How It Is Used you to add more LDAP directories to be used for searching people over the Internet/intranet from the Operator Workstation application and ACA.
Installed On
LDS Configuration
Allows you to setup other local database servers from one that is already configured.
Use the D.N.A. Name Identity Conversion Server Utility translate subscriber directory information into MML command files for D.N.A. telephone name display. Gives D.N.A. system administrators the Server ability to assign operators access to various departments within the organization. Determines what department data a given operator can access. Enables you to assign easily recognizable Server names to incoming trunks for efficient operator identification and routing. Use the D.N.A. Voice System Voice Server System Interface Configuration Utility to set up and maintain Diversion and Message Waiting communications settings between external Voice Systems and the D.N.A. Voice System Interface (VSI). For initial population of OWS directory assistance database. Runs on D.N.A. server and selected D.N.A. client workstations. Server and Client
Operator Configuration
Trunk Manager
VSI Configuration
Directory Import
Directory Export
Use the Export Utility to create .dat text Server and files of Dynamic Network Administration Client subscriber directory databases. The .dat files can then be imported into another D.N.A. installation with the Directory Import utility. Used to configure the ACA server and setting up the connection to Application Link. Server
ACA Configuration
154
D.N.A. Server
Alphabetic:
Numeric:
155
D.N.A. Server
Field
Explanation
Non-alphanumeric: From the Total Length, the minimum number of non-alphabetic characters required. Example of non-alphanumeric characters are: -,&*# etc. 2. 25. 26. 27. Enter your existing password into the Old Password edit box. Enter your new password into the New Password edit box. Again, enter your new password into the Confirm New Password field. Check your entries and click the Save button.
Registry
Registry Settings
The Windows Registry is a database repository for information about a computers configuration. It is organized in a hierarchical structure of sub-trees and their keys, hives, and value entries. This section explains Registry settings that correspond to D.N.A. component properties not found in the GUI.
The default value of this registry key is 0, meaning new processes will not inherent the security attribute from its parent process. When the registry key value is set to 1, the new launched schedule tasks will inherent its parent process' security information. The RDS service must be restarted after changing this registry key.
156
D.N.A. Server
Server Identification
Use the D.N.A. Server Configuration Utility to build and maintain a list of available database servers. Aastra's Dynamic Network Architecture relies on uniquely identified servers for centralized database and application support services. D.N.A. applications and utilities accessing network servers through security services require user logon and server selection. The Server Configuration Utility allows you to specify names and other attributes for the servers appearing in the User Logon D.N.A. Servers selection list.
LDS Servers
After a D.N.A. Client machine has been removed, the list of LDS servers in the D.N.A. Server must be updated manually by deleting the following Registry keys and restarting RDS.
HKLM\SOFTWARE\Ericsson\MRS\RemoteDS\RDSClients\NumberOfLDSClients HKLM\SOFTWARE\Ericsson\MRS\RemoteDS\RDSClients\LDS000x
RDS will rebuild these Registry keys with the correct number of LDS servers.
Maintenance
SQL Database
This section explains SQL database upsizing and maintenance procedures.
Database Upsizing
You can re-size D.N.A. database components to accommodate changes in the network. Use the Resize Database option. 1. Re-run the D.N.A. installation and choose the Resize Database button on the D.N.A. Setup dialog box. 2. Choose or enter new space requirements in the Nodes and Extensions for Database, Upsizing Extension Per Node, and Upsizing Performance manager Node Setup dialogs. 28. Respond to the remaining prompts and instructions from the installation wizard.
Tasks
You must schedule or perform maintenance tasks such as backing up databases and dumping transaction logs in support of SQL Server database operations. Refer to your SQL server documentation for information on managing these maintenance tasks.
Transaction Log
Important! Do not confuse the SQL transaction log with the D.N.A. Transaction Log. These resources serve two unrelated purposes. Expired message diversions are kept as reference information until being deleted daily. PBXMessage Waiting indications are updated daily. Use the SCHEDULE1 on the RDS Schedules tab to schedule daily database clean up for message diversion and message waiting. RDS performs this maintenance routine CheckDB once per day.
157
D.N.A. Server
From MX-ONE TSW onwards, more than one SMS Server can be initiated from Extension Manager.
158
D.N.A. Server
Extension Manager supports initiation, change, and removal of SMS. An SMS message will continually attempt to send the message to the phone until it is received. For MX-ONE 3.1, one SMS server per LIM can be initiated. Change the SMS server functionality by deleting the current SMS server and initiating a new SMS server using another generic extension.
Limitations
You can only send SMS messages from Operator Workstation. Sending an SMS message to more than 1 handset at a time or from one handset to another are not supported. You cannot have the D.N.A. SMS server and another SMS server connected to the MD110 at the same time. This is a MD110 limitation.
The compression is done just before the Local Database (LDB) files are sent over the network. They are then uncompressed by Operator Workstation right after they are retrieved from the network. Thus, the files can be accessed by Operator Workstation uncompressed.
The machines at both ends must have D.N.A. installed. The supporting components are in the client files in DNA_C\SHARE\BIN. Both machines must have the Registry value set to 1. You can see when compression is active by watching the file transfers in Remote Data Manager.
159
D.N.A. Server
GICI Connection
Once started, RDS listens for a GICI connection. A GICI connection is a socket connection initiated from the PBX. Once RDS receives a connection attempt, it will monitor heartbeat events from the PBX. The heartbeat (event 98), is initiated from the client (PBX) to RDS. RDS will acknowledge the heartbeat with event 93, and then send a heartbeat response (event 99). The PBX will in turn acknowledge this with event 93. If no events (heartbeat or other event) are received from the PBX for 5 minutes, RDS will close the socket connection and then start listening for connection attempts. The event signaling can be monitored via RDM.
160
D.N.A. Server
A shared extension is an extension that is shared among two or more users. A shared extension can be a primary extension or a secondary extension for the user. As a shared extension is shared among two or more subscribers, one of the subscribers is configured to be the primary subscriber.
There are two methods in which message diversion can propagate between primary and secondary extensions. Top-down. The message diversion is set on the users primary extension. RDS Configuration controls whether the message diversion shall also be considered for the users secondary extension(s). For more information refer to Message Diversion Options in RDS Configuration online help. Bottom-up. The message diversion is set on the users secondary extension. A Registry key controls whether the message diversion shall also be considered for the users primary extension. Set HKLM\SOFTWARE\Ericsson\RemoteDS\Manager\MsgDivToPrimaryExtension to 0 to disable and 1 to enable.
Normally, message diversions are managed on an extension level. However, OWS can show information using both a subscriber view and extension view. The OWS main window uses a subscriber view when performing a search operation. The detailed information view shows the extension view. If searching based on an extension number, then the OWS main window will show the subscriber view, whereas the detail view will show the extension view. Depending on the extension number used in the search, the detail information can be for primary or secondary extension. Thus, it is possible to see a message diversion in the detail view that is not visible in the main window. The following is the rule for setting message diversion using top-down method. Primary extension OWS (subscriber) Secondary nonshared extension Shared extension OWS (non-shared secondary extension) OWS (shared extension) No No No Yes (3) No No
161
Trigger
Top-down method Set from primary extension Set from OWS (subscriber) Yes Yes Yes Yes No No Yes Yes Yes (1) Yes (1)
Bottom-up method Set from non-shared secondary extension Set from shared extension Set from OWS (nonshared secondary extension) Set from OWS (shared Yes No Yes Yes No Yes No Yes No Yes Yes (2) Yes Yes (1) No Yes
No
No
Yes
No
No
D.N.A. Server
extension) (1) This is shown in the detail information when searching for the individual extension. (2) This will show in OWS subscriber view if the user has this extension number as the primary extension. (3) This will show in the extension view when searching for the particular extension.
162
Chapter 10 Maintenance
Archival Backup
PDM creates one archive file for each MD110 node that is written to the Dna_s\Siten\Pmg\Archive directory on the server PC (where n is the node number). Automatic or manual data extraction that exceeds the disk space configured for the primary D.N.A. server traffic measurement database causes the overflow to be extracted to archival flat files. For example, if D.N.A. traffic measurement disk space has been allocated for 3 months of data and you attempt to manually extract 6 months of data, the first 3 month's data will be placed in three separate monthly files, and the most recent 3 month's data are stored in the primary database. Important! It is imperative that there be a minimum of 4 MB of disk space free for each node on the server disk where the Dna_s directory resides. To maintain available disk space, the archival files in the Archive subdirectory for each node should be periodically backed up to auxiliary storage and deleted from the server disk drive. The archival files are used when setting up the auxiliary database, and all required files must be in the appropriate directory in order for it to be set up correctly. Therefore, when setting up the auxiliary database, you should restore any required files that were backed up and deleted from disk.
Temporary Workspace
PDM uses local drives for temporary files to store data during data extraction and to display MD110 system information. There must be at least 2 MB of free space free on the disk drive where the D.N.A. directory is installed. Be sure to maintain this minimum of 2 MB of free space on the disk drive where the D.N.A. directory is installed.
Automatic Extraction
Automatic data extraction refers to Performance Data Manager's downloading, translating, and transferring traffic measurement data to the D.N.A. database server on a daily basis. PDM performs this task once each morning between 00:30 (or 30 minutes after midnight) and 06:00, based on a 24-hour time scale. The 00:30 time is the default setting and can be changed in the PDM application. The polling period for database extraction extends to six hours by default from the configured start time. You can setup a Registry string to extend the polling time. Refer to Extend Polling Time for details. Note: PDM makes three extraction attempts for each measurement site.
163
Maintenance
Where: PATH specifies the directory where traffic measurement data files reside. The path name must be as specified and must not be altered. FORMAT specifies the traffic measurement file format, which is always hexadecimal. The file name is encrypted in the form Dnyddd where: n = the sequence of dumped files, valued 0, 1, 2 or 3. A maximum of 4 dumped files are allowed per day, e.g., the first dump of the day has n = 0. Although the traffic measurement data is being collected by MD110 software in 15 minute intervals, dumping only occurs when the temporary buffer in MD110 software is full or at the end of the day. After the midnight dump occurs, the temporary buffer is erased to pre-pare for traffic measurement data collection of the new day. y = the last unit digit of the year. For example, 4 for 1994 or 2004. ddd = the day of the year. The day of the year, for example 031 is Jan 31, 032 is Feb 1, 033 is Feb 2, and so on...
164
Maintenance
Clock Synchronization
The MD110 midnight dump occurs at 11 minutes after midnight. The midnight dump signifies that dumping of the day's traffic measurement data to the HDU has been completed. The Performance Data Manager extraction process is scheduled to run automatically at 00:30 (or 30 minutes after midnight). These time-related events require that the MD110 and PC clock to be synchronized with one another.
Extraction Process
The data extraction process includes Performance Data Manager converting collected traffic measurement data from hexadecimal to decimal format and store the results in the D.N.A. database. PDM is able to perform the extraction process for both local and remote D.N.A. database servers.
Example:
HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson\PMG\DNA_SERVER1
Add a string SkipSites with the nodes you want to skip separated by commas (",") under the key created in Step 1 and end with a comma (","). Example: If there are five nodes and only node 2 and 4 should be polled, set the Registry string to:
165
Maintenance
Presentation Manager
Following are important operation and maintenance considerations for Performance Presentation Manager.
Operational Requirements
PPM, like Microsoft Excel 2000, Excel 2002, or Excel 2003, requires an installed printer driver to function when connected to a printer.
Database Utility
The purpose of the D.N.A. database utility (DBCP.EXE) is to backup/restore D.N.A. application-related databases to/from a files running on Microsoft SQL Server 7, Microsoft SQL Server 2000, MSDE and MSDE 2000. The backup feature provided by SQL Server sometimes may corrupt ogins/users/ownership of databases. Therefore, DBCP is preferred as a more secure backup/restore method. Besides, this is the only way to backup databases if MSDE is used. This utility should be used for backup/restore of the same release of DNA.
Options
The Following command line options are available when you execute this console application. -B Backup database from SQL server to file -D DNA application (All, MRS, DMG, EMG, or PMG)
166
Maintenance
-O Change database ownership to D.N.A. default account -P User account password, defaults to (blank) -R Restore database from file to SQL server -U User account name for accessing SQL server (defaults to sa) ? Help and usage information The following table shows what is backed up or restored with the D option. DNA Application All MRS DMG EMG PMG Backed Up/Restored All installed DNA databases Dnadfdb emgdb security db_xaction Dirdb SiteX Pmglocks auxXpmg siteXpmg
167
Chapter 11 Troubleshooting
Log Files
The D.N.A. installation program creates two logs that can be used to troubleshoot installation problems. The Detail log contains all operations performed during the installation process. The Summary log contains the final status (success or failure) for each installed component. These ASCII text files can be viewed with Windows Notepad.
168
Troubleshooting
1 CPBXLINK: Fix PC hardware. InputHandler() cannot get timer capabilities. 2 CPBXLINK: Unable to contact the telephone. 3 Check phone, connection cable, and proper ELU initiation. N/A
4 Unable to open registry Check and correct Registry and user key. permissions. 5 No response from PBX port. Check all TAU connecting cables and cycle power on the TAU. This message ONLY appears when Operator Workstation is explicitly configured to use a TAU. Check all TAU connections and COM port assignments. Check connection to the PBX jack on the TAU. Check connection to PHONE jack of the TAU.
6 Unable to detect a terminal adapter on the PBX port. 7 The terminal adapter reports no PBX connection. 8 The terminal adapter reports no phone connection.
9 CPBXLINK: Restart Operator Workstation. This SendSignal(%1!s!) failed. usually appears if the program is GetLastError returned %2! aborted unexpectedly. s!. 10 Error reading registry value. RegEnumValue() returned %1!s!. If the returned value is 234, there is a Registry value of type REG_SZ longer than 80 characters. Shorten that value.
169
Troubleshooting
Application
Error Message 11 13 14 SetCommState() Failed. GetLastError returned "%1!s!". 15 CreateFile(%1!s!) failed. GetLastError returned "%2!s!".
Corrective Action N/A Fix COM port configuration or hardware problem. Fix COM port assignment problem. This can also occur if Operator Workstation is configured to use a non-existing port.
16 CreateThread() for Reinstall Windows. If error recurs, CCommLink::InputHandler contact system administrator. failed. GetLastError return "%2!s!". 17 18 No response from the Operator Workstation keyboard port. 19 Failed to connect to directory server. N/A Check Operator Workstation keyboard connection and COM port assignment. Verify that both the SQL server and D.N.A. Server are installed and running on the server PC.
20 Failed to open directory Verify that both the SQL server and database. D.N.A. Server are installed and running on the server PC. 21 Failed to retrieve subscriber user-defined fields. 22 ODBC Error: SQLState: "%1!s!", ODBCError: "%2!s!", NativeError: "%3!s!". 23 ODBC Information: SQLState: "%1!s!", ODBCInfo: 2! s!",NativeInfo: "%3!s!" 24 Warning physical memory is running low. 25 Warning Virtual memory is running low. Correct database setup using the Directory Configuration utility. Check SQL and ODBC driver using SQL utilities.
Either increase memory or close (exit) non-essential programs. Increase the paging file size via the Windows Control Panel. Select System and virtual memory.
170
Troubleshooting
Application
Corrective Action
Signals from the PBX and/or the phone are not being processed fast enough. This is usually due to some other process consuming most of the available CPU time. Use the Task Manager to determine which process is at fault and end it. Re-install the D.N.A. Server client software.
28 Warning Operator Workstation will not try to connect to Database. ODBC driver is not installed in registry. 29 Error Signal Buffer Overflow Count
Signals from the PBX and/or phone have been lost. This is an increase of the severity of the problem indicated by event 27. Take the same corrective action. The signal buffer pointer has advanced beyond its upper boundary. It is unlikely that this would occur in the absence of more serious operating system problems. There is a problem with one or more services on the server or the client, or a network problem. Try to stop and restart the Ericsson LFS service on the local machine. Verify that RDS and SDS on the server are running. Verify that the server is reachable over the network. This event is obsolete and not used in D.N.A. 4.0 or later.
33 Message and Diversion Same as event 31. If these two database connection events (31 and 33) occur disconnected. independently, there may be an installation related problem. 34 Department diversion database connection complete. None. This is an information message. The absence of this message indicates a service or network problem similar to events 31 and 33. This event is obsolete and not used
35 External search
171
Troubleshooting
Application
36 Message and Diversion None. This is an information database connection message. The absence of this complete. message indicates a service or network problem similar to events 31 and 33. 1001 E1001 - Database Server Error(37000): [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot open user default database. Login failed. There is a problem connecting to SQL Server. Check if SQL Server is running. If not, start SQL Server. Note: When using Microsoft Desktop Engine (MDE) and rebooting the PC, there may be an instance of this message logged. This is due to Desktop Engine starting after RDS. RDS will enter reconnect mode and will connect to Desktop Engine when Desktop Engine is started. Initialization error. Verify that the cloksync.lll is in the same directory as the service. %1 = file name Initialization error. Lack of system resources. Reduce the number of running applications and start the service again. Initialization error. Lack of system resources. Reduce the number of running applications and start the service again. Initialization error. Verify the permission level of the service. Restart the service. %1 = Registry key name.
ClockSync
ClockSync
ClockSync
ClockSync
ClockSync
1004 Client is enabled, but Initialization error. server machine name is Restart the service. invalid. Client disabled. 1005 Receive broadcasts Initialization error. is enabled, but server Restart the service. machine name is invalid. Receive disabled.
ClockSync
172
Troubleshooting
Application ClockSync
Error Message 1006 Could not open process token, client disabled.
Corrective Action Initialization error. Lack of system resources. Reduce the number of running applications and start the service again. Initialization error. Lack of system resources. Reduce the number of running applications and start the service again.
ClockSync
1007 Could not enable time set privilege for process, client disabled.
Installation
0 %1 unable to connect to Refer to database manual for database %2. detailed information of database error. Correct the problem per database manual and redo the installation. %1 = Application name. %2 = Database error message. 0 %1 error inserting application %2. Refer to database manual for detailed information of database error. Correct the problem per database manual and redo the installation. %1 = Application name. %2 = Database error message. Refer to database manual for detailed information of database error. Correct the problem per database manual and redo the installation. %1 = Application name. %2 = Database error message. Refer to database manual for detailed information of database error. Correct the problem per database manual and redo the installation. %1 = Application name. %2 = Database error message.
Installation
Installation
Installation
Installation
0 %1 number of licensed Refer to database manual for elements does not match detailed information of database element table. error. Correct the problem per database manual and redo the installation. %1 = Application name. %2 = Database error message.
173
Troubleshooting
Application Installation
Error Message
Corrective Action
1000 %1 number of Refer to database manual for elements in element table detailed information of database does not match site table. error. Correct the problem per database manual and redo the installation. %1 = Application name. %2 = Database error message. 1001 %1 error updating number of element licenses %2. Refer to database manual for detailed information of database error. Correct the problem per database manual and redo the installation. %1 = Application name. %2 = Database error message.
Installation
Installation
1002 %1 the element type Refer to database manual for was not defined. detailed information of database error. Correct the problem per database manual and redo the installation. %1 = Application name. %2 = Database error message. 1000 Could not load resource library. Initialization error. Verify that the lfs.lll is in the same directory as the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error.
LFS
LFS
LFS
LFS
LFS
LFS
LFS
174
Troubleshooting
Application
Corrective Action Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service.
LFS
LFS
LFS
1009 Failed to set security Initialization error. attributes. Reduce the number of running applications and restart the service. 1010 Failed to create message queue thread. Initialization error. Reduce the number of running applications and restart the service.
LFS
LFS
1200 Failed to retrieve Initialization error. security data server name Restart the service. from registry. 1201 Failed to initialize Initialization error. security data server client. Reduce the number of running applications and restart the service. 1200 Cannot retrieve the Run-time error. password format data from Neither the primary nor the backup the local database. Notify databases are available. Password the system administrator. cannot be changed with this condition. Contact your system administrator. 1201 Cannot retrieve the Run-time error. password format data from Cannot retrieve data from the the server database. primary database. Password cannot Notify the system be changed with this condition. administrator. Contact your system administrator. 1202 Cannot retrieve the user data from the local database. Notify the system administrator. Run-time error. Neither the primary nor the backup databases are available. Password cannot be changed with this condition. Contact your system administrator.
LFS
LFS
LFS
LFS
LFS
1203 Cannot retrieve the Run-time error. user data from the server Cannot retrieve data from the
175
Troubleshooting
Application
Corrective Action primary database. Password cannot be changed with this condition. Contact your system administrator.
LFS
1204 Cannot save the new Run-time error. password. The server Cannot store data to the primary database is unavailable. database. Password cannot be changed with this condition. Contact your system administrator. 1205 Cannot save the new Run-time error. password. Unable to Cannot store data to the primary connect to the security database, due to communication data server. problems with the security data server. Password cannot be changed with this condition. Contact your system administrator. 1206 Cannot retrieve the Run-time error. user data from the server Verify that the application is installed. database. The application Reinstall the application, if needed. may not be installed. Notify the system administrator. 1207 Cannot retrieve the Run-time error. user data from the local Verify that the application is installed. database. The application Reinstall the application, if needed. may not be installed. Notify the system administrator. 1500 Failed to close Shutdown error. message queue normally. Notify the system administrator. 1700 Out of memory. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Verify that the sds.lll is in the same directory as the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running
LFS
LFS
LFS
LFS
LFS
SDS
SDS
SDS
176
Troubleshooting
Application
Error Message
SDS
Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Reduce the number of running applications and restart the service.
SDS
SDS
SDS
SDS
SDS
SDS
1009 Failed to set security Initialization error. attributes. Reduce the number of running applications and restart the service. 1010 Failed to create message queue thread. Initialization error. Reduce the number of running applications and restart the service. Initialization error. Refer to the database manual for information on database error. Correct the problem per database manual and try again. %1 = Database error message
SDS
SDS
SDS
1201 Failed to connect to Run-time error. database server. Retrying Check whether database server is in %1 seconds. running and restart, if necessary. %1 = Database error message 1202 Failed to create database server connection thread. Run-time error. Reduce the number of running
SDS
177
Troubleshooting
Application
Error Message
SDS
1203 Failed reading the database source from the registry. Application type = %1.
Run-time error. Check the content of the Registry setting with RDS configuration. Check the access permission to the Registry entries with the Registry Editor. %1 = Application type
SDS
1500 Failed to close Shutdown error. message queue normally. Notify the system administrator. 1700 Out of memory. General error. Reduce the number of running applications and restart the service. Refer to database manual for detailed information of database error. %1 = Database error message. Refer to database manual for detailed information of database error. %1 = Database error message. Refer to database manual for detailed information of database error. %1 = Database error message. Refer to database manual for detailed information of database error. Correct the problem per database manual and try again. %1 = Database error message. Refer to database manual for detailed information of database error. Correct the problem per database manual and try again. %1 = Database error message. Refer to database manual for detailed information of database error. Correct the problem per database manual and try again.
SDS
UserConfig
UserConfig
UserConfig
UserConfig
UserConfig
UserConfig
178
Troubleshooting
Application
Error Message
UserConfig
Refer to database manual for detailed information of database error. Correct the problem per database manual and try again. %1 = Database error message. Refer to database manual for detailed information of database error. Correct the problem per database manual and try again. %1 = Database error message.
UserConfig
UserConfig
1008 Cannot load the site Refer to database manual for table %1. detailed information of database error. Correct the problem per database manual and try again. %1 = Database error message.
Registry key actually exists and that system account has permission to read it. Make a note of the error code, 0xnnn. GetAppSuiteRegState: RegOpenKeyEx failed: 0xnnn Make sure that the HKLM\SOFTWARE\Ericsson\DMI\AppSuite Registry key actually exists and that System account has permission to read it. Make a note of the error code, 0xnnn. GetAppSuiteRegState: RegQueryValueEx failed: name 0xnnn Make sure that the HKLM\SOFTWARE\Ericsson\DMI\AppSuite\"name" Registry key actually exists and that System account has permission to read it. Make a note of the name and error code, 0xnnn. SetAppSuiteRegInstalled: RegCreateKeyEx failed: 0xnnn Make sure that the System account has permission to create and/or write Registry key HKLM\SOFTWARE\Ericsson\DMI\AppSuite. Make a note of the error code, 0xnnn. SetAppSuiteRegInstalled: RegSetValueEx failed: 0xnnn
179
Troubleshooting
Make sure that the System account has permission to create and/or write Registry key
HKLM\SOFTWARE\Ericsson\DMI\AppSuite\InstalledAppSuiteComponents.
Make a note of the error code, 0xnnn. SetAppSuiteRegState: RegCreateKeyEx failed: 0xnnn Make sure that the System account has permission to create and/or write Registry key HKLM\SOFTWARE\Ericsson\DMI\AppSuite. Make a note of the error code, 0xnnn. SetAppSuiteRegState: RegSetValueEx failed: name 0xnnn Make sure that the System account has permission to create and/or write to Registry keys under HKLM\SOFTWARE\Ericsson\DMI\AppSuite\"name". Make a note of the name and error code, 0xnnn. AddAppX: GetAppSuiteRegInstalled failed Make sure that the HKLM\SOFTWARE\Ericsson\DMI\AppSuite\ Registry key actually exists and that System account has permission to read it. AddAppX: SetAppSuiteRegInstalled failed Make sure that the System account has permission to create and/or write Registry key
HKLM\SOFTWARE\Ericsson\DMI\AppSuite\InstalledAppSuiteComponents.
AddAppX: SetAppSuiteRegState failed Make sure that the System account has permission to create and/or write to Registry keys under HKLM\SOFTWARE\Ericsson\DMI\AppSuite. RemoveApp: GetAppSuiteRegInstalled failed Make sure that the HKLM\SOFTWARE\Ericsson\DMI\AppSuite\ Registry key actually exists and that System account has permission to read it. RemoveApp: SetAppSuiteRegInstalled failed Make sure that the System account has permission to create and/or write Registry key
HKLM\SOFTWARE\Ericsson\DMI\AppSuite\InstalledAppSuiteComponents.
Init: AddApp failed: 0xnnn Make sure that the System account has permission to create and/or write Registry key
HKLM\SOFTWARE\Ericsson\DMI\AppSuite\InstalledAppSuiteComponents.
Make a note of the application id, 0xnnn. SetAppState: Can't find app: 0xnnn The function SetAppState was called with an invalid application id. Make a note of the application id, 0xnnn. SetAppState: SetAppSuiteRegState failed Make sure that the System account has permission to create and/or write to Registry keys under HKLM\SOFTWARE\Ericsson\DMI\AppSuite. SetModified: Can't find id: 0xnnn The function SetModified was called with an invalid application ID. Make a note of the application id, 0xnnn.
180
Troubleshooting
CheckPID: SetAppSuiteRegState failed Make sure that the System account has permission to create and/or write to Registry keys under HKLM\SOFTWARE\Ericsson\DMI\AppSuite. GetApps: Map is empty A list of known applications has been requested and the list was empty. This might or might not be an error. GetEventType: Can't find id: 0xnnn The function GetEventType was called with an invalid application ID. Make a note of the application id, 0xnnn. GetEventSeverity: Can't find id: 0xnnn The function GetEventSeverity was called with an invalid application ID. Make a note of the application id, 0xnnn. GetAppStart: Can't find id: 0xnnn The function GetAppStart was called with an invalid application ID. Make a note of the application id, 0xnnn. GetAppSuiteServerName: RegOpenKeyEx failed: 0xnnn Make sure that the HKLM\SOFTWARE\Ericsson\MRS\CurrentVersion\ Registry key actually exists and that System account has permission to read it. GetAppSuiteServerName: RegQueryValueEx failed: 0xnnn Make sure that the
HKLM\SOFTWARE\Ericsson\MRS\CurrentVersion\ServerName Registry key
actually exists and that System account has permission to read it. GetAppSuiteServerID: RegOpenKeyEx failed: 0xnnn Make sure that the HKLM\SOFTWARE\Ericsson\MRS\CurrentVersion\ Registry key actually exists and that System account has permission to read it. GetAppSuiteServerID: RegQueryValueEx failed: 0xnnn Make sure that the HKLM\SOFTWARE\Ericsson\MRS\CurrentVersion\ServerID Registry key actually exists and that System account has permission to read it. GetAppVer: Can't find id: 0xnnn The function GetAppVer was called with an invalid application ID. Make a note of the application id, 0xnnn. GetAppState: Can't find id: 0xnnn The function GetAppState was called with an invalid application ID. Make a note of the application id, 0xnnn.
181
Troubleshooting
Technical Support
The Troubleshooting book contains information needed to resolve most problems that can occur with the D.N.A. applications. However, situations may occur in which you are unable to resolve problems using troubleshooting information. For additional technical assistance, contact your Aastra representative.
Number of: OWS clients DMG clients Names in subscriber database MD110 or MX-ONE nodes
If Hotfixes loaded:
Version of "fixed" .exe files (To view, use the Windows Explorer to select and right-click the .exe file, select Properties from the pop-up menu, click the Version tab. PBX software release CNI version or Service Pack Status Any special OWS patches System size (i.e., nodes, extensions, etc.) A detailed description of the problem. Although it is not necessary, it will also be helpful if you can try to guess the source of the problem and then try to provide Aastra engineers with detailed information relating to that part of your system.
PBX setup:
Include:
182
Troubleshooting
Problem Description
State each problem description clearly and include any available details relating to the problem, including: Time-of-day problem occurred Operations in progress when the problem occurred Applications and/or databases involved General type of failure (i.e., transitory, repeatable/non-repeatable, application halt, system halt, etc.)
PBX
PBX Type ______________ Version ________________ No. of Nodes ____________ IPU Revision _____________ ICU Revision _____________ NIU Revision _____________
Configuration
Workgroup______________ Stand Alone_____________ FAT ___________________ Domain _________________ File System______________ NTFS___________________
PC
Manufacturer ____________ CPU __________________ Memory (RAM) __________ Model __________________ Clock Speed _____________ Hard Disk _______________
183
Troubleshooting
D.N.A. Applications
Report each application that was running when the problem occurred. Include the version/release level and which national language the application supports. Application Directory Manager (DMG) ________________________ ________________________ Extension Manager (EMG) ________________________ ________________________ Operator Workstation (OWS) ________________________ ________________________ Performance Data Manager (PDM) ________________________ ________________________ Performance Presentation Manager (PPM) Aastra Communication Assistant (ACA) Aastra Communication Client (ACC) Other ________________________ ________________________ Version/Release Level Language Supported
________________________ ________________________
________________________ ________________________
________________________ ________________________
Directory Manager
When using Directory Manager (DMG) on the D.N.A. server to add a department name containing a comma (,), the following error message appears: The following characters are reserved by CAAPI and cannot be used in name, phone and cost centers fields: , ; DIRPOP will also generate an error if there is a comma (,) in the department name. However, using DMG or DIRPOP on a D.N.A. client (i.e., a computer other than the D.N.A. server) works without receiving any error message. The reason is as follows. The Registry settings for CAAPI reside on the D.N.A. server along with the CAAPI application. When DMG is run on the D.N.A. server, DMG will check to ensure that CAAPI delimiters are not used in the department names. On a D.N.A. client however, the Registry settings do not exist for CAAPI, so DMG cannot check for the CAAPI delimiters. DIRPOP exhibits this same limitation.
184
Troubleshooting
Before any of the following procedures are used, close all D.N.A. applications (DMG, DIRPOP, DirLink, LDAP, etc.) to avoid a potential database mismatch. Note: The values for FieldMark and RecordMark may be changed to other values, provided there is no conflict with subscriber or department names. Ensure that the values for FieldMark and RecordMark are always synchronized between the D.N.A. server and its clients. The following procedure is used on a system where CAAPI is not used and department names with comma are used: 1. On the D.N.A. server open the Registry key Software\Ericsson\MRS\CAAPI under the HKEY_LOCAL_MACHINE hive. 2. Change string value FieldMark to $ (dollar sign). FieldMark is the divider between the data within one subscriber or department. 3. Change string value RecordMark to | (vertical pipe, or upper-case backslash symbol on QWERTY keyboard). RecordMark is the divider between the subscribers or departments. The following procedure is used on a system where CAAPI and department names containing commas are used: 1. On all D.N.A. client machines where DMG or DIRPOP is run, open the Registry key Software\Ericsson\MRS under the HKEY_LOCAL_MACHINE hive. 2. Create sub-key CAAPI. 3. Create string value FieldMark under the CAAPI sub-key. FieldMark is the divider between the data within one subscriber or department. 4. Set the value of FieldMark to $ (dollar sign). 5. Create string value RecordMark under the CAAPI sub-key. RecordMark is the divider between the subscribers or departments. 6. Set the value of RecordMark to | (vertical pipe, or upper-case backslash symbol on QWERTY keyboard). Change the corresponding Registry values on the D.N.A. server to match the values set on the D.N.A. clients The following table lists error messages displayed by the Directory Manager application that may indicate a setup problem. Problem Corrective Action
An error occurred while closing Verify that there is a connection to RDS (Remote the database. Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Cannot get user ID for transaction register entry. Could not add a new department to the database. Verify that the D.N.A. Server utilities are running and that Remote Data Server is set up correctly. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data
185
Troubleshooting
Problem
Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests.
Could not get a valid record ID A record in the delete_id table is locked. from IDMSC. Could not retrieve authorization code from the logging services. Could not retrieve database source information from the logging services. Could not update extension data. Verify that the Management Repository Server utilities are running and that Remote Data Server is set up correctly. Verify that the Management Repository Server utilities are running and that Remote Data Server is set up correctly. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests.
186
Troubleshooting
Corrective Action Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests. A record in the delete_id table is locked. Verify that there is a connection to RDS (Remote Data Server) and the SQL server, and verify that RDS and the SQL server are responding to data retrieval and update requests.
Data for the selected department could not be retrieved. Data for the selected external directory entry could not be retrieved. Data for the selected subscriber could not be retrieved. See your Database Administrator. The department could not be updated.
187
Troubleshooting
Corrective Action
HKLM\SOFTWARE\Ericsson\ECC\C urrentVersion\PortCallSignal
to a value other than 1720, which is the default, to avoid a conflict. Restart ACC.
Confirm the settings in the Gatekeeper tab of the Setup property sheet
Failure to connect to the RAS Modify the Registry value port due to network limitation HKLM\SOFTWARE\Ericsson\ECC\C urrentVersion\PortRAS to a port (the port is restricted). number that is unrestricted by the network to avoid a conflict. Restart ACC. Multiple Network Cards installed Security policy is set in Service Node Confirm that the correct network card is selected on the Network tab of the Setup property sheet. If the security policy is set in Service Node, remove it or else change the security exception of the extension to YES and then try to register again. Modify the Registry value
HKLM\SOFTWARE\Ericsson\ECC\C urrentVersion\PortRTP to a port
Failure to connect to the RTP port to send voice data packets due to network limitation (the port is restricted).
Multiple sound cards installed. Make sure the sound card selected on the General tab of the Setup property sheet is correct.
188
Troubleshooting
Problem The state Error appears in the ACC Monitor window for monitored extensions.
Possible Cause Only extensions that are on the same PBX node as the ACC users extension may be monitored by ACC. If the state Error is displayed for an extension in the ACC, it could indicate that either the ApplicationLink information is improperly configured, or the monitored extension is on another PBX node.
Corrective Action Confirm that ApplicationLink information was setup properly during ACC installation. This can be found in the Windows Registry at
HKLM\SOFTWARE\Ericsson\ECC\C urrentVersion. There should be
a pair of values for each PBX node (e.g., Node1Name, Node1Port, Node2Name, Node2Port). If the ApplicationLink information is correct, it may be the case that the users extension is defined on a different PBX node than the monitored users extension. Since ACC can only connect to a single ApplicationLink server, it will not be possible to monitor that extension, and Error will display as the state for the extension. If the ApplicationLink information is incorrect, reinstall the ACC Server. This will update the ApplicationLink configuration information in the ecc.cfg configuration file on the server, and clients will automatically retrieve this updated information the next time ACC is run.
Wave files for incoming and outgoing calls (i.e., ring and ringback tones) are not played out the selected sound card.
The selected sound card is This is a limitation in the not the active (default) system application. The wave files sound card. configured will not be affected by the sound card selected by the Audio Devices list. If you override the default system sound card, only the speech path for your calls will be affected. Wave files will be played using the system sound card.
189
Troubleshooting
Problem Personal Number errors: Failed to delete choice Failed to change choice data Failed to initiate choice Failed to activate the profile
Possible Cause 1. Personal number data is out-of-synch between PBX and SQL database. 2. Backend component is not configured properly.
Corrective Action 1. Re-synchronize extension data for the faulty extension via the MD Support utility. 2. EMG connection with PBX will fail if configuration is not set up properly. The administrator must ensure that EMG can be logged onto with the System account and can connect with PBX successfully. Please refer to Configuration for Personal Number access section for details. Note: The administrator can also turn on the log for more information. Refer to Trace in the Personal Number problems section for Aastra Communication Assistant.
Extension Manager
Problem Cannot access database at this time. Synchronization is currently running. (Message Box) Possible Cause Another user is using Extension Manager or MD Support to access the database, or database remained locked when MD Support application terminated abnormally. Corrective Action Use Access Control option on Application menu to display information about user accessing database. If the other user is still accessing the database, try to access the database again later. If it is suspected that the other user is not still accessing the database, the record in the database which is blocking access to other users can be deleted manually. Restart the network.
Cannot connect to database server. (Message Box) Cannot get database server information. (Message Box) Cannot open database. (Message Box) Cannot connect to
Network is down.
Data source points to Setup the data source. the wrong PC. Server database is down. Restart the server database.
190
Troubleshooting
Problem MD110.
Cannot connect from the All Telnet ports are Telnet server to the serial occupied. port. No connection from the Telnet server to the MD110 IPU port. Cannot connect to the Serial Communication Service. Cannot connect to the Telnet server. Connection attempt has failed. Access agent is not running. Incorrect Telnet server address, User ID, or password.
Make sure there is a port available. Verify there is a functioning cable connection between the Telnet server and the MD110 IPU port(s). Verify the SCS is running.
Make sure the access agent is running. Verify that the Telnet server logon information is entered correctly. Restart the network. Restart the database server. Close the other application using the communication device or wait until the communication device is available.
Cannot get Telnet Network or SQL address from the server is not running. database. (Message Box) Cannot open communication device. Communication device is being used by another application.
Specify a valid communication Selected device. communication device does not exist. Cannot retrieve PBX error Server database is messages from database. down. (Message Box) Required entry in EMGDB database MDERR table does not exist. Cannot synchronize with PBX. Restart the server database. Reinstall the EMGDB database.
Logon to PBX not Verify that the connection to the PBX completed due to is good and verify that the PBX is problem with operating properly. connection to the PBX or the PBX itself. Problem with Verify that the connection to the PBX connection to the is good and verify that the PBX is PBX or the PBX itself. operating properly.
191
Troubleshooting
Problem available. Connection to this site is not allowed. Please synchronize this site before reconnecting. Data source retrieved from Logging service for node database is undefined. Data source retrieved from Logging service for transaction database is undefined. (Message Box)
Possible Cause
Corrective Action
Extension Manager Run MD support utility to MD database table is synchronize MD data. empty. Data source set up incorrectly. Setup the data source.
EMG client is killed when This occurs by RDS restarts. design. During startup, RDS kills all EMG instance(s) in order to allow the extension Link function to function properly. Error communicating with Network is down or the Remote Database the RDS is down. Server. Error disconnecting from the Telnet server. Error initializing the modem. Error resetting the modem. Error loading the template file from the server. Make sure the Remote Data Server is running. Also make sure that the Registry contains the correct path to the D.N.A. directory structure. Problem with connection to modem/TAU or modem/TAU itself. Network is not operating properly. Remote Data Server is not running. Incorrect entry in Registry for path in server for template files. Verify that the connection to the modem/TAU is good and that the modem/TAU is operating properly. Restart the network. Run RDS. Contact technical support. Restart the network and verify RDS is running.
Error initiating extension. There is no space Not accepted. Equipment available for the position already assigned. corresponding ISDN extension. When the Dual access extension interface is provided, 32 time
When initiating the Dual access extension you select the Equipment position for the digital extension among the first 16 time slots, the remaining 16 time slots are used for the corresponding ISDN extension (Example: digital extensions
192
Troubleshooting
Problem
Possible Cause slots are required in the switch for each ELU 28/3 board.
Corrective Action equipment position was 1-0-40-3, the ISDN extensions equipment position will be 1-0-40-19). Restart the network. Setup the data source. As soon as the synchronization stops, (by letting it finish or by "breaking" it) restart the synchronization. Set up the communication parameters to match the communication device.
Failed to ...
Network is down. Data source set up incorrectly. A command was sent to the PBX while synchronization was running.
Communication parameters for the communication device are not set up correctly.
Invalid authorization to Telnet Access Agent. Invalid client path. Please Directory set for Contact technical support. check with your system TargetDirectoryClient administrator. in Registry does not exist. Invalid path to the log files. Extension Manager log sub-directory for the specific site does not exist. Online help subdirectory does not exist. Site sub-directory under client path does not exist. The D.N.A. Database has not received updated license information. Create emg\log sub-directory under the site directory.
Invalid path to the online help parameter description. Invalid site path. Please contact your system administrator. Licenses in EMG do not match the licenses in the MD.
If you have modified a license file in the MD with new values for certain objects (e.g., updating a Personal Number license from a Trial license of 0 to 100 new licenses), use MD Support to synchronize the D.N.A. Database with the updated license information. A full synchronization is not required, only the feature that includes the updated license information (e.g., Operator Message Diversion).
193
Troubleshooting
Possible Cause Logon attempt rejected by MD110 after three unsuccessful attempts. Time limit for MD110 feedback too short.
Corrective Action Restart the MD110 as described in the MD110 Operation and Maintenance manuals.
Problem with Verify that the connection to the connection to the MD110 is good and verify that the MD110 or the MD110 MD110 is operating properly. itself. Problem with TAU/modem. All Telnet ports are occupied. No password assigned for user ID. Restart/reset the TAU/modem.
No dial tone received from the communication device. No free MML session is available. No password assigned.
Verify that there is a port available. Request that system administrator add Extension Manager access password to the user ID.
Logon to PBX not Verify that the connection to the PBX completed due to is good and verify that the PBX is problem with operating properly. connection to the PBX or the PBX itself. Incorrect MD110 password entered. Enter correct password, or use MD Support application to assign a new password. Verify that the device is available. Resend command. Try to connect again. If the attempt fails, try again after intervals of several minutes. Request that system administrator add Extension Manager access privilege to the user ID.
Password unknown.
SCS device is not available. Serial line not available. The dialup number is busy.
The SCS device is occupied. Command to MD110 temporarily blocked. The destination directory number is unavailable due to current activity. User ID not authorized for Extension Manager.
The number of extensions The reason could be available for initiation that during the
Run the DNA server installation and select Resize Database. Any value
194
Troubleshooting
Possible Cause installation of the DNA server, the value set per node was lower than the number of extensions you actually have in the node, and after synchronization of all extensions, you exceeded the maximum allowed for that node in the database.
Corrective Action in the Total Number of Extensions, and the Extensions for each node, can be used. These values have no impact towards the license value in ELM, as ELM is the master.
The site for the current transaction is different from the selected site.
You are attempting to Disconnect the current site and process a transaction reconnect to the site required for the for a different site transaction. than the site currently connected. Extension number is Run MD support and re-synchronize not a member of any "Directory Information" and "Number known number series Series". currently in the database. Network is down. Site security information does not exist in logging local database. Logging facility service is down. Restart the network. Run RDS on the server.
Unable to retrieve the TargetDirectoryClient value from the Registry. Please contact your Administrator. Unable to retrieve transaction data source from Logging service.
TargetDirectoryClient Contact technical support. entry for Aastra does not exist in Registry.
RDS not running. Logging facility service is down. Data mismatch between RDS and logging facility service.
Run RDS on the server. Run logging facility service on the client. Restart logging facility service on the client.
195
Troubleshooting
Problem
Corrective Action
Operator Workstation
This table lists problems that may occur during Operator Workstation operation. It provides an explanation of the probable causes and recommended remedies. Problem Possible Cause Corrective Action Use the Windows Performance Monitor to check the exchng32.exe and mapisp32.exe processes. See E-mail Integration for OWS, in the Configuration section.
Cannot deliver (send) OWS may not have e-mail messages to successfully attached D.N.A. subscribers to a MAPI session. from Operator Workstation.
Cannot send mail via System default locale is Force an update to the system default SMTP with localized not set to the localized locale. Run the windows Control Panel, versions of OWS. version. and select the Regional Options applet. Click the Set default button, choose your language, and click OK. If you are not prompted to restart the system, select a different language and restart the system. After the system restarts, set your language again and restart once more. Error dialog box displayed when starting Operator Workstation. Database settings configured incorrectly. PBX interface problem. Perform the suggested corrective action and restart Operator Workstation. If the problem recurs, verify the RS-232C connection between the TAU and the PC by using a breakout box, and verify the line by initiating the line as a digital station and verify that the D3 works on that line. IRQ conflict or I/O address problem. Multiple ports or devices assigned the same IRQ (interrupt request), or address settings improperly configured. Use the winmsd.exe utility in the system32 directory for Windows to view IRQ and address settings. Reassign IRQs and/or address settings to resolve conflicts. Check D.N.A. Server installation and restart Operator Workstation after correcting database configuration.
Operator Workstation Line initiation or cabling Verify the RS-232C connection between starts, but cannot get problem. the TAU and the PC by using a any on/off duty breakout box, and verify the line by
196
Troubleshooting
Problem indications.
Possible Cause
Corrective Action initiating the line as a digital station and verify that the D3 works on that line. Check the class of service and call origin group for this operator interface in the MD110.
Operator Workstation Setup problem. starts and you can go "on duty" but cannot make or answer calls. OWS hangs at Problem with Vista OS startup on a Vista while configuring User Business machine Account Control. with User Account Control (UAC) enabled, but when UAC is disabledOWS starts up with out any problems. The account that tries to run the OWS is the Administrator.
Switch the windows user to Administrator account and start the OWS, it should start ok. Switch back to the account which has admin privilege and try launching OWS. Problem could occur if the Administrator account has no password.
197
Troubleshooting
OWS Supervisor
Use the following table to correct problems found when running OWS Supervisor. Error Message Possible Cause Failed to find The user ID on the client Connection cannot logon to the D.N.A. Point in Server server. Or "Failed to advise the connection point" is displayed when starting OWS Supervisor. Extra security running on Windows XP (with Service Pack 2 or higher). Corrective Action Verify that the user ID logged on at the client has correct authority to logon at the D.N.A. server. This can be done by using domain rather than local accounts when the machines are in the same domain. When in separate domains or in a workgroup, the easiest solution is to create a local account on the server with the same user ID and password as the local account on the client. In addition to DCOM and Windows account permissions, SP2 adds a Firewall control panel. The exact steps necessary to enable OWS Supervisor depend on the network and security setup, i.e. whether clients and servers are in a domain or workgroup, and domain or local accounts being used. Troubleshooting is aided greatly by enabling Security Auditing (in Local Security Policy) and D.N.A. auditing (in the D.N.A. User Manager under the Application menu).
198
Troubleshooting
Corrective Action The minimum requirements are: 1. The Windows account in effect for OWS Supervisor must have administrative privilege on the DNA server. 2. DCOM Access and Launch permissions for OWS Supervisor (the client application) and DNASupervisorServer (the server service) must include that account or a group to which it belongs. 3. The Firewall control panel must show OWS Supervisor checked (enabled). 4. Port 135 has to be opened through the Windows firewall for OWS Supervisor over TCP. 5. The DNA user account must have Access permission to OWS Supervisor.
"Access is denied"
The windows account for OWS supervisor does not have administrative privilege on the DNA server.
Verify that the Windows account in affect for OWS Supervisor has administrative privilege on the DNA server.
Deployment Scenario 1:
DNA Server Connected to a Domain Controller. Operating System logged with Domain Administrator account. DNA Client Connected to a Domain Controller. Operating System logged with Domain user priviledge account. Problem: OWS users logged with Windows Domain user privilege are not listed in the OWS Supervisor.
199
Troubleshooting
Corrective Action: 1. 2. 3. 4. 5. 6. 7. 8. From the Start Menu, select Run and then type dcomcnfg. Click OK. The Component Services dialog box displays. In the Component Services dialog box, select Component Services. Traverse to the path Component Services>Computers>My Computer>DCOM Config. In the DCOM Config folder, select the component DNASupervisorServer. Right click to view properties of DNASupervisorServer and click the Security tab. Under Launch and Activation Permissions, select Customize and click Edit. Add the Windows User logon that is going to launch the OWS Application.
9. Set permissions to allow Local Launch, Remote Launch, Local Activation and Remote Activation. Now when OWS is launched by a Windows user with DOMAIN User privilege, they are listed in the OWS Supervisor.
Deployment Scenario 2:
DNA Server Deployed as a Workgroup. Operating System logged with Local Administrator account. DNA Client Connected to a Domain Controller. Operating System logged with Domain user priviledge account. Error Message: Failed to advise the Connection Point Corrective Action: For the message above, perform these settings: Firewall should be set to Off on the client machine.
The Domain User that logs in to Win XP Client should be added on to the DNA Server using Component Management > System Tools > Local Users and Groups > Users. (Do not use Administrator UserID since the DNA Server also has this ID). The UserId and the Password should match the Client Windows Operating System logon UserID and password. Perform the following steps using the Component Services of the Win XP Client: 1. 2. 3. 4. 5. From the Start Menu, select Run and then type dcomcnfg. Click OK. The Component Services dialog box displays. In the Component Services dialog box, select Component Services. Traverse to the path Computers>My Computer. Select the My Computer and right click to view Properties of My Computer.
200
Troubleshooting
6. 7. 8. Access. 9.
Click the COM Security tab. Under Access Permissions click Edit Limits. Under Permissions for ANONYMOUS LOGON allow Local Access and Remote Click Apply. Now when OWS is launched in Win XP Client with Windows Domain user, OWS Supervisor will work correctly.
Cannot connect Telephone number to access Verify that MD110 telephone to MD110. MD110 unavailable or incorrect. number is correct and available. Cannot open Communication device is being Close the other application using communication used by another application. the communication device or device. wait until the communication device is available. Selected communication device Specify a valid communication does not exist. device. Communication to this node is rejected because of mismatch in system identity. PBX system identity has been changed and does not match with the one stored in the database. Resynchronize data. If synchronize system identify only, you can synchronize Numbering Series.
Or, wrong communication node Check node configuration is defined. settings. Telnet is set for communication. Check the connection list via However, there is no IP Communications -> Define list. address set in the connection list.
No default attempt connection list is defined. DNA application will not be able to connect to MD with Telnet setting.
Cannot Logon to MD110 not completed Verify that the connection to the synchronize with due to problem with connection MD110 is good and verify that MD110. to the MD110 or the MD110 the MD110 is operating properly. itself.
201
Troubleshooting
Corrective Action
Communication Problem with connection to the Verify that the connection to the line blocked. MD110 or the MD110 itself. MD110 is good and verify that Communication the MD110 is operating properly. line failure. Data format error. Possibly caused by MD110 file system error. MD110 file system problem. Contact MD service personnel. Consider skipping data for that day (unrecoverable error).
Data format Noise in the communication line Retry the operation at a later error. Possibly between the PC and MD110. time. caused by noise. Data sequence error during data transfer. Database No SQL server connection operation failed available. or there was an error connecting to database server. SQL server is down or network connection is down. Data source is not set up correctly. Check event log for more specific error messages provided by the SQL server. Restart PDM. Verify that at least two connections are available. Verify that SQL server is up and network connection is OK. Verify that the data source is set up properly. Verify that the connection to the modem/TAU is good and verify that the modem/TAU is operating properly.
Error initializing Problem with connection to the modem, or modem/TAU or modem/TAU an error itself. resetting the modem. Failed to allocate memory. Not enough system memory.
Failed to create No disk space available on the Delete unneeded files from the temporary file. local drive. local drive to make space Failed to write to available. temporary file.
202
Troubleshooting
Corrective Action
Failed to get Network is down, or RDS is not Restart the network, and run data associated running. RDS on the server. with PMG from the logging server. Incorrect Communication parameters for Set up the communication communication the communication device are parameters to match the settings. not set up correctly. communication device. No character received from MD110 within time limitation. Time limit for MD110 feedback Increase time limit. Maximum is too short. 300 seconds (5 minutes). Time limit should be increased to reflect the size of the PABX switch (the larger the switch, the longer the time limit). Problem with connection to the Verify that the connection to the MD110 is good and verify that MD110 or the MD110 itself. the MD110 is operating properly. No prompt received from MD110. Logon to MD110 not completed Verify that the connection to the due to problem with connection MD110 is good and verify that to the MD110 or the MD110 the MD110 is operating properly. itself. Command to MD110 temporarily blocked. Resend command.
203
Troubleshooting
Error Message Possible Cause Unable to connect to database server. Unable to establish connection to database server. No SQL server connection available.
Corrective Action Check event log for more specific error messages provided by the SQL server, restart PDM, and verify that at least two connections are available.
SQL server is down or network Verify that SQL server is up and network connection is OK. connection is down. Data source is not set up correctly. Verify that the data source is set up properly.
User for database is not set up Verify that the user ID and password for database is set up correctly. correctly. Not enough space for the auxiliary database. Reinstall the database for PDM. Increase the size for the auxiliary database. You may want to back up the databases and restore them after reinstallation. Retry the operation later.
Unable to lock Database has been locked by database. PDM running on another PC. Database is used exclusively by other process.
Essential Requirements
PPM, like Microsoft Excel 2000, Excel 2002, or Excel 2003, requires an installed printer driver to function when connected to a printer.
204
Troubleshooting
Report Limitations
Although all traffic measurement data collected on the hard drive is stored in the SQL database, only objects related to Operators, Trunk Routes, Voice Extensions, PCM lines, PBX Hunt Groups, Cordless Extension Common Fixed Part, Cordless Extension Traffic and Mobility Function and IP Network Interface are available in pre-defined traffic measurement reports for PPM. Because PPM Lite is only a subset of PPM, only objects related to operators, Trunk Routes, and PBX Hunt Groups are available to PPM Lite. All traffic measurement reports generated from the Query Measurements panel are write-protected. You must save edited report worksheets under new filenames to preserve their contents and to distinguish them from the original files.
Excel 2000 and Excel The macro security level is 2002 - Launch PPM set too high. but only Excel is started Excel 2003 Launch The macro security level is PPM with Excel set too high. message Macros are disabled because the security level is set to High
Auto-formatted charts Incorrect print driver selected Use the Printers option for the do not print properly. or print driver not set up Windows Control Panel to properly. select a different printer or modify the printer setup. Cannot access SQL database. ODBC data source not set up Set up ODBC again. properly. PPM does not have access rights to one or more databases. Server goes down and the connection is damaged. Incorrect site database. Make sure that all databases set up by PDM and the different site databases grant the proper access to PPM. Exit and restart PPM to reestablish the connection. Use PPM Switch Sites option to select the correct site and database (primary or auxiliary).
205
Troubleshooting
Mobile Executive
The following table contains recovery information for phone error codes. Symptoms Failed to load Mobile Executive URL Error on Phone WAP ERR-500 Internal server error Possible Cause Make sure the MobileDNAObject.dll and CallEvetn.dll have been registered and assigned the correct permission (read + execute). Make sure the session.mdb has the correct permission (read + write), and the Mobile Executive logged on user's phone number is assigned in the DMG database. Make sure SQL server and RDS are running. Make sure SQL server is running
Failed to Logon
Failed to Logon
WAP ERR-408 Server timeout WAP ERR-408 Server timeout Error code: xxxx Failed to activate profile!
Make sure EMG is not running in the foreground on the same machine where Mobile Executive is installed, the MD connection is OK, and the SYSTEM user has been added in DNA User Configuration with EMG privileges.
206
Troubleshooting
Error on Phone
Possible Cause Make sure RDS is running and LDB files exist in \DNA_C or DNA_S\DDB\DATA.
No call handling license or IPService is not enabled The extension is not a mobile extension
The following values are recommended. CSTAEVENT (= 0) ENTERINGMETHOD (=1) events sent from AppLink to ACA. Stored if = 1, = 0 not stored LEAVINGMETHOD (=1) service requests sent from ACA to AppLink. Stored if = 1, = 0 not stored LOGFILE specifies where the log file is stored and the name of the log file (defaults to <eca directory>\bin\eca.log) PORTID (= 1f92 in hex, and 8082 in decimal) TRACE (= 1)
Extension xxxxx in node Request has failed due to x cannot be monitored AppLink is not running
207
Troubleshooting
Possible Cause Failure event received from AppLink. If getting this message continuously, check the ACA log for details. The connection between ACA client and IP Service has broken. This is usually due to the connection between IP Service and AppLink being broken.
Corrective Action Make sure AppLink is running. Find the failed event in eca.log. Also suggest to trace in CSTA log. Make sure AppLink is running. After problem is fixed, the ACA client should receive Communication to Call Event Service restored message.
To correct the problems, please re-synchronize extension data for the faulty extension through MD Support. 2. Backend component not configured properly The other possible cause is because EMG connection with PBX fails. The administrator must make sure EMG can be logged on with SYSTEM account and can connect with PBX successfully. Please refer to Configuration for Personal Number access section for details.
Trace
The administrator can turn on a log file to capture the errors if needed. Perform the following steps to turn on the log. Define the full path of the log file Specify the full path of the log file for Registry HKLM\SOFTWARE\Ericsson\ECA\CurrentVersion\DlinkLog E.g., c:\dna_c\eca\bin\Dlink.log Set the value of the following Registry keys to 1
HKLM\SOFTWARE\Ericsson\ECA\CurrentVersion\DlinkDebug HKLM\SOFTWARE\Ericsson\ECA\CurrentVersion\DlinkEntering HKLM\SOFTWARE\Ericsson\ECA\CurrentVersion\DlinkLeaving HKLM\SOFTWARE\Ericsson\ECA\CurrentVersion\DlinkWarning
208
Troubleshooting
Restart IIS Go to the command prompt and enter iisreset Use the following table to investigate the errors. For any errors not listed, send the log to support personnel for analysis. Error Message DnaLink.ocx CoCreateInstance Failed. Failed to create DnaLink.ocx object. Possible Cause Dnalink.ocx is missing or not registered. Corrective Action Check the file in \share\bin. Reinstall D.N.A. if file is missing. Register the file using Regsvr32 if file exists. Check the file in \share\bin. Reinstall D.N.A. if file is missing. Register the file using Regsvr32 if file exists. Make sure EMG is installed on D.N.A. Server and EMG can be lauched with System account. Turn on SQL Trace to get detail information from SQL Server side.
EmgMdConnect DnaLink.ocx failed to connect to EMG, node=XX ConnectToEmgDb() DnaLink.ocx failed to connect to EMG database. OCX_Error=XX, Node=XX GenerateTask failed OCX service stopped, TaskType=XXXX All other errors
Dnalink.ocx failed to connect to EMG. Check if EMG is installed. Dnalink.ocx failed to connect to database.
Check the file in \share\bin. Reinstall D.N.A. if file is missing. Register the file using Regsvr32 if file exists. Send the log to support personnel for analysis.
Service
IP Service is installed on the D.N.A. Server. Since this service interfaces with AppLink, it should be restarted if call handling becomes a problem.
Header Error
If you get a Header Error when attempting to access the Assistant Log from a client browser, make sure buffering is enabled on the D.N.A. Server. To enable buffering 1. Run Internet Information Services by selecting Start4Programs4Administrative Tools4Internet Services Manager.
209
Troubleshooting
2. In the Internet Information Services window directory tree, expand the server directory to display its subdirectories. 29. Expand the Default Web Site directory. 30. Click on the eca directory and click the Properties icon on the toolbar.
210
Troubleshooting
31. Click the Configuration... button in the eca Properties dialog box. 32. In the Application Configuration dialog box, go to the App Options tab.
211
Troubleshooting
Slow to logon
It will take longer to logon for the first ACA logon request. This is due to the backend EMG process which will be started by the first logon request if EMG/Personal Number flag is turned on by the administrator. However, if backend EMG connection to PBX failed, the logon will take even longer because ACA has to wait until the EMG connection request has returned. If EMG connection with PBX fails, the request will not return until time-out. The administrator must make sure EMG can be logged on with System account and can connect with PBX successfully.
Outlook or Lotus Notes Integration would not logon to the DNA Server
This problem is caused when there is no subscriber entry found with the current computer name (or User ID) defined in the D.N.A. Directory. Make sure you added the computer name(or User ID) to the subscriber's entry in the D.N.A. Directory.
Diversion information does not match between Outlook or Lotus Notes Integration and DNA
This problem is caused when the current desktop extension does not match the primary extension of the D.N.A. subscriber entry that has the computer name (or user ID) defined for that subscriber. Make sure the subscriber entry in the D.N.A. directory has the correct primary extension with the correct computer name (or user ID).
212
Troubleshooting
3) Identify the conflicting appointment(s). The conflicting appointment(s) will be displayed with a crossed-swords icon ( ). 4) Clear the conflicting appointment(s). Double click on each conflicting appointment to bring up the "Conflict Message" Dialog Box, and follow the instructions to clear the conflicting appointment.
213
214
Application Data
30 30 30 30 30 30 30 30 30 30 30 30 30
subscriber
215
Application Data
Field Name udf1_field udf2_field udf3_field udf4_field udf5_field udf6_field udf7_field udf8_field udf9_field udf10_field udf11_field udf12_field udf13_field udf14_field udf15_field udf16_field udf17_field udf18_field udf19_field udf20_field recID name dept_type_recID parent_recID child_recID sibling_recID udf1_recID udf2_recID udf3_recID udf4_recID sort_priority recID nodeID directory_number options primary_user_recID nodeID sitename nodename remote_nodeID remote_server options recID nodeID start_extension end_extension type options recID
Field Type varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar int varchar int int int int int int int int int int int varchar int int int varchar varchar int varchar int int int varchar varchar int int int
Max Characters 160 160 160 160 160 160 160 160 160 160 160 160 160 160 160 160 160 160 160 160 60
department
dept. record ID dept. name parent record ID child record ID sibling record ID UDF record ID UDF record ID UDF record ID UDF record ID sort priority ext. record ID node ID directory number user record ID
extension
site
50 50 30
node ID site name node name remote node ID remote server record ID node ID start extension end extension
numser
30 30
keyword
record ID
216
Application Data
Table Name
Field Type varchar int int varchar varchar varchar int int int int int int int tinyint varchar tinyint varchar varchar tinyint int varchar int int int int varchar int int int int int int int int int int varchar varchar int int varchar int int varchar
Max Characters 45
Description text value record ID dept. record ID address phone number name UDF record ID UDF record ID UDF record ID UDF record ID UDF record ID UDF record ID record ID
external_directory recID department_recID address listed_number name udf1_recID udf2_recID udf3_recID udf4_recID udf5_recID udf6_recID field_ definition recID SQL_type field_name field_type field_resid label_name record_type options table_name display_sequence UDF_number max_data_length char_fields recID value def_char_recID share_count department_recID subscriber_recID extension_recID subscriber_recID keyword_recID subscriber_recID recID nodeID trunkID trunk_name options groupID name access_codes recID nodeID exchangeID
160 30 50
30 30 30 20
dept. record ID sub. record ID ext. record ID sub. record ID keyword record ID sub. record ID record ID node ID trunk number trunk name display global group ID global name Table "access codes" for multiple tenants
20 30 30 30
global_name
20
217
Application Data
Table Name
Field Type varchar int varchar varchar int int varchar int varchar varchar varchar varchar int int varchar datetime datetime varchar varchar varchar it datetime datetime int int varchar varchar int int tinyint int int int int int int int int int int datetime int varchar
Max Characters 20 30 20
Description
deleted_id dept_recid_tmp
deleted table record ID temporary department record ID table extension dialing information
16
dial_extension_inf recID o country_code area_code prefix suffix options numser_recID dirdb_info schema_ver_no created_date released_date database_server database_server_ver_n odbc_ver_no recID start_time end_time duration reason_code reason_text cancel_text counter options status is_diverted_recID diversion_type dept_diversion_recID link_diversion_recID owner_appID repeat_type repeat_every repeat_type_day_0 repeat_type_day_1 repeat_type_day_2 repeat_type_day_3 repeat_end_time oper_div_recID
10 10 10 10
30 30 30 30
diversion
Message diversion
160 80
218
Application Data
Table Name
Field Type
Max Characters 60
Description
divr
nodeID pbx_reason_code dna_reason_code pbx_description dna_description tdn duration reference method options priority
int int int varchar varchar varchar int varchar varchar int int int varchar varchar varchar tinyint datatime int int int varchar int varchar varchar varchar int int int varchar varchar int int varchar varchar varchar varchar varchar int varchar varchar int varchar varchar varchar int int
10 30 1 40 30
message
recID msg_text cancel_text phone status when_received oper_msg_recID received_recID options operatorID recID userID external_extension sub_extension sub_recID status options name
160 80 30
outbound_dialer
reserved_id_table table_name reserved_flag ts_trans_codes portID ts_reason_code reason_code diversion_flag tdn ts_reason_text portID ts_msg_byte msg_byte
4 1 1 1 80 1 1 20 20 1
ts_msg_convert
time system
219
Application Data
Table Name
Field Type varchar varchar int int varchar int int varchar varchar varchar int int int varchar int int varchar varchar int datetime datetime int varchar int int int varchar int
Max Characters 10 20
user_search_acce recID ss userID department_recID vs_mail_box_no_r portID ange start_mail_box_no end_mail_box_no diversion_flag vs_message recID received_recID msgID mail_box_no portID
20
20 20 1
vs_reason_codes PortID reason_code reason_text sub_activation_ex subscriber_recID piration activation_time expiration_time options description vs_diversion rec_ID is_diverted_recID divID mail_box_no portID
1 80
subscriber to be activated time to activate time to expire 80 description of activation voice system diversion
20
220
Application Data
Field Type smallint smallint smallint varchar varchar smallint smallint varchar varchar varchar varchar smallint varchar varchar varchar varchar smallint smallint varchar varchar varchar smallint smallint smallint varchar smallint varchar varchar varchar varchar varchar varchar varchar
null null 5 5 null null 11 10 5 3 20 20 20 2 null null null null null null null null null null 5 5 5 null null null 5 null 8 8 9 6 1 11 1 null null null null null null null null
acdsup acgrp
extno groupno traffic limno queuelen service selcat qindchannel cust name1 name2 info pres sat aveconvtime bkgroupno
acmem
adn
221
Application Data
Table Name
Field Type smallint varchar varchar varchar smallint smallint varchar smallint smallint smallint smallint smallint smallint varchar varchar varchar smallint varchar varchar varchar smallint varchar varchar smallint varchar smallint varchar smallint int varchar varchar smallint smallint
Max Default Characters null 20 20 20 2 null null null null null 5 null null null null null null 4 20 20 64 5 5 10 20 64 null null null null null null null null null null
ancdgrp
ancd lim serv sel traf cust sat maxtim name1 name2 pres status
ancdmbr
anndesc
annnum annname
60
null null
apppam
pamnum pamval
authcode
222
Application Data
Table Name
Field Type varchar smallint smallint varchar varchar smallint smallint varchar smallint smallint smallint varchar varchar varchar smallint varchar varchar varchar varchar varchar varchar varchar smallint varchar varchar varchar varchar int char varchar varchar varchar smallint
Max Default Characters 5 null null null 7 6 null null null 5 null null null null 5 5 5 8 9 9 6 9 4 1 20 20 20 2 null null null null null null null null null null null null null null null
authcode2
auxana
extno prianano auxananext cat traffic service calldivcat routingcat addcat icat transcat cust name1 name2 info pres
9 20 20 20
null
223
Application Data
Table Name
Field Type varchar varchar smallint smallint smallint smallint varchar varchar varchar varchar smallint smallint smallint varchar varchar varchar varchar varchar smallint varchar varchar smallint varchar smallint varchar int smallint varchar varchar int varchar varchar
Max Default Characters 10 5 null null null null 20 20 20 2 null null null null null
cbgrp
channel
chgrp comabb
comabbdesc
comabbinfo
comabbno status
comdiv
10
compg
compgm
pageno
224
Application Data
Table Name
Field Type smallint int varchar varchar varchar varchar varchar varchar varchar smallint varchar varchar varchar int smallint tinyint varchar varchar varchar smallint varchar varchar varchar varchar varchar varchar varchar varchar smallint varchar varchar int
comsrvprf
10 12 8 6 3 60 5 8 13 48
cordless
corg
cpagrp
cpgrpno cpagrpno
cpgrp
groupno limno
csta cstagrp
cstaiodev
cstalgrp
linkgroupid iodevice
custinfo
custno
225
Application Data
Table Name
Field Name
Field Type
custname custmusic custno parkedann queuedann dat extno tau datcat traffic service termcat transcat routingcat devtype modgrp addcat datapool dpnum dpgrp dptype dayn route type extno trunk dcat catno traffic service termcat transcat routingcat descp deftfunc insttype keyno
varchar smallint smallint smallint varchar smallint smallint varchar varchar varchar varchar varchar varchar varchar varchar varchar smallint smallint smallint smallint varchar varchar smallint varchar varchar varchar varchar varchar varchar int varchar 3 8 2 10 14 2 30 5 6 8 2 10 14 2 10 5 6 5 5
226
Application Data
Table Name
Field Type varchar varchar varchar smallint smallint varchar varchar varchar smallint varchar varchar int varchar varchar smallint varchar smallint varchar varchar smallint varchar varchar varchar varchar smallint smallint varchar varchar varchar varchar varchar
Max Default Characters 3 5 5 null null 2 4 5 null 5 5 3 5 null null null null null null
dgrp
dgrpstatus
groupno used
dirpg
dirpgm
pageno psano
dnisnums
dnisnum used
dnisused
emdev emdevname
60 11 60 5 255
null
equloc
equpos location
null
extdesc
extno description
null
227
Application Data
Field Type varchar smallint smallint varchar varchar int varchar varchar smallint varchar varchar int smallint int int varchar varchar varchar varchar varchar smallint smallint smallint smallint smallint varchar smallint smallint smallint smallint varchar varchar
extpg
extpgm
pageno psano
gdgrp generic
groupno extno csp cust lim type name1 name2 info pres
5 5 null null 20 20 20 2 5 null null null null null 5 null null null null 9 3 null null null null null null
grprva
hgrp
228
Application Data
Table Name
Field Type smallint varchar varchar varchar varchar int int int varchar smallint varchar varchar varchar smallint smallint varchar varchar varchar varchar int smallint varchar varchar varchar varchar smallint smallint varchar smallint varchar varchar varchar
histtaskinfo
hot
icuequ
icuind equ
11 5 10 5
null
idiv
idivfrom idivto
null
indabb
ipext
isdn
229
Application Data
Table Name
Field Name roc adc acctyp cust name1 name2 info pres da
Field Type varchar varchar smallint smallint varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar varchar smallint varchar smallint int int int varchar varchar int smallint smallint varchar varchar varchar varchar
Max Default Characters 6 8 null null null null 20 20 20 2 5 5 5 2 2 2 5 11 2 5 16 null null null null null null null null null null
ivmbox
lvmsys
lang
idx name
lim marker
32 32
null null
mdmgrp mdn
5 5 3 1 null
230
Application Data
Field Type varchar varchar smallint int varchar varchar varchar varchar varchar smallint varchar smallint varchar varchar varchar varchar varchar varchar varchar varchar smallint varchar varchar varchar varchar smallint smallint varchar varchar varchar varchar varchar varchar
Max Default Characters 5 5 null 5 5 20 5 5 null null 5 null 9 8 9 6 1 11 1 3 20 20 20 2 null null null null null null null null null null null null null null null 5 5 3 5 3 3 null null null
mns
msgint
odn
extno catno traffic service calldivcat routingcat transcat addcat callalt insttype cust name1 name2 info pres datype lang
odnadn
odnfunc
231
Application Data
Table Name
Field Type varchar varchar varchar varchar varchar int char varchar varchar smallint smallint varchar varchar smallint smallint varchar varchar varchar smallint smallint varchar smallint smallint smallint smallint smallint smallint varchar smallint varchar varchar smallint
odntaut
operator
id equpos
11 5 5
null
pgagrp
grpcodeno pageno
pgchl
11 11
null
phyequ
pninfo
extno profile position answerno timeout busygoto frinternal froperator frpublic useonce
20
pnstatus
extno profile
priana
232
Application Data
Table Name
Field Name traffic service calldivcat routingcat addcat transcat insttype icat cust name1 name2 info pres
Field Type varchar varchar varchar varchar varchar varchar varchar varchar smallint varchar varchar varchar varchar smallint smallint smallint varchar varchar varchar varchar smallint smallint char char smallint smallint smallint int int smallint smallint varchar varchar
Max Default Characters 8 9 9 6 9 1 4 4 20 20 20 2 null null null null null null null null null null null null null
psarea
rfp
bpos rpn
route routrunk
id id equpos route_id
11 11
null null
rvadata
rvamsg
msgnum msgname
60 5
null null
satgrp
sat
233
Application Data
Table Name
Field Name
Field Type
ancd node oflno inftyp ofltim ovflow sms extno msgserver iodevice sms1 extno msgserver lim ip port spext extno specexttype taskinfo taskid batchid procid procinfo status resultdesc taufunc extno keyno value dig usedext extno type equpos vcat catno traffic
varchar smallint varchar varchar varchar smallint varchar int varchar varchar int int varchar varchar varchar int int int int varchar smallint varchar varchar varchar varchar varchar varchar smallint varchar smallint varchar 8 11 255 5 3 5 20 5 2048 14 5 1 1 20 5 5 5 10 1 4
null
null null
null
null null
null null
null null
null
234
Application Data
Table Name
vmport
Application Data
Table
pagext pagsar pbxgrp pcmlin roubwy rouddi roudio rouinc rouout tone_r Trunks
Paging number Paging search area Internal group hunting group number PCM line Both way (incoming and outgoing) route Direct indialing route Direct indialing outgoing route Incoming route Outgoing route Tone receiver Individual trunk
D.N.A. Directory Manager Directory Manager is a day-to-day administrative Application application for both populating and managing the contents of Operator Workstation subscriber records.
236
Application Data
237
Application System Parameter ASPAC Authorization Code System Time Common Bell Group Call Diversion Charging Cordless Extension CSTA Data Group AUCOE AUCOI CATII CBCAC CBELI CBGME CBGMI CDCOE CDCOI CDINE CDINI CHGME CHGMI CXAKE CXAKI CSTPE CSTPI CSTLE CSTLI DGCAC DGGME DGGMI DGGRE DGGRI
238
MML Commands
Functional Grouping
Commands
Data Extension DNIS Analogue Extension Generic Extension Group Do Not Disturb Internal Group Hunting Group Call Pickup Common Service Profile Data Category Voice Category Integrated Voice Mail
DTCAC DTCCS DTEXC DTEXE DTEXI DTFUI ACTNI ACTNE EXCCS EXCAC EXCUC EXDPC EXTEE EXTEI GEDIC GEDIE GEDII GDNDE GDNDI GHCAC GHGME GHGMI GHGRI GPAGE GPAGI GPGME GPGMI GESPC GESPE GESPI DTCCS EXCCS IVBOI IVMAI IVMAE IVBOE
Interception Service & Message ISEPE ISEPI Waiting ISDN Terminal Digital Key System Telephone ITCAC ITCUC ITNUE KSANE KSANI KSCAC KSCAP KSCUC KSDDP KSEXE KSEXI KSFKC KSMDE KSMDI Name Identity/Call By Name Night Service Paging NIINE NIINI NSCOI NSCOE PAALE PAALI PACAC PACHE PACHI PAGIE PAGII PASAE PASAI PEALC PELPC PELPE PELPI RODNE RODNI SPEXE SPEXI
239
MML Commands
Functional Grouping
Commands
Voice Mail
VMPOE VMPOI
Recorded Voice Announcement RADSE RADSI RAGAI RAGAE RAGAC RAMDE RAMDI Music On Hold Per Customer IP Extension Mobile Extension Short Message Service CUMHI CUMHE IPEXI IPEXE IPEXC REEXI REEXP REEXE NUTRI NUTRE BC12: CXSYI CXSYC CXSYE MSCOI MSCOE BC13: MSCOI MSCOE MX-ONE 3.1: sms_server_initiate sms_server_end Note: PELCS command is not supported in EMG.
MD Support Utility
The D.N.A. Server MD Support Utility uses the following MML commands in its communications with the PBX. Note: Only a subset of these commands is available in the MX-ONE. Please consult the MX-ONE O&M for details. Functional Grouping Calendar Data and System Identity Digital Extension Analog Extension Data Extension ISDN Extension Number Series Name Identity Commands CADAP
KSCAP KSDDP KSTSP KSFKP KSMDP EXCAP EXDDP EXCCP DTCAP DTCCP DTDDP DTFUP ITDAP NADAP NIINP
240
MML Commands
Functional Grouping Group Hunt Automatic Call Distribution Automatic Network Call Distribution Common Bell Group Operator Data Group Modem Group Charging Group Group Call Pickup Group Do Not Disturb Account Code
Commands GHDAP ACGMP ACGCP ACPAP ACBGP NCNOP NCICP NCGRP NCGMP NCGSP NCSGP CBDAP OPDDP OPCGP OPRSP DGDAP MGMGP CHGMP GPDAP GDNDP AOCOP account_code_print (for BC release greater than MX-ONE 2.0)
Authorization Code
Intercept Computer
ICFUP
Recorded Voice Announcement RAGAP RAMDP Special Purpose Extension Trunk Paging Abbreviation Call Diversion SPEXP RODNP ROCAP ROEDP RADSP RADNP PAEDP PADAP PAALP ADCDP ADIDP CDIDP CDCDP
241
MML Commands
Functional Grouping Voice Mail Message Interception Computer Support Telephony Applications
Application System Parameters ASPAP Configuration System Data Group Junction Lines Program Correction Log Print System User Information Generic Extension Cordless DNIS Personal Number Number Conversion I/O-Data Integrated Voice Mail Customer Music On Hold IP Extension Mobile Extension Short Message Service CNPIP CNLIP CNBIP SYEDP SYEVP GJLCP PCLOP SUDIP SUSIP GEDIP GESPP CXAKP ACTNP PELPP NUTRP IONCP IVMAP IVBOP CUMHP IPEXP REEXP BC13: MSCOP MX-ONE 3.1: sms_server_print
242
MML Commands
243
MML Commands
Functional Grouping Tone Receivers Read traffic measurement data from MD110 HDU
Specify Cordless Extension Common Fixed Part TRCFI Cordless Extension Traffic for BC11 or later IP Network Interface for BC11 or later TRCFI TRIPI
244
MML Commands
cb - Common Bell Group dg - Data Group mg - Modem Group ch - Charging Group gh - Hunt Group ad - Automatic Call Distribution ancd - Automatic Network Call Distribution rvagnac - RVA Group Announcement rvamdat - RVA Message Data
245
MML Commands
loc - Location Code numconv - Number Conversion lim - Line Interface Module pripubpref - Private/Public Prefix
Examples
To synchronize all information in node 1: MDS.EXE /site:1
Make sure to check the option Activate Using the Current Logged-In DNA Account. 34. When RDS Schedule invokes MDS, it will pass to MDS the schedule identifier that MDS uses to retrieve from the Registry the account identification. Internally, MDS uses this account to log in to D.N.A.
246
Question: What does the extension category in Directory Manager stand for? Answer: In Directory Manager, the extension category is shown in the Subscriber window. When you select an extension from the Extension to Add list box, the category is shown in the Category list box. If you add a new extension, you may choose a category for it by using the Category list box. Categories apply to all extensions, not just primary extensions.
247
The extension category was implemented to integrate Directory Manager and Operator Workstation with PSC. Directory Manager and Operator Workstation treat the extensions the same regardless of their categories. Since Directory Manager or Operator Workstation does not use the extension category, it is not shown at all in Operator Workstation, and it is not shown prominently in Directory Manager. Directory Manager just provides an easy way to assign a category to a new extension so that PSC can use the category.
D.N.A. Server
Question: Why do I repeatedly see the warning "PBX watchdog timed out" in the event log? Answer: This warning shows up if the PBX Service is running but does not have a connection to the MD110 via a CT-adapter. If you do not plan to use OWS on your D.N.A. Server you can stop the messages by running the OWS / PBX Extension Line control panel program and set the com port to none.
Extension Manager
Question: How do I configure programmable/nonprogrammable buttons, LEDs and text strings for buttons on the phone layout to be displayed in EMG? Answer: A data file is used to store information about the phones characteristics, which include the phone size, programmable/nonprogrammable buttons, LEDs, and text strings for buttons. Phone data files are stored on the client machine in DNA_S\EMG\DEF. The following rules are used to describe the phone: 1 Comment line An entry start # is a comment line 2 Dimension of the instrument (single entry) Format: s w h where w, h are width and height of the instrument in pixels. 3 Pure text object (multiple entries) Format: t x y, string where (x, y) is the coordinate to draw the string 4 Non-programmable button (multiple entries) Format: n x y w h, string where (x, y) are coordinates and w, h are width/height of the object. String is the text to be displayed on the button.
248
5 Non-programmable button with round LED (multiple entries) Format: nl x y w h, string where (x, y), w, h and string are the same as those described in 4. 6 Non-programmable button with rectangular LED (multiple entries) Format: nr x y w h, string where (x, y) w, h and string are the same as those described in 4. 7 Programmable button (multiple entries) Format: i x y w h x2 y2, string where (x, y), w, h, and string are the same as those described in 4. (x2, y2) are the coordinates to draw the function name assigned to the button. 8 Programmable button with round LED (multiple entries) Format: il x y w h x2 y2, string where (x, y), w, h, (x2, y2) and string are the same as those described in 7. 9 Programmable button with rectangular LED (multiple entries) Format: ir x y w h x2 y2, string where (x, y), w, h, (x2, y2) and string are the same as those described in 7. 10 Pure rectangular LED (multiple entries) Format: l x y where (x, y) is the coordinate to draw the LED.
Operator Workstation
Question: What kind of local databases does Operator Workstation use? Answer: The LDBs have *.DAT and *.NDX files (like FoxPro) but they are in an Aastra specific format. The local database files are a binary tree based design implemented by Aastra. It is not based on any commercial products. You cannot read it with any 3rd party applications. To refresh the local databases try to delete the following files: \DNA_C\OPI\DATA\ *.DAT and *.NDX and restart Operator Workstation. Do not delete the *.OWS and the *.STG files because they are the configuration files for each user account in Operator Workstation. If the *.DAT and *.NDX files are not rebuilt again you will have a problem with your network or your RDS Service.
249
35. Do not delete the *.OWS and the *.STG files because they are the configuration files for each user account in Operator Workstation. If the *.dat and *.ndx files are not rebuilt again you have some problem with your network or Remote Data Server. Problem: Operator Workstation application crashes (fails) within 5 hours of startup in a configuration where an English language Windows server is running with a Norwegian Windows workstation. Solution: The problem is in the default configuration of the Norwegian Windows Workstation and the English Windows Server. When installed, they default to Disable Distributed COM. To solve this problem: 1. Login as the Windows Administrator. 2. Run DCOMCNFG.EXE. You should find this file under the WINNT\System32 directory. 36. In Default Properties, select Enable Distributed COM. Enabling this flag eliminates this Operator Workstation crash problem.
Question: How does the receipt function in the Operator Workstation messaging dialog box work? Answer: If a MAPI session has been established, the Snd Rcpt key sends the message with a request for a return receipt. If the recipient's mail system honors the request, the operator's mailbox receives a message when the recipient opens the message from the operator. If sender and receiver both use the same mail server or post office (i.e., Microsoft Exchange Server or Microsoft Mail with a work group post office) return receipts are quite reliable. If one or both parties use SMTP mail, the results are less reliable.
250
If the receiver is using Outlook with preview, it is possible for the message to be read without being opened. In that case, the return receipt is not sent until the message is either opened or deleted. If it was read in a preview and then deleted, the return receipt will say that the message was deleted without being read! Question: What is the function of the Operator Workstation meter key? Answer: Call metering requires hardware support on the MD110. If the MD110 is equipped with pulse counters and the public exchange uses metered trunks, then the operator can request that trunk calls be metered and get the pulse count (which represents time and charges) when the call ends. The count is displayed in the dial box. If the system does not support metering, pressing the meter key just displays Meter in the dial box, and then VACANT in the speech window. In this case, it is better to program some other function for the key.
251
252
E1186 - Remote Data Server Unexpectedly Terminated - Switching Over To Standby Remote Data Server This log entry indicates that the standby Remote Data Server has taken over the RDS business. The new active RDS spawns for another standby process to monitor it. Unfortunately, the new active RDS is now running as a process and not as a service. This is because it is not possible to run two instances of the same service simultaneously. However, starting from Windows 2000, the operating system provides support for restarting failed services. This provides equivalent functionality as the Standby Remote Data Server and is the preferred alternative. Open the RDS service properties in Windows Service Control Manager and display the tab called Recovery. Set First, Second, and Subsequent failures to Restart the service. Set reset failure count after 1 day and restart the service after 0 minutes. Save the configuration. Open RDS Configuration and disable Standby Service. Question: How does the Standby Remote Data Server work? Answer: If (for example) RDS crashes, it switches over to the standby side and generates a DrOhan.log crash dump file under WINNT directory. You will also get the following message in the Event Log. Question: Why do some MD110 PBXs fail to properly clear and/or update active diversions, even when the RDS service has been verified as running? Answer: In BC11 SP2 and later, a new code (04) exists in the GICI protocol. The 04 will trigger a 54 response from the MD110 (DIM clears active diversions before sending 54). Check for presence and proper value of the following Registry key:
HKLM\SOFTWARE\Ericsson\MRS\RemoteDS\Manager\ EnableDNAGICIInitiateUpdateRequestToPBX
Format: N/A Value: [REG_DWORD] 0=disabled (default value); 1=enabled For a previously installed D.N.A. server, the administrator needs to start the RDS service at least once for the Registry key to be created (with the default value). If the Registry key value is subsequently modified, the RDS service must be stopped and restarted for the changes to take effect. Note that this Registry key supercedes:
HKLM\SOFTWARE\Ericsson\MRS\RemoteDS\Manager\EnableDNAGICIUpdatesTo PBX If EnableDNAGICIInitiateUpdateRequestToPBX is set to 1, then EnableDNAGICIUpdatesToPBX will be ignored, since it is no longer relevant.
253
The optional SCS service (a.k.a. GICI Server) in D.N.A. was designed for that purpose. It allows multiple D.N.A. servers to share the same GICI port and it also allows a third party Interception Computer to share the same GICI port. It is however not recommended to run multiple diversion and directory systems due to the overhead in work with updating two systems instead of one.
You need to add the value: Ba tc hTi m e , DWor d , and enter the hour in hexadecimal. Example: Enter Ba tc hTi me =0 A if you want to start PDM downloading at 1000 Hours. Question: How does PDM work in BATCH mode? Answer: Is it possible, in a multi node environment, to extract data from only a certain node? For example, in a two-node system the second node is created for future use. When PDM.EXE BATCH is scheduled, PDM is also trying to extract from node two, witch results in errors because there is no MD110 to connect to. However, it is possible to select the desired node to poll.
Example:
HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson\PMG\<computer name>Siten
2. Add the key Sk i pSi te s with the string of the nodes you want to skip separated by commas (",") under the key created in Step 1. Example: If there are 5 nodes and only nodes 2 and 4 should be polled, set the Registry string to 1,3,5, (end with a ",") Question: Which account is used for PDM in batch mode? Answer: In User Configuration you can allow or disallow a User to use PDM for a certain node. PDM polling however bypasses this D.N.A. security feature.
254
Release Information General release version of DNA 5.3 and BC12.1, and MX-ONE support. General release version DNA 5.4 and MXONE Telephony System Telephony Server (TSE). General release version DNA 5.6 and MXONE Telephony System Telephony Server (TSE).
DNA 5.6
MD110
Question: What ASPAC parameters are available for operator functions? Answer: The following table list ASPAC parameters. ASPAC 2 9 Format PARNUM=2,PARVAL=DDDDD PARNUM=9,PARVAL=DDDDD Range 0 - 32768 seconds 0 - 32768 seconds Description Time before recall to PABX operator from a parked party. Time before a PABX operator is recalled, after a call is extended to a busy extension. Time before a PABX operator is recalled on no answer, after a call is extended to a free extension. Time before a call in the common operator queue is indicated by a flashing common queue counter on an alphanumeric console. Time before calls in the individual PABX operator queue will be indicated as delayed. Time before a PABX operator is marked as absent after automatic call acceptance. Time before a PABX operator is marked as absent automatically when an indicated call is not answered. PABX operator call extending by means of Loop keys. Automatic and manual recall of the PABX operator after parking an external call Intrusion on a party with an external call. Maximum time a PABX operator can reserve an extension after conversation is complete.
10
PARNUM=10,PARVAL=DDDDD
0 - 32768 seconds
14
PARNUM=14,PARVAL=DDD
15
PARNUM=15,PARVAL=DDD
10 - 100 in 0.5 second units 100 - 10000 in 0.2 second units 50 - 6000 in 0.2 second units
16
PARNUM=16,PARVAL=DDDDD
17
PARNUM=17,PARVAL=DDDD
33 34
PARNUM=33,PARVAL=D PARNUM=34,PARVAL=D
0 - not allowed, 1 allowed 0 - manual, 1 automatic 0 - not allowed, 1 allowed 0 - 32768 seconds
36 38
PARNUM=36,PARVAL=D PARNUM=38,PARVAL=DDDDD
255
ASPAC 39
Format PARNUM=39,PARVAL=DDDDD
Description Time before a PABX operator is recalled, when a call is extended before answer to a paged extension. Maximum time a PABX operator can reserve an extension before ringing. PABX operator forced release of third party after intrusion. Request for camp-on busy facility for PABX operator calls over public ISDN. Choice of clock format on PABX operator console and DTS. Manual and automatic ringing for Operator Workstation. PABX operator can extend to busy extension without call waiting category. Common PABX operator call queue size.
40
PARNUM=40,PARVAL=DDDDD
0 - 32768 seconds
57 76
PARNUM=57,PARVAL=D PARNUM=76,PARVAL=D
0 - not allowed, 1 allowed 0 - not allowed, 1 allowed 0 - 12 hour, 1 - 24 hour 0 - manual, 1 automatic 0 - yes, 1 - no
195
PARNUM=195,PARVAL=DDD
Registry
Question: What are the following Operator Workstation Registry keys used for? Answers:
HKLM\SOFTWARE\Ericsson\OPI\CurrentVersion\Number
This key holds a prefix number that will be dialed before the directory number of the subscriber selected in the directory list box. A typical use is to enable an easy way to override diversions.
HKLM\SOFTWARE\Ericsson\OPI\CurrentVersion\UseAltSpelling
This key is intended to control the display of the closest matched names in the directory. Previous versions of Operator Workstation showed only the first and last names in the directory list box, even when the name that caused the match was an alternate spelling. The default is now to show the name that matched, surrounded with pairs of asterisks. By setting this Registry value to 0, the name display reverts to the pre-D.N.A. 4 method.
HKLM\SOFTWARE\Ericsson\OPI\CurrentVersion\Secrecy
This key holds the feature access code for the Business Phone secrecy feature.
HKLM\SOFTWARE\Ericsson\OPI\CurrentVersion\ActivateMapiDialog
When this value is set to 1 and MapiResolveName fails the MAPI dialog is displayed to permit the user to choose an email address.
HKLM\SOFTWARE\Ericsson\OPI\CurrentVersion\SendMessageOnCancel
256
The default value for SendMessageOnCancel is 1. When set to 1, a message is sent when the MAPI Resolve Name dialog box is displayed and the user clicks the Cancel button. The ActivateMapiDialog Registry item must also be set to 1 to display the MAPI Resolve Name dialog box.
ClockSync
Question: Does anyone know what happens if you have more than one ClockSync Server running on the network? How does a specific client know which ClockSync Server it needs to read? I do not see a computer name in the ClockSync part of the Registry. When you have both a CCM and a D.N.A. server present in one Windows domain, how will the CCM clients know that they need to use CCM server ClockSync, and vice versa for D.N.A. clients? Answer: It is OK to have multiple ClockSync servers on the network. The ClockSync server on which they were installed will update the clients. This is defined in the Registry in:
HKLM\SYSTEM\CurrentControlSet\Services\ClockSync\Parameters \ServerMachineName
The use of Windows named pipes means that the time request event is directed. ClockSync does not use TCP/IP Broadcast packets to send out the time. If you have two servers (CCM and D.N.A.) each with a ClockSync Server process (EnableServer in the above key is 0x1), you could change one to be a client of the other. For example, change CCM server machine to be a ClockSync client of the D.N.A. server, and then change all the CCM client machines to ask the D.N.A. server for time updates. If you change the CCM server and not the CCM clients, then they will not get the updates. Note: A ClockSync client cannot also act as a server.
SNMP
Question: I started one or more of the services that are flagged as manual start but they didn't show up in EVM, what's wrong? Answer: EVM, SNMP and DMI don't know which services are installed until they are started for the first time, due to a limitation in DMI that won't be propagated to EVM if the DMI runtime is already running. The solution is to briefly stop and then restart the CIMgr service. From that point on, all components will be aware of its existence whether it's running or not.
Export
Question: When will Export.exe export the confidential UDF fields? Answer: Export.exe will export confidential UDF fields when it's running in: Interactive mode Batch mode with the "/c" switch (e.g., from the command prompt, enter export batch /c). The only case when Export.exe will not export the confidential UDF fields is when it is running in: Batch mode without the /c switch (e.g., from the command prompt, enter export batch).
257
Note: A confidential UDF field is a UDF field defined in the Confidential tab in Directory Configuration.
258
Chapter 15 Configuration
Networking (SNMP) Access Agent
The SNMP Agent for MD110 consists of two functional elements: Access Agent SNMP Agent This guide only explains the Access Agent, the only element used by the D.N.A. Application Suite. (The SNMP Agent element is used in D.N.A. Node Manager.)
259
Configuration
(0 . 0. 0 .0 fo r n on e ) [2 55 . 25 5 .2 55 . 19 2 ] E th e rne t Ma ximu m Tra n smissio n Un it ? [1 50 0] Do yo u wan t a P PP int e rf a ce ? [ N] S ho u ld t he re be a d ef au lt ga te wa y f o r p a cke t rou t ing ? [Y ] Wh a t is it s I P a dd re ss? [ 16 4 .4 8. 7 1. 1 29 ]
260
Configuration
# A configuration row has the following format, and the items must # be separated by space: # # <symbol> <comport> <baudrate> <databits> <parity> <stopbits> <flow> # # <symbol> : Any symbolic name (maximum 50 character). Used to identify # a port configuration. # <comport> : Communication port COM1,COM2 and COM4. # COM3 may be used but are reserved for MD110 or BIM. # <baudrate>: 300, 600, 1200, 2400, 4800, 9600, 19200 or 38400 # <databits>: Number of databits; 7 or 8 # <parity> : e = even, o = odd, n = no parity # <stopbit> : Number of stopbits; 1 or 2 # <flow> : Software or hardware flow control; XON/XOFF, CTS or NONE # # EXAMPLE: # Configuration:mml COM1 9600 8 n 1 XON/XOFF # Start tncom:tncom mml #------------------------------------------------------------------mml COM1 9600 8 n 1 XON/XOFF mml COM2 9600 8 n 1 XON/XOFF gici COM3 9600 8 n 1 XON/XOFF 7. Type put comport.cnf to overwrite the file in your Agent with the updated version. Note: "mml" and "gici" must be lower-case!
Features in Agent
Agent has the ability to work with more than one login account. The default login account with version 1.0.x was "agent/spectre". Administrator Agent Box account is "root/sysadmin". You cannot delete the Administrator Agent Box account; you can only add new accounts. There is a possibility to change the root/sysadmin account, but we do not recommend this. If you want to change the configuration of the Agent box, you can also do this remotely via Telnet (without the need of connecting to COM4). You can do this by typing the command "CONFIG" after the $ prompt. Note: You must use <Ctrl> + J instead of <Enter> !
261
Configuration
262
Configuration
Service
Port
Type
Description
auth auth ntp nntp ntp netbios-ns netbios-dgm Netbios-ss sqlsrv snmp snmp snmptrap snmptrap bgp imap3 imap3 exe login who cmd syslog
113 113 119 123 123 137 137 150 156 161 161 162 162 179 220 220 512 513 513 514 514
TCP TCP TCP TCP UDP ? ? ? ? TCP UDP TCP UDP ? TCP TCP TCP TCP UDP TCP UDP
Authentication Service Authentication Service Network Transfer Protocol Network Time Protocol Network Time Protocol NetBIOS Name Servicer NetBIOS Datagram Service NetBIOS Session Service SQL Server SNMP SNMP SNMPTRAP SNMPTRAP Border Gateway protocol Interactiv Mail Access Protocol Interactiv Mail Access Protocol Remote process execution Remote login Remote who (rwhod) Remote command (rsh) System Log Facility
263
Configuration
Service printer talk talk ntalk ntalk router uucp uucp uucp-rlogin uucp-rlogin klogin klogin pmd pmconsole radius radacct
Port 515 517 517 518 518 520 540 540 541 541 543 543 1642 1643 1645 1646
Type TCP TCP UDP TCP UDP UDP TCP UDP TCP UDP TCP UDP TCP TCP UDP UDP
Description lpd spooler Terminal to terminal chat Terminal to terminal chat Newer version of terminal to terminal chat Newer version of terminal to terminal chat RIP UNIX to UNIX Copy UNIX to UNIX Copy a different variant of UNIX to UNIX Copy a different variant of UNIX to UNIX Copy Kerberized login Kerberized login PortMaster daemon in.pmd PortMaster Console Protocol Remote Authentication Dial In User Service RADIUS Accounting
264
Configuration
Note: Client-side browsers will not automatically trust the certificate that you generate since it is not a well-known CA such as Verisign, however they will still work.
NTFS Permissions
The NTFS permissions needed for D.N.A. web applications files and directories are also granted to the IUSR account during D.N.A. installation. The NTFS permissions set are: Directories \dirb\data NTFS permission Modify D.N.A. Applications Aastra Communications Assistant, ACC, and Mobile Executive Mobile Executive PPMLite
\mobileexec\bin \ChartJPEG
Modify Modify
Configuration
2. Configure according to the following screenshot. (Enter your own password and remember it!) Once configured, the AastraWeb account can be used for other Aastra Web applications as well.
266
Configuration
3. Assign the AastraWeb account to the proper groups, Administrators, Users and IIS_WPG. IIS_WPG is a Windows 2003 account group that allows the user privilege to run an IIS 6.0 application pool, called a service account.
267
Configuration
268
Configuration
2. It will pop up a dialog prompting you for the application pool ID. Enter AastraWebPool and select the first radio button that uses the default settings.
3. Once the application pool has been created, right-click on AastraWebPool and select Properties. In the Identity tab, select the second radio button and specify the AastraWeb account that was created earlier. Enter in the correct password. Click OK. It will then ask you to reconfirm your password. Type in your password and click OK again.
269
Configuration
4. Make sure that the application pool has been started by refreshing the IIS Manager view (i.e., click on the Action menu and then Refresh). A started application pool will have an icon with green arrows overlaid on top. A pool that has not been started will have a red x overlaid on top of the icon (possible cause could be that an incorrect password was entered). Please make sure it is running properly.
270
Configuration
271
Configuration
Reset IIS
Go to the command prompt and enter iisreset. Wait until it is finished and then test the D.N.A. Web applications to make sure they are working as expected.
272
Configuration
1. The AastraWeb account created in section D.N.A. Server and Web Application on the Same Machine is a local account on the ACA Server. For this scenario, the AastraWeb account needs to be created as a domain account. Instead of creating the account on the IIS 6.0 server, create it on the domain controller. For example, on the domain DNA, the user would be accessed by specifying DNA\AastraWeb. 2. Once the domain account has been created, on the IIS server, add DNA\AastraWeb to the IIS_WPG account group. 3. Follow the steps in Create Custom User Identify and Assign NTFS Permissions sections and specify the domain account DNA\AastraWeb as the user identity for the application pool and the anonymous identity. Again, make sure the correct permissions are assigned to the data directories for this new domain account. 4. Verify that D.N.A. Web Applications are working properly.
273
Configuration
System Component IP Service PBX Service Security Data Service (SDS) Remote Data Service (RDS) GICI SMTP Time System Service (TSS) Voice System Service (VSS) Service () Ows Supervisor Service Local Data Service (LDS) Serial Communication Service (SCS) LDAP Service
Comment Default value (can be changed via CSTA GUI). Uses COM-port (not connected to the network). Uses Windows named pipes. Uses Windows named pipes. Port value is set in RDS Configuration. Default value (port value is set in RDS Configuration). Uses Windows named pipes. Uses Windows named pipes. Uses Windows named pipes. Uses DCOM (i.e., ports in the range 1024 to 65535) Uses Windows named pipes. Uses Windows named pipes. Default value (can be changed via LDAP Server Configuration). Default value. Telnet session. Default value. Telnet session. Default value. Telnet session. Default value (can be changed via GUI). (Serverport) Default value Multicast Default value (can be changed via GUI). Call control and Intercept calls.
Potential Clients Application Link (via CSTA client) CT-Adapter D.N.A. Client applications (via LFS) RDS, LDS, D.N.A. client applications. MD110 SMTP E-Mail Server RDS RDS RDS OWS Supervisor application, RDS RDS RDS LDAP Server
Extension Manager (EMG) MD110 Support (MDS) Performance Data Manager (PDM) Enterprise License Manager (ELM)
23 23 23 2580
SDS IIS
274
Configuration
System Component
Port 80
Comment Default value (can be changed via GUI). Logon and Search, using HTTP. Default value (can be changed via GUI). Logon and Search, using HTTPS (SSL). Uses Windows named pipes. Default value (can be changed via GUI). Call control and Intercept calls. Default value (can be changed via GUI). Logon and Search, using HTTP. Default value (can be changed via GUI). Logon and Search, using HTTPS (SSL). Microsoft CDO Uses Windows named pipes. Default value Uses UDP. Default value (can be changed via Registry or ACC.CFG configuration file). Uses UDP (PortRAS). Default value (can be changed via Registry or ACC.CFG configuration file). Uses TCP (PortCallSignal). Default value. ESSP communication with MD110. Uses UDP. Default value. Dynamically allocated (can be changed via Registry or ACC.CFG configuration file). RTP packets, using UDP. (PortRTP) Default value. Dynamically allocated. RTCP packets, using UDP.
443
WAP Device
80
ACA Clients
443
IIS
Exchange Server RDS H.323 Gatekeeper Discovery H.323 Registration and Status
1720
9200
ESSP Control
2326 2444
2327 2445
275
Configuration
System Component
Port 80
Comment Default value. Can be changed via GUI. Logon and Search, using HTTP. (PortDNAIIS) Default value. Can be changed via GUI. Uses HTTP. Default value. Can be changed via GUI. Uses HTTPS (SSL). ADSI Logon. ADO TM data retrival Default value. Can be changed via GUI. Search, using HTTP. Default value. Can be changed via GUI. Search, using HTTPS (SSL).
80
Web browser
443
Web browser
443
276
Configuration
2. Enter the Node ID that will be used for call handling and/or diversions. Enter the AppLink Server that is the name of the PC where AppLink is installed for the selected node. Enter the Port number used for AppLink connection. It defaults to 2555. Click OK to save your configuration. To set up IP Service settings Turn on ACA log
277
Configuration
1. Specify the log file name and full path. Defaults to <D.N.A. directory>\eca\bin\eca.log. It is used to trace the events between the IP service, the browser, and AppLink events. 2. Define IP Service port number The default port number is 8082. To set up Access Code Define the leading dialing codes for Local, Long distance, and internal calls for outbound dialing use.
Free Seating This feature allows user to logon to an extension other than his/her primary extension during the current session. This means user will be logged with primary extension next time. This feature is off by default. Show node number This feature allows showing node number in addition to extension number. It is on by default. Wait Time after Diversion response from Data Server
278
Configuration
ACA Server interfaces with Data Server i.e either LDS or RDS for message diversion. After ACA Server receives message diversion response from Data Server, it needs to wait for enough time to ensure that the Data Server processes the message diversion request on the switch. After this wait time, ACA Server will send the proper message diversion details to the ACA client. This wait time depends on various parameters like performance of Data Server, connection between Data Server and the switch, and performance of switch. ACA Server will rely on the wait time specified here in seconds. The default is 5 seconds. User defined information page Administrator can create a page to provide information for users having logon problems. In the Aastra Communication Assistant Configuration utility, enter the link to an information page in the User defined information page edit box. When it is defined, a link entitled "Having trouble logging on?" appears on the Logon page. Default language Administrator can choose the default language. This language will be used for the ACA pages without logging on and first time logon. User can choose his/her own desired language after logging on. The selected language will be the language used each time you log on. The language is set to English by default. Show diversion notes This feature allows ACA users to view diversion notes, if available. It is off by default. EMG is installed and Personal Number is used ACA personal number features is handled by the backend EMG process. Do not turn on this feature unless EMG is installed on the D.N.A. Server and personal number feature is used. Otherwise, the ACA logon process will be slowed. If this feature is on, refer to Configuration for Personal Number access. Internal directory name Administrator can define the preferred directory name for Local D.N.A. internal directory. This name will be used for Directory drop-down list for search. External directory name Administrator can define the preferred directory name for Local D.N.A. external directory. This name will be used for Directory drop-down list for search. Personal Directory ACA supports personal contact search for Outlook only. If Personal Directory is set to none, personal contact will not be available in the Directory drop-down list.
279
Configuration
To test EMG communication with PBX It is important to make sure EMG, running on the D.N.A. server, can connect with the node(s) on the ACA Server. Launch EMG and logon with SYSTEM Setup Communications and connect to all the nodes grant to System account Note: If a user credential, such as NIU Login User Name and Exchange Password, for connecting to a node from MD Support is changed, it is mandatory to connect to the node and synchronize at least one feature. Close all ACA and ACC clients and make sure that EMG is not running in Task Manager on the DNA server. Launch ACA and ACC clients and make sure that EMG is launched in Task Manager on the DNA server.
280
Configuration
To support Personal Contact search, Aastra Communication Assistant uses WebDAV protocol to interface with an Exchange Server. Currently the versions of Exchange Server which support WebDAV protocol are 2000 and 2003. This means that Personal Contact search is only supported on 2000 and 2003 versions of Exchange Server. By default, Exchange Server 2000 and 2003 installs a default HTTP Virtual server which provides support for WebDAV. However, you should ensure that default HTTP server is installed before using this search feature. The existence of IIS virtual directory Exchange confirms that the default HTTP server is installed. HTTPS connection with the Outlook Personal Contact search integration using WebDAV on the Exchange Server is not supported. The Office version on the ACA server must be Office 2000. In addition, MSXML 4.0 SP2 needs to be installed on the ACA Server to perform the Personal Contact search from ACA. By default on Windows 2003 server, the Internet Enhanced Security Configuration option is on, this security feature must be turned off on the ACA Server if installed on Windows 2003 server.
281
Configuration
The following parameters must be entered on the Aastra Communication Assistant Personal Options page in order to perform Personal Contact search: Exchange Server Domain name NT User name and password Exchange Mailbox: To know exact mailbox name, logon to Outlook Web Access, and place your mouse pointer over the Inbox icon. The Exchange Server Mailbox will be shown in the URL displayed in the status bar between "http://ExchangeServerName/exchange/" and "/Inbox/" folder." Exchange Server name
Procedure for configuring the above parameters 1) Create a Windows User account in the domain of the Exchange server. 2) Create an Exchange mailbox for that user. 3) Configure the Outlook client to work properly on the ACA server (The Outlook client does not need to be logged on at all times, only enabled and configured so the MAPI client can be used later on when searching). 4) Install CDO: Verify/Install the "Collaboration Data Objects" feature under the Microsoft Outlook. (This can be done using Add/Remove Programs). 5) Configure the ACA server's DNS settings to also point towards the Domain Controller where ACA server is joined. This allows "ACAuser" (created for use with the COM object) to be added to the Local Security Policy. 6) Enable the Personal Contact option in the ACA Configuration. 7) After everything is installed and configured, reboot the ACA server. The administrator of Aastra Communication Assistant has several options as to how to communicate this information to the end users. The administrator can just send an email containing the following information: Aastra Communication Assistant login name and password Exchange users domain name:The domain where the Exchange server is located NT username and password:The domain user in the Exchange server domain and the domain users password Exchange mailbox: Either the Display Name or Alias of the Exchange users mailbox, connected to the domain user Exchange Server name:The Exchange server machine name After the parameters have been set, end-users can search contacts by performing the following: 1) Click the Update button. 2) Go to the Search Page, select and search for the Contacts.
282
Configuration
283
Configuration
When ACC attempts to register with the gatekeeper, it will use the IP address entered in the VPN Client Address field. If registration fails, the ACC user will be prompted to enter the IP address assigned by the VPN provider. The prompt will display the IP address entered in the VPN Client Address field by default, so the user can just edit this field to enter the correct address. To avoid waiting for a registration timeout, you can check the box "Always Prompt for VPN Address." In this case, ACC will display the prompt for the IP address immediately, before attempting to register with the gatekeeper. Case 3: The VPN uses Tunneling via the WAN In this case, the IP address assigned by the VPN is bound to the network card, so there are two IP addresses displayed when using the command "ipconfig", the original machine IP address and the VPN IP address. In this case, the H.323 interface must be initialized with the VPN IP address. To handle this case, make sure you select the WAN address in the Network tab of the Settings options. Select the WAN address from the "Use Selected Network Adapter" drop-down list.
Type:
DWORD
Value: 1 to enable display of external parties Note: This Registry value is not created by default, to avoid legal issues in exposing this feature to end users.
284
Configuration
User ID
When creating a User ID, Profile, Person, and Confidential UDF can be used. Confidential UDFs are the only ones that can be excluded when exporting directory data via batch mode. The USER ID field is also used for other D.N.A. applications. The D.N.A. Outlook Integration (DOI) and D.N.A. Notes Integration (DNI) are using the data type to validate the Windows user with a subscriber. They can also use COMPUTER name (which is the default) to validate the subscriber. DOI and DNI are used to send message diversion information between the users Calendar and D.N.A.
Password
When creating a password, the Confidential UDF is recommended but Profile and Person UDF can also be used. Confidential UDFs are the only ones that can be excluded when exporting directory data via batch mode. Since user passwords are stored as plaintext in the database, they become visible in the export file when defined as Profile or Person UDF.
Operator Workstation
Improving the Performance of OWS
1. Run LDS on the OWS PC. This helps RDS synchronize the directory replications locally to the OWS. Use the following procedure to install LDS. Note that you must have logged in with a Windows administrator account to be able to perform the first step successfully. 1. Run the Windows Control Panel and start Services. Set the "StartUp" of the LDS entry to Automatic. Then start the LDS Windows service.
285
Configuration
2. Run LDS Configuration Utility from the D.N.A._C\SHARE\BIN directory and configure the LDS Replication Subscription and Publication items as you have done in RDS Configuration Utility when configuring the D.N.A. server. 3. Run the Registry Editor (REGEDT32.EXE) on the OWS client, and modify the following Registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson\LocalDS\LDSServerName and. set this key to the client computer name that the LDS service and OWS is running on. Also modify HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson\LocalDS\UseLDS and set this key to 1. This will force OWS to connect to LDS on the client OWS PC rather than on the SP D.N.A. Server. Now the OWS is ready to use LDS.
E-mail Integration
The Operator Workstation (OWS) application, which is a part of the Dynamic Network Administration (D.N.A.) suite, enables operators to take messages and deliver them via electronic mail systems. Operator Workstation employs Messaging Application Programming Interface (MAPI) functions for preparing and sending messages. Operator Workstation can obtain e-mail addresses from an external messaging system or from the D.N.A. subscriber database. Due to the variety of e-mail systems and their associated security requirements, a number of factors can prevent Operator Workstation from sending e-mail. It is the intent of this document to explain the requirements that must be met for successful integration of e-mail with Operator Workstation.
286
287
1 - Passive (Do Not Divert Phone) SSSS Start date/time* 12 character format (YYMMDDHHMMSS) 12 character format (YYMMDDHHMMSS) 00-99 00-80 0-160 characters 0-9 2-5 characters 00-99 ASCII 49 000-999 ASCII 32-127
EEEE
End date/time*
DD KK TEXT V XX NN 1 PPP Y
Record ID Length of Message text Message text** Voice Reason *** Terminal number Number of msgs/div. First part of text msg PBX Node ID Check Sum Byte****
* If the Start and End date/time contains YYMMDD000000 then only the date is specified. If it contains 000000HHMMSS then only the time is specified. If it contains 000000000000 then the default or indefinite date/time is specified. ** Even though the message text maximum is 160 characters, Max field length VoiceDesigner can handle 132 characters. Long messages must therefore be split into two parts. Max (actual) text in one message is 80 characters. *** 0 = Unknown, 1 = Message Diversion, 2 = Direct forwarding, 3 = Busy, 4 = No answer. These values are configured using VSI Configuration Utility. **** This is the 7-bit arithmetic sum of all the bytes in the message, disregarding the checksum and the final CR and LF. If the sum is smaller than 20H (32 Decimal), then 20H is added to it. All messages sent between VSI Service and the receiver should acknowledge the Voice System. An ACK (06H) must be sent if the received message is correct. A NAK (15H) must be sent if the received message is invalid due to incorrect checksum or missing the end code (i.e., CR LF). In the event the sender did not receive an acknowledgement message within 5 seconds, the sender re-transmits the message.
288
Sending of acknowledge messages can be deactivated by using the VSI Configuration Utility. For the VSI protocol, it is required that all parts of each message type are included in order to be acknowledged by the Voice System Interface. The EMDIP protocol (Extended Message Diversion Interface Protocol) is optionally available. If selected, VSI will generate a heartbeat event to the client at 2 minute intervals. The client application is responsible for checking the heartbeat event, but it does not send a response. If two consecutive heartbeat events are missed, the client application should close the current connection and attempt to reestablish a new connection with the server. If the server is shut down normally, the client should receive a server down notification. An abnormal server shutdown (e.g., power loss) will result in the client application closing the connection and attempting a new connection with the server, as described earlier (i.e., after two consecutive heartbeat events have been missed). All messages sent between VSI Service and the Voice System include a checksum byte. The VSI service can disregard the checksum byte if the checksum option is deactivated using the VSI Configuration Utility. Calculating the checksum is done by a 7-bit arithmetic sum of all the bytes in the message disregarding the checksum and the final CR and LF. If the sum is smaller than 20H (32 Decimal), then 20H is added to it. Following is a C-language example to calculate the checksum. int checksum(str, len) char *str; int len; { int sum = 0; while (len-- > 0) sum += *str++; sum &= 0x7f; if (sum < 0x20) sum += 0x20; return (sum); }
289
Interface
The time monitoring system is connected to a V.24 (RS-232C) port directly on to D.N.A. Server. Several time monitoring systems can be connected to D.N.A. at once. D.N.A. Time System Interface Module can be configured for 256 connections of each protocol type. In practice, the maximum number of connections is limited to the customer's Windows configuration.
Logical Interface
The logical interface between D.N.A. and the various time monitoring systems is defined in CCITT's Rec. V.24. The protocol is defined by a number of signals sent between the time monitoring system and D.N.A. Time System Interface. These signals are composed of a group of characters, each consisting of one start bit, seven to eight information bits, one parity bit, and one stop bit. The information bits are to be coded in accordance with ASCII. Baud rate, seven/eight information bits, parity, XON/XOFF and modem control are selectable.
Protocols
Five different protocols can be applied to the D.N.A. Time System Interface: CTR, GENERAL, FLEXIM, ESMI, and TIMECON. The protocols are grouped into different protocol families: CTR, GENERAL, and TIMECON belong to group 1 and FLEXIM and ESMI belongs to group 2. Asynchronous RS-232C, 8 data bits, no parity, transfer rate select able. The character code is 7 bit ASCII, with the Finnish special characters code as follows:
Message Format
<STX><message type><data><BCC><CR><LF> STX = 02H, Start of message message type = A char which determines how the rest of the message should be interpreted. data = Data space
290
BCC = The 7-bit arithmetic sum of all the bytes in the message disregarding the checksum itself and the final CR. If the sum is smaller than 20H (32 dec), then 20H is added to it. CR = End of message LF = Optional
FLEXIM Protocol
The phone switch operator has a FLEXIM info terminal. FLEXIM sends a message to the D.N.A. Time System Interface each time a person logs in or out using his card. The message contains that person's id information (card number, phone number or personal id-number) and in addition the return time (if known), the login/logout time (optional 1) and the validation time (optional 2). The D.N.A. Time System Interface tells FLEXIM if any person has a call request or some other message. The next time such a person logs in or out, this message will be displayed on the FLEXIM console in plain text form in addition to the time and date when it was entered. A person can have multiple messages in the system at the same time - when the login or logout is completed, all read messages are deleted from the system. A message may contain a maximum of ten 16-character lines. In addition, FLEXIM sends Time Sync messages to the D.N.A. Time System Interface. Either end can initiate data transfer. All messages are acknowledged as either correct or faulty. There are two kinds of fault acknowledgement messages: frame error and message error. Frame error means that the receiver has gotten the beginning code of the message but not the end code, or that the checksum is wrong. The sender must send the message again. Message error means the receiver has received a message that has a correct length and a correct checksum, but which contains an invalid message. The sender writes an entry about the faulty message in its own log file and continues by sending the next message in line (if any). The faulty message is not retransmitted. When the FLEXIM send program starts it first sends the status information of all the people in the system to the receiving end, regardless of what data has been previously transmitted. In the event of a frame error (see above), message retransmitting is attempted until midnight. If the frame error persists after 00:00 the message is discarded and the system revert back to sending all of the system status information from the beginning. The same situation forms in the event of a takeout. The system waits 5 seconds for an acknowledgement message before retrying. When the status information for all the people in the system has been successfully sent the program starts sending information on logouts and logins from the program starting time onwards.
291
X = Phone number / Card number / ID number (field length 1-11,bytes) TAB X = Other Reason code (length 0-3 bytes) TAB
HHMM = Return time (4 bytes if specified, otherwise 0) TAB DDMM = Login/logout date (optional') TAB HHMM = Login/logout time (optional 1) TAB DDMM = Validation date (optional 2) TAB HHMM = Validation time (optional2) BCC = Checksum CR = End of message LF Optional 1: Configurable when the system is installed. Optional 2: Configurable when the system is installed, contains option I. 2 In 3 Ou t 4 Trip in 5 Trip ou t 6 Va ca t io n o ut 7 S ick o ut 8 Ove rt ime ou t 9 Ot he r Re a so n in 0 Ot he r Re a so n ou t a Lu nch ou t
Reason Code
292
Other Reason is a customer-specified function. Pressing a number and the "Other Reason" key on the FLEXIM terminal uses it. This results in either `0' (In) or `9' (Out) being passed to the info system, with the other reason number (`0' ... `199') in the Other Reason field of the message. Return date/time is not checked by the system, it is always sent exactly in the form that the user types it in - it is possible to leave incomplete or impossible return times. The return time must be in numeric form. However, in the FLEXIM system the login/logout information and the return date/time information are given separately, so when the user specifies a return date the D.N.A. Time System Interface receives two messages with the same reason code. The second of these contains the return date/time information. Login/logout time, when sent, is always some time of the on going day. The information is not necessarily sent in a chronological order, however. Validation date/time comes into play when the so-called "double login/logout" feature of the system is in use, in which the user gives information of a future event using the FLEXIM terminal (for example: "Working overtime today, on a trip tomorrow". The validation field gives the time when the second event becomes valid. In a double-login/logout situation, the D.N.A. Time System Interface may receive up to three consecutive "logout" messages for the same person. A logout message-without a validation time or a return time, for example a simple "Out." A message with a double-log field, for example "Trip" with a validation time and date of 8:00 AM the next morning. A message with all of the information in the previous case and the addition of a return time/date field. The interval between these messages may be several minutes, and messages from other people may occur between them, naturally. Examples No rma l L og in <S TX > 2 <TA B > 1 50 34 91 15 E <TA B > <TA B > <TA B > <B CC> <CR> No rma l L og ou t <S TX > 3 <TA B > 1 50 34 91 15 E <TA B > <TA B > <TA B > <B CC> <CR> Trip I n <S TX > 4 <TA B > 12 3 <TA B > <TA B > <TA B > <B CC> <CR> Trip O ut + re t u rn t ime <S TX > 5 <TA B > 1 24 <TA B > <TA B > 15 07 <TA B > 1 53 0 <B CC> <CR> Trip O ut + re t u rn + lo g t ime <S TX > 5 <TAB > 12 4 <TA B > <TA B > 1 50 7 <TA B > 1 53 0 <TA B > 1 30 7 <TAB > 13 00 <B CC> <CR> Trip O ut + re t u rn + lo g + va lid a t ion <S TX > 5 <TA B > 1 24 <TA B > <TA B > 1 50 7 <TA B > 1 53 0 <TA B > 1 30 7 <TAB > 13 00 <TAB > <14 07 > <TA B > 0 80 0 <B CC> <CR> V a ca t ion + re tu rn t ime <S TX > 6 <TA B > 1 25 6 <TA B > <TA B > 1 30 5 <TA B > 0 80 0 <B CC> <CR> S ick + re tu rn t ime <S TX > 7 <TA B > 1 11 5 <TA B > <TA B > 1 40 5 <TA B > 0 63 0 <B CC> <CR> O ve rt ime Ou t <S TX > 8 <TA B > 11 15 <TA B > <TA B > <TA B > <B CC> <CR> O th e r Rea so n + co de + re tu rn <S TX > 0 <TA B > 1 50 3 <TAB > 2 <TA B > 3 05 <TA B > 12 00 <B CC> <CR>
293
O th e r Rea so n + co de (I n ) <S TX > 9 <TA B > 8 90 <TAB > 3 <TA B > <TA B > <B CC> <CR> Absence deactivate registration STX = Start of message X = Reason code (2 or 4 or 9) TAB X = Card number TAB TAB TAB TAB TAB BCC = One byte checksum CR = End of message D.N.A. has only one absent code while FLEXIM has many. Because of this, the field F sent from FLEXIM with the values 2, 4 or 9 are translated by D.N.A. as deactivate absence. It will delete corresponding diversion in D.N.A. that previously was created by the time system diversion originator. Diversions that were created by other diversion originators will only be deactivated. Absence activate registration: The same as login message. Reason code sent from FLEXIM with the values 3, 5, 6, 7, 8, A or B will all be translated by D.N.A. Time System Interface as activate absence. It will create a diversion for the corresponding subscriber. The D.N.A. Time System Interface absent code that will be used for the diversion will be defined by the configuration command TRANS. Since not all fields in a message are required, a message can be composed in several different ways. See the following examples: <S TX > 2 <TAB > 11 99 9 <TA B > <TA B > <TA B > <B CC> <CR> Deactivate absence for card number 11999. Note three is the minimum number of < TAB> after the card number, even if the message does not contain any more information after the card number. <S TX > 3 <TAB > 23 56 <TA B > <TA B > 03 12 <TA B > 14 45 Activate absence for card number 2356 with return date and time 3 December 14:45. Reason code 3 will be translated to corresponding D.N.A. Time System Interface absent code and assigned to the diversion. <S TX > 0 <TAB > 44 55 77 <TA B > <X > <TA B > 2 80 6 <TA B > <TA B > 2 10 6 <TA B > 0 73 2 <B CC> <CR> Activate absence for card number 445577 with return date 28 June and from date and time 21 June 07:32. Other reason code <X> will be translated to corresponding D.N.A. absent code and assigned to the diversion. Time Sync messages STX = Start of message K = `K' is the Time Sync message type TAB
294
YYMMDDHHMMSS = Date and time (12 bytes) BCC = Checksum CR = End of message If the D.N.A. Time System Interface does not respond to a Time Sync message, it is not resent. If the D.N.A. Time System Interface responds with a frame error, the sending of the message is retried (max. three times). FLEXIM message acknowledgements Correct: <STX> <A> TAB <id field, as in message> <CR> Message Error: <STX> <N> <CR> Frame Error: <STX> <E> <CR> Note: As has been said before, a "Frame Error" message is sent only in case of an error in the message frame (Start/End codes or checksum). A message with a correct frame but bad contents is acknowledged with a "Message Error" message. If no acknowledgement is received, the message is resent. Retries continue until midnight, at which time a "line down" condition is logged and all status info is resent. The status info is resent until successful, after which normal sending of login/logout messages is resumed.
295
Removal of messages STX = Start of message P = `P' is the Remove Message type TAB X = Personal ID and optional Message ID as in the Call Request message BCC = Checksum CR = End of message This message causes the removal of all call requests for the given person from the FLEXIM system. If a Message ID is specified, only matching messages are removed. Removal of all messages STX = Start of message P = Remove Message -field type BCC = Checksum CR = End of message This message causes the removal of all call requests sent by the D.N.A. Time System Interface from the FLEXIM system. Init request STX = Start of message I = `I' is the Init Request message type CR = End of message The FLEXIM system acknowledges the message and sends the status of all the people in the system to the info system. D.N.A. Time System Interface message acknowledgements As FLEXIM.
296
as the past and schedules a current activity with start time as 09/08/2006 01:00PM and end time as 11/08/2006 08:30AM. Future activity: If the login and return date and time are 08/08(dd/mm) 12:00PM and 09/08(dd/mm) 08:30AM, then this will be scheduled as the future activity by DNA with start time as 08/08/2007 12:00PM to end time 09/08/2007 08:30AM.
General Protocol
Data messages exchanged between D.N.A. Time System Interface and the time monitoring system are composed by ASCII coded characters. The messages are composed of the following fields
Login/logout message
STX = Start of message X = Message type (B or C or D) X = Card number (field length 1-11,bytes) X = Reason code (A-Z, a-z) X = Ignored data (field length 1 byte) X = Return time (the length is depending on the message types ) X = Message waiting indication ETX = Start text BCC = Checksum <STX> Start of Text - A one byte ASCII code denoting the start position of the text. Each message will start with the STX field. Message type - A one-character message type with the value B, C or D. D.N.A. Time System Interface will ignore messages with other message types. The ignored message will also be acknowledged with ACK. Card Number - A unique card number that can be up to ten alphanumeric characters long. Normally this field is set to any number in the range 1 to 9999999999 that is then translated to a subscriber in D.N.A.. The length of the card number is configured at installation. Card number length will be defined by the configuration command CARD. Reason Code - A one-character absent reason code (A-Z, a-z). The translation table for D.N.A. absence codes will be defined by the configuration command TRANS. Ignored data - A one-character long data field ignored by D.N.A. Time Information System. (Could hold any value). Return Time - A four character long number giving the time of return for message type C. This field becomes a six plus four character long number for message type D. See further description of message type D. Interpretation depends on absent reason code given. (DDMM = Day and month. HHMM = Hour and minute.) Message Waiting Indication - A one character long data field specifying if message-waiting indication should be activated or deactivated. <ETX> Start text - A one byte with ASCII character ETX. Each message will start with ETX.
297
BCC Checksum - A one-byte check character. The check character is calculated as an XQR sum of all characters from F up to and including <ETX> (<STX> is not included). All messages sent between D.N.A. Time System Interface and the time monitoring system should be acknowledged by the receiver. An ACK must be sent if the received message is correct. A NAK (H15) must be sent if the received message is invalid. Sending acknowledge messages can be deactivated by using the configuration command ACK. For the General protocol it is required that all parts of each message type are included in order to be acknowledged by the D.N.A. Time System Interface.
Messages sent from General Time Monitoring System to Time System Interface
Arrival and Gone Out Registration STX = Start of message B = Message type is set to B X = Card number (field length 1-11,bytes) X = Reason code (A-Z, a-z), lowercase: arrival, upper case: gone out X = Ignored data (field length 1 byte) ETX = Start text BCC = Checksum If the absent reason code is a lower case character, the message is considered to be an arrival message. In this case, D.N.A. Time System Interface deletes all old diversions created from the time monitoring system and deactivates all other active diversions. If the absent reason code is an upper case character, the message is considered to be a gone out registration. D.N.A. Time System Interface creates a diversion with the given absent reason code and a default return time. Example: <STX>B1234a <ETX>? An arrival message (lowercase a), for card number 1234. (The check character is not calculated correct in the example.) Gone Out Registration STX = Start of message C = Message type is set to C X = Card number (field length 1-11,bytes) X = Reason code (A-Z, a-z). absent reason code. X = Ignored data (field length 1 byte) TTTT = Return time (DDMM or HHMM: 4 bytes if specified, otherwise 0) ETX = Start text BCC = Checksum
298
This message is always a gone out registration. D.N.A. Time System Interface creates a diversion with the given absent reason code and the return time that is specified. Depending on the absent reason code, the TTTT is interpreted either as a time (HHMM = Hour and Minute) or as a date (DDMM = Day and Month). For the time format D.N.A. Time System Interface will use a default date to create a complete return time. For the date format D.N.A. Time System Interface will use a default time when creating the complete return time. The connection between a certain absent reason code and a time/date format is defined during installation. Gone Out Registration STX = Start of message D = Message type is set to D X = Card number (field length 1-11,bytes) A = Reason code (A-Z, a-z) X = Ignored data (field length 1 byte) DDMMYYHHMM = Return time (the length is 10) ETX = Start text BCC = Checksum This message is always a gone out registration. D.N.A. Time System Interface creates a diversion with the given absent reason code and the return time that is specified. The return time can contain both information about date (DDMMYY) and time (HHMM). If DDMMYY has the value 000000 then no return date is included. D.N.A. Time System Interface will then use the default date for the current absent code. IF HHMM has the value "0000 then no return time is included. D.N.A. Time System Interface will then use the default time. The connection between a certain absent reason code and a default return date/time is defined during installation.
Messages sent from Time System Interface to General Time Monitoring System
Message Waiting Indication STX = Start of message C = Message type is set to C X = Card number (field length 1-11,bytes) M = Set to A if activate, set to B if deactivate ETX = Start text BCC = Checksum To activate the message waiting, the M character is set to "A". To deactivate the message waiting, the M character is set to "B". Using the configuration command WAIT can deactivate sending of the Message waiting indication.
CTR Protocol
Data messages exchanged between D.N.A. Time System Interface and the CTR Time Monitoring System are composed of ASCII coded characters. The messages are composed of the following fields:
299
STX = Start of message X = Message type ( 2 digits from 65 to 71) X = Card number X = Absent reason code (0~9) X = Return time (MMDD or HHMM) CR LF <STX> Start Text - A one-byte field with the ASCII character STX. Each message will start with STX. Card Number - A four-character long card number. ("0000"-"9999") Card number length is usually defined by the configuration command CARD, but for the CTR system, the card number length is fixed to 4. Absent Reason Code - A one character absent reason code ("0"-"9"). Translation table for D.N.A. absence codes will be defined by the configuration command TRANS. Return Time - A four character long number giving the return time. HHMM (MMDD = Month and day, HHMM = Hour and minute.) <CR> Carriage Return - A one-byte field with the ASCII character CR. <LF> LF - A one-byte field with the ASCII character LF. Each message sent from the CTR system will end with the combination <CR> <LF>. For the CTR protocol, it is required that all fields of each message are included in order to be acknowledge by the D.N.A. Time System Interface.
LF Example: <stx>664444<cr><lf> where card number = 4444 Set diversion using the default diversion specified in TSS Configuration. In this case, D.N.A. Time System Interface will create a diversion with the given absent reason code and a default return time. STX = Start of message 67 = Message type is set to 67 X = Card number A = Reason code CR LF Example: <stx>6744442<cr><lf> where card number = 4444 reason code = 2
Set diversion using the selected reason code and end time/duration specified in RDS Configuration. D.N.A. Time System Interface will in this case, update a previously created time monitoring system diversion with the specified return time. D.N.A. Time System Interface will use a default date to create a complete return time. D.N.A. Time System Interface will use the previously set end date, if provided, to create a complete return time. If there is no previous end date entered, then the default end date is used to create a complete return time. STX = Start of message 68 = Message type is set to 68 X = Card number HHMM = Return time (hours and minutes) CR LF Example 1: <stx>6844441830<cr><lf> where card number = 4444 return time = 1830 Update the endtime of the previously set diversion (e.g., 66 or 67) for this TSI card (to 18:30). Here the return date is the default return date associated with the diversion code Example 2: <stx>6944440625<cr><lf> <stx>6844441830<cr><lf> as configured in RDSSetup. If a previously set diversion has a end date (e.g. "69") then sending "68" will update the end time for this TSI card (to 18:30) keeping the end date (June 25) set with "69".
301
Update a previously created time monitoring system diversion with the specified return time. D.N.A. Time System Interface will use a default time to create a complete return time. D.N.A Time System Interface will use the previously set end time, if provided to create a complete return time. If there is no previous end time entered then the default end time is used to create a complete return time.
STX = Start of message 69 = Message type is set to 69 X = Card number MMDD = Return time (month and day) CR LF Example 1: <stx>6944440625<cr><lf> where card number = 4444
Update the end date of the previously set diversion (e.g. "66" or "67") for this TSI card (to June 25). Here the end time is the default end time associated with the diversion code as configured in RDSSetup Example 2: <stx>6844441830<cr><lf> <stx>6944440625<cr><lf> return time = 0625 If a previously set diversion has an end time (e.g. "68") then sending "69" will update the end date for this TSI card (to June 25) keeping the end time (18:30) as set with "68".
Messages sent from Time System Interface to CTR Time Monitoring System
Sending of these messages can be disabled in D.N.A. Time System Interface by using the configuration command WAIT. Deactivate Message Waiting Upon receipt of this message, D.N.A. Time System Interface will deactivate message waiting for card number X. STX = Start of message 70 = Message type is set to 70 X = Card number CR LF Activate Message Waiting D.N.A. Time System Interface will in this case, activate message waiting for card number X. STX = Start of message 71 = Message type is set to 71 X = Card number CR
302
LF
ESMI Protocol
The ESMI protocol is in the same protocol family as the FLEXIM protocol.
Messages sent from ESMI Time System To D.N.A. Time System Interface
The message format (absence codes): STX = Start of message X = Message type (2 or 3 or A or E) TAB X = Identification number (1 - 10 digits) TAB MS = Reason code for out (1-9: pre-defined. 10-63: free) TAB DDMM = Return date (0 to 4 digits) TAB HHMM = Return time (0 to 4 digits) BCC = Checksum CR Explanation of the records STX Start of message (= ASCII 2) X Message type: 2 = in, 3= out, A = reply message ok, E = reply message error TAB TAB-mark, works as a separator xxxxxx Identification number, Iength 1 - 10 digits MS Reason code for out (1-2 marks if given, otherwise 0 marks). 	Explanations used: 1=trip, 2=vacation, 3=sick, 4=health care, 5= business, 6=own, 7=overtime, 8=extended working time, 9=Iunch, 10...63 free codes DDMM The return date. 0-4 digits HHMM The return time. 0-4 digits. The date and time of return wouldn't be set if it is not known. BCC Checksum. CR Carriage-Return. In this case the separator won't send anything. Message will re-transmit after 5 S, if TS won't get any reply. Also if TS-system gets error message, re-transmit will be done. Re-transmit will be done only once. If the OK -reply won't come after this, system continues with a new message. Reason codes in TS-system (in case): All messages will be sent by "in" code. Out codes: - All reason codes will be in MS field. Others: Correction message will be sent from TS-system Reply from the TS-system to D.N.A. Time System Interface
303
Reply, if the message is OK STX = Start of message A = Message type is set to A TAB X = Identification number (1 - 10 digits) CR Reply, if there is an error in the message: STX = Start of message E = Message type is set to E CR
Messages sent from D.N.A. Time System Interface to ESMI Time System
TS-system terminal setting message: STX = Start of message S = Message type is set to S (S is TS-system message) TAB XXXXXX = Identification number (1 - 10 digits) TAB sss = Message contents TAB sss = Message contents TAB BCC = Checksum CR Explanation of the records STX Start of message (= ASCII 2) X Message type: S = TS terminal message, A = reply message ok, E = reply message error TAB TAB-mark, works as a separator XXXXXX Identification number, length 1 - 6(10) digits ss... s TS Terminal message contents, CR or TAB not included. A message can include up to 10 text rows. Since a message row in D.N.A. Time System Interface can be up to 40 characters, these rows will be divided into several text rows. Words longer than 20 characters will be truncated. Overall, length should not exceed 80 characters. Note: Only the first two ss.. .ss records will be approved as TS-system terminal message, others will not be handled. If ss... ss records are blanks, will the XXXXX persons TS terminal message be removed. BCC Checksum, will be counted by marks (including the STX-mark) sum mod 128, and if the sum is under 20H, there will be added 20H. CR Carriage-Return Reply from the D.N.A. Time System Interface to TS-system if the message is OK:
304
STX = Start of message A = Message type is set to A (A is OK) TAB XXXXXX = Identification number CR Reply, if there is an error in the message: STX = Start of message E = Message type is set to E (E is error) CR TSS systems checking and replies: Message should start with STX S TAB -marks and checking sum should be right, otherwise error in message -reply will be sent, In case: error in reply, TS-system won't send any error in message -reply.
TIMECON Protocol
Stamping Message
The stamping message type: "B" and "C", is equal to the stamping message into GENERAL-protocol. However the return time should be interpreted different than in GENERAL-protoco1 (see below).
Return Time
The return time unit is determined in the contents of this field. If position (3 & 4) is 01 - 12, it is treated as a date; otherwise as a time, this means that time contains minutes l to 60 and hours 1-24.
Clock Message
TIMECON has a message called clock message, the clock message is repeatedly sent from time system to TSS as an online check. TSS should answer with an <ACK> if this message is OK. STX = Start of message X = Message type (A or D or Z) HHMM = Time information YYMMDD = Date information EXT BCC = Checksum X - Message type is something else than "B" or "C" TSS algorithm: IF F in ("A", "D", "Z") THEN Intepret_Clock_Message HHMM - Time info HHMM TSS algorithm: IF ABS (HHMM - D.N.A. Time) > 5 min THEN Logg_Warning IF ABS (HHMM - D.N.A. Time) > 15 min THEN Logg_Error YYMMDD Date number starting with a value of 0001 from 76-01-01. TS-system algorithm: None, ignore this field
305
The time info from TSU will be check and logged as a Warning if it differs 5 - 15 minutes and an error will be logged if it differs more than 15 minutes, it should only log first time it receives a time zone outside D.N.A. time. It should be possible to change the range value for the invalid time zone, but it will default to 5 min and IS min.
Exchange Interface
The D.N.A. Interface is compatible towards the exchange from ASB50101 R6/1 and later releases of the exchange.
Message Types
There are two types of invalid messages. Frame error - This means that the receiver has received the beginning code of the message but not the end code, or that the checksum is wrong. The sender must send the message again. This is done when the receiver sends a NAK to the sender. Message error - The receiver has received a message that has a correct length and correct checksum, but which contains an invalid message. The receiver sends an ACK message to the sender and writes an entry about the faulty message in its own log file or Windows event log. The sender continues sending the next message in line (if any). The faulty message is not re-transmitted by the sender.
Initiate Message Diversion Type for extension because of Reason from Start until End with Reason Text. Initiate Message Diversion Type for extension because of Reason from Start until End with Reason Text. Action Request Initiate diversion for MMMM because of RRR from SSSS until EEEE Command Example
STX 60 MMMM RRR STX 60 1234 000 0 T SSSS EEEE KK 961231113000 TEXT Y CR LF 961231123000 15 "Gone To Lunch" Y CR LF
306
Command
Example
View Message Diversion(s) for Extension Action Request View diversion(s) for MMMM Command Example
Initiate Message Text for Extension Action Request Command Example STX 70 1234 16 "Call home soon" Y CR LF
Delete Message Text for Extension Action Request Delete message DD for MMMM Command Example
View Message(s) for Extension Action Request View message(s) for MMMM Command Example
Download all Message Diversions and Messages from D.N.A. Action Request Command Example This message is sent from VOICE System to VSI Service to download all messages and diversions from the D.N.A. Server to VOICE System. This is used to synchronize database information between both systems when VOICE System restarts.
307
View (synchronize) D.N.A. system time Action Request Time Synchronization Message Command Example
STX 91 This allows VSI Service to YYMMDDHHMMSS Y check the local date/time of CR LF the D.N.A. Server against the local date/time of the VOICE system. If local date/time deviates more than 1 minute and less than 10 minutes, then VSI Service prompts a warning message in the D.N.A. Server Windows event log. If local date/time deviates more than 10 minutes, then VSI Service prompts an error message in the D.N.A. Server Windows event log.
Start of showing message STX 10 MMMM NN Y See below diversion(s) for MMMM CR LF that has NN diversions
Show Message Diversion with recID for Extension Action Request Show diversion DD for MMMM Command STX 11 MMMM DD RRR T SSSS EEEE KK TEXT Y CR LF Example See below
End of showing Message Diversion(s) for Extension Action Request End of showing diversion(s) for MMMM Command Example
STX 12 MMMM Y CR (1234 has 2 diversions, LF lunch (0) 11:30-12:30 and vacation (7) June 25th until July 12th) STX 10 1234 02 Y CR LF
308
STX 11 1234 01 000 0 961231113000 961231123000 15 "Gone To Lunch" Y CR LF STX 11 1234 02 007 0 960625000000 960712000000 25 "Vacation To The Bahamas" Y CR LF STX 12 1234 Y CR LF
Activate Message Diversion for Extension Action Request Activate diversion for MMMM Command STX 13 MMMM DD PPP RRR T SSSS EEEE KK TEXT Y CR LF Example STX 13 1234 01 001 000 0 961231113000 961231123000 15 "Gone To Lunch" Y CR LF
Deactivate Message Diversion for Extension Action Request Deactivate diversion for MMMM Command Example
Start of showing Message(s) for Extension that has Number of Messages Action Request Command Example
Start of showing STX 20 MMMM NN Y See below message(s) for MMMM that CR LF has NN messages
Show Message with Number of characters with recID for Extension Action Request Show message DD for MMMM Command STX 21 MMMM DD KK TEXT 1 Y CR LF or STX 21 MMMM DD KK TEXT 0 Y CR LF Example See below
309
End of showing message(s) STX 22 MMMM Y CR (1234 has 2 messages, first for MMMM LF with 130 characters, second only few) STX 20 1234 02 Y CR LF STX 21 1234 01 80 "This message contains information about this and that, especially that. Please" 1 Y CR LF STX 21 1234 01 50 " remember that this is a very small example only" 0 Y CR LF STX 21 1234 02 15 "Short message" 0 Y CR LF STX 22 1234 Y CR LF
310
Indicate that Extension has a Message Waiting Indication Action Request Indicate message waiting indication for MMMM Command Example
Erase the Message Waiting Indication for Extension Action Request Erase message waiting indication for MMMM Command Example
311
Chapter 17 Security
Directory Security
The D.N.A. directories are open to anyone with full control, by default, if FAT is used. If NTFS is used, Read and Write permission is granted to the appropriate users by administrator. The following table contains the directories and the applications/services that require write permission.
D.N.A. Server
D.N.A. Components MRS Directory / File \CAAPI\data Applications / Services / User Call Accounting API (RDS Scheduled job) LFS RDS
SDS RDS Not used today, for 3rd party use only LDS MD Support users Name Identity Conversion users SCS EMG users MD Support users PDM users
\Data\LDS \Data\MDS \Data\NameID \Data\SCS Site1, 2, \EMG and sub-directories \MDS and sub-directories \PMG and sub-directories
312
Technical Guide
D.N.A. Client
D.N.A. Components Share Directory / File \Data\DirChangeLog Applications / Services / User Not used today, for 3rd party use only LDS LFS MD Support users Name Identity Conversion users SCS EMG users MD Support users PDM users OWS users PDM users
\Data\LDS \Data\LFS \Data\MDS \Data\NameID \Data\SCS Site1, 2, \EMG and sub-directories \MDS and sub-directories \PMG and sub-directories OWS PMG \OWS\Data \PMG\Data
313
Technical Guide
Web Server
D.N.A. Components ACA, DME, or Personal Assistant ACA DME Directory / File DirB\data Applications / Services / User everyone
root \ MobileExec\bin\session.m db
Logon Local System Account Local System Account Local System Account Local System Account Local System Account Local System Account
Remarks
ACA Scheduler
ACA Scheduler
Manual
IP Service
IP Service
Automatic
LDAP
LDAP
Manual
LDS
LDS
Manual
LFS
LFS
Automatic
314
Technical Guide
Logon Local System Account Local System Account Local System Account Local System Account Local System Account Local System Account Local System Account Local System Account Local System Account
Remarks
OWS Supervisor
DNASupervisor Server
Automatic
If OWS installed
PBX Service
PBXService
Automatic
If OWS installed
RDS
RDS
Automatic
SDS
SDS
Automatic
SCS
SCS
Manual
SMS
DNA_SMS
Manual
TSS
TSS
Manual
VSI
VSI
Manual
315
Technical Guide
DNA Client
Service Display Name (in Service Manager) ClockSync Service Internal Name (in Registry) ClockSync Startup Type Automatic Logon Remarks
Local System Account Local System Account Local System Account Local System Account If OWS installed
LFS
LFS
Automatic
SCS
SCS
Manual
PBX Service
PBXService
Automatic
ODBC Connection
The ODBC User Data Source configuration is as follows: Data Source name Server name defined in the D.N.A. Server configuration. E.g., Local DNA Server (default for local server) Data Provider SQL Server name Authentication use SQL Authentication, login ID is oliver. Others Refer to the following screen capture for the remaining configurations
316
Technical Guide
Windows NT
Destination Directory WINNT System32 Files hh.exe opi_msg.dll owspbxext.cpl Api.dll Cstrain.dll Ossapi.dll Ossdmem.dll Remarks MS redistribution files DNA files DNA files Third party files Third party files Third party files Third party files
317
Technical Guide
Destination Directory
Files Soedber.dll Ossmem.dll Asycfilt.dll Atl.dll Comcat.dll Gapi32.dll Mfcans32.dll Mscal.ocx Mscomct2.ocx Msflxgrd.ocx Msvbvm60.dll Msvcp50.dll Msvcp60.dll Oleaut32.dll Olemsg32.dll Olepro32.dll Stdole2.tlb Ctl3d32.dll Dbmssocn.dll Mfc40.dll Mfc42.dll Msvcrt40.dll
Remarks Third party files Third party files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files
318
Technical Guide
Destination Directory
Files Sqlstr.dll Sqlwid.dll Sqlwoa.dll Csh.dll Hhctrl.ocx Itircl.dll Itss.dll Roboex32.dll Sms_rl.dll
Remarks MS redistribution files MS redistribution files MS redistribution files Third party files MS redistribution files MS redistribution files MS redistribution files Third party files DNA file DNA files
adsdna.dll
CiMgrLdr.exe DmiProxy.dll Program Files\Common files\EricssonShare\DM I\Mapper Program Files\Common files\EricssonShare\Ser viceProvider Dmi2snmp.dll
*.*
Intel files
319
Technical Guide
Destination Directory
Files
Remarks
owspbxext.cpl Api.dll Cstrain.dll Ossapi.dll Ossdmem.dll Soedber.dll Ossmem.dll Gapi32.dll Mfcans32.dll Mscal.ocx Mscomct2.ocx Msflxgrd.ocx Msvcp60.dll Olemsg32.dll Csh.dll Roboex32.dll Sms_rl.dll Program Files\Common files\EricssonShare \ADSI adsdna.dll
DNA files Third party files Third party files Third party files Third party files Third party files Third party files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files MS redistribution files Third party files Third party files D.N.A. file DNA files
320
Technical Guide
Files
Remarks
CiMgrLdr.exe DmiProxy.dll Program Files\Common files\EricssonShare\DM I\Mapper Program Files\Common files\EricssonShare\Ser viceProvider Dmi2snmp.dll
*.*
Intel files
Databases
Permissions: dbo: Database Owner with full controls SELECT: Read permission Database Permission for User oliver aux1, aux2 db_xaction dnadfdb dirdb emgdb pmglocks security site1pmg, site2pmg site1, site2 dbo dbo dbo dbo dbo dbo dbo dbo dbo Permission for User thirdpty SELECT SELECT No permission SELECT SELECT SELECT No permission SELECT SELECT
321
Technical Guide
Registry
Location
The root of the DNA key is HKLM\SOFTWARE\Ericsson. The primary sub-keys for each individual DNA application is created under \Ericsson by various installations. DDB DMG DMI ACA ACC EMG Integration LocalDS MobileExec MRS OPI PersonalAssistant PMG PPMLite ServicePack Installed by D.N.A. installation Installed if DMG is selected Installed on server only Installed by ACA installation Installed by ACC installation Installed if EMG is selected Installed by Outlook integration and Lotus Notes installations Installed on server and client Installed by Mobile Executive installation Installed on server only Installed if OWS is selected Installed by Personal Assistant installation Installed if PMG is selected Installed by PPMLite installation under \PMG Installed by DNA Service Pack installation
Permissions
Permissions Setup by D.N.A. Installation
Default Permissions By default, the Ericsson Registry key permissions are set as follows by D.N.A. installations:
322
Technical Guide
Administrator Full Control Everyone Special Access. Reference the following screen capture for Special Access permissions.
Deviation from Default Permission Due to special needs by applications, the following specific sub-keys under HKLM\SOFTWARE\Ericsson are granted for Full Control to Everyone by D.N.A. installation. LocalDS MRS ConnectionList DirChangeLog DrOhan HIS LDS RemoteDS SCS Servers SMS
323
Technical Guide
The following table contains the Registry keys and the applications that require write permission. All the Registry keys are located at \HKLM\SOFTWARE\Ericsson\ D.N.A. Server Registry Key Location HKLM\SOFTWARE\Ericsson MRS\ConnectionList MRS\DirChangeLog MRS\DrOhan MRS\HSI MRS\LDS MRS\MDS MRS\NameID MRS\RemoteDS MRS\SCS MRS\SMS MRS\Servers MRS\TSS MRS\VSI DMG\LDAP EMG PMG MD Support RDS RDS HSI Configuration LDS Configuration MDS Name Identity Conversion RDS Configuration SCS Configuration RDS Configuration DNA Server Configuration, LFS TSS Configuration VSI Configuration LDAP Configuration Extension Manager Performance Data Manager & Performance Presentation Manager Applications
324
Technical Guide
D.N.A. Client Registry Key Location HKLM\SOFTWARE\Ericsson MRS\ConnectionList MRS\DrOhan MRS\LDS MRS\MDS MRS\RemoteDS MRS\SCS MRS\Servers DMG\LDAP ACC EMG PMG
Applications
MD Support RDS LDS Configuration MDS LDS SCS Configuration LFS LDAP Configuration Aastra Communication Client Extension Manager Performance Data Manager & Performance Presentation Manager
Applications
325