Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
AMENDMENTS
The items that follow are incorporated in the update of this manual from issue 0207 to 0210: General SysManager 410 release 4.5 Customer Engineer Manual integrated with Management@Net 1.1.0 Customer Engineer Manual. All multi-user aspects and all about the TABS Fault Reporting Module. Pre-installation setup for Windows NT Key Programming Manager (new chapter). Alarm Display Application (added to Alarm Status Module chapter renamed). CM@Net Connection Configurator (new chapter) IP Gateway support chapter is generalised to Third Party Application Support All "SysManager 410" chapters, to reflect the use in Management@Net
Removed
Added
Revised Updated
The items that follow are incorporated in the update of this manual from issue 0210 to 0301: Added Warning in MSDE procedure in 5.1. FIRST INSTALLATION.
The items that follow are incorporated in the update of this manual from issue 0301 to 0303: Added Changed To the preface: general rules for a good administration and maintenance of a server/specialised computer. Values of boundaries 324 and 325 in 4.1. ISPBX REQUIREMENTS.
The items that follow are incorporated in the update of this manual from issue 0303 to 0304: Added In different sections: Management@Net 1.1.1 can be installed on Windows 2000 Professional or Windows XP Professional, but without Terminal Services IP Forwarding if the BIM is on Windows 2000 Professional Requirements: The Call@Net Application Server may not be on a Domain Controller General configuration of Management@Net: @Net Configurator settings and Mgt@Net TSBased AppConfigurator settings
The items that follow are incorporated in the update of this manual from issue 0304 to 0307: Changed Changed Changed Removed Revised Added Added Revised Installation of Management@Net: choose SOPHO iS3000 Configuration of Management@Net: Messenger@Net added Connection Manager@Net: Messenger@Net added Pre-installation Setup for Windows 2000 Server: DHCP (can not be used - fixed IP address) Management@Net Authentication (CA) Alarm Status Module: Status Control External Application Interface: PMS connection over IP General Maintenance and Troubleshooting: Diagnostic Monitor added
The items that follow are incorporated in the update of this manual from issue 0307 to 0312: Changed Added Alarm Status Module: more information about Application Status Monitoring Key Programming Manager: section with more background information
The items that follow are incorporated in the update of this manual from issue 0312 to 0401: Changed Data Distribution Module, table 33-4: Where MAC is involved, MAC supplies the Names if synchronise in DSM is done
The items that follow are incorporated in the update of this manual from issue 0401 to 0404: Changed Added Changed Changed Added Added Changed Added Added All Chapters: minor changes Chapter 6: Define a (dummy) Printer for TABS Chapter 8: List of TCP/UDP ports Chapter 17: Example screens Chapter 18: Warning when starting the Key programming Manager for the first time Chapter 28: Define a (dummy) Printer for TABS Chapter 31: Reference to DECT Manager Manual made instead of 'readme' file Chapter 35: Meser SQL View Chapter 36: OM Logging
PREFACE
This book is valid for Management@Net, release 2.1 installation on a Windows 2000 Server or Advanced Server. Management@Net, release 2.1 can also be installed on Windows 2000 Professional or Windows XP Professional, but without Terminal Services. This Customer Engineer Manual of Management@Net, release 2.1 is for the SOPHO iS3000 platform only. The English version of the Windows operating system is recommended.
GUIDELINES FOR MAINTENANCE AND ADMINISTRATION OF A SERVER/ SPECIALISED COMPUTER The following general rules should be kept in mind for a good administration and maintenance of a server/specialised computer: 1. Keep operating system and application software up-to-date Servers by their very nature form a critical part of the infrastructure. When they go down this will affect the entire business structure. It is imperative to keep the basic operating system and application software working and also up-to-date both for stability and security reasons. There can be an automated or semi-automated process for upgrades and patches. However sometimes upgrades and patches can have unpredictable interactions with running services. In case of doubts, please ask PBC about the possible impact of specific updates or fixes. 2. Don't run unnecessary services or applications Reduce risk by not running any non-essential service or application. It's about the possible interactions between them (e.g. ports that are used by other applications too), the server capacity or security lacks that might be introduced by those applications. When there is a need for combinations of applications then PBC should be contacted. Also check the manufacturer's features of the other product. Be aware of the impact on the services that should be provided. 3. Back up your data All computers will have a moment in time when they will fail (hardware or software). Servers usually host data. Loosing the server also means loosing data. That's why for every production system (servers, specialised machines) backup of the system and data is a must.
The backup procedure depends on many factors, like the volume of data, rate of data change, the recovery procedure, time for backup and recovery, and the response of the applications. Sometimes an automatic backup cannot work. There are applications that must be aware when the backup process is starting. This information you can find in the specifications (requirements) of the products involved. Summarised: there should be a backup policy, carefully analysed, built on the existing IT infrastructure. 4. Account maintenance / authorised use Keep a strict list of the accounts that will have access to the server and the privileges that they might have. If unauthorised users can have access to the server, then the entire server activity can be compromised, or even worse, affecting the business, e.g. when confidential information is accessed. 5. Specialised software for servers Strongly consider installing specialised software to provide: anti-virus protection, maintenance tools, and/or firewall. Firewall policy can be implemented in the entire network based on enterprise firewalls. Where these are not available, a "desktop" solution is welcomed. PBC applications can use a range of ports and kind of access. PBC Hilversum can be contacted for information about ports and accesses. Antivirus and firewall software has to be included in the list of applications that must be updated periodically. Some of the most used maintenance tools are ScanDisk and Defrag. After an unpredictable event, scanning the disk can be automatically or manually driven. Defragmentation is a must. Database applications are very sensitive to this issue. There could be performance bottlenecks or application errors. 6. Physical Security A power failure is one of the most often events, and also one of the dangerous. A good Uninterruptible Power Supply (UPS) will filter the current and in case of a general power down, it will provide the system a few minutes allowing the applications to close properly. Without an UPS, data can be lost or damaged (open files, unfinished changes in database, or files impossible to be recovered). Finally, also consider a correct location and environment (air conditioning, ventilation) for the equipment. 7. Computer Names Be very careful with changing the name of a computer. This brings a lot of changes. Many applications will need a reinstallation!
1.
INTRODUCTION
Management@Net consists of a number of web based management applications that supports the System Administrator or Telecom Engineer in performing their management tasks. These applications can be run from a PC at their workplace using Internet Explorer. In this release, the following SOPHO Management@Net applications are available: SOPHO Management@Net Maintenance Manager (OM@Net); SOPHO Management@Net Announcement Manager (AM@Net); SOPHO Management@Net DECT Manager (DM@Net); SOPHO Management@Net Phone Manager (MAC@Net); SOPHO Management@Net Directory Manager (PBM@Net); SOPHO Management@Net Accounting (Call Reporting Module version 7.026); SOPHO Management@Net Alarm Status Module (SNMP Alarming and Alarm Display Application); SOPHO Management@Net Authentication Manager (Central Authentication). SOPHO Management@Net Key Programming Manager; SOPHO Management@Net Third Party Applications (IP Gateways and others);
The underlying framework consists of: Login Module; Licence Manager; CM@Net Module (for IP connections); Connection Manager (for V.24 connections); @Net Core Module, working with the Call@Net Application Server (PVE); Central Authentication; Data Distribution Module; Directory Services Module; DECT Management Module; External Application Interface; MAC-Manager Module; MML Files Module; Operational Maintenance Module; Phonebook Manager; Announcement Manager Module; Alarm Status Module; TABS Call Reporting Module version 7.026; Key Programming Manager Module; ISPBX File Manager; Optionally, Microsoft Database Engine (MSDE) can be installed.
1.1.
The server contains application and configuration related components. Applications available via the Start menu are: Announcement Manager; DECT Manager; IFM Disk Emulator and IFM iS3000 File Convertor, both are part of the ISPBX File Manager; MAC-Manager Module; MML Help Files as part of the MML Files Module; OM Terminal as part of the Operational Maintenance Module; TABS as part of the Call Reporting Module version 7.026; Management@Net as access to Central Authentication for user administration.
Configuration related components available via the Start menu are: Licence Manager; CM Database Configurator, CM Modem Configurator and CM Monitor, all part of the Connection Manager for V.24 connections; CM@Net Connection Configurator as part of the Connection Manager for IP connections; ISPBX Destination Activator; CA Import Tool as part of Central Authentication; @Net Configurator One Day Password Tool as part of the Announcement Manager; User Administrator as part of the Login Module; Mgt@Net TSBased App Configurator for applications through Terminal Services; Directory Services; EAI Configurator; Where to Enter Data and How to Synchronise for Help on Data Distribution matters.
1.2.
Clients can start the applications, from a button in the portal see Figure 2-3 An example of the Management@Net portal. The portal also contains a Management Information Console in which the presence of ISPBX alarms are shown. After selecting the alarms, the Alarm Status Monitor is opened showing the alarm details. Applications that operate through Terminal Services, are:
Directory Manager (PBM@Net); Announcement Manager (AM@Net); Maintenance Manager (OM@Net); Phone Manager (MAC@Net). DECT Manager (DM@Net);
Management@Net, release 2.1 can also be installed on Windows 2000 Professional or Windows XP Professional, but without Terminal Services. This means that the applications mentioned above are not available. Other applications, not working through Terminal Services, are: Accounting as web client of a TABS Web server, which is running on the Management@Net server; Third Party Applications, one of them is IP Gateways Support; The Key Programming Manager.
1.3.
DOCUMENTATION
In addition to this manual, the following documentation is available: Management@Net Getting Started Management@Net MAC-Manager Getting Started Management@Net TABS Call Reporting Module - Installation Guide Phonebook Manager Getting Started Phonebook Manager Installation and Support Manual External Application Interface - Interface User Guide DECT Manager Manual
Beside the paper documentation, on-line help is available in most Management@Net modules with a user interface.
2.
2.1.
MANAGEMENT@NET ARCHITECTURE
THE CONCEPT
Management@Net consists of a number of web based management applications that are started from a Web Client via a Management@Net portal. Terminal Services is used to execute these applications remotely, so first an explanation of Terminal Services is given. Windows 2000 Terminal Services allows clients to remotely execute applications on a Windows 2000 based server from a wide range of devices. In Management@Net, these devices are the Web Client PC's with a Windows 95, Windows NT or Windows 2000 operating system and Internet Explorer. With Terminal Services running on a Windows 2000 based server, all client application execution, data processing and data storage occurs on the server. Applications and user desktops are transmitted over the network and displayed via terminal emulation software. Similarly, print streams, keyboard input and mouse clicks are also transmitted over the network via the terminal emulation software. All logged-on users have their own individual client-server session. Each session is managed by the server and is independent of any other client session. A specific Microsoft protocol, the Remote Desktop Protocol (RDP) running on top of TCP/IP, is used over a single fixed port (3389). A customer network configuration should allow this (think of firewalls).
2.2.
DEPLOYMENT VIEW
In Management@Net, the following devices are involved: Web Clients with a Windows operating system and Internet Explorer; A Web Server with a Windows 2000 Server operating system, Internet Information Server, Terminal Services, optionally Microsoft Database Engine (MSDE) and the required Management@Net modules installed;
Note: Without Terminal Services, Windows 2000 Professional or Windows XP Professional can be used as operating system. - If MSDE is not used, an SQL Server is required where the Management@Net databases will be stored. Note: The General name for the PC with @Net applications is called Call@Net Application Server.
10
Web Server
IP LAN
IP
Web Client
Figure 2-1 Management@Net architecture
Web Client
The process flow as experienced by a user of a Web Client starting a Management@Net application, is as follows: 1. A user of a Web Client browses with the Internet Explorer to the Internet Address (URL) of the Web Server. An example of such a URL is: http://pc4/ca/management.asp. 2. A login screen is shown and the user must enter the User name and Password.
11
Figure 2-2 An example of the Management@Net login 3. Central Authentication (CA) will check if the user is known in the CA database. If so, a Management@Net portal is shown. This portal shows the applications which the user is allowed to use.
12
Figure 2-3 An example of the Management@Net portal 4. After selection of the desired application, the user will be redirected to the required application. Some applications run through Terminal Services. Such an application is the Directory Manager and this is used as an example in the next steps. After connecting to the chosen application, a Terminal Services session is opened.
Figure 2-4 An example of connecting to the Directory Manager 5. The user will be prompted with a login screen for authorisation. If the User name and Password are correctly set, the login will go automatically. [The User name and Password
13
will come from CA and will be used on the Client to access the Terminal Services Server]. 6. Terminal Services will start up the application and a new user session is emulated: the user of the Web Client will now be running the application.
2.3.
The licensing of Terminal Services is subject to a procedure described by Microsoft. Licensing is not under control of Philips but controlled by Microsoft. Consult the Microsoft documentation: "Microsoft Windows 2000 Terminal Services, Licensing Technology White Paper" on their web site for the latest procedures.
14
2.4.
The SysManager 410 building (architecture) is part of Managemen@Net, and therefore it contains the SysManager 410 modules including the Data Distribution configurations.
2.4.1.
Architecture
The following SysManager 410 modules are always necessary and will always be installed: Licence Manager (LM); Login Module (LIM); Connection Manager (CM) and Connection Manager for IP (CM@Net); Data Distribution Module (DDM); MAC-Manager (MM); MML Files Module (MML); TABS Call Reporting Module (CRM); Directory Services Module (DSM); External Application Interface (EAI).
Together, these form the basis of SysManager: When you start a module, the module 'asks' the Licence Manager if it is allowed to run (e.g. does it have a licence for, say, the MAC-Manager) and how many ISPBXs it is allowed to manage (e.g. the MAC-Manager might be allowed to manage three iS3010 systems and two iS3030 systems). For some modules: when you start a module, the Login Module is called and you are presented with the Login Module's dialogue box. Your access to these modules is controlled by the name and password that you enter. When a module exchanges information with the ISPBX(s), it makes use of one of the Connection Managers (V.24 and/or TCP/IP). The following figure is an example of how the system architecture including the External Application Interface.
Note: Here is an important difference: in SysManager 410, only V.24 connections are possible (NO IP connections).
15
ISPBX
MAC DECT FDCR AM DE OM SS
AMM
IFM
OMM MML
MM
CRM
Display Services
CNND /TSD
SS Router
Healing Services
Data Distribution
Data Distribution
Data Distribution
EAI Services
COM Port
Messages
Figure 2-6 SysManager 410 Building (Architecture) including the External Application Interface Below the list of abbreviations used in the architecture example above:
16
ABBREVIATION MAC DECT FDCR AM DE OM SS DMM AMM IFM OMM MML MM CRM PMS 1
EXPLANATION MAC Management (OM/DE) purpose DECT Management purpose FDCR (Call Reporting Module) purpose Announcement Management purpose Disk Emulator purpose Operational Maintenance purpose Switching Services (SS Router + EAI/DSM) purspose DECT Management Module Announcement Management Module ISPBX File Manager Module Operational Maintenance Module MML Files Module MAC-Manager Module TABS Call Reporting Module Property Management System MAC-Manager can subscribe/unsubscribe a DECT handset using the DECT Management Module (if licensed)
Table 2-1 Abbreviations used in System Architecture All modules make a call to the Licence Manager Module before opening, to make sure that there is a valid licence available for them. Furthermore, most modules contact the Login Module, when a user tries to open them, in order to check whether or not the user has access permission for them. (The Licence Manager and Login modules are not shown in the diagram, for sake of simplicity.) An external application (for example, a Property Management System) might be used in a hotel or hospital. The Data Distribution Module distributes the required information so the other modules can update their databases, keeping the common information consistent. The SS Router routes messages to and from the ISPBX(s). The SS Router also interfaces with the External Application Interface (for handling service requests like DND, AEM, Bar/Unbar, Wake up, message waiting and PID requests) and the Display Server of the Directory Services Module (for handling TSD/CNND requests).
17
2.4.2.
Configurations can operate with or without Data Distribution. With Data Distribution, the following configurations are possible: Configuration Name MAC Full Hospitality Full Hospitality, no PMS Billing Full Hospitality, no CRM Basic Hospitality Basic Hospitality, no PMS Billing Full Distribution Full Distribution, no CRM Basic Distribution Messaging Yes Yes Yes No No Yes Yes Yes No CRM Yes Yes No Yes Yes Yes No Yes No DSM Yes Yes Yes Yes Yes Yes Yes No Yes EAI Yes Yes Yes Yes Yes No No No Yes
1)
Multi-Site
site. This site can be a single unit or a multi-unit system (FIN). The CRM supports PMS Billing (so the CRM sends the Call Info to the EAI and the EAI sends a bill to the PMS). CRM only works on a direct non-buffered FDCR connection to the site (FIN). For a multi-unit system (FIN) one output device for FDCR for the complete FIN can be used with the restriction of 8 FDCR call records per second. 3) The EAI supports only one site. 4) The EAI supports only one site. CRM can be used on multi-site and does NOT support PMS Billing. 5) The EAI supports only one site. If DSM is used for "Centralised SysManager for AEM in a DPNSS network" (Call@Net 2.5) all DNRs of all sites should be assigned to the same site group code in the Phonebook. Table 2-2 Supported Data Distribution Configurations Although the MAC, CRM, DSM and EAI are always installed, the chosen configuration determines which modules will be activated. This is done by the Data Distribution Configurator at the end of the installation or at a later stage if a transition to another
1) MAC and DSM are always multi-site. 2) The EAI and the CRM only support one
18
configuration is required, see Section 33.2. DATA DISTRIBUTION CONFIGURATOR. WARNING: IN THE FULL HOSPITALITY CONFIGURATIONS, NO NAMES ARE DISTRIBUTED TO THE MAC-MANAGER. FUTHERMORE, BY DEFAULT, PID HANDLING IS DONE COMPLETELY BY THE EAI OVER SWITCHING SERVICES; THIS REQUIRES SOFTWARE PACKAGE CALL@NET 2.10.
19
3.
SYSTEM REQUIREMENTS
The system requirements are split up into requirements for the Management@Net server, the Clients and the ISPBX's connected to the Management@Net server.
3.1.
The PC that operates as Management@Net server must meet the following requirements: Minimum PC requirements: - Pentium III, 1GHz; - 256 MB RAM (minimum 128 MB plus max 24 MB per TS user); - 4 GB free space on the hard disk with NTFS file system. Recommended PC requirements: - Pentium IV, 2 GHz; - 512 MB RAM; - 4 GB free space on the hard disk with NTFS file system. Microsoft Windows 2000 Server or Advanced Server with Service Pack 4or higher;
Note: Management@Net can also be installed on Windows 2000 Professional with Service Pack 4 or higher or Windows XP Professional with Service Pack 1 or higher, but without Terminal Services. - Internet Information Server 5.0; - Internet Explorer 5.5 or higher; - MSDE 2000 (Microsoft Data Engine) or SQL Server 2000; The Management@Net databases for Central Authentication (CA), Connection Manager@Net (CM@Net) and PBX Data Mirror (PVE) require a database server. This can be SQL Server 2000 or MSDE 2000. For Phoneware the database types SQL and Jet are supported. If the Phoneware database already uses SQL Server, then it is advised to also use this SQL server for CA, CM@Net and PBX Data Mirror. Otherwise MSDE 2000 is advised. Note that the use of MSDE is limited to five concurrent users. Note: MSDE 2000 is delivered with Management@Net and - if used - it must be installed before Management@Net is installed, see chapter 5. INSTALLATION. It is advised to install Service Pack 3 for MSDE (or SQL) which is available on the Management@Net CD-ROM. - Microsoft Windows 2000 Terminal Services installed and licensed; - Latest Microsoft Windows 2000 Terminal Services (Licensing) Hotfix; - Terminal Services Client Access Licences, to be obtained from Microsoft.
20
WARNING: OTHER SOFTWARE AND/OR APPLICATIONS ARE NOT ALLOWED ON THE CALL@NET APPLICATION SERVER PC. (SUCH AS A DOMAIN CONTROLLER FOR EXAMPLE)
3.2.
CLIENT PC REQUIREMENTS
PC's from where the Management@Net applications are started, are called Clients in the context of this book. These are the PC's on which the System Administrator or Telecom Engineer works. The client requirements are: Minimum PC requirements: - Pentium II, 233 MHz; - 64 MB RAM for Windows 95; - 128 MB RAM for Windows NT, Windows 2000 Professional or Windows XP Professional. Internet Explorer 5.5 or higher.
Note: Management@Net applications require downloading of extra components. These components are downloaded automatically the first time an application is started. This requires the correct security settings in the Internet Explorer, see section 6.3. CHECK THE SECURITY SETTINGS FOR THE INTERNET EXPLORER ON CLIENT PC'S. - Terminal Services Client Access Licences on the Management@Net server, to be obtained from Microsoft. Note: The Terminal Server must have enough Terminal Services Client Access Licences (TSCAL's). Windows 2000 based Client systems do not require TSCAL's.
21
4.
4.1.
ISPBX's connected to the Call@Net Application Server (for Management@Net) must meet the following requirements: Software package Call@Net 2.8 or higher for SNMP Alarming. Software package Call@Net 2.9 or higher for the Key Programming Manager. Software package Call@Net 2.10 or higher for a better performance of the Key Programming Manager. Besides, a download request from an ErgoLine user can be handled by the Key Programming Manager (option 115 is set to true). Software package Call@Net 2.10 or higher for complete PID control by the External Application Interface (EAI) over Switching Services. For the appropriate licences, options and boundaries that must be used, see tables below: Description Call@Net Application Service (formerly called PVE); set to yes
Number 56
Table 4-1 Required ISPBX Licences for Management@Net. Number 115 121 123 Description Function key downloading by Call@Net Application Server; set to yes (Call@Net 2.10) PVE active; set to yes PVE short XML; set to yes
22
Number 183 305 324 325 365 370 371 379 380
Description System limited number of softkeys; set to 60 Max number of internal CNND database entries; set to 0 (to let DDS update the names in the ISPBX instead of the MAC-Manager) Maximum number of sockets per unit; set to 200 Maximum number of sockets per task (CPU3000 only); set to 50 PVE listen port; set to 2596 (default) PVE manager id; set to 1 (default) PVE server id; set to 12345 (default) Maximum number of profiles; set to 10 Maximum number of known IP addresses; set to 10
4.2.
PROJECTING IP CONNECTIONS
A Client Server Profile must be set in the ISPBX and is needed for PVE, OM, SS and FDCR over IP, see steps below. The PVE Services is used for Alarming and the Key Programming Manager, the OM service is used by the Key Programming Manager, the OM Module, the MAC-Manager and for transport of buffered FDCR records (for Accounting); the TMS (SS) service is used by the DSM (CNND/TSD functions) and the EAI (Hospitality functions); the FDCR service is used for direct FDCR output (for Accounting). Note: A Client Server Profile is used as a protection mechanism. The Call@Net Application Server is connected to an ISPBX and operates as IP client via a Client Server Profile. The Call@Net software in the ISPBX operates as IP server and checks the rights through the Client Server Profile. To activate IP connections for OM, SS and FDCR, take the following steps: 1. Look for OM, SS and FDCR devices on the V.24 ports of the CPU (or CIE-2). Example: DIPORT:11,18,20&&25; where 11,18 is the CPU address. If necessary assign devices
23
with ASDEVC. Note: The recommended equipment types for OM are 14 and 15. With these equipment types journalling is skipped, which is important if the Key Programming Manager is used. Note: The FDCR device is only needed for direct FDCR output over IP (single site). The FDCR device must be assigned with equipment type 33 (FDCR over IP). 2. Check if the client is related to a Client Service Profile. Example: DIIPPR:192.168.1.5; where 192.168.1.5 is the IP address of the Management@Net server. 3. If needed, assign a Client Service Profile to the client. Example: CHIPPR:192.168.1.5,1; where 192.168.1.5 is the IP address of the Management@Net server and 1 is the Client Service Profile id. 4. Check the services on this Client Service Profile. Example: DIPROF:1; where 1 is the Client Service Profile id. 5. If needed, assign the required services to the Client Service Profile. Examples: CHPROF:1,0,1,VDU010; where 1 is the Client Service Profile id, 0 means OM, 1 means allowed and VDU010 is the logical device name of the OM connection found in step 1; CHPROF:1,1,1,SYSMSS; where 1 is the Client Service Profile id, 1 means SS, 1 means allowed and SYSMSS is the logical device name of the SS connection found in step 1; CHPROF:1,3,1,FDCRIP; where 1 is the Client Service Profile id, 3 means FDCR, 1 means allowed and FDCRIP is the logical device name of the FDCR connection found in step 1. Note: The FDCR device is only needed for direct FDCR output over IP (single site). For buffered FDCR, the OM service is used. Use for buffered FDCR the LBU as device name both on the CPU3000 AND on the BIM (CCS systems). 6. Check if the PVE service is running. Use DISRVC:0; to check, STSRVC:0; to start or SPSRVC:0; to stop. Other IP related OM commands that may be useful, are: DITCPC: to display the IP configuration of a CPU3000 or a CIE-2 board; EXPING: to check if the Call@Net Application Server can be reached over the network; DIIPSE: to display the (running) IP sessions.
4.2.1.
For a CCS system, the BIM should be programmed as a router to the CIE-2. The BIM has two network cards. One of the network cards must be assigned to the same network segment as the Management@Net server. The other network card that connects the BIM to the CIE-2, must be assigned to a different network segment. The picture below shows an example.
24
Management@Net Server
BIM
192.170.1.1 192.170.1.12
CIE-2
192.168.1.4
192.168.1.20
LAN
Figure 4-1 The BIM as gateway to the CIE-2 To reach the CIE-2 from a Management@Net server, take the following steps: 1. For Windows NT: On the BIM, in the TCP/IP properties (Network Neighborhood), select the Routing tab and set the 'Enable IP Forwarding' check box. See figure below.
25
Figure 4-2 Enable IP Forwarding on a BIM 2. For Windows 2000 Professional: Using the Registry Editor (regedit), check the registry key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Paramete
26
Note: IPEnableRouter=1, enables TCP/IP Forwarding for all network connections installed and used by this computer. 3. On the Management@Net server, add a new route entry in the routing table. Example using Figure 4-1 The BIM as gateway to the CIE-2:
route add 192.170.1.0 mask 255.255.255.0 192.168.1.20 -p IP address 192.170.1.0 and the mask defines the network to go to (CIE-2) and IP address 192.168.1.20 is the address of the BIM (router). The flag -p is used to make
4.3.
V.24 connections are used in the following cases: Connections to ISPBX's with software packages older than Call@Net 2.8. Disk Emulator connections for the ISPBX File Manager (IFM). IAS(A) connections for the Announcement Manager (AM).
Below, hints are provided on how to project the ISPBX ports for the various modules: Projecting for the MAC-Manager When using the MAC-Manager on a CPU-ME/MT system, a Remote Backup Unit (RBU) device must be added to the CPU-ME/MT's OM port. The MAC-Manager can be used on a CCS/CPS system with a standard projection, using the OM port. The same is true for a CPU3000 system. For CCS and CPU3000 systems with Call@Net 2.4 or higher, you can speed up the file transfer by adding a DSK device to the OM port. This is projected using the following OM-commands: Assign a V.24 port (for the CPU-ME/MT this must be BCS protocol). For a CPU-ME/MT system assign the logical device names VDUxx0, VDUxx1 (for the OM connection) and add an RBUxx device with equipment type 26 to this port. The value xx must be equal to the unit number of this system. Note: the RBU cannot be added to a port which contains the LBU device (port 20).
ASPORT ASDEVC
27
ASDEVC
SETINS
For CCS and CPU3000 systems assign the logical device names VDUxx0, VDUxx1 (for the OM connection). For Call@Net 2.4 or higher, you can speed up the file transfer by adding a DSKxx device with equipment type 26 to this port. The value xx must be equal to the unit number of this system. In the connection manager you have to select the check box: Optimise speed of MAC file transfer . To set the port in service.
Projecting for the TABS Call Reporting Module On a CPU3000 system, the LBU can be used as buffer for FDCR records; this saves a TOPS Box or ComboX. The CPU software package must be Call@Net 2.4 or higher . This is projected using the following OM-commands: Assign a V.24 port with BCS protocol. To assign the logical device names VDUxx0, VDUxx1 (OM connection) and DSKxx with equipment type 26 (disk emulator) to this port. The value xx must be equal to the unit number of this system. To set the port in service.
ASPORT ASDEVC
SETINS
Projecting for the External Application Interface Projecting for Messaging Only Assign prefixes for Automatically Entered Messages (AEM), assign switching services for: AEM requests, Do-Not-Disturb (DND) and message waiting indication for Manually Entered Messages (MEM) (see also the Hotel Applications manual, step by step). This is projected using the following OM commands:
ASTMSD
ASTMSW CHTMSL
Assign a V.24 port with BCS protocol. Assign a logical device name for switching services using equipment type 29. Assign prefixes for dialling AEM codes (result id 82); the number length is determined by the message number ( two digits) and possible additional information like date, time and so on. Specify the digit position. AEM maps on switching services window 83 which means that in the AEM prefix a digit '3' must be used. The position of this digit is determined by this OM command. Assign window 83 for AEM / Assign window 3 for message waiting / Assign window 5 for DND. Relate window 83 to the logical device name as assigned with OM command ASDEVC.
28
Projecting for Full EAI Take all actions for Messaging Only. Then assign prefixes for wake up and cancel wake up and announcement devices for wake ups. In addition, assign switching services for: bar/ unbar and automatic directory dialling. This is projected using the following OM commands: ASINTN ASTMSD Assign prefixes for request wake up and cancel wake up (result id 82). Specify the digit position. Wake up maps on switching services window 83 which means that in the wake up prefixes a digit '3' must be used. The position of this digit is determined by this OM command. Define the relations between announcement port numbers (as send by the EAI) and the announcers. Synchronous (answer) announcers require a DNR; continuous announcers require an EHWA. Assign window 2 for wake up requests. Assign window 4 for automatic directory dialling. Assign window 5 for bar/unbar and PID handling. Projecting for the Directory Service Module Assign a V.24 port with BCS protocol (not needed if already done for EAI). Assign a logical device name for switching services using equipment type 29 (not needed if already done for EAI). Assign window 81 for automatic name and number display; window size 9. Relate window 81 to the logical device name as assigned with OM command ASDEVC. Assign Facility Class Mark 28 to all extensions for which you want to have TSD.
CHTMSL
ASTMSW
29
5.
5.1.
INSTALLATION
FIRST INSTALLATION
The procedures below describes a general check, followed by the installation of Terminal Services and then followed by the installation of Management@Net.
30
7. Press Next. A Wizard starts. In this Wizard, choose 'Application server mode' and 'Permissions compatible with Windows 2000 Users'. 8. At the end of the Wizard, press Finish and restart the PC if requested.
Figure 5-1 Terminal Services Configuration - Server Settings 5. In the Terminal Services Configuration, select 'Connections' and double-click RDP-Tcp.
31
Figure 5-2 Terminal Services Configuration - RDP-Tcp settings 6. Select the 'General' tab. In the 'Encryption level' list, select 'Medium'. Select the 'Use standard Windows authentication' check box.
32
Figure 5-3 RDP-Tcp Properties - General settings Note: This setting is mandatory if users want automatic logon. 7. Select the 'Logon Settings' tab. Select 'Use client-provided logon information'. Clear the 'Always prompt for password' check box.
33
Figure 5-4 RDP-Tcp Properties - Logon Settings 8. Select the 'Client Settings' tab. Clear all check boxes.
34
Figure 5-5 RDP-Tcp Properties - Client Settings 9. Select the 'Network Adapter' tab. Select 'Unlimited connections'.
35
Figure 5-6 RDP-Tcp Properties - Network Adapter settings 10. Press OK and close the Terminal Services Configuration. Additional Information General remark: Run the service pack again after installation of new Windows components.
36
37
Figure 5-7 Terminal Services Setup: always choose 'Application server mode' 8. At the end of the Wizard, press Finish and restart the PC if requested. 9. Press Start, select Programs, Administrative Tools and then select Services. 10. In the Services list, double click on 'SNMP Service'. 11. In the SNMP Service Properties, select the 'Traps' tab. Enter 'Public' as 'Community name' and press 'Add to list'. Under 'Trap destinations', press Add and enter the SNMP host name. This is the system that receives the alarm information, i.e. the system that has the SNMP Manager.
38
Figure 5-8 SNMP Service Properties - Traps settings 12. In the SNMP Service Properties, select the 'Security' tab. Check the settings as shown in Figure 5-9 SNMP Service Properties - Security settings.
39
Figure 5-9 SNMP Service Properties - Security settings 13. Press OK and close the Services. Additional Information General remark: Run the service pack again after installation of new Windows components.
40
WARNING: DON NOT RUN SETUP.EXE! 6. Wait until the installation has finished. 7. Restart the PC as requested.
41
Note: MSDE or SQL is used to access the CM@Net database, CA database and the PVE Mirror database.
42
Figure 5-11 Provide password Get MSDE or SQL server info and use the same password as in the previous step (default "Philips"):
43
Figure 5-12 Get MSDE or SQL server info Check the program files and data files destinations. Normally the defaults are acceptable. - Review the settings. 9. Press Next. 10. During installation of the Directory Services Module Manager, select the Phonebook sort order. 11. During installation of the Phonebook Manager, choose 'Express'. If the box with text 'System must be restarted to complete the installation' appears, choose Cancel. So do NOT restart the PC!! 12. Wait until all modules have been installed and then press Finish. 13. Restart the PC. 14. After restart of the PC and log on as Administrator: - Wait until Management@Net has finalised the installation. - Choose the required data distribution configuration. - Review the data distribution configuration and confirm. - Choose the required system default language. -
44
5.2.
Re-install may be required if there are problems with an existing module. Install may be needed to install an additional module.
Note: Be aware that there are dependencies between modules. So if you re-install a particular module, other module may also be re-installed. 7. For modules that work with MSDE or SQL databases, a screen is shown asking you for the LoginID and the Password of the MSDE or SQL Server. The LoginID is sa and the Password is Philips, for example. 8. Before a re-install of a module, the system will ask you "Do you want to overwrite the program files?" and you have to press 'Yes'. Then the system will give you the choice to "Use the existing data files" or to "Overwrite the existing data files?" and you normally choose to "Use the existing data files" unless the data has been corrupted. 9. Restart the PC. 10. After restart of the PC and log on as Administrator: - Wait until Management@Net has finalised the installation. - Choose the required data distribution configuration. - Review the data distribution configuration and confirm. - Choose the required system default language. 11. Now follow the configuration procedure, see Chapter 6. CONFIGURATION.
5.3.
UNINSTALL
Uninstall may be required if certain modules are not (or no longer) used or to clean up a PC.
45
Note: Be aware that there are dependencies between modules. So if you uninstall a particular module, other module may also be uninstalled. 5. Follow the uninstall wizard. 6. Restart the PC.
5.4.
UPGRADE INSTALLATION
46
6.
CONFIGURATION
The procedures below describe the configuration of Management@Net. It is split up into a general part that always has to be done and separate parts that depend on the use of the different applications.
6.1.
GENERAL CONFIGURATION
47
Figure 6-1 Example of the @Net Configurator 5. Start the Mgt@Net TSBased App Configurator and check the following: - Behind 'Server', type the name of the Terminal Services Server (or IP address or Fully Qualified Domain Name). Note: A Management@Net application using Terminal Services from a client PC (through Internet Explorer) will try to connect to Terminal Services Server using this name. - Select the 'Automatic login for all users' check box. - Clear the 'Manual login for non Windows 2000 users' check box. - Under 'Application Settings', select the application tabs and you see the paths to the applications. Example: For OM@Net, this could be C:\Program
48
Files\Philips\Operational-Maintenance\om.exe.
Figure 6-2 Terminal Services based Application configurator 6. If the Management@Net Server is part of a Workgroup, the Clients must be known on this server. To create user accounts on this Windows 2000 (Advanced) Server, take the following steps: - Press Start, select Programs, Administrative Tools and then select Computer Management. - In Computer Management, select 'Users' under 'Local Users and Groups' - Create New Users with user names and passwords. These user names and passwords will be used during login to Management@Net applications. CAUTION: USERS OF THE MANAGEMENT@NET SERVER MUST HAVE ADMINISTRATOR RIGHTS.
Optionally, create a New Group (TS Users, for example) containing the users defined above.
If the Management@Net Server is part of a Domain, the Clients are known in the
49
network. Users must be added in a different way in the Central Authentication (CA) database. See step 7. CAUTION: USERS THAT ARE CREATED ON A DOMAIN CONTROLLER FOR USING MANAGEMENT@NET FUNCTIONS, MAY NOT HAVE A HOME DIRECTORY. THIS IS PART OF THE USERS PROFILE, SEE FIGURE BELOW. ALSO LOGON SCRIPTS MAY CAUSE PROBLEMS. USERS OF THE MANAGEMENT@NET SERVER MUST HAVE ADMINISTRATOR RIGHTS.
Figure 6-3 No Home Directory for Management@Net users created on a Domain Controller 7. Run Central Authentication through Start, Programs, Management@Net and Management@Net and login with user name 'Administrator' and an empty password. Click on 'Edit personal properties' and change the password. This is to avoid that everyone can login as Administrator. 8. In Central Authentication, select 'Administration' and press 'Add user'. Now, users have to be entered into the CA database. There are two different cases: a Workgroup is being used or a Domain is being used.
50
If Clients using Management@Net applications, are in the same Workgroup as where the Management@Net server is: - Under 'User properties', enter the Username and Password as defined in step 5. - For each application that the user may use, select the application check box and enter the Username and Password. These are the same as under 'User properties'. - Press Save. Repeat this procedure until all users are added. See also section 9.2. USER ADMINISTRATION FOR WORKGROUP ACCOUNTS. If Clients using Management@Net applications, are in the same Domain as where the Management@Net server is: - Under 'User properties', enter after 'WinNT login name' <domain name>\<user name>. For example: Domain116\Marcel. - For each application that the user may use, select the application check box and enter the Username in the same way as under 'User properties' and enter the Password. - Press Save. Repeat this procedure until all users are added. See also section 9.3. USER ADMINISTRATION FOR DOMAIN ACCOUNTS.
6.2.
51
5. Now you can start the MAC-Manager, login to it and leave it running.
PROCEDURE: Configure the Modules and Perform Initial Filling of the Databases
Actions Initially all databases used in the chosen data distribution configuration must be consistent. In Full Distribution, for example, data is shared between the MAC-Manager, the Call Reporting Module and the Directory Services Module (Phonebook). 1. Setup the modules correctly. See Section 33.3. FILLING THE DATABASES INITIALLY or the on-line help subject "Before filling the databases". You can find the on-line help in Start, Programs, Management@Net, Configurators. Double click on the icon: "Where to Enter Data and How to Synchronise". 2. Perform the initial filling. See Section 33.3. FILLING THE DATABASES INITIALLY or the on-line help subject "Filling the databases initially". You can find the on-line help in Start, Programs, Management@Net, Configurators. Double click on the icon: "Where to Enter Data and How to Synchronise".
52
Preview or Print-to-file.
6.3.
CHECK THE SECURITY SETTINGS FOR THE INTERNET EXPLORER ON CLIENT PC'S
Different applications running on a client PC require the right setting in Internet Explorer. The following procedure can be used to check these settings.
53
7.
7.1.
The basis of SOPHO Management@Net consists of the following components/modules: SysManager 410 modules including Data Distribution; Central Authentication; @Net Core Module (PVE Server). CM@Net (for IP connections). New web based components, inluding a new version of TABS.
The SysManager 410 building (architecture) is part of Managemen@Net, and therefore it contains the SysManager 410 modules including the Data Distribution configurations. This means that all configuration rules of SysManager 410 must be followed. All Customer Engineering aspects of SysManager 410 are integrated in this Manual. For user aspects, see the Management@Net Getting Started booklet.
7.2.
LICENCES
In addition to the usual "SysManager 410 licences" (see Chapter 22. LICENCES IN Management@Net), for Management@Net the following licences are required: Additional user licences for the MAC-Manager, because more MAC-Manager processes can be running at the same time. The number of additional user licences must be equal to the number of concurrent web users of MAC@Net; User licences for Web users: - Number of Management@Net OMM Web users (for OM@Net); - Number of Management@Net DMM Web users (for DM@Net); - Number of Management@Net CRM Web users (for Accounting); - Number of Management@Net MAC Web users (for MAC@Net); - Number of Management@Net PBM Web users (for PBM@Net); - Number of Management@Net AMM Web users (for AM@Net); - Number of Management@Net 3P1 Web users (for third party applications); - Number of Management@Net KPM Web users (for Key Programming Manager); - Number of Management@Net VMM Web users (for MyMail@Net 510). License for SNMP Alarming; Module and equipment licences for the SOPHO Mgt@Net Call Reporting Module, instead of the usual Call Reporting Module licenses.
54
7.3.
LIMITATIONS
The following general limitations apply to this Management@Net release: The Key Programming Manager can be used on software package Call@Net 2.9 or higher. However, the Key Programming Manager has a better performance on software package Call@Net 2.10 or higher. This is because OM command "Copy Function Key Data" has been added to Call@Net 2.10.
Note: In Call@Net 2.10, an ErgoLine user can request a download of function keys which is handled by the Key Programming Manager, provided that option 115 is set to 1 (true). - Adding or deleting PID's can be done by the External Application Interface through switching services on software package Call@Net 2.10 or higher. - SNMP Alarming operates only on ISPBX's that are connected through IP and on software package Call@Net 2.8 or higher. - CRM version 7.026 does not support Pre 805 ISPBX's - No more than four simultaneous users for applications that run through Terminal Services. - The ISPBX's connected to Management@Net must minimally have software package 805.24. Hospitality configurations require 805.29 or higher. - The MAC-Manager does not support CPU-ME/MT systems via a ComboX. This is because the ComboX only handles transparent mode Operational Maintenance (character protocol), while the MAC-Manager requires BCS protocol on CPU-ME/MT systems.
55
Handling requests from an ISPBX for Central Name and Number Directory (CNND) or Terminal Service Display (TSD): For TSD, minimally software package 805.25 is required; for CNND minimally software package 805.28 is required.
7.3.1.
Management@Net manages networks up to 20 ISPBXs and the maximum number of extensions is 5000 (total network).
7.3.2.
-
Management@Net 2.1 can handle a mix of V.24 and IP connections. On software packages older than Call@Net 2.8 there is no choice: only V.24 connections can be used. From software packages Call@Net 2.8 onward you can choose between V.24 and IP connections. Of course IP connections are preferred, because it saves modems and cabling and these connections are much faster. Some connections must be IP connections: for the Alarm Status Module and Key Programming Manager because these use the PVE Mirror process. The PVE link is activated in the CM@Net Connection Configurator if you select the "PVE" check box. The connection to DAS-iS is also IP based (SNMP protocol). Some connections must be V.24 connections: for the Announcement Manager (IAS or IASA) and the ISPBX File Manager (Disk Emulator). For direct FDCR output (Hospitality Configurations) and for Switching Services (Hospitality and Messaging Configurations) you have to choose: either V.24 or IP. For OM you can have both V.24 and IP to the same destination. In that case connection setup is first tried over IP and then over V.24. Special Points of Attention: - Buffered FDCR over IP means that the FDCR records are stored on the LBU both on the CPU3000 and on the BIM (so do not use the SPB function of the BIM). The records are taken using TYPFIL (not ZIPFIL), so only an OM connection is sufficient. This is automatically selected in the CM@Net Connection Configurator if you select the "Buffered" check box. - No mixed FDCR connections within a Fully Integrated Network. This means NO combinations of V.24 and IP to units in the network, but also NO combinations of direct and buffered FDCR output.
7.3.3.
Management@Net 2.1 can handle a network of more ISPBXs. However, if you use the Key Programming Manager, there are some restrictions:
56
Free numbering can not be used. Only one DPNSS cluster is allowed. DNRs must be unique throughout the customers network, so use NDNRs. This means that in a DPNSS cluster with open numbering scheme, a CLID (Cluster ID) must be used (NDNR=CLID+DNR). Note that the CLID equals the NAC (Network Access Code).
57
8.
8.1.
Since software package Call@Net 2.8, connections to the ISPBX's can be made through IP. Connections are made to the CPU3000 directly or - for CCS systems - to the CIE-2 via the BIM. Other applications over IP are: DECT Manager (DAS-iS), External Application Interface and Messenger@Net. The following TCP/UDP Ports may be used: Protocol TELNET (OM) Application OM Module, MAC-Manager, Collection of buffered FDCR records (for CRM) and Key Programming Manager Call Reporting Module Direct FDCR output for Hospitality configurations Directory Services Module, External Application Interface Module Alarming, Key Programming Manager DECT Manager for DAS-iS Between Management@Net and a Fault Management System Used by Terminal Services Browser, Web pages Messenger@Net Link between PMS and External Application Interface TCP/UDP Port 23
FDCR
2599
Switching Services PVE SNMP and FTP SNMP Alarming RDP HTTP eAPI PMS1)
1)
2597 2596 161 and 21 161 and 162 3389 80 3112 (default) 4000 (default)
The PMS link is configured in the EAI Configurator and not in CM@Net!!
58
8.2.
The CM@Net Connection Configurator is used to: Define connections over IP to the ISPBX's for OM, Switching Services, FDCR and PVE. Define connections over IP to the DCX board on a DCC-8 for the DECT Manager (DASiS). Define a Messenger@Net Connection.
59
Figure 8-1 Configuring a PBX Connection 4. Press Apply. 5. Repeat the previous steps until all ISPBX's have been defined. 6. Activate all destinations: Select a destination name in the left pane and - from the Configure menu - select Activate. 7. Close the CM@Net Configurator.
60
3. From the Configure menu, select Create and choose DAS-iS. 4. Fill-in the IP Address of the DCC-8. All other parameters are acceptable.
Figure 8-2 Configuring a DAS-iS Connection 5. Press Apply. 6. Repeat the previous steps until all DAS-iS systems have been defined. 7. Close the CM@Net Configurator.
61
3. From the Configure menu, select Create and choose Messenger@Net. 4. Fill-in the Node Name, Hostname or IP Address and TCP/IP port (default 3112) of the Messenger@Net system.
Figure 8-3 Configuring a Messenger@Net Connection 5. Press Apply. 6. Close the CM@Net Configurator.
62
9.
9.1.
The Central Authentication database is used to control access for all web clients. It contains the user names and passwords and the access rights to the various Management@Net applications. After login to Central Authentication as Administrator and select User Administration, you can Add, Delete or Edit users. For users who can access applications that run through Terminal Services, the user must also be known in Windows (user account). This is because at the moment an application starts, Terminal Services will logon to Windows. How user accounts are created, depends on whether the Managemen@Net server is in a Domain or in a Workgroup. Check 6.1. GENERAL CONFIGURATION.
9.2.
1. 2. 3. 4. 5.
Press Start, select Programs, Management@Net and then select Management@Net. Login as Administrator. Select User Administration. Select the Personal Properties tab. Press the Add New button and enter the user attributes: - 'Username' is the CA login name for the end-user. - 'Phone number' is the active phone number (NDNR) in the ISPBX of the end-user. This item is optional for Management@Net. - 'Password' is the CA login password for the end-user. This item is optional. - 'WinNT login name' is not used for Workgroups. - 'E-mail address' is used to supply password information in case a user forgets his or her password. This item is optional. 6. Press the Apply button. 7. Select the Management@Net tab and search for the user. 8. Select the check boxes for the applications that you want to assign to this user. Some applications require a login name and a password. You will be prompted if necessary. CAUTION: FOR TERMINAL SERVICES BASED APPLICATIONS, USE THE WORKGROUP ACCOUNT. THIS ACCOUNT MUST HAVE BEEN DEFINED ON THE MANAGEMENT@NET SERVER.
9.3.
63
2. 3. 4. 5.
Login as Administrator. Select User Administration. Select the Personal Properties tab. Press the Add New button and enter the user attributes: - 'Username' is the CA login name for the end-user. - 'Phone number' is the active phone number (NDNR) in the ISPBX of the end-user. This item is optional for Management@Net. - 'Password' is the CA login password for the end-user. This item is optional. - 'WinNT login name' is user's domain account and must be defined in the format <domain name>\<user name> , example: sopho.com\marcel. - 'E-mail address' is used to supply password information in case a user forgets his or her password. This item is optional. 6. Press the Apply button. 7. Select the Management@Net tab and search for the user. 8. Select the check boxes for the applications that you want to assign to this user. Some applications require a login name and a password. You will be prompted if necessary. CAUTION: FOR TERMINAL SERVICES BASED APPLICATIONS, USE THE DOMAIN ACCOUNT IN THE SAME WAY AS YOU DID FOR THE 'WINNT LOGIN NAME'. THIS ACCOUNT MUST HAVE BEEN DEFINED ON THE DOMAIN CONTROLLER.
9.4.
You can import user data into the Central Authentication database with the Central Authentication Import Tool. User data can be imported from Domain accounts, the Phoneware database or from a predefined file in "csv" format. This procedure is recommended when you want to add lots of users to the CA database at once, for example, when the system is initially started up at the customer site.
64
3. Make a choice to import Domain accounts or PhoneWare database entries. 4. Define the path and name of the intermediate file, which will be used to store the Domain accounts or PhoneWare entries. 5. Specify the name of the PC running the database engine that controls the CA database. 6. Press the 'Export' button. A file as defined in step 4 is created. Note: It is also possible to create the intermediate file yourself with Excel or a text editor and use this file as starting point for importing data to the CA database.
Figure 9-1 Example of a CA Import Tool Session 7. You can edit this intermediate file, but the layout must comply to the following specification: - The first line contains the LABELS of the data fields and are separated by a comma. - Each line is separated by a Carriage Return/Line Feed. - Empty fields contain no characters, even no SPACE character. - Every line contains the same amount of data fields. - The contents of data fields have NO (single or double) quotes around it. 8. Use at least the fields: 'USERNAME' and 'DNR' when importing data to CA. When Domain login names will be used, use 'NTACCOUNT' as well.
65
Figure 9-2 Example of a 'csv' File 9. Press the 'Import to CA' button and the contents of the intermediate file will be imported to the CA database. 10. A confirmation screen will appear, see the example below:
66
Figure 9-3 Example of an Import to CA Confirmation 11. Start CA to verify that the users have been added and to modify some settings. 12. Enable the applications for all the new users. 13. Save the modifications and leave CA / user administration
67
10.
10.1.
The OM@Net module is used for remote access to an ISPBX. It is designed as a web interface to the OM Module and allows clients to perform Operational Maintenance on an ISPBX using Internet Explorer and Terminal Services to run an OM Terminal.
10.2.
68
11.
11.1.
The DM@Net module is used for remote access to a DECT system. It is designed as a web interface to the DECT Manager Module and allows clients to perform subscription and configuration on a DECT system using Internet Explorer and Terminal Services to run the DECT Manager.
11.2.
69
12.
12.1.
The MAC@Net module is used for remote preparation of moves, adds and changes for an ISPBX. It is designed as a web interface to the MAC-Manager Module and allows clients to perform moves, adds and changes on an ISPBX using Internet Explorer and Terminal Services to run a MAC-Manager.
12.2.
70
71
13.
13.1.
Many customers have centralised fault management systems like HP OpenView or IBM NetView. These fault management systems are based on SNMP. In Management@Net an SNMP Agent is installed. This SNMP Agent will send alarm counter information when any major, minor, silent or blocked alarm in the ISPBX changes. Detailed information about alarms must be retrieved using OM@Net. Note: SNMP Trap uses port 162 and SNMP get uses port 161.
Management@Net Server
PBX
72
implementation (if present). Refer to the application documentation for more information or contact the vendor of the virus scan application.
13.2.
The Alarm Display Application is used to display alarm information in the Management@Net portal. It will display the same information that is available through the SNMP Alarming interface as traps. This alarm information is shown as part of the Management Information Console, which is available for every user. Below is an example of a Management@Net portal with the Management Information Console, containing alarm information:
Figure 13-2 Example of the Management Information Console with ISPBX Alarms If you click on the entry in the Management Information Console, an ISPBX Alarm Status
73
Monitor window will pop up showing you the Source (ISPBX), the alarms (Major, Minor, Silent or Blocked) and the number of alarms (Extra information):
Figure 13-3 Example of the ISPBX Alarm Status Monitor window Now you can use the Maintenance Manager (OM@Net) to further investigate the alarms and take appropriate maintenance actions to solve the alarms.
13.3.
ALARM INFORMATION
For both the SNMP Alarming and the Alarm Display Application, the following alarm information is monitored per ISPBX: Changes in the Major Alarm Count; Changes in the Minor Alarm Count; Changes in the Silent Alarm Count; Changes in the Blocked Alarm Count; Changes in the Operational Status: SOPHO iS3000 (PVE) link failure, for example.
If an the alarm counter is zero for an alarm category, the message disappears.
13.4.
Application Status Monitor is part of the Alarm Status Module. It collects notifications from various processes and will display these notifications in the Management Information Console box in the portal of the user. The Management Information Console, is available for every user.
74
Currently, the following processes report to the Application Status Monitor: Call Collector Guard (part of CM@Net). It reports if polling to a destination was not possible in time, for example. External Application Interface. It reports if a connection to a destination was lost, for example. Data Distribution Module. It reports if data distribution failed, for example. PBX Data Mirror. It reports if a PVE link to an ISPBX was lost, for example. Electronic Data Transfer. It report that a destination could not be updated, for example.
Below is an example of a Management@Net portal with the Management Information Console, containing Status Control information:
Figure 13-4 Example of a Management Information Console with Status Control Information If you click on the entry in the Management Information Console, the details are shown. You can use this information to further investigate the problem and take appropriate actions to solve it. You also can delete the information by pressing the Delete button. See figure below:
75
2. Add a new 'DWORD value" with process name as "value name" and as "value data" a 1 (suppress) or a 0 (do not suppress).
76
Any 'wav' file can be used, but the name must be alarm.wav. If this file is not present, no alert is given.
77
14.
14.1.
The Management@Net Accounting or TABS Web Access is used for remote access to the CRM Server. It is designed as a web interface (using Internet Explorer) to generate reports, to view or change organisational elements (extensions, accounts, hierarchy) and to monitor the system status (polling, alarms). The CRM Server is installed on the same PC as the Management@Net server. With an administrative tool called Web Admin on the Management@Net server, the access rights of the users of a client are set.
14.2.
78
15.
15.1.
The Phonebook Manager@Net module is used for remote access to the central directory (Phonebook). It is designed as a web interface to the Phonebook Manager and allows clients to look in and edit the Phonebook using Internet Explorer and Terminal Services to run an Phonebook Manager.
15.2.
79
16.
16.1.
The Announcement Manager@Net module is used for remote access to the VoiceManager 110 (IASA) or the VoiceManager 150 (IAS). It is designed as a web interface to the Announcement Manager and allows clients to program announcements and ports using Internet Explorer and Terminal Services to run the Announcement Management Module. A "One Day Password Tool" is available in the configurators group of Management@Net and is used to generate a one time (one day) password to logon to the VoiceManager 110 (IASA) or the VoiceManager 150 (IAS) for the first time. The "One Day Password Tool" is only available on the Management@Net server; it cannot be used by a Web client. However, there are also default passwords for first time logon and these passwords can be found in the Customer Engineer Manual for the VoiceManager 110 (IASA) or the VoiceManager 150 (IAS).
16.2.
80
81
17.
17.1.
The Management@Net portal should not only give access to Philips products, but also to other applications. An example is the IP Gateways support discussed later in this chapter. The system administrator can - in Central Authentication - program buttons for the users. For this purpose the system administrator has a Third Party Application Configurator. The following properties can be set for the user button: Application Name that appears in the button in the users portal; URL to where the browser goes if the user presses the button; Icon that appears in the button in the users portal; Window properties, like the width and height of the window and toolbars.
17.2.
IP GATEWAYS SUPPORT
The IP Gateways button in the Management@Net portal is used to link to an IP Gateway for remote maintenance. Pressing the button takes you to a list of hyperlinks to Gateways. A link takes you to a Gateway for remote maintenance, i.e. status and configuration. The list with hyperlinks can be updated by the user.
17.3.
82
Figure 17-1 An example of an IP Gateway Configurator List 5. If no links have been made, you can add a link as follows: enter a Name and a URL and press 'Add'. 6. If links are present in the list, just select the required link and you will be routed to the Gateway.
83
84
18.
18.1.
The Key Programming Manager is used for remote programming of function keys and facility codes for ErgoLine users. The system administrator can in this way program an ErgoLine for a user or for a group of users using templates.
85
- The time that an extension connected to a Function key Menu is longer. In Call@Net 2.10, the first function key menu of the range will be used to store the default template. Also in Call@Net 2.10, a new option is introduced: "Function Downloading by External" (Option 115=Yes). This means that if a user sends a function key download, a request is sent towards the Management@Net Server. So Key Programming Manager handles the function key download. This mechanism is not used for other types of Feature Phones, such as SOPHO-SET S375, P375, S370, P370. After a download request, the data is loaded from the menu's in the ISPBX. Set Boundary 183 (system limited number of softkeys) in the ISPBX to at least 60. Journalling of CHFKDA must be switched off, which means that you must assign the OM devices with equipment type 14 and 15.
18.2.
If you press Yes the Key Programming Manager starts, but at your own risk. Better is to press No and use the Key Programming Import Tool first, see 18.3. KEY PROGRAMMING IMPORT TOOL. Also read section 18.4. WHAT YOU NEED TO KNOW ABOUT THE KEY PROGRAMMING MANAGER for a better understanding of the Key Programming Manager. Actions 1. Start the Internet Explorer.
86
2. Go to the Internet Address (URL) of the Management@Net server. An example of such a URL is: http://pc4/ca/management.asp . 3. Login with the User name and Password as supplied by the System Administrator. 4. On the Management@Net portal, choose 'Key Programming Manager'. The web application 'Key Programing Manager' opens. 5. For working in the Key Programing Manager, on-line help is available.
18.3.
You can import existing function key data (menus) from an ISPBX unit using the Key Programming Import Tool (KPIT). The basis for KPIT are the retrieve files: PRxx.POM and ORxx.POM. Use the Key Programming Import Tool only once, after installation of the Key Programming Manager. If the Key Programming Import Tool is used after you have been using Key Programming or the Key Programming Manager, it will overwrite existing function key settings. To avoid taking information contained in the menus used by Key Programming, you can use the Advanced button (see below).
87
Figure 18-1 Example of an Import with the Key Programming Import Tool 5. You may use the 'Advanced' button to exclude a range of menus. This means that the information contained in these menus are not imported into the Key Programming Manager. In addition, you can also ignore menus to be imported by using one or both of the check boxes.
Figure 18-2 Example of Advanced Settings in the Key Programming Import Tool 6. Press the 'Import' button. 7. Repeat previous steps for all ISPBX units.
88
18.4.
In the next sections, more details are given about the Key programming Manager. Rules that you must observe, are given as 'CAUTION' .
18.4.1. Definitions
The following definitions are vital to understand the Key Programming Manager. Menus Menus in the ISPBX are used to program one or more feature phones, like ErgoLines. Menus must contain the programming of functions keys AND facility codes. Function keys are physical keys that are programmed for functions like Follow Me. Facility codes are codes (prefixes) sent to the ISPBX to activate or deactivate the function. For example, for Follow Me the facility codes can be *21 to activate or #21 to deactivate. Facility codes are also called soft keys, because they are stored in the memory of the feature phones (using virtual key numbers). Templates Templates are used in the Key Programming Manager to store function key data AND facility codes. After installation, there is one template called 'Default' that contains only facility codes and all extensions are linked to this default template. When you create a new template, the default template is used to give you a copy of these facility codes; after that you program the function keys and link extensions to this new template.
89
CAUTION:
FROM THIS STORY, YOU CAN SEE THAT: THE RESERVED MENU RANGE (50 - 59) IN THE ISPBX CANNOT BE USED FOR ANY OTHER PURPOSE. EXISTING PROGRAMMING IN THIS MENU RANGE (50 - 59) IS LOST. EVENTUALLY, ALL EXTENSION RELATIONS TO EXISTING MENUS IN THE ISPBX WILL BE DELETED AFTER YOU LINKED THESE EXTENSIONS TO NEW MENUS IN THE KEY PROGRAMMING MANAGER.
Through templates, the programming of functions keys AND facility codes are maintained in Management@Net. The default facility codes come from a file named Template_EN.csv in C:\Program Files\Common Files\Philips\PSEngine\Data. This file has no direct relation with the actual facility codes in the ISPBX. CAUTION: FROM THIS STORY, YOU CAN SEE THAT: YOU HAVE TO VERIFY THAT THE FACILITY CODES IN TEMPLATE_EN.CSV REFLECT THE VALUES USED IN YOUR ISPBX. DO THIS BEFORE YOU CREATE NEW TEMPLATES IN THE KEY PROGRAMMING MANAGER.
90
CAUTION:
FROM THIS STORY, YOU CAN SEE THAT: YOU HAVE TO VERIFY THAT THE FACILITY CODES IN THE TEMPLATES REFLECT THE VALUES USED IN YOUR ISPBX. DO THIS BEFORE YOU CREATE NEW TEMPLATES IN THE KEY PROGRAMMING MANAGER.
CAUTION:
Linking Extensions When you have a template, you link extensions to it. As soon as the system downloads the data to these extensions, earlier menu-extension relations are gone. This is because an extension can only be linked to one menu in the ISPBX. Example: suppose you had extension 3040 and 3042 linked to menu 2 in the ISPBX. After using the Key Programming Manager where you linked extension 3040 and 3042 to Template 10-2 and downloaded the settings, extension 3040 and 3042 are no longer linked to menu 2. This is not a problem, because all the data is kept in Management@Net (PVE database). CAUTION: BACKUP THE PVE DATABASE REGULARLY!
91
19.
19.1.
TROUBLESHOOTING
INTRODUCTION
19.2.
If a client does not close the application, but presses Disconnect or closes the Internet Explorer instead, the TS session keeps running on the server. To avoid this, a time out can be set on TS sessions. The Terminal Services time-out can be set per user or in the TS server.
PROCEDURE: Terminal Services Time Out per User on a Domain Controller (Windows 2000 Server)
Actions 1. Make sure that you have Administrator rights on the Domain Controller. 2. Press Start, select Programs, Administrative Tools and then Active Directory Users and Computers. Select a user and Properties. Select the tab Sessions. 3. Here you can set Terminal Services time outs for a disconnected session, an active session or an idle session. See figure below.
92
93
1. Make sure that you have Administrator rights on the Terminal Services Server. 2. Press Start, select Programs, Administrative Tools and then Terminal Services Configuration. Select Connections and double-click RDP-Tcp. Select the tab Sessions. 3. Here you can set Terminal Services time outs for a disconnected session, an active session or an idle session. See figure below.
94
19.3.
If a client on a domain cannot automatically logon into CA (so gets the Management@Net login screen), check the following.
95
Figure 19-3 User Account Properties on Domain Controller 3. Check that 'All computers' has been selected. See figure below.
96
97
Figure 19-5 Directory Security Properties of CA 3. Check that the 'Anonymous access' check box has NOT been selected. See figure below.
98
99
20.
20.1.
100
driver for your network adapter by using 'Have Disk...' or, in case of a Stand-Alone installation without a network adapter, install the Microsoft Loopback Adapter.
20.2.
Some PCs contain energy saving features, which, when used in conjunction with battery powered 'Lap-Top' PCs, can effect the performance of some Windows applications. It is possible, for example, that the Connection Manager will be unable to set up connections when the PC is in 'Energy Save' mode. It is therefore advisable to: SWITCH PC POWER MANAGEMENT TO 'OFF' Refer to the documentation provided with the PC for further information and specific instructions regarding Power Management settings. In Windows 2000, power management can be configured via 'Power Options' in the Control Panel. It is not possible to generally describe the Power Management switch-off procedure, as this will depend on the PC brand and type. For Compaq Desktop PCs the following procedure should be used to switch the PC Power Management off: 1. If the system is running, shut it down and switch off the power. 2. Switch on the power, and let the PC reboot, until, just after memory check, the cursor appears in the upper right corner of the screen. Press F10 now and the PC will enter Setup Mode. 3. Select the appropriate language from the dialogue box. 4. Select 'Power Management' from next dialogue box and follow the instructions to switch off 'Energy Saver' mode.
20.3.
Should the desired configuration require more than two COM ports, then a multi-port card must be installed in the SysManager PC in a free PCI slot. Refer to the product documentation for more information. WARNING: ONLY THE PCI-FAST 8 CARD (CHASE) AND SMARTIO C168H/PCI CARD (MOXA) CARDS ARE SUPPORTED ON WINDOWS 2000.
101
1. 2. 3. 4.
Shut down the PC, switch off the power and remove the power plug. Remove the PC cover. Locate an empty PCI slot. Insert the multi-port card firmly, and secure it to the chassis with the retaining screw provided. 5. Replace the PC cover. 6. Attach the plug with the eight V.24 cables to the card and tighten the screws. 7. Insert the power plug and switch on the PC. 8. Logon as Administrator. Windows 2000 detects the new card and starts the 'Found New Hardware Wizard' automatically. 9. Press 'Next' and select 'Search for a suitable driver'. 10. Select 'CD-ROM drivers' and insert the CD-ROM delivered with the card. Close the "Welcome' screen. 11. Press 'Next'. 12. A box with the message 'Digital Signature Not Found' can be ignored by pressing 'Yes'. 13. Press 'Finish'. 14. The 'Found New Hardware Wizard' will start again. Just repeat the steps above.
102
21.
21.1.
Once Management@Net is installed, it is possible to give users limited or no access to modules. There are three methods: Access is always allowed. Examples are the Directory Services Module and the MML Files Module; Access is controlled by adding additional users within the module. This is the case for the MAC-Manager and TABS Call Reporting Module; Access is controlled by the Login Module.
Note: The Login Module also sets the language for the user who is allowed to access the modules/ applications. The following table gives an overview of the access methods for the various modules/ applications.
103
Module/Application Licence Manager Login Module (User Administrator) Connection Manager Database Configurator, Modem Configurator and Monitor ISPBX Destination Activator One Day Password Tool Operational Maintenance Announcement Management DECT Management EAI Configurator Data Distribution IFM Disk Emulator MAC-Manager TABS Call Reporting Directory Services and MML Files Table 21-1 Module/Application Access
Login Module Login Module No authorisation No authorisation No authorisation Login Module Login Module Login Module Own authorisation mechanism Own authorisation mechanism No authorisation
21.2.
SWITCHING LANGUAGES
Modules are installed in various languages. It is possible to set the general system language. The general system language is used for the names of the Management@Net program group and the names of the applications in this program group.
104
PROCEDURE: Setting the Language for the MAC-Manager and the TABS Call Reporting Module
Preconditions To switch to a user specific language that is different from the system wide language (set at the end of the installation or with the Language Selector), the user must have been defined in the Login Module with the required language. Modules like the MAC-Manager and the TABS Call Reporting Module can operate in different languages, but are not authorised through the Login Module. However, during Windows log on the user name is checked with the Login Module to set the language for the MAC-Manager and the TABS Call Reporting Module. Actions 1. Define user name(s) in the Login Module that are identical to the Windows log on user name(s) and set the required language(s). 2. From the Start menu, select 'Shut Down'. A 'Shut Down Windows' box is shown. Select 'Close all programs and log on as a different user' and press 'Yes'. 3. Windows asks for a User name (and Password). Enter the user name as defined in the Login Module. This user name is checked through the Login Module and - if found - the user's language is set in the registry. Now the MAC-Manager and the TABS Call Reporting Module will operate in the user's language. Additional Information If no user names have been defined in the Login Module, the MAC-Manager and the TABS Call Reporting Module will operate in the system wide language.
105
22.
22.1.
LICENCES IN Management@Net
LICENCE MANAGER
The Licence Manager is used to activate and view the licences for the various applications. So as soon as an application is started a license check is done. On top of the application license, some applications require additional licenses such as equipment licenses, free instance licenses and/or functional licenses. The Licence Manager is located in the 'Configurators' program group. Licences are required for all applications, except for the Licence Manager itself, the Connection Manager or the CM@Net, the Login Module and the MML Files Module. The following types of licences exist: An application only license, an example is the Operational Maintenance Module. An application license related to equipment (iS3000 type and amount). This is used for the Call Reporting Module and the MAC-Manager. An application license with functional levels, an example is the External Application Interface with "Full" functionality or "Messaging only" functionality. Aa application license related to equipment (ISPBX licences: iS3000 type and amount) AND functional levels. An example: A customer has bought a license that allows him to use the MAC-Manager on one iS3010 and three iS3050's with DECT subscription management. "Additional User Licences". These are the licences permitting users to work with multiple instances of the MAC-Manager for MAC@Net.
If you open the Licence Manager, it displays an overview of the Licensed Applications. The following details are displayed if you select an application: The computer(s) that hosts the application: Host Name and IP Address; Wether the application is currently in use or not available ('Free Instance Licences'); The date the Licences Expire; The Functionalilty Licences of the application; The Equipment Licences: Equipment Model (iS3000 type), Used and Free.
More information about the Licence Manager can be found in 'Management@Net Getting Started'.
106
22.2.
Before using the Licence Manager, it is necessary to connect a Dongle to the PC. There are two possibilities: 1. A Sentinel Superpro Dongle can be used. This Dongle is connected to a parallel port (e.g. LPT1:) of the PC. 2. A USB Superpro Protection Key can be used. This Dongle is connected to a free USB port of the PC. Both type of dongles have a unique fingerprint. Combining this fingerprint with the licence string makes SysManager work.
22.3.
107
2. In the dialogue box, identify the licence file and click 'Open'. The Licence file is identified by the extension .LIC. The Licence string will now be taken from the file and validated by the Licence Manager. If the validation is OK, the licensed applications can be used immediately.
22.4.
TROUBLESHOOTING
108
22.5.
Note: It is possible to upgrade from a "No Reporting" CRM license to a "Full Reporting" CRM license. - "Full Reporting". The CRM uses all possibilities that FDCR offers and all currently possible reports can be used. For an overview of report types supported with this license, see: On-line help.
109
DECT sets. "Subscription via MAC-Manager". The DECT Management Module offers Subscription management for DECT sets from the MAC-Manager. The MAC-Manager license must include a "DECT Subscription Management" license. In this case also the "Configuration Management" license for the DECT Management Module must be set!! "Configuration Management". On top of Subscription management, the DECT Management Module offers Board, Radio and Configuration management.
110
CAUTION:
WITHOUT THE REQUIRED LICENSES DATA DISTRIBUTION DOES NOT WORK. THIS ALSO MEANS THAT AFTER AN UPGRADE A NEW LICENSE MAY HAVE TO BE LOADED MAC CRM DSM EAI DDM license required Yes Yes Yes Yes Yes Yes Yes No No MACB license required Yes Yes Yes No No Yes Yes No No
Yes
Full Hospitality, no Yes PMS Billing Full Hospitality, no Yes CRM Basic Hospitality Basic Hospitality, no PMS Billing Full Distribution Full Distribution, no CRM Basic Distribution Messaging No No Yes Yes Yes No
22.6.
These licenses are required if Web Clients use Management@Net applications. The amount of user licenses should be the same as the amount of users that use the Web based application concurrently. The following licenses are defined for this release of Management@Net: Management@Net OMM Web users; Management@Net MAC Web users; Management@Net DECT Manager Web users; Management@Net CRM Web users; Management@Net PBM Web users; Management@Net AMM Web users; Management@Net 3rd Party Web users; Management@Net KPM Web users; Management@Net VMM (MyMail@Net 510) Web users.
111
23.
23.1.
LOGIN MODULE
INTRODUCTION
Administrators use the Login Module's User Administrator application to administer each user's access to the modules. In addition, Administrators can also use the Login Module to set each user's default language for these modules. Ordinary users only use the Login Module's Login dialogue box. This can appear when they try to start a module; they must then enter a password in order to gain access. Because the Login Module is both simple and intuitive to use, it has no on-line help. Note: The Login Module is used for access to some modules on the Management@Net Server. For web access to modules, like OM@Net, the Login Module is not used.
23.2.
CLASSES OF USER
There are three classes of user associated with the Login Module: Ordinary User An ordinary user only has access to the Login Module's Login dialogue box. This offers him three functions: - Access to the modules, depending upon the rights configured by an Administrator. - The opportunity to change his password. - The opportunity to change his personal language. There may be one or many (normally many) ordinary users. Administrator An Administrator has access to the User Administrator application, which he uses to create, configure, and remove users and Administrators within the context of the Login Module. Creating and configuring includes the following tasks: - Allocating user names. - Allocating users' default passwords (although these can be later changed by users). - Configuring users' access rights to SysManager applications. (When applications comprise several sub-applications, access can be configured for each sub-application.) Administrators can also configure their own access rights. - Setting users' default languages (although these can be later changed by users). - Configuring login behaviour (the conditions under which the Login dialogue box is displayed to users). There may be one or several Administrators, depending upon the size of the installation.
112
System Administrator The system Administrator has all the abilities of the Administrators. He has access to all applications and sub-applications, and he (and anyone else) cannot delete or rename himself. There can only be one system Administrator.
23.3.
SECURITY
As can be seen from an examination of the list of Login Module users, the Login Module offers two levels of security: System Administrator / Administrator - access to all SysManager applications managed by the Login Module. (An Administrator may have to configure his own rights in order to gain access to all applications. However, this is easy to do, and does not require permission from the System Administrator.) Ordinary User - access to only those SysManager applications configured for the user by the system Administrator or an Administrator.
There is no security distinction between the System Administrator and any other Administrator, since all Administrators can: configure their own access rights to all applications managed by the Login Module enable and disable password protection globally, for all users and all applications managed by the Login Module
WARNING: IF THE SYSTEM ADMINISTRATOR OR ANY OTHER ADMINISTRATOR SETS THE LOGIN BEHAVIOUR TO LOGIN NOT REQUIRED, IT IS POSSIBLE FOR USERS TO GAIN ACCESS TO ANY SYSMANAGER APPLICATION NORMALLY PROTECTED BY THE LOGIN MODULE'S DIALOGUE BOX. THIS INCLUDES GAINING ACCESS TO THE LOGIN MODULE'S OWN USER ADMINISTRATOR APPLICATION. FROM WITHIN THE USER ADMINISTRATOR, IT IS THEN POSSIBLE TO DELETE ALL USERS AND ADMINISTRATORS. FURTHERMORE, IT IS POSSIBLE TO CHANGE ALL PASSWORDS INCLUDING THE SYSTEM ADMINISTRATOR PASSWORD!
23.4.
When an ordinary user starts a module, the Login Module's Login dialogue box may or may not be displayed, depending upon the system and user configuration set by an Administrator. If displayed, the dialogue box requires that the user enter his name and password in order to access the application he wishes to use.
113
Ordinary users can change their passwords, and can request a personal language. For more information about ordinary users' interactions with the Login Module's dialogue box, see SOPHO SysManager Getting Started. For a further discussion of personal user language, see.
23.5.
The System Administrator and other Administrators open the Login Module's User Administrator application by means of the MS Windows menu system. The Login Module's dialogue box controls access to the User Administrator, just as it does to other applications. The default user name for opening the User Administrator application is "System Administrator", and the default password is an empty string. Configuration of users is very intuitive, with the possible exception of the Personal user language (see section 23.5.1. What the User Language Setting Does) and Login behavior (see section 23.5.2. Login Behaviour).
Each source can have a different language defined. The Login Module's personal language setting only affects SysManager applications running in the Windows user interface. Most SysManager modules are available in a wide range of languages. These languages can be made accessible to users by configuring the users in the Login Module. Note: Before using the Login Module to configure users with languages, the required languages must first be installed.
114
Users are presented with the Login Module's Login dialogue box the first time they try to open an application governed by the Login Module. Provided that they open the application successfully, they are not presented with the Login dialogue box again, when they try to open other applications for which they have access permission. For each application Users are presented with the Login Module's Login dialogue box every time they try to open an application governed by the Login Module.
115
24.
24.1.
The Connection Manager module is used to create and manage V.24 connections between various modules and the ISPBX. It works together with the Licence Manager and the Login Module. The Connection Manager consists of: Foreground applications, which are found in the 'Configurators' group in the Management@Net program group Background applications, which are found as tray icons at the bottom right of the screen
For more information about using the Connection Manager, refer to the Connection Manager's online help.
The Configurator is dealt with at length in Section 24.2. THE CONNECTION MANAGER DATABASE CONFIGURATOR. CM Monitor The CM Monitor is used to monitor the data sent over a connection. It can be used for troubleshooting: for example, a connection failure. CM Modem Configurator You only need the CM Modem Configurator when you use non-standard modems. Use this application to: enter information about modem types specify the modem for the PC COM ports
116
ISPBX Destination Activator The Destination Activator detects whether or not the destinations configured in the Connection Manager database have a valid licence available for them to run. For more information, see Section 24.1.3. ISPBX Destination Activator User Interface.
The Process Guard ensures that the following Management@Net background functions are automatically (re)started when the PC is switched on and you are logged in: CM Broker CM Protocol Server
117
External Application Interface Module DSM Display Server and DSM Healing Server
For maintenance purposes, all background processes can be stopped as follows: 1. 2. 3. 4. Stop all foreground processes. Click on the Process Guard icon with the right mouse button. Click on 'Stop Processes'. A box shows the processes that will be stopped. Click on 'Yes'.
To start all background processes again: 1. Click on the Process Guard icon with the right mouse button. 2. Click on 'Start Processes'. The Process Guard itself can be stopped as follows: 1. Click on the Process Guard icon with the right mouse button. 2. Click on 'Close'. The Process Guard can be started by executing C:\Program Files\Common Files\Philips\Process Guard\PG.exe (default path). In this case, all background processes are also started. SS-Router It is only possible for one Connection Manager application to make use of one specific connection at any time. However, when the External Application Interface (EAI) and the Directory Services Module (DSM) are used, both applications attempt to make use of the same Switching Services connection to an ISPBX at the same time. For this reason, the SS-Router is placed between the EAI and the DSM and the CM. This enables the EAI and the DSM can make use of the Switching Services connection to the ISPBX concurrently, while it appears to the CM that there is only one application (the SS-Router) making use of this connection.
118
The ISPBX Destination Activator User interface can be started via the Management@Net Configurators Program Group, or from the CM Configurator's GUI, and can be used to: determine which destinations are inactive manually activate a destination
Manual activation of a destination is only required under exceptional circumstances, as indicated by the application using the Connection Manager (e.g. the Call Reporting Module). A possible case is where automatic activation has failed and a user does not want to wait until the next automatic activation. Before Using the ISPBX Destination Activator Check the following: The network is fully installed physically, including all necessary connections. The PC is running. OM connections are defined and operational for each ISPBX, even if only using Call Reporting Module at specific destinations.
24.2.
24.2.1. Overview
What you use the CM Database Configurator for: You use the CM Database Configurator to create connections between applications, and a destination in the ISPBX network such as an ISPBX, DECT Access System (using SNMP and TCP/IP), or VoiceManager (IAS/IASA). There are two aspects to creating these connections: Specifying the items (such as ISPBXs, ports, buffers or port selectors and so on) to be used in the connections, and storing them in the CM database. In other words, these are items which exist in the physical world, for which you record detailed notes in the CM database. Configuring connections by joining together specified items and storing information about the connections in the CM database. In other words, you determine how items which are physically connected, interact electronically.
How you interact with the CM Database Configurator: The CM Database Configurator can be completely wizard-driven. When using the wizard, you begin by selecting one of the eight basic connection types. The wizard then guides you through
119
the process of creating the connection. Although you must use the wizard to configure all connections, you can specify items and add them to the database while working outside the wizard. By using the wizard, you ensure that no part of the procedure for creating a connection is forgotten. Additional Features offered by the CM Database Configurator: A sophisticated print function enables you to create a permanent printed record of: all properties of a ComboX, SPB, or BIM all properties of a connection
Management@Net can automatically select the fastest modem available when it connects a module to an ISPBX. You create an ordered list of all modems potentially available for any connection, with the preferred (normally fastest) modem at the top of the list, the slowest last. When the connection is made, Management@Net selects the highest available modem in the list. The CM Database Connection Wizard guides you through this task.
When configuring a connection which includes a ComboX it is no longer necessary for the box to be physically connected to the network during configuration, since you can download the configuration settings later. To do this, click on 'Tools: Send ComboX settings...'
Note: If a (BCS) port appears more than once in a list, this is because it is used for more than one purpose. For example, you can use the same BCS port for Operational Maintenance and the MAC-Manager. Together, the two panes comprise an intuitive environment for exploring the contents -
120
ISPBXs, ports, buffers or port selectors and configured connections - in the CM Database. A further view of the CM Database is offered by using the print function. In the left pane, select one of: SPB/BIM ComboX Connection
then click on 'Configure: Print' (or 'Configure: Print Preview...'). In this way, a printed record detailing buffers or port selectors and connections is easily available.
You can add, delete, rename or otherwise manipulate an item by: right-clicking on the item in either the left or right panes, and using tools from the pop-up menu selecting the item by clicking on it, and using the tools available under the 'Configure' menu selecting the item by clicking on it, and using the tools available from Toolbar icons
The Connection Manager Configurator displays the appropriate dialogue box or wizard for you to complete or edit. The Connection Wizard The Connection Wizard is a unique item in the CM Database Configurator, because it enables you to perform all the tasks needed to create a connection - in fact, it automates almost all the functions available in the CM Database Configurator. It is your primary tool for creating connections, and is dealt with at length in section 24.2.3. The CM Database Configurator's Connection Wizard. The 'Tools' Menu While most aspects of the Configurator are extremely intuitive, some of the functions offered under the 'Tools' menu require further explanation. (It is these functions which are not offered by the Connection Wizard.) Activate Destination - The Destination Activator performs OM commands to check that all destinations (ISPBXs) entered in the database are physically connected to the Management@Net server, and that Management@Net has the necessary licences to manage them. While the Destination Activator normally runs in the background, you may need to start it manually in event of a system failure such as a cable disconnection, or when
121
you are first configuring a connection. For more information, see section 24.1.3. ISPBX Destination Activator User Interface. Show Connected Ports - Displays details of all the connections - including port details of the SPB or ComboX you select. Send ComboX settings- Upates the passwords and modem settings in a selected ComboX manually. See on line help for details. Normally, you do not need this, because a dialogue box invites you every time you complete the Connection Wizard or the ComboX Wizard.
Note: It is not always necessary for a ComboX to be physically connected to the network during configuration, since settings can be sent to it at a later time. Upload Firmware to ComboX- Uploads new Firmware to the ComboX from a file. See on line help for details. CM Monitor - Launches the CM Monitor application.
The Connection Wizard includes online help, which offers detailed information at a field level. See section 24.2.2. The CM Database Configurator's Environmentfor a wider view of the CM Database Configurator environment. See section 24.3. MAKING CONNECTIONS for details of configuring many of the connections you want to make. This section includes notes on both the CM Database Configurator, and other tools you require to create working connections. Opening the Connection Wizard By default, the Connection Wizard opens automatically when you start the CM Database Configurator. You can also open it at any time by: clicking on 'Connection Wizard...' in the 'Configure' menu - or -
122
right-clicking the 'Connections' icon in the left pane, and selecting 'New'
Note: If the menu items for the Connection Wizard are greyed out, this is an error, and could be because no Management@Net server is specified. This can only be caused by corruption of the database. Contact your Management@Net service provider. 'Connection Wizard - Connection type' dialogue box This first dialogue box in the Connection Wizard enables you to select one of the eight basic kinds of connection supported by Management@Net. The buffer or port selector referred to are: TOPS box ServicePlus Box / BIM (SPB/BIM) ComboX ISPBX local disk
For the purposes of this walk through, select 'Remote Connection to ISPBX via buffer or port selector'. The picture at the bottom of the dialogue box changes to display a connection between an ISPBX and a PC running Management@Net. Included in the connection are ports, modems, and an buffer or port selector. In the dialogue boxes that follow, the wizard guides you through the process of building the connection, working through the connected items from the ISPBX destination on the left, to the PC running Management@Net on the right. Click 'Next' to continue. 'Connection Wizard - Select destination' dialogue box Note: If there is no ISPBX specified in the CM database, the wizard does not show you this dialogue box. If there are already one or more previously-specified ISPBXs stored in the CM database, the 'Select destination' dialogue box appears. This box enables you to either select a stored ISPBX, or choose to specify a new one. Selection boxes of this kind are used frequently in the wizard - for example, when adding ports, buffers or port selectors. Click on 'Next' to continue. 'Connection Wizard - Unit' dialogue box
123
This displays either: details of the previously-specified ISPBX that you selected - or default values for the ISPBX you are about to specify
If specifying a new ISPBX, enter a suitable name in the 'Destination name' field. The name must be unique within the CM database, should be intuitively understood, and should be consistent with any company naming policy you have - for instance, 'ISPBX Amsterdam 2'. The 'Unit number' of the ISPBX can be any number from 1-14, even if the ISPBX unit is not part of a cluster. This is because a single ISPBX unit can be allocated any number. The 'Multi unit' check box is greyed-out if the 'CPU type' selected does not support multiple units. If you were creating a 'Remote connection without buffer or port selector', you would normally set the ISPBX Authorisation (enter the System ID and the passwords that have already been configured in the ISPBX). (See the online help for details about how to configure these.) The ID and passwords enable the ISPBX to demand authorisation for a connection (providing you tick the 'ISPBX authorisation required' check-box on the wizard's 'Port General Settings' dialogue box - this comes later). Note: Users do not have individual passwords. Instead, they use the password of the group to which they are allocated on the 'Port - General Settings' dialogue box. Users with 'Group 0' passwords are able to receive alarms, users with 'Group 1' passwords are not. You must enter the System ID and passwords in upper case when using an ISPBX with CPU-ME.
'Connection Wizard - Select destination port' dialogue box Note: If there is no ISPBX port specified in the CM database, the wizard does not show you this dialogue box. If there is already data for one or more previously-specified ports stored in the CM database, the 'Select port' dialogue box enables you to either select a stored port, or choose to specify a new one. 'Connection Wizard - Destination port general settings' dialogue box This displays either:
124
details of the previously-specified destination port (on the ISPBX) that you selected - or default values for the destination port (on the ISPBX) you are about to specify
If specifying a new port (in other words, entering into the CM Database details of a port on the ISPBX) enter a suitable name in the 'Port name' field. For instance, you might enter 'ISPBX Amsterdam 2 Port 1'. As with the ISPBX, this name must be meaningful, and consistent with any company naming policy you have. All other fields on this dialogue box are greyed out. This is because the fields were either specified on a previous dialogue box, or are associated with authorisation. However, if you were making a remote connection without a buffer or port selector, you would have access to: ISPBX authorisation required Call back User index Group index
You could then select authorisation, together with the appropriate group index for the user. (Users with a Group index of 0 can receive alarms. Users with a Group index of 1 cannot.) You could also set Call back (the ISPBX telephones back to the Management@Net computer). However, to do this, you must select an appropriate user index. This must correspond to the user index set in the ISPBX which determines which phone number the ISPBX dials. The relationship between user indexes, group indexes and the associated telephone numbers is shown in the figure below.
125
Group Index
0 0 1
00-441716320
User Index 1
00-31889998733
0779823
T elephone number that the ISPBX uses for dialling the user with Group Index 1 and User Index 2. (This number must be programmed into the ISPBX.)
Conclusion Remember the following: Authorisation requires that you set the appropriate group index (this defaults to 0) and password (passwords are set in the "Connection Wizard - Unit" dialogue box) of the operator who will use this connection Call back requires that you set authorisation, and that you set the appropriate group index, user index and password (passwords are set in the "Connection Wizard - Unit" dialogue box) of the operator who will use this connection
'Connection Wizard - Destination buffer or port selector' dialogue box This enables you to specify: the function - buffer or port selector - in the connection the kind of buffer or port selector you are using in the connection - TOPS box, SPB/BIM, ComboX or ISPBX local disk
If you were making a remote connection via a buffer or port selector, you could use call back for: TOPS box SPB/BIM, where the SPB function on the BIM is used as Buffer or Port selector (CCS systems) ISPBX local disk, where the CPU3000 is used as Buffer.
126
CAUTION:
FOR CALL BACK WITH THE TOPS BOX, THE MODEM THAT WILL BE CONNECTED TO THE TOPS BOX MUST BE CONFIGURED FOR CALL BACK WITH THE "TOPS MODEM CALL BACK CONFIGURATOR" TOOL SUPPLIED WITH THE CD-ROM THAT CONTAINS THE SERVICE TOOLS.
The sequence of dialogue boxes the wizard displays when you click on 'Next', depends upon the buffer or port selector you select: TOPS Box You can only configure a TOPS box by making adjustments at the box itself. For this reason, if you select the TOPS box you do not move on to configuration dialogue boxes, but go immediately to the 'Destination modem phone numbers' dialogue box (see below). SPB/BIM and ComboX If you select one of these options, you move on to a dialogue box, where you can select a previously-specified box (if available on the CM Database) or specify a new one. You then move to the 'SPB/BIM settings' or 'ComboX modem settings' dialogue box, where you can review and edit settings.
Note: If the SPB option is greyed-out, this may be because there are no SPB templates available. Although the CM Database Configurator is supplied with templates, they may have been deleted. To create a new template, exit the wizard, and right-click on 'SPB/BIM Template' in the left pane of the Configurator. ISPBX local disk For the ISPBX local disk with call back, an 'Authorisation' dialogue box is shown next.
'Connection Wizard - SPB/BIM settings' dialogue box When specifying an SPB or BIM for the connection, you only require this dialogue box for its configuration. Use the dialogue box to: Select one of the previously-configured SPB or BIM templates (these are used to define the messages that the SPB or BIM sends). Enter a name of your own choosing for the SPB or BIM (like the names of the destination ISPBX and port, this name must be unique within the CM database, and consistent with your naming standards). Enter the password already configured in the SPB or BIM. This password is used automatically by Management@Net to log in to the box, when someone uses the connection you are now configuring.
127
The online help gives additional information about the 'SPB/BIM name' and 'Password' fields. When you click on 'Next' the dialogue box displayed is 'Destination modem phone numbers' (see below). 'Connection Wizard - ComboX modem settings' dialogue box This screen enables you to: specify or confirm the name of the ComboX configure the ComboX to 'speak to' the modem through which it communicates
Note: The wizard does not have an equivalent screen to this for configuring the Management@Net PC to 'speak to' the modem(s) connected to its COM port(s). If you wish to configure the initialisation and test strings for these modem(s), you must use the CM Modem Configurator. Note: When you have worked through all the wizard's dialogue boxes for the connection you are creating, a final dialogue box invites you to download the 'Connection Wizard - ComboX' settings to the ComboX. The 'ComboX was last updated on' field displays the time (if any) of the last download. 'Connection Wizard - ComboX OM (or FDCR) port passwords' dialogue box The two versions of this dialogue box (OM and FDCR) enable you to add to the connection you are creating, the various passwords required to use the ComboX's OM or FDCR port. Depending upon the choice you made in the "Connection Wizard - Destination buffer or port selector" dialogue box, the 'ComboX Port ID' field at the top of the page displays: FDCR - if you have selected the ComboX as a buffer for call reporting OM - if you have selected the ComboX as a port selector for Operational Maintenance
The 'Login password' gives basic login access to the ComboX. The 'Setup password' enables changes to the ComboX. The 'Access password' enables the ComboX to operate in transparent mode, when used as a port selector. This field is therefore greyed out in the FDCR (call buffer) version of the screen. If adding a new box, the Configurator supplies default values for all the password fields of the 'OM Port Password' dialogue box. In every case, the default value is MERMER. This is the same as the factory default values configured in the ComboX. Remember that if you wish to change one or more passwords with this dialogue box, you must
128
first reconfigure the ComboX with the appropriate changes (see ComboX documentation). 'Connection Wizard - ComboX OM (or FDCR) port settings' dialogue box This dialogue box enables you to configure the ComboX's OM (or FDCR) port settings. As with the previous dialogue box, the 'ComboX port ID' field at the top of the page displays either FDCR or OM, depending upon the choice you made in the 'Destination buffer or port selector' dialogue box. Make sure that these settings are the same as those configured for the corresponding port on the ISPBX. (This must be done at the ISPBX.) 'Connection Wizard - Destination modem phone numbers' dialogue box This dialogue box deals with the various components (prefixes and codes) of the number that the Management@Net server dials to contact the modem controlling access to the ISPBX (and buffer or port selector, when included in the connection). This dialogue box is used with all remote connections. For a further discussion of dialling, see section 24.2.4. Understanding Dialling. Country code: This is the code of the country in which the modem is geographically situated. For instance, 31 for Netherlands. Area code: This is the area code for the region. Enter the code as it must be dialled from another country, for instance, 35, (not 035) for Hilversum in the Netherlands. Company prefix: This is the main number for dialling the company in which the modem resides. The number is probably not complete in itself, but requires the Extension to complete the connection.
You must make entries in the 'Country code', 'Area code' and 'Extension' fields. If there is no extension as such, enter the complete company number in the 'Extension' field. 'Connection Wizard - Destination port protocol and purposes' dialogue box Use this dialogue box to assign a purpose or purposes to the connection you are creating. Be aware, however, that there are two levels of authorisation in force which limit you to only a very limited range of choices: At the first level, you can only select a protocol and purpose(s) consistent with the
129
connection choices you made earlier in the wizard. For instance, if you have a connection using a ComboX as a buffer, you can only select character protocol and FDCR (Call Reporting Module): these limitations are imposed by the ComboX. This first level of authorisation is imposed by making some check boxes impossible to select, and is supplemented by explanatory messages to help you understand why some of the choices you might try to make are not permissible. However, there is also a second level of authorisation, which is imposed by greying-out the 'Next' button. This can seem confusing, since the button can be greyed-out even when a legitimate protocol and purposes(s) are selected. This situation can occur if you may have made selections that would specify two ports with the same function on one ISPBX . For instance, you cannot create two OM ports or two FDCR ports. To find out if this is the problem, compare the choices you made in the wizard (use the "Back" button) with the specifications of existing ports on the ISPBX.
If there are one or more server port / modem combinations available, you now move immediately to the 'Select COM port' dialogue box when you click on 'Next' (this is discussed later). If there are no server ports currently specified, a short sequence of dialogue boxes enables you to set up one or several server port / modem combinations. The boxes used are: Connection Wizard - Server phone prefixes Connection Wizard - COM port Connection Wizard - COM port modem settings
'Connection Wizard - Server phone prefixes' dialogue box This dialogue box works together with the "Connection Wizard - Port phone settings" and "Connection Wizard - COM port" dialogue boxes, to determine exactly which digits the Management@Net server must dial when establishing a remote connection. The fields contained in this dialogue box are for information common to all the ports on the Management@Net server. (Information specific to individual ports is set on the 'Connection Wizard - COM port' dialogue box.) For a further discussion of dialling, see section 24.2.4. Understanding Dialling. International prefix: Enter the prefix required to make an international telephone call from the country in which the Management@Net server resides. In most countries, this is 00. Management@Net only uses this prefix if it has to make an international call. Outgoing prefix:This is the prefix required (if any) to make an external call from within office in which the Management@Net server resides. In many cases, it is necessary to dial zero (0)
130
to obtain an outside line. Long distance prefix: This is the prefix which Management@Net adds to the area code when not making an international phone call. For example, the area code 35 might be used when making an international phone call. However, Management@Net changes this to 035 when making a national phone call. The 'Long distance prefix' is normally 0.
'Connection Wizard - COM port' dialogue box This dialogue box works together with the "Connection Wizard - Port phone settings" and "Connection Wizard - Server phone prefixes" dialogue boxes, to determine exactly which digits the Management@Net server must dial when establishing a remote connection. The fields contained in this dialogue box are for information specific to the Management@Net server port you are configuring. (Information common to all ports on the Management@Net server is set on the "Connection Wizard - Server phone prefixes" dialogue box.) For a further discussion of dialling, see section 24.2.4. Understanding Dialling. Country code: This is the code of the country in which the modem connected to the Management@Net server port is geographically situated. For instance, 44 for England. Area code: This is the area code for the region. Enter the code as it must be dialled internationally, for instance, 1235, (not 01235) for Didcot in England. Company prefix: This is the main number of the company in which the modem resides. The number is probably not complete in itself, but requires the Extension to complete the connection. 'Connection Wizard - COM port modem settings' dialogue box Use this dialogue box to configure settings for the Management@Net server COM port that you are specifying. Make sure that the settings on the modem are the same as those you configure on this dialogue box. 'Connection Wizard - Select COM port' dialogue box You only see this dialogue box if there are already a number of Management@Net server COM port / modem pairs specified and stored in the CM Database. (If there are none, the wizard leads you through a sequence of dialogue boxes to enable you to specify a pair, starting
131
with the 'Select server phone prefixes' dialogue box, above.) Use the dialogue box to build a preferred list of COM port / modem pairs for the connection you are creating. When phoning, Management@Net selects the highest-placed modem in the list which is free for use. You will therefore normally build the list such that the COM port connected to the fastest modem is at the top, and the COM port connected to the slowest at the bottom. 'Connection Wizard - Summary' dialogue box This final box gives an overview of all the decisions you made while using the wizard. When you click on the 'Finish' button, the wizard may display a warning: 'The requested action might modify the property of more than one connection.' This happens if you have changed one or more of the properties of a pre-existing item. For instance, you might have changed the protocol of a port. If the port is then used as part of another connection (in other words, the connection you are currently creating) the original connection could become unserviceable.
When a Management@Net port dials a remote modem, it compares its own local country and area codes, company prefix and extension ("Connection Wizard - Port phone settings"), to those of the remote modem ("Connection Wizard - COM port"). Depending upon this comparison, it determines the correct number to dial. For instance, if the Management@Net server and the remote modem share the same country code, it is not necessary for Management@Net to dial an international number. However, if the country codes are different, Management@Net must dial: the international prefix (normally 00 ) the correct international code (say, 44 for England )
132
the area code (say, 1344 for Didcot, England) the digits associated with the modem (prefix and extension)
In addition, it may be necessary for the server to preface the whole number with the trunk access code required to gain an outside line from within the company where the Management@Net server is based. Examples Example 1 (Internal Company Call) Number of modem connected to server's COM port: 31 35 689 1012. Number of remote modem connected to ISPBX port: 31 35 689 1013.
The number Management@Net dials has the same country code, area code and company prefix. It therefore just dials: 1013.
Example 2 (Local Call) Number of modem connected to server's COM port: 31 35 689 1012. Number of remote modem connected to ISPBX port: 31 35 687 1013.
The number Management@Net dials has the same country code and area code. However, it must use an outside line (because the company prefixes are different) so Management@Net uses the company's outgoing prefix. It therefore dials: 0 687 1013.
Example 3 (Long-Distance Call) Number of modem connected to server's COM port: 31 35 689 1012. Number of remote modem connected to ISPBX port: 31 30 687 1013.
The number Management@Net dials has the same country code. Its is a long-distance call (because the area codes are different) so Management@Net must use the long-distance prefix. It is an outside line so Management@Net must also use the outgoing prefix. It therefore dials: 0 030 687 1013.
133
Number of modem connected to server's COM port: 31 35 689 1012. Number of remote modem connected to ISPBX port: 44 1235 687 1013.
This is a international call (because the country codes are different) so Management@Net must use the international prefix. It is an outside line, so Management@Net must also use the outgoing prefix. It therefore dials: 0 00 44 1235 687 1013.
24.3.
MAKING CONNECTIONS
This section offers examples of some of the connections you are likely to want to make. It provides the necessary settings for modems, and for applications at both ends of the connection.
134
The connected terminal initialises the modem. The connected terminal sends the initialisation string. The advantage of this method is that a modem can be exchanged for a new one without programming the modem first. Modem uses information of the NVRAM profiles. NVRAM = Non Volatile RAM; settings in this memory are kept after the modem power is switched off. Program a new modem after replacement of a faulty one and save the information in NVRAM.
Note: To make reliable connections, it is advisable to program both application and modems.
24.3.2. Remote Operational Maintenance / MAC-Manager Connection with User Authorisation for CPU-ME/MT (without or with Call Back)
Hints and Tips: Use BCS protocol with user authorisation (use the CHREMC command to configure a remote port on the CPU-ME/MT). Use CHPORT to set the maximum speed on CPU-ME. Enter the speed in Connection Manager accordingly. Maximum speed = 38K4. BCS protocol is used on a remote CPU-ME connection, and the Connection Manager always uses these defaults: flow control = none, 8 databits, 2 stopbits, parity = none.
Note: Consult the modem settings in appendix F . MODEM SETTINGS FOR Dynalink V1456ER2 MODEM and appendix E . MODEM SETTINGS FOR U.S. Robotics 56 K Voice Fax MODEM. Settings for remote CPU-ME/MT port Use the commands ASPORT, ASDEVC, CHDEPR, CHDEAU, CHPORT and CHREMC to create a remote OM port with BCS protocol on a free CPU-ME/MT V24 port. Use the command CHREMC to configure the remote configuration file on CPU-ME/MT. Enter following parameters:
Note: The parameters that are not important are omitted. CHREMC:0 (corresponds to Group index 0) or CHREMC:1 (corresponds to Group index 1) - Password in configuration file: enter the same password as in the "Connection Wizard - Unit" screen - Number of connect attempts: 1 (only for call back) - Connection setup command: 1 (for direct) or 2 (for call back)
135
index n)
Subscriber number n: call back number (only for call back; corresponds to User Number of retries: 0 (only for call back) System identification: enter the same identification as in the "Connection
V1456E-R2 MODEM and appendix E . MODEM SETTINGS FOR U.S. Robotics 56 K Voice Fax MODEM. After finishing these settings, perform SETNIN, SETINS on this port. The modem is now initialised by CPU-ME/MT. Settings in Connection Manager If it is not already running, start the Connection Wizard. In the wizard's "Connection type" dialogue box, select "Remote connection to ISPBX without buffer or port selector". (Authorisation is not possible with a TOPS box or ComboX.) Complete the dialogue boxes the wizard displays, bearing in mind the following notes: "Connection Wizard - Unit" dialogue box: Make sure that "CPU type: CPU-ME or CPU3000" is selected. Enter a System ID, and either Group 0 or Group 1 passwords. You must enter the System ID and passwords in upper case when using an ISPBX with CPU-ME. 'Connection Wizard - Destination port general settings' dialogue box Make sure "ISPBX authorisation required" is selected. Set the Group index to 0 or 1. For call back, set User index n. 'Connection Wizard - Destination port protocol and purposes' dialogue box Set the protocol to "BCS" and the purposes to "Operational Maintenance" and "MAC Management". 'Connection Wizard - Select COM port' dialogue box' Make sure that you configure at least two COM port / modem pairs with the following settings: Flow control = RTS/CTS, speed = 38k4 bps (example), stopbits = 2, parity = none If you do not have suitable modems configured, click on 'New COM port' and complete the necessary dialogue boxes, including the 'Connection Wizard - COM port modem setting' dialogue box, where these settings are entered.
136
137
24.3.4. Remote Operational Maintenance / MAC-Manager Connection with User Authorisation to a BIM (without or with Call Back)
Note: For modem settings see appendix F . MODEM SETTINGS FOR Dynalink V1456E-R2 MODEMand appendix E . MODEM SETTINGS FOR U.S. Robotics 56 K Voice Fax MODEM. Settings in Connection Manager If it is not already running, start the Connection Wizard. In the 'Connection Wizard Connection type' dialogue box, select 'Remote connection to ISPBX without buffer or port selector'.. Complete the dialogue boxes the wizard displays, bearing in mind the following notes: 'Connection Wizard - Unit' dialogue box Set the 'CPU type:' to 'CCS'. Enter a System ID, and either Group 0 or Group 1 passwords. 'Connection Wizard - Destination port general settings' dialogue box Make sure "ISPBX authorisation required" is selected. Set the Group index to 0 or 1. For call back, set User index n. 'Connection Wizard - Destination port protocol and purposes' dialogue box Set the protocol to "BCS" and the purposes to "Operational Maintenance" and "MAC Management". 'Connection Wizard - Select COM port' dialogue box Make sure that this connection has access to at least one COM port / modem pair with the following settings: Flow control = RTS/CTS, speed = 38k4 bps (example), stopbits = 1, parity = none. If you do not have a suitable modem configured, click on "New COM port" and complete the necessary dialogue boxes. Settings on the CIE board Configure an Operational Maintenance port on the CIE. Use commands ASPORT, ASDEVC, CHDEAU and CHDEPR to create an OM port on the CIE. Use logical protocol. Set the port in service (SETINS).
138
Settings on the BIM Configure a remote port on the BIM From the Main Menu, choose BIM Configuration (4) and Port Configuration (2) and Modify the port definition corresponding to the selected CIE port that you have defined with the ASPORT command. Example:
Physical Port Number: port 2 Description: <Remote Service> Connection Type: [Remote] Line Speed: [38400] Word Length: [8] Stop Bits: [1] Parity: [None] Protocol Usage: [BCS] No Activity Interval:<30> Minutes Modem type: [Robotics]
Modify - if needed - the modem type. When using the default Robotics 56K Voice Fax modem example, change the numeric connect string in the robotics modem settings as follows:
Connect string: 1,5,10-155
Change Remote Configuration From the BIM Configuration Menu, choose Remote BCS Configuration (3). Select Modify Usergroup 0 or Modify Usergroup 1 according to the settings in Connection Manager database. Enter the password according to the settings in Connection Manager database.
Password: <...> see Connection Manager Authorisation Type: [Connect] or [Dialback] (only for call back) Number of retries: <0> (only for call back) Subscriber number n: <...> (only for call back; corresponds to User index n)
Fill in the Miscellaneous menu From the BIM Configuration Menu choose Miscellaneous (5) and enter the System ID. This must be the same as in the Connection Manager database.
139
24.3.5. Remote FDCR Connection to a BIM using the SPB/BIM Function as Buffer (without or with Call Back)
Note: Consult modem settings in appendix F . MODEM SETTINGS FOR Dynalink V1456E-R2 MODEM and appendix E . MODEM SETTINGS FOR U.S. Robotics 56 K Voice Fax MODEM. Settings in Connection Manager Make sure you have at least one BIM template in the CM Database. (Templates determine the messages sent to and from the BIM.) To do this, cancel the Connection Wizard if it is running, and click on the 'SPB/BIM Template' icon in the left pane. At least one template of Type BIM (not SPB) should display in the right pane. If this is not the case, right-click on the 'SPB/BIM Template' icon and create a new BIM template. Start the Connection Wizard. In the 'Connection Wizard - Connection type' dialogue box, select 'Remote connection to ISPBX via buffer or port selector'. Complete the dialogue boxes the wizard displays, bearing in mind the following notes: 'Connection Wizard - Unit' dialogue box Set the 'CPU type:' to 'CCS'. 'Connection Wizard - Destination buffer or port selector' dialogue box Select 'Buffer' and 'SPB/BIM'. Set call back if required. 'Connection Wizard - SPB/BIM settings' dialogue box Enter password. 'Connection Wizard - Destination port protocol and purposes' dialogue box The protocol is already set to 'KERMIT' . Set the purpose to 'FDCR'. 'Connection Wizard - Select COM port' dialogue box Make sure that this connection has access to at least one COM port / modem pair with the following settings: Flow control = RTS/CTS, speed = 38k4 bps (example), stopbits = 1, parity = none. If you do not have a suitable modem configured, click on 'New COM port' and complete the necessary dialogue boxes. Settings on the CIE Use commands ASPORT, ASDEVC CHFROD, CHFRCR, CHRTCG, and STRTFR to
140
create an FDCR application port on the CIE. Set the port in service (SETINS). Settings on the BIM Configure a remote port on the BIM. From the Main Menu, choose BIM Configuration (4) and Port Configuration (2) and Modify a port for remote configuration. Example:
Physical Port Number: port 6 Description: <My Remote Service port> Connection Type: [Remote] Line Speed: [38400] Word Length: [8] Stop Bits: [1] Parity: [None] Protocol Usage: [VDU] Data Flow: [RTS/CTS] Terminal Type: [procomm] Modem Type: [Robotics]
For changes in the robotics modem settings, see section 24.3.2. Remote Operational Maintenance / MAC-Manager Connection with User Authorisation for CPU-ME/MT (without or with Call Back). Configure an FDCR to file port Use the same port as defined on the CIE!
Description: <FDCR Buffer> Connection Type: [TT To File] Call Records Buffering: Yes Size: <.....> Records. Set the file size.
Configure the settings to enter a BIM as a Service user From the BIM Configuration Menu, choose User login Configuration (1). Configure a user as follows:
Password: <...> same as SPB password in Connection manager Database User Name: <...> Enter any name Service Class: <16> Usage: [Serv]
141
Connection Type: [Remote-direct] or [Remote-callback] (only for call back) Callback Number: <...> (only for call back)
Settings in TABS CRM Setup Module Configure the CRM module according the TABS CRM Installation Guide.
24.3.6. Remote IAS/IASA Connection Through a BIM using the SPB/BIM Function as Port Selector (without Call Back)
Note: Consult the modem settings in appendix F . MODEM SETTINGS FOR Dynalink V1456ER2 MODEM and appendix E . MODEM SETTINGS FOR U.S. Robotics 56 K Voice Fax MODEM. Settings in Connection Manager Make sure you have at least one BIM template in the CM Database. (Templates determine the messages sent to and from the BIM.) To do this, cancel the Connection Wizard if it is running, and click on the 'SPB/BIM Template' icon in the left pane. At least one template of type BIM (not SPB) should display on the right pane. If this is not the case, right-click on the 'SPB/BIM Template' icon and create a new BIM template. Start the Connection Wizard. In the 'Connection Wizard - Connection type' dialogue box, select 'Remote connection to ISPBX via buffer or port selector'. Complete the dialogue boxes the wizard displays, bearing in mind the following notes: 'Connection Wizard - Unit' dialogue box Set the 'CPU type:' to 'CCS'. 'Connection Wizard - Destination buffer or port selector' dialogue box Select 'Port Selector' and 'SPB/BIM'. 'Connection Wizard - SPB/BIM settings' dialogue box Enter password. 'Connection Wizard - SPB/BIM port' dialogue box Select the SPB/BIM port through which you want to connect SysManager to the IAS/IASA board (see figure 24.3.2. Remote Operational Maintenance / MAC-Manager Connection with User Authorisation for CPU-ME/MT (without or with Call Back)). 'Connection Wizard - Destination port protocol and purposes' dialogue box Set the protocol to 'BCS' and the purpose to 'Announcement Management' for an IAS/IASA connection.
142
'Connection Wizard - Select COM port' dialogue box Make sure that this connection has access to at least one COM port / modem pair with the following settings: Flow control = NONE, speed = 2400 bps, Data bits = 8, Parity = NONE for an IAS/IASA connection. If you do not have a suitable modem configured, click on 'New COM port' and complete the necessary dialogue boxes. Settings on the BIM Configure a remote port on the BIM. From the Main Menu, choose BIM Configuration (4) and Port Configuration (2) and Modify a port for remote configuration. Example:
Physical Port Number: port 2 Description: <Port Selector> Connection Type: [Remote] Line Speed: [2400] Word Length: [8] Stop Bits: [1] Parity: [None] Protocol Usage: [VDU] Data Flow: [RTS/CTS] Terminal Type: [procomm] Modem Type: [Robotics]
Configure an IAS/IASA port. From the Main Menu, choose BIM Configuration (4) and Port Configuration (2) and Modify a port for remote configuration. Example:
Physical Port Number: port 4 Description: <IASA port> Connection Type: [External] Line Speed: [2400] Word Length: [8] Stop Bits: [1] Parity: [None] Protocol Usage: CHAR Data Flow: [None]
143
Configure the settings to enter a BIM as a Service User. From the BIM Configuration Menu, choose User login Configuration (1). Configure a user as follows:
Password: <...> same as SPB password in Connection manager Database User Name: <...> Enter any name Service Class: <16> Usage: [Serv] Connection Type: [Remote-direct] Callback Number: <...> (not used)
24.3.7. ISPBX local disk: connection to CPU3000 systems with the LBU as FDCR buffer and 'ZIPPING' of FDCR records before transfer
The new buffer type 'ISPBX local disk' means that the LBU on the CPU3000 is used to store the FDCR records. This saves a TOPS box or ComboX. To save time, the FDCR file on the LBU is 'packed' before transfer. Precondition is Call@Net 2.4 or higher, because 'ZIPFIL' is used to 'pack' the FDCR file. Settings for the CPU3000 port You must use a V.24 port with BCS protocol with OM device (VDUyy0 and VDUyy1) and disk emulator device: DSKxx, where xx is the unit number. If such a port is not present, assign it. Use the commands ASPORT, ASDEVC, CHDEPR, CHDEAU. For remote connections, use the command CHREMC to configure the remote configuration file. After finishing these settings, perform SETINS on this port. Starting FDCR in the CPU3000 for the first time
CHFROD:LBU01,1; STRTFR:CALLS; Created file: LBU01:CALLS.U01.1
WARNING: DO NOT STOP THE FDCR OUTPUT (STOPFR:;). DO NOT USE A FILENAME LIKE FDCRXX. Settings in Connection Manager
Note: As an example, a direct connection is used. However, a remote connection with or without call back can also be made for the same purpose. If it is not already running, start the Connection Wizard. In the wizard's "Connection type" dialogue box, select "Direct connection to ISPBX via buffer or port selector". Complete the dialogue boxes the wizard displays, bearing in mind the following notes:
144
"Connection Wizard - Unit" dialogue box: Make sure that "CPU type: CPU3000" is selected and that the unit number is correct. 'Connection Wizard - Destination buffer or port selector' dialogue box Make sure "ISPBX local disk" is selected. 'Connection Wizard - Destination port protocol and purposes' dialogue box Set the protocol to "BCS" and the purposes to "FDCR". Troubleshooting For every connection where the 'ISPBX local disk' is used a status file 'File Status.dat' is kept. This can be found in (default) C:\Philips\Data Files\ConnectionManager\<ISPBX folder>. In this file, the status of the FDCR file collection is kept. An active entry could look like: LBU01:FDCR01.U01 ; PBX2ZIP ; 1, where LBU01:FDCR01.U01 is the FDCR file to be collected, PBX2ZIP is the state and 1 is the numer of retries. The state can be: - PBX2ZIP: this means that the FDCR file has to be zipped (ZIPFIL) on the LBU. - ZIP2CM: this means that the zipped FDCR file has to be collected (CPYFIL). - UNPACK: this means that the FDCR file has to be unpacked in Management@Net. - CM2APP: this means that the FDCR records have to be given to CRM.
24.3.8. Optimise speed of MAC Manager file transfer: connection to CPU3000 or CCS systems with 'ZIPPING' of retrieve files before transfer
The new facility 'Optimise speed of MAC Manager file transfer' means that after the retrieve, the OR and PR files on the LBU are 'packed' before transfer. This saves time in a 'Get Configuration' in the MAC Manager. Precondition is Call@Net 2.4 or higher, because 'ZIPFIL' is used to 'pack' the files. Note: Do not use 'Optimise speed of MAC Manager file transfer' if you are using an OM connection with character protocol, because that is already optimal (the fastest solution). Settings for the CPU3000 port You must use a V.24 port with BCS protocol with OM device (VDUyy0 and VDUyy1) and disk emulator device: DSKxx, where xx is the unit number. If such a port is not present, assign it. Use the commands ASPORT, ASDEVC, CHDEPR, CHDEAU For remote connections, use the command CHREMC to configure the remote configuration file. After finishing these settings, perform SETINS on this port.
145
Note: As an example, a direct connection is used. However, a remote connection with or without call back can also be made for the same purpose. If it is not already running, start the Connection Wizard. In the wizard's "Connection type" dialogue box, select "Direct connection to ISPBX without buffer or port selector". Complete the dialogue boxes the wizard displays, bearing in mind the following notes: "Connection Wizard - Unit" dialogue box: Make sure that "CPU type: CPU3000 or CCS" is selected and that the unit number is correct. 'Connection Wizard - Destination port protocol and purposes' dialogue box Set the protocol to "BCS", the purposes to "MAC Management" and mark "Optimise speed of MAC Manager file transfer".
24.4.
TROUBLESHOOTING
This module contains tracing possibilities, see section 35.2.5. Technical Support Module.
146
PROBLEM
POSSIBLE SOLUTION
Activation of a destination Start the ISPBX Destination Activator user interface and locate failed the problem destination. Then try to activate manually. Activation of a destination is not possible at all. Connecting to a destination takes a very long time (The CM Status screen shows 'contacting Broker' for about 30 seconds...) The physical connection is faulty: Check modems, cabling, etc. The OM connection is occupied by MAC-Manager or OM Terminal: Close the connection. OM connection not defined or non-operational for this destination.
The PC is configured as network PC and shortly disconnected from the (LAN) network. Reconnect the PC with the network, or If it is necessary to work disconnected, speed up Management@Net by adding an IP address, as follows: 1. 2. 3. 4. 5. In the Control Panel, double click the network icon. Select TCP/IP from the installed network components list. Click Properties button. Select the IP Address tab and select Specify an IP address. Add an IP Address (e.g. 192.168.0.1) and Sub-net Mask (e.g. 255.255.255.0)
147
25.
25.1.
MAC-Manager
INTRODUCTION
The MAC-Manager is used to make Moves, Adds and Changes to the data in the ISPBX. For more information about the use of the MAC-Manager, see: Management@Net MAC-Manager Getting Started. The MAC-Manager's online help.
Note: One MAC-Manager must always run on the Management@Net Server. This MACManager has the rights to execute projects, see Section 6.2. ADDITIONAL CONFIGURATION, DEPENDING ON THE USED MANAGEMENT@NET APPLICATIONS.
25.2.
A MAC-Manager Module licence is required and MAC equipment licenses for each connected ISPBX (unit). For a V.24 port to a CPU-ME/MT, make sure an OM and an RBU device is defined to which the MAC-Manager is connected. For a V.24 port to a CPU3000 with Call@Net 2.4 or higher you can speed up the file transfer using an OM and a DSK device. In all other cases just an OM device is sufficient. See section 4.3. PROJECTING V.24 CONNECTIONS. Since Call@Net 2.8, OM over IP connections can be used, see section 4.2. PROJECTING IP CONNECTIONS. CAUTION: IT IS STRONGLY ADVICED TO SWITCH OFF THE UPDATE OF NAME/NUMBER INFORMATION FOR CNND/CDD IN THE ISPBX BY THE MAC-MANAGER, SPECIALLY IN FULL HOSPITALITY CONFIGURATIONS. THIS CAN BE DONE BY SETTING BOUNDARY 305 TO ZERO IN THE ISPBX. THE RESULT IS THAT IN THE MAC-MANAGER THE "MAINTAIN DNR NAMES TABLE" IS OFF. THE UPDATING OF NAME/NUMBER INFORMATION FOR CNND/CDD IN THE ISPBXCAN BEST BE DONE BY THE
148
DIRECTORY DISTRIBUTION SERVICE - AN ADDITIONAL PRODUCT. SEE APPENDIX G . DIRECTORY DISTRIBUTION SERVICE.
25.3.
TROUBLESHOOTING
25.3.1. Audits
There are two types of audits that can be used for trouble shooting purposes: Communication Audit The Communication Audit stores information regarding communication between the MAC-Manager and the ISPBX; i.e. the OM commands which are sent to the ISPBX in a project. A project must be selected prior to selecting 'Communication Audit' from the menu. Session Audit The Session audit stores information regarding tasks performed in the MAC-Manager per user per session. To view, open the Session Audit and select 'History' in the File menu. For more information about audits, refer to MAC-Manager Getting Started.
Inconsistencies can be avoided by advising the customer to do the following: 1. Schedule ISPBX data retrieval and 'move, add and change' instructions on a regular basis. For example, retrieve the data from the ISPBX every morning and send the 'moves adds and changes' to the ISPBX every evening. 2. When MAC-Manager operations are complete, send the 'moves, adds and changes' to the ISPBX before starting work with the OMM. 3. Do not perform any moves adds or changes within the Operational Maintenance Module. 4. Make clear agreements between the users of the MAC-Manager about working in different projects.
25.4.
DATA DISTRIBUTION
The Data Distribution Module contains a program called SNAPI (Second Nature Application
149
Programming Interface), which is used to exchange data between the MAC-Manager database(s) and other modules (Call Reporting Module, Directory Services Module and External Application Interface). SNAPI is only active in data distribution configurations that include the MAC-Manager. At the request of other modules, SNAPI creates and schedules projects to change names (CNND/CDD) or to create PIDs or Cost Centres in the PBX(s). These projects are scheduled within a minute after arrival of the changes. You can recognise these projects in the MAC-Manager, because they have the owner (creator) "API Client". For possible errors, check the Communication Audit of the executed projects. SNAPI also distributes changes to other modules, for example after adding DNRs or changing names in the MAC-Manager.
25.5.
For answers to questions like: "where to enter data in daily use" and "how to synchronise data", see online help. Online help is available in the Management@Net Configurators group.
150
26.
26.1.
The Operational Maintenance Module (OMM) is used to perform operational maintenance by entering OM commands. The OMM consists of one application: the OM Terminal. For more information about using the OMM, see: Management@Net Getting Started the Operational Maintenance Module's online help
For more information about using OM-commands, see: MML Help Files
26.2.
Ensure the MML Files, Licence Manager and Connection Manager Modules have been installed. The OMM is not normally used to perform moves, adds or changes in the ISPBX data (for extensions, operators, trunks or groups). These operations are conducted in the MACManager, where appropriate.
26.3.
TROUBLESHOOTING
151
27.
The Announcement Management Module is used to manage announcements stored on the IAS(A) board and consists of two applications: Announcement Manager The Announcement Manager is used to record, play and erase announcements. Announcements are voice messages in a digital form. They can be used for wake-up and message waiting service, music on hold, music on camp on busy, trunk announcements and information lines. One-Day Password Tool The One-Day Password Tool is used to generate a temporary password allowing a user initial access to an announcement server. The One-Day Password Tool is located in the 'Configurators' program group.
Full information about announcement management is available from the following sources: Installing and Projecting the IAS Board For IAS, see: SOPHO VoiceManager 150 (IAS) - Customer Engineer Manual. For IASA, see: SOPHO VoiceManager 110 (IASA) - Customer Engineer Manual. Using the Announcement Management Module See Management@Net Getting Started. See also the Announcement Management Module's online help.
152
28.
28.1.
TABS Call Reporting Module is used to collect FDCR call records from the ISPBX and to generate reports based on the data collected. A CRM application licence is required and a CRM equipment licence for each connected ISPBX (unit). The TABS Call Reporting Module consists of the following applications: TABS TABS is used to generate reports and to define the site parameters, pricing structure etc. TABS is located in the program group. TABS Call Collector The TABS Call Collector is responsible for the collection of data, in accordance with the settings made in TABS and can be found via the "Start" menu, in "Programs, Startup". The TABS Call Collector is started automatically, upon 'login'. TABS Exchange Server The TABS Exchange Server (tesmain.exe) is used to exchange data between the Call Reporting Module and other modules (MAC-Manager, Directory Services Module and External Application Interface) for Data Distribution; tesmain.exe only runs if one of the CRM applications runs: TABS or TABS Call Collector. See also Section 28.6. DATA DISTRIBUTION.
For more information about the TABS Call Reporting Module, see: Management@Net TABS Call Reporting Module Installation Guide. The TABS Call Reporting Module's online help.
28.2.
The TABS Call Reporting Module Licence is required and an equipment licenses for each connected ISPBX (unit). Direct FDCR output can be used which is needed in Hospitality Configurations (single site). On a CPU3000 with Call@Net 2.4 or higher, FDCR records can be buffered on the LBU. On a V.24 connection to a CPU3000 port, you must define OM and a DSK device. See Section 4.3. PROJECTING V.24 CONNECTIONS. Since Call@Net 2.8, direct FDCR output over IP can be used which is needed in Hospitality Configurations (single site). For other Configurations, FDCR records can be buffered on the LBU and collected using OM over IP (multi-site). See section 4.2. PROJECTING IP
153
CONNECTIONS.
28.3.
TOPS BOX
A local or remote TOPS box is used to buffer the FDCR records produced by the ISPBX. Then the TOPS box is accessed by the TABS Call Reporting Module to process the FDCR records. The maximum speed between TOPS and Management@Net is 38400 bps. The maximum speed between TOPS and ISPBX is 4800 bps for a TOPS box containing a 6 MHz crystal and 9600 bps for a TOPS box wit a 12 MHz crystal. This crystal is the middle one on the PCB of the TOPS box. The EPROM (the one on a socket) must be of type 2DQ-TGL. To check this, you need to open the TOPS box. Note: Your TOPS box might even contain a more modern EPROM version. Different EPROM types can have influence on the amount of records, that can be stored in the TOPS box. For more information on the used hardware: activate the Site Setup in the TABS module and consult the hardware tab in Sites/Define Site. After TOPS is connected with the Management@Net, the screen will give information about the used hardware inside the TOPS box. (This procedure can be found in the TABS Installation guide).
28.3.1. Calculating How Often You Need to Access the TOPS Box
The TOPS box holds up to 6382 FDCR records. The length of time the TOPS box can be left without being accessed, depends on the amount and type of calls that the ISPBX is expected to handle within a given time. Use the following formula to calculate how often the TOPS box needs to be polled: Number of generated records = 1.10 * (number of internal calls + 1.05 * number of incoming calls + 2 * 1.05 * number of outgoing calls) This formula allows for a 10% overhead caused by transferred calls and 5% caused by operator assistance; and assumes all FDCR options are switched on. If FDCR records are generated for outgoing calls only, the TOPS box can store 6382 / 2 = 3191 calls. If this information is not available, the following formula can be used to predict the number of FDCR records during office hours:
154
Number of generated records per hour = number of extensions * 5 * 1.10 This formula is based on the following assumptions: all FDCR options are switched on for internal calls 0.04 E is generated with holdtime of 60 seconds for incoming calls 0.04 E is generated with holdtime of 120 seconds for outgoing calls 0.04 E is generated with holdtime of 120 seconds 5% of the incoming and outgoing calls are established via operator assistance 10% of the calls are transferred to another extension
Note: A TOPS Box is not required if the ISPBX has a BIM or a ServicePlus Box, since a BIM or ServicePlus Box can also buffer FDCR records.
28.4.
ComboX
Instead of a TOPS box, a ComboX can be used for storing FDCR records. For details about the ComboX, see "Management@Net TABS Call Reporting Module Installation Guide". The formula's given in the previous section also apply to the ComboX. The following sections are based on the use of the ComboX only for storage of FDCR records.
28.4.1. Making Physical Connections PROCEDURE: Connecting the ComboX to the ISPBX and the modem at the Remote Site
For details of the cables required for these connections, see Chapter C . CABLES Actions 1. Using OM commands, prepare a port on the ISPBX for FDCR. This port must use Character protocol, and must be set to 19200 bps in order to match the default port setting on the Combox. 2. Reset the ComboX to its factory settings as follows: - Set Dipswitch 1 to OFF. - Press the 'RESET' button on the rear of the ComboX. - Set Dipswitch 1 to ON. 3. Connect Port 2 on the ComboX to the ISPBX FDCR port. 4. Make sure that the dip switches on the ComboX are all set to 'On'. 5. Connect Port 3 on the ComboX to a modem.
155
28.5.
TROUBLESHOOTING
This section contains some additional trouble shooting information that is not included in the TABS Call Reporting Module User Guide or Installation Guide.
156
1. Configure HyperTerminal in accordance with Section 28.5.2. Testing the COM Port. 2. Compose an ASCII file containing some FDCR records. 3. In Connection Manager, define a connection with FDCR purpose in character protocol format.
Note: Above settings are for HyperTerminal only! Configure Connection Manager and TABS CRM Setup module with the usual settings (8 bits, parity 'none', 1 stopbit, etc.) Use the HyperTerminal to send a test file to the COM port. 1. If the Call Collector does not run, start it up via the Call Collector icon. 2. In Hyper Terminal, choose Transfer/Send Text File and choose the test file from he directory.
157
158
28.6.
DATA DISTRIBUTION
The Call Reporting Module contains a background program called tesmain.exe (TABS Exchange Server), which is used to exchange data between the Call Reporting Module database(s) and other modules (MAC-Manager, Directory Services Module and External Application Interface); tesmain.exe only runs if one of the CRM applications runs: TABS or TABS Call Collector. tesmain.exe appears to the user as a TABS Events window that shows the status of data distribution or the progress of data synchronisation. If the TABS Events window shows errors, look for details in TABS, Main, Maintenance and Log Events.
28.7.
For answers to questions like: "where to enter data in daily use" and "how to synchronise data", see online help. Online help is available in the Management@Net Configurators group.
159
29.
29.1.
The MML Files Module contains the MML Help and the actual MML conversion files, as described below: MML Help MML Help is a Windows Help file containing context-sensitive reference information for OM commands. The MML Help is updated when OM commands in the ISPBX software are changed or added. Format: MML_Vx.hlp (x=version), present in C:\Program Files\Philips\MMLFiles. The MML Help file can be opened by double clicking the icon in the Management@Net program group or from the OM Terminal application via the Help menu. Parsed MMLText Files MML Files allow codes sent between the Operational Maintenance Module, MACManager and ISPBX, to be converted into readable text. As the format used in the ISPBX is different to that recognised by Management@Net, it is necessary for MML files to be converted into a PML file. The MML Text files are updated when OM commands in the ISPBX software are changed or added. Format: MML_Vx.PML (x=version), present in C:\Program Files\Philips\MMLFiles. MML Update A new MML release consists of: an MML Text Files only diskette or an MML setup diskette. The setup diskette contains an installation program that makes the MML Text Files suitable for use in Management@Net. The setup diskette also contains the MML Help file. When a new MML version is released, it is not mandatory to update Management@Net.
29.2.
The PC applications CD-ROM always contains an MML Files Module related to the latest (possible) MML files version. When the MML files are installed directly from the CD-ROM, a PML file is automatically created and the MAC-Manager and Operational Maintenance Module can be readily used.
160
If existing copies of MML Text Files are to be used, they can be converted into a PML file in Management@Net, as follows. Converting MMLText Files to a Single PML File
Note: The following procedure assumes that the installation is standard, so the default path names have been used. 1. Copy the new set of MMLText Files from SIR to a floppy or in a directory on the Management@Net PC. 2. If Operational Maintenance Module is connected to an ISPBX, close the connection(s). 3. Close the MAC-Manager application. 4. Double click on MMLtoPML.exe in C:\Program Files\Philips\MML-Files . 5. Enter the path to the MML files directory in the dialogue box. 6. Enter the path to the PML directory: C:\Program Files\Philips\MML-Files. 7. Click on 'OK'. Note: Do not delete superseded PML files. In case the Operational Maintenance Module or the MAC-Manager is used for connection to an older model ISPBX, the correct version files will be selected automatically.
29.3.
The MML Text Files convertor should only be used for minor changes, since the MML Help is not changed. For a complete update of both MML Text Files and MML Help, use the following procedure: 1. If Operational Maintenance Module is connected to an ISPBX, close the connection(s). 2. Close the MAC-Manager application. 3. Insert the Service Tools CD-ROM and browse to the MML folder for the CPU package that you have. Look for the "MSWINDOW" folder and open the folder with the correct MML version. 4. Double click on setup.exe. 5. Check the path, default: C:\Program Files\Philips\MML-Files . 6. Click on 'Continue'. 7. Wait until the loading is complete and click on 'OK'.
161
30.
30.1.
The Directory Services Module is used to interface with a Corporate Directory for two reasons: Handling requests from an ISPBX for Central Name and Number Directory (CNND) or Terminal Service Display (TSD). For TSD, minimally SSW 805.25 is required; for CNND minimally SSW 805.28 is required. Handling requests from modules within Management@Net for reading and updating entries in the Corporate Database. The first module that uses this function is the External Application Interface (EAI).
The Directory Services Module consists of three programs: DSM Display Server ( DSMDisp.EXE) This is an ActiveX server for handling TSD and (external) CNND request from the ISPBX. It has no user interface. DSM Healing Server (DSMHeal.EXE) This is an ActiveX server for keeping the information in the Phonebook Database consistent with other modules. It has no user interface. DSM Admin (DSMADMIN.EXE ) This program is used primarily to start and stop the DSM Server programs and to configure display layouts and Optional Field layout. It also provides statistics about certain events in the server. The DSM Admin program does not have to be running all the time the server is started, i.e. you can run up the admin program, start the server, close down the admin program, and the server will continue to run in the started state. You can then run the DSM Admin program later to stop the server. More information about the DSM Admin is given in the on-line help of this program.
The DSM Admin program is also used to: Indicate the type and place of the Phonebook Database; Configure the layout for TSD and CNND; Configure the layout of the Optional Info fields in the Internal, External and Guest entries of the Phonebook Database; Synchronise data with other modules.
30.2.
162
The Directory Services Module requires a Switching Services connection to the ISPBX. This can be a V.24 connection (see section 4.3. PROJECTING V.24 CONNECTIONS) OR - since Call@Net 2.8 - an IP connection (see section 4.2. PROJECTING IP CONNECTIONS). The Directory Services Module works on a Phonebook database that can be: On the Management@Net Server Only Management@Net modules use the information in the Phonebook database. The DSM module contains an empty directory: "master.pb" that can be used as the database. Somewhere on the LAN In this case, Management@Net and SuperVisor 60E can use the information stored in the corporate Phonebook database. The DSM module acts as interface between the corporate Phonebook on the LAN and Management@Net. The corporate Phonebook exists on the LAN and can be reached through File Sharing or can be put on an SQL Server.
PROCEDURE: Configuring the Directory Services Module for support of CNND and/or TSD:
Actions 1. Start the DSM Admin in the Management@Net Configurators Group (if not already running). 2. Select Configure/Display. 3. Set the fields and format for TSD for internal names, if used. 4. Set the fields and format for TSD for guest names, if used.
163
5. Set the fields and format for CNND names, if used. Note: Consult the DSM Admin OnLine Help: "Display Layouts", on how to layout the information that is shown on the display of a digital set. To activate any changes in display layouts, you must STOP and START the Display Server. Use menu: Server/DSM-Display
PROCEDURE: Configuring the Directory Services Module for data exchange with an External Application ("Healing Services")
Between the DSM-Healing Server and the EAI, the Data Distribution Module (Spider) is located. For the concept, see the figure. Actions 1. Start the DSM Admin in Management@Net Configurators Group (if not already running) 2. Select Configure/Healing. 3. Select the 'Optional Info Field' tab and set the mapping of the optional info fields that are used in PMS messages (check-in/out, add & change names) for internal, external and guests. See "Addtional Information" below. 4. Click on 'Broadcast: Update: still alive' to configure the different timings for data interchange between DSM, the PhoneWare database and Data Distribution Module. Additional Information An External Application can send the following messages with optional information: Check-in (= add guest name) with an Optional Information field of 83 characters. Add / Change internal name with an Optional Information field of 71 characters Add / Change guest name with an Optional Information field of 83 characters Add / Change external name with an Optional Information field of 82 characters
So an Optional Info string can be a maximum of 83 characters. This optional info string can be mapped to a maximum of 7 optional fields in a Phonebook entry, namely "Other Info 1" to "Other Info 7". For each entry Type (Internal, Guest, External), a layout can be configured. The layout specifies what is taken from the Optional Info string (number of characters) and where it is put in the Phonebook entry ("Other Info 1" to "Other Info 7". Each Optional Info field used by one of the entry types can not be used by another entry type.
30.3.
This module uses the Diagnostic Facility Logging of Philips, see chapter 35. GENERAL MAINTENANCE AND TROUBLESHOOTING. Next to this facility some other logfiles are used. The contents of these log files are meaningful for developers.
164
DSMDisp.log, DSMHeal.log and DSMAdmin.log, all located in directory C:\Philips\Data Files\Diagnostics\Directory-Services. These files grow to up to 50 Kbytes. Then they are copied to a file with extension .blg and a new file with the extension .log is created.
30.4.
PHONEBOOK MANAGER
Phonebook Manager version 2.175 is installed as part of Management@Net. This application is used for filling and maintaining the Phonebook Database(s). The Phonebook Manager is provided free of charge and therefore no licence is needed. For more information on how to use this module, refer to the Phonebook Manager's on-line help and Phonebook Manager - Getting Started. Consult Phonebook Manager Getting Started for information about populating an empty database.
30.5.
PHONEBOOK MAPPING
In this Management@Net release a fixed field mapping in the Phonebook database is required; this mapping is present in Phonebook schema 2-3-0. The Optional Info Fields in different PMS messages (check-in/out, add & change names) can be mapped to the Other Info fields 1 to 7 in the Phonebook database, see "Configuring the Directory Services Module for data exchange with an External Application" and the on line help. For the field mapping, see the next table. The fields in the table are reserved for Management@Net and can not be used for other purposes.
165
Ui Field Name Department Nationality Other Info 1 Other Info 2 Other Info 3 Other Info 4 Other Info 5 Other Info 6 Other Info 7 Type VIP Language Room Ext. Room Alt. Ext. User Field 15 (Privacy Level Indicator) Surname Extension Number DND MW
Format/Use Text 30 characters Text 2 characters Text 30 characters Text 30 characters Text 30 characters Text 30 characters Text 30 characters Text 30 characters Text 30 characters Internal or External or Guest Text 1 character Text 2 characters
(Fixed) Directory Tab Internal Name _user01 _user02 _user03 _user04 _user05 _user06 _user07 _user08 _user09 _user10 _user11 _user12 Custom Custom Custom Custom Custom Custom Custom Custom Custom Custom Custom Custom Custom Custom Custom Contact Contact Yes/No Yes/No Yes/No Yes/No Message/Alt. Contact Groups Not visible
Number 30 characters _user13 Number 30 characters _user14 Text 1 character Text 40 characters True or False True or False _user15 _surname _yesno01 _yesno02 _yesno03 _yesno04 _message1 _hier1_name _message2
Hidden when browsing True or False Preferred when dialled True or False Message 1 (MEM) Hierarchy 1 Message 2 (AEM) (AEM) Text 80 characters Text 36 characters Text 80 characters Date/Time, see remarks
166
_site_group_cod Site Groups e _site_group_des Site Groups c _site_name _name _parent_name Site Groups/Hierarchy 1 Groups/Hierarchy 1
Site Group Description Text 80 characters Site Name Name (in hierarchy) Parent Name (in hierarchy) Text 20 characters Text 36 characters Text 36 characters
Table 30-1 Phonebook Mapping for Management@Net The fields in table 30.5. PHONEBOOK MAPPINGcan be (partly) checked with the help of the Phonebook Manager. First configure the Phonebook Manager to work with the appropriate Phonebook database (i.e. the same database as DSM is using). See the "Register" function in Phonebook Manager. For more help, see30.4. PHONEBOOK MANAGER. In Phonebook Manager open a new or existing extension number. On your screen you find the Directory Tabs mentioned as in above table. Remarks on table 30.5. PHONEBOOK MAPPING(Fieldnames are indicated between " "): After Check-In "Nationality" = "Language"; after add/change name "Nationality" may differ from "Language". "Other Info 1" to "Other Info 7" requires configuring via the DSM Admin module, menu Configure/Healing. Extension numbers in Phonebook database must be predefined with "Surname"='Unassigned' to make Check-In or Add/Change name possible. Do not translate 'Unassigned' when using another language than English! After Check-Out or Delete Name, the field is set back to 'Unassigned'. The field "Extension Number" must contain a value. The field "Type" is not translated. (Type is used to indicate 'Internal', 'External', 'Guest'). Date/Time is represented as: yyyy-mm-ddThh:mm:ss. Example: 1999-03-01T15:40:10.
Note: For more info on AEM/MEM see the Hotel Applications Manuals (Explained/Step by step). MEM messages can be viewed in Phonebook Manager via the "Message/Alt. Contact" tab. AEM messages are only visible on a SuperVisor 60E display.
167
30.6.
DATA DISTRIBUTION
The DSM Healing Server background program of the Directory Services Module is used to exchange data between the Phonebook database and other modules (MAC-Manager, Call Reporting Module and External Application Interface). For correct data distribution, observe the following rules: In the Phonebook, the Site Group Code is used to identify the destination(s). In the Phonebook and CRM each department (organization level) must have a unique name. In the Phonebook only one organization structure exists in "Hierarchy 1", so only one top level in the hierarchy can be made. In the Phonebook each department (organization level) is assigned to a site group code. In the Phonebook each directory entry must be assigned to a site group code and site. In CRM and the Phonebook all extensions must be assigned to a department (organization level), if an organization is used. In CRM you can select only one site at a time, but the top level of the hierarchy must be the same for all sites (in multi-site installations), and all other organization levels (departments) must have unique names throughout all sites, because the Phonebook requires this. - External name/number entries in the Phonebook are independent of destinations, but also these directory entries must be assigned to a site group code and a site. To avoid confusion with existing destinations, take the following steps: - Create a new (dummy) site group entry with: Site Group Code: 999, Server Replica Id: External Numbers and Site Group Description: External Numbers. - In creating new directory entries for external name/numbers, use: Site Group Code "999" and select a (dummy) site. If more than one site is used, create a dummy site for external numbers.
30.7.
For answers to questions like: "where to enter data in daily use" and "how to synchronise data", see online help. Online help is available in the Management@Net Configurators group.
168
31.
The version of the DECT Management Module on Management@Net, only supports SNMP connections to a DCC. Therefore, use 'Networked connection to ISPBX for DAS-iS' in the 'Connection Wizard - Connection Type' of the CM Database Configurator. The DECT Manager Manual contains important information for SNMP connections to a DCC. See also the on-line help provided with the DECT Management Module. Information on hardware installation, software packages, configuration and projection, can be found in the SOPHO iSMobile, Customer Engineer Manual or the SOPHO iSMobile DCC-8, Customer Engineer Manual. WARNING: IF SUBSCRIPTION OF HANDSETS IS DONE VIA THE MACMANAGER (DECT SUBSCRIPTION MANAGEMENT VIA MAC), THE DESTINATION NAME USED FOR 'NETWORKED CONNECTION TO ISPBX FOR DAS-IS' IN THE CM DATABASE CONFIGURATOR MUST BE THE SAME AS THE DESTINATION NAME USED IN DEFINING THE MAC-MANAGER CONNECTION IN THE CM DATABASE CONFIGURATOR.
169
32.
32.1.
The main purpose of the External Application Interface (EAI) is to give external applications access to the ISPBX and Management@Net related services. Examples of such applications are central management systems and hotel and hospital applications. Functions like Do-NotDisturb (DND), message waiting indication and wake up with announcement in the language of a guest are supplied by the ISPBX. Functions like call accounting (billing), assigning extensions and management of a name database are supplied by Management@Net. Additionally the EAI performs tasks that are required by the external applications. For more information about the EAI, please refer to the document: "External Application Interface Interface User Guide".
32.2.
The External Application Interface requires a licence. There licence includes a functional level: "Full" or "Messaging only". When the level is 'messaging only', there will be no connection established with the external application and there will be no Wake-up functionality, for example. The External Application Interface requires a Switching Services connection to the ISPBX. This can be a V.24 connection (see section 4.3. PROJECTING V.24 CONNECTIONS) OR - since Call@Net 2.8 - an IP connection (see section 4.2. PROJECTING IP CONNECTIONS). Concerning the Hospitality Configurations using the EAI, note the following: There is always a one to one relation between an EAI and an ISPBX. If TABS Call Reporting is used and "PMS Billing" is required, direct FDCR output coming from the ISPBX is required (so no TOPS Box or ComboX). The reason is that a buffer creates a possible delay so that guest bills come too late (maybe after checkout). The EAI needs to be configured before first use, using the EAI-Configurator (see below and Management@Net Getting Started ).
PROCEDURE: Configuring the External Application Interface before use Messaging Only
(See also the Hotel Applications manuals) Actions 1. Start the EAI Configurator in the Management@Net Configurators Group.
170
2. Use the tab 'Connections' to specify the ISPBX as defined in the Connection Manager database. 3. Use the tab 'Prefixes' to specify the prefixes as defined in the ISPBX for Extension Messages (Automatically Entered Messages - AEM). 4. Use the tab 'Extension Messages' to define all the needed AEM texts.
PROCEDURE: Configuring the External Application Interface before use Full EAI
(See also the Hotel Applications manuals) Actions 1. Start the EAI Configurator in the Management@Net Configurators Group. 2. Use the tab 'Connections' and select the ISPBX as defined in the Connection Manager from the drop down list. Select the type of PMS connection: - V.24 connection: select COM / V.24, select the COM port from the drop down list and check the COM Port Settings by pressing the 'Settings' button. - TCP/IP connection: select TCP/IP and check the IP Port (default 4000). 3. Do all actions as required for 'Messaging Only'. 4. Use the tab 'Languages' to specify all available language announcements; the abbreviation should match the language code as send by the PMS during check-in. 5. Use the tab 'Announcement Devices' to specify all announcement devices for the various languages as defined in the ISPBX (CHTMST, DITMST). 6. Use the tab 'Prefixes' to specify the prefixes for 'wake up' and 'cancel wake up' as defined in the ISPBX. 7. Use the tab 'Wake Up Calls' to specify the retry time, the retry interval, the scatter period for wake up calls and if status information about wake ups must be send to the PMS. 8. Use the tab 'Bills & Toll Tickets' to indicate if Bills and/or Toll Ticket information must be send to the PMS. Under 'PID Dialling", fill in the money value for one SOPHO unit (in local currency). 9. Use the tab 'Extension Messages' to indicate if AEM information must be send to the PMS.
32.3.
INTERFACES
The EAI opens the connections to the Directory Services Module and the TABS Call Reporting Module, by connecting to the Data Distribution Module. The connection with the external application is directly configured in the EAI-Configurator. The EAI requests the Connection Manager to set up a connection to the ISPBX.
171
The EAI provides a graphical user interface for configuration of the EAI via the EAIConfigurator. The EAI-Configurator can be found in the Configurators program group of the Management@Net program group.
32.4.
TROUBLESHOOTING
An EAI Status window displays the status of the EAI. This includes: the license type, whether or not Wake-up handling is operational and the condition of the connections to the ISPBX, the PMS and the DDM. On top of this an EAI Fatal Alarm window informs the user if the EAI cannot operate properly anymore; it contains hints to repair the situation. This EAI Fatal Alarm window appears always after installation and before configuration of the EAI to remind the engineer to configure the EAI (Connection Manager Database Configurator, EAI Configurator). All incoming and outgoing events will be logged for every message based interface, using the diagnostics module. This module contains also tracing possibilities, see chapter 35. GENERAL MAINTENANCE AND TROUBLESHOOTING.
172
173
Double click on PIDUseMAC.reg in C:\Philips\Data Files\EAI-Module . To let the EAI handle the Add / Delete PID through switching services: Double click on PIDUseSSRouter.reg in C:\Philips\Data Files\EAI-Module .
174
33.
33.1.
The Data Distribution Module (DDM) is used to distribute common data between the MACManager Module, the Call Reporting Module, the Directory Services Module and the External Application Interface Module. For example, the name of a person related to a specific DNR is used in the MAC-Manager database, the Call Reporting Module database and the Phonebook database. When this name is updated in one of these databases, the DDM will be notified of this update. Then the DDM will inform the other modules about this update. This way the update will automatically be entered in all databases keeping this information up-to-date. DDM supports the following data transfers: Between the External Application Interface and the Directory Services Module (Phonebook database). Between the External Application Interface and the MAC-Manager for adding or deleting PIDs. Since Call@Net 2.10, it is possible to add or delete PIDs through switching services and this is handled by the External Application Interface instead of the MAC-Manager. See section 32.4.5. Add / Delete PID by MAC-Manager or EAI (through switching services). From the TABS Call Reporting Module to the External Application Interface. This only holds for Call Accounting information (PMS Billing). Between the MAC-Manager and the TABS Call Reporting Module (replacing the passport mechanism from earlier Management@Net releases). Between the MAC-Manager and the Directory Services Module (Phonebook database). Between the TABS Call Reporting Module and the Directory Services Module (Phonebook database).
Because data field lengths may be different in various databases, it is adviced to use a common length as preferred length:
175
CRM 12 6 32 32 7
DSM 12 6 30 36 no limit
EAI 6 20 30 -
ISPBX 12 6 20 -
Table 33-1 Preferred Database Field Lengths CAUTION: DEPARTMENT NAMES MUST BE UNIQUE OVER ALL ORGANISATIONS ON ALL LEVELS OF THE HIERARCHY.
33.2.
The Data Distribution Configurator is a tool to select the data distribution configuration. The Data Distribution Configurator is used during installation and if another data distribution configuration is required. During installation the Data Distribution Configurator is automatically executed. If the Data Distribution Configurator starts for the first time the "No Distribution" configuration is selected, otherwise the stored data distribution configuration is selected. A limited number of data distribution configuration transistions is supported.
176
Existing Data Distribution Configuration New Data Distribution Configuration Basic Distribution No Distribution No Distribution No Distribution No Distribution Full Distribution Basic Hospitality Basic Hospitality Basic Hospitality Messaging Full Distribution Basic Distribution Messaging Full Distribution, no CRM Full Hospitality, no CRM Full Hospitality, no PMS Billing Full Hospitality Basic Hospitality, no PMS Billing Full Hospitality, no PMS Billing Basic Hospitality
33.3.
Before initial filling of the databases, a number of steps must have been taken: The licences must have been loaded. The destinations must have been defined in the Connection Manager and ACTIVATED!! In configurations with CRM: The Site Setup must have been completed on all sites, using the TABS icon in the Management@Net Group. Do not start the Call Collector yet. In configurations with DSM:
177
The DSM must have been configured to refer to the right Phonebook. Use the Directory Services icon in the Management@Net Configurators Group. In the PhoneWare Phonebook Manager the right Phonebook must have been registered. In configurations with EAI: The External Application Interface must have been configured, using the EAI Configurator icon in the Management@Net Configurators Group. ALTHOUGH THERE ARE OTHER POSSIBILITIES, THE STEPS DESCRIBED IN THE INITIAL FILLING OF THE DATABASES ARE STRONGLY RECOMMENDED. FOR CORRECT DATA DISTRIBUTION, OBSERVE THE RULES IN SECTION 30.6. DATA DISTRIBUTION.
CAUTION:
PROCEDURE: Initial Filling of the Databases for Full Hospitality (EAI, DSM, CRM, MM)
Actions 1. The "default" site group entry in the Phonebook must be redefined to contain the destination as defined in the Connection Manager: - Start the PhoneWare Phonebook Manager in Start/Programs/PhoneWare/Phonebook Manager. - Select the Phonebook and press Edit. - Select the tab "Site Groups", select the "default" (Site Group Code 1) entry and press Edit. - Enter the destination name in the "Site Group Description" and "Server Replica Id" and press Save. - Press New. Set Site Group Code to 999, enter "External Numbers" in the "Site Group Description" and "Server Replica Id". Press Save. Note: Use Site Group Code 999 for external name/number relations. 2. Start the MAC-Manager in Start/Programs/Management@Net. Select the PBX and perform "PBXs/Get Configuration" for this PBX. Wait until the PBX configuration has been retrieved. 3. Start the Directory Services in Start/Programs/Management@Net/Configurators. Select "Server/DSM-Healing/Synchronise/DNR" and press Start. A Synchronise confirmation box is showing "Synchronise started for DNR". Press OK. Close the "Synchronise Data" box. 4. Start the TABS in Start/Programs/Management@Net. Select "Setting Up/Setup/Action/ Synchronization". Select only "Extension" as Data Type in the "Synchronization" box and press "Sync. Now". A Synchronization Status box is shown. Wait for the result (counters show the progress) and then press Done. A "TABS Events" window will also pop up and
178
shows the progress/result. Close the "Synchronization" box. Close TABS Events box. Close TABS. 5. Start the TABS Call Collector in Start/Programs/Startup. 6. Start the TABS in Start/Programs/Management@Net. Select "Main/Organization Layout". Add the required organization levels. Add ALL extensions to the organization levels from the "Unassigned Extensions" list. Note: The department names (sub levels in the hierarchy) must be unique for ALL levels. 7. Start the PhoneWare Phonebook Manager in Start/Programs/PhoneWare/Phonebook Manager, select the Phonebook and press Edit. Enter the names. Note: Take care that entries used for guest check-in have "Unassigned" in the "Surname" field. The guests' name will later be filled-in after check-in from the PMS.
PROCEDURE: Initial Filling of the Databases for Full Hospitality, no CRM (EAI, DSM, MM)
Actions 1. The "default" site group entry in the Phonebook must be redefined to contain the destination as defined in the Connection Manager: - Start the PhoneWare Phonebook Manager in Start/Programs/PhoneWare/Phonebook Manager. - Select the Phonebook and press Edit. - Select the tab "Site Groups", select the "default" (Site Group Code 1) entry and press Edit. - Enter the destination name in the "Site Group Description" and "Server Replica Id" and press Save. - Press New. Set Site Group Code to 999, enter "External Numbers" in the "Site Group Description" and "Server Replica Id". Press Save. Note: Use Site Group Code 999 for external name/number relations. 2. Start the MAC-Manager in Start/Programs/Management@Net. Select the PBX and perform "PBXs/Get Configuration" for this PBX. Wait until the PBX configuration has been retrieved. 3. Start the Directory Services in Start/Programs/Management@Net/Configurators. Select "Server/DSM-Healing/Synchronise/DNR" and press Start. A Synchronise confirmation box is showing "Synchronise started for DNR". Press OK. Close the "Synchronise Data" box. 4. Start the PhoneWare Phonebook Manager in Start/Programs/PhoneWare/Phonebook
179
Manager, select the Phonebook and press Edit. Enter the names. Note: Take care that entries used for guest check-in have "Unassigned" in the "Surname" field. The guests' name will later be filled-in after check-in from the PMS.
PROCEDURE: Initial Filling of the Databases for Basic Hospitality (EAI, DSM, CRM)
Actions 1. The "default" site group entry in the Phonebook must be redefined to contain the destination as defined in the Connection Manager: - Start the PhoneWare Phonebook Manager in Start/Programs/PhoneWare/Phonebook Manager. - Select the Phonebook and press Edit. - Select the tab "Site Groups", select the "default" (Site Group Code 1) entry and press Edit. - Enter the destination name in the "Site Group Description" and "Server Replica Id" and press Save. - Press New. Set Site Group Code to 999, enter "External Numbers" in the "Site Group Description" and "Server Replica Id". Press Save. Note: Use Site Group Code 999 for external name/number relations. 2. Start the TABS in Start/Programs/Management@Net. Select "Main/Define/Extensions". Add the required extensions. 3. Start the TABS Call Collector in Start/Programs/Startup. 4. Start the TABS in Start/Programs/Management@Net. Select "Main/Organization Layout". Add the required organization levels. Add ALL extensions to the organization levels from the "Unassigned Extensions" list. Note: The department names (sub levels in the hierarchy) must be unique for ALL levels. 5. Start the PhoneWare Phonebook Manager in Start/Programs/PhoneWare/Phonebook Manager, select the Phonebook and press Edit. Enter the names. Note: Take care that entries used for guest check-in have "Unassigned" in the "Surname" field. The guests' name will later be filled-in after check-in from the PMS.
PROCEDURE: Initial Filling of the Databases for Full Distribution (DSM, CRM, MM)
Actions
180
1. The "default" site group entry in the Phonebook must be redefined to contain the largest destination as defined in the Connection Manager: - Start the PhoneWare Phonebook Manager in Start/Programs/PhoneWare/Phonebook Manager. - Select the Phonebook and press Edit. - Select the tab "Site Groups", select the "default" (Site Group Code 1) entry and press Edit. - Enter the destination name of the largest destination in the "Site Group Description" and "Server Replica Id" and press Save. - Press New. Set Site Group Code to 999, enter "External Numbers" in the "Site Group Description" and "Server Replica Id". Press Save. Note: Use Site Group Code 999 for external name/number relations. 2. Start the MAC-Manager in Start/Programs/Management@Net. Select the PBX and perform "PBXs/Get Configuration" for this PBX. Wait until the PBX configuration has been retrieved. Do this for every PBX. 3. Start the Directory Services in Start/Programs/Management@Net/Configurators. Select "Server/DSM-Healing/Synchronise/DNR" and press Start. A Synchronise confirmation box is showing "Synchronise started for DNR". Press OK. Close the "Synchronise Data" box. 4. Start the TABS in Start/Programs/Management@Net. Select "Setting Up/Setup/Action/ Synchronization". Select only "Extension" as Data Type in the "Synchronization" box and press "Sync. Now". A Synchronization Status box is shown. Wait for the result (counters show the progress) and then press Done. A "TABS Events" window will also pop up and shows the progress/result. Close the "Synchronization" box. Close TABS Events box. Close TABS. 5. Start the TABS Call Collector in Start/Programs/Startup. 6. Start the TABS in Start/Programs/Management@Net. Select Site with "Tools/Select Site". Select "Main/Organization Layout". Add the required organization levels. Add ALL extensions to the organization levels from the "Unassigned Extensions" list. Do this for every Site. Note: The department names (sub levels in the hierarchy) must be unique for ALL levels and all sites. 7. Start the PhoneWare Phonebook Manager in Start/Programs/PhoneWare/Phonebook Manager, select the Phonebook and press Edit. Enter the names.
PROCEDURE: Initial Filling of the Databases for Full Distribution, no CRM (DSM, MM)
Actions
181
1. The "default" site group entry in the Phonebook must be redefined to contain the largest destination as defined in the Connection Manager: - Start the PhoneWare Phonebook Manager in Start/Programs/PhoneWare/Phonebook Manager. - Select the Phonebook and press Edit. - Select the tab "Site Groups", select the "default" (Site Group Code 1) entry and press Edit. - Enter the destination name of the largest destination in the "Site Group Description" and "Server Replica Id" and press Save. - Press New. Set Site Group Code to 999, enter "External Numbers" in the "Site Group Description" and "Server Replica Id". Press Save. Note: Use Site Group Code 999 for external name/number relations. 2. Start the MAC-Manager in Start/Programs/Management@Net. Select the PBX and perform "PBXs/Get Configuration" for this PBX. Wait until the PBX configuration has been retrieved. Do this for every PBX. 3. Start the Directory Services in Start/Programs/Management@Net/Configurators. Select "Server/DSM-Healing/Synchronise/DNR" and press Start. A Synchronise confirmation box is showing "Synchronise started for DNR". Press OK. Close the "Synchronise Data" box. 4. Start the PhoneWare Phonebook Manager in Start/Programs/PhoneWare/Phonebook Manager, select the Phonebook and press Edit. Enter the names.
PROCEDURE: Initial Filling of the Databases for Basic Distribution (CRM, MM)
Actions 1. Start the MAC-Manager in Start/Programs/Management@Net. Select the PBX and perform "PBXs/Get Configuration" for this PBX. Wait until the PBX configuration has been retrieved. Do this for every PBX. 2. Start the TABS in Start/Programs/Management@Net. Select "Setting Up/Setup/Action/ Synchronization". Select only "Extension" as Data Type in the "Synchronization" box and press "Sync. Now". A Synchronization Status box is shown. Wait for the result (counters show the progress) and then press Done. A "TABS Events" window will also pop up and shows the progress/result. Close the "Synchronization" box. Close TABS Events box. Close TABS. 3. Start the TABS Call Collector in Start/Programs/Startup. 4. Start the TABS in Start/Programs/Management@Net. Select Site with "Tools/Select Site". Select "Main/Define/Extensions" and enter the names. Do this for every Site.
182
33.4.
For answers to questions like: "where to enter data in daily use" and "how to synchronise data", see online help. Online help is available in the Management@Net Configurators group. The online help is dedicated for the installed configuration and therefore does not give a total overview. To see which modules are operating in which configuration, see table for Stand-Alone or table for Multi-User. The following table shows - per configuration - what data is entered in which module and to which other modules the data is sent (distributed).
183
Configuratio Enter n Name Extensio Extensio Extensio Name s in ns in ns in ns in Phonebo MAC CRM MAC ok Full Hospitality Sent to ISPBX / CRM / DSM -
Name Names in Organis Phonebo ation in s in CRM ok CRM Sent to CRM Sent to DSM
Sent to Full ISPBX / Hospitality, no PMS Billing CRM / DSM Full Hospitality, no CRM Basic Hospitality Sent to ISPBX / DSM -
Sent to CRM
Sent to DSM
Sent to CRM Sent to CRM Sent to ISPBX / MAC / CRM Sent to ISPBX / MAC
Basic Hospitality, no PMS Billing Full Distribution Sent to ISPBX / CRM / DSM Sent to ISPBX / DSM Sent to ISPBX / CRM -
184
Table 33-3 Data Entry in Data Distribution Configurations Observe the following general rules: In the Phonebook, the Site Group Code is used to identify the destination(s). External name/number relations are independent of a particular destination. Use Site Group Code "999" for these relations. In the Phonebook and CRM each department (organization level) must have a unique name. In the Phonebook only one organization structure exists in Hierarchy 1, so only one top level in the hierarchy can be made. In the Phonebook each department (organization level) is assigned to a site group (code). In the Phonebook each directory entry must be assigned to a site group (code). In CRM and the Phonebook all extensions must be assigned to a department (organization level), if an organization is used. In CRM you can select only one site at a time, but the top level of the hierarchy must be the same for all sites (in multi-site installations), and all other organization levels (departments) must have unique names throughout all sites.
Considerations for multiple names: The Phonebook displays all names in separate entries. The Call Reporting Module (CRM) has multiple names, but only shows the last entered name. The MAC-Manager (MAC) only has one name, which is the last entered name.
The following table shows - per configuration - where to synchronise what data and which module supplies the data (leading database). Synchronisation is always done for all sites.
185
Configuratio Synchronise n Name Extensio Extensio Names in Names Name Organis ation in s in in DDM ns in ns in DSM CRM CRM (MAC / DSM CRM ISPBX) Full Hospitality MAC supplies MAC supplies MAC supplies MAC supplies CRM supplies CRM supplies MAC supplies MAC supplies DSM supplies DSM supplies DSM supplies DSM MAC DSM supplie supplie supplies s s DSM MAC DSM supplie supplie supplies s s MAC supplie s
MAC Full supplies Hospitality, no PMS Billing Full Hospitality, no CRM Basic Hospitality -
DSM supplies
DSM CRM DSM supplie supplie supplies s s DSM CRM DSM supplie supplie supplies s s DSM MAC DSM supplie supplie supplies s s MAC supplie s -
DSM Basic supplies Hospitality, no PMS Billing Full Distribution Full Distribution, no CRM Basic Distribution Messaging MAC supplies -
MAC supplies -
MAC supplie s -
Table 33-4 Synchronisation in Data Distribution Configurations Synchronisation is normally not needed. It is needed during initial filling (after installation) or when databases have become inconsistent. Synchronisation in an application means updating the data in that application from the database in another application (which is considered to
186
be correct).
How do databases become inconsistent? Here are the major reasons: (A part of) an application has not been started while updates are being sent to this application. An example is the Call Reporting Module (CRM): if non-of the applications are running, updates are not processed. Rule: at least one of the applications of CRM must be running, normally the TABS Call Collector. Another example is the DSM Healing Server.
Note: Updates (during data distribution) are retained only for a certain period of time (2 hours). A user updates the same item in two different places at the same time. An example: a user updates a name for the same DNR in both the MAC-Manager and the Call Reporting Module. Rule: follow only the instructions in "where to enter data in daily use". Abnormal termination of an application (power failure). Pending changes could be lost.
33.5.
TROUBLESHOOTING
The Data Distribution Module has a tray icon. After clicking with the right mouse button on this tray icon, a menu is opened. In the menu the two choices "Disable DDM" and "Enable DDM" are important for troubleshooting. In case of serious inconsistencies between databases, you can disable the distribution temporarily, correct the databases and enable the distribution again. Changes offered to DDM during the time that DDM is disabled are not distributed. The DDM logs events and exceptions using the diagnostics module. This module contains also tracing possibilities, see chapter 35. GENERAL MAINTENANCE AND TROUBLESHOOTING.
187
34.
34.1.
The ISPBX File Manager (IFM) performs the following service functions: Disk Emulation The Disk Emulator (DE) provides the ISPBX with a (external) storage device like a PC hard disk and transfers files between the ISPBX and the external PC. The DE may connect to only one port on one destination at any given time during the DE session. iS3000 File Convertor Converts files to iS3000 Format and from iS3000 Format. One of the options on the DE File Menu is 'File Convert'. This option is also available as the third toolbar button from the left. A file which is in SOPHO ISPBX format cannot be read or changed in the PC. Conversely, a file created in the PC cannot be processed by a SOPHO ISPBX. In such cases, file conversion is necessary. A off-line conversion - without connection to an ISPBX - can also be performed. Start the tool directly from the Management@Net program group by clicking the proper icon. File Conversion To iS3000 Used to convert projecting text files into 'POM' files (PE/LL), Command text files into 'COM' and licence text files into 'LIC'. File Conversion from iS3000 Used to convert projecting files, ASCII files (command and log files) and binary files (PPH trace for example).
For additional information regarding the use of the Disk Emulator, refer to the Disk Emulator on-line help.
34.2.
Ensure you have a license for the IFM (check with the Licence Manager) and you have setup a connection in the Connection Manager. The ISPBX File Manager (IFM) can only be used on a V.24 port to an ISPBX. This V.24 port must run bcs protocol and a disk emulator device must have been assigned to it. See section 4.3. PROJECTING V.24 CONNECTIONS.
34.3.
Prior to commencing Disk Emulation, check that the previously defined Connection Manager ports have been setup correctly.
188
To setup disk emulation, follow the steps below: 1. Double click on the 'Disk Emulation' icon, located in the 'Management@Net' program group. 2. Select the required ISPBX destination from the list. 3. Set Specific Directory. The specific directory is where dedicated files containing ISPBX specific data is stored. (e.g. PE, LL, MIS files etc.) The Specific Directory may be new or existing and is set as follows: - From the 'File' menu, select 'Set Specific Directory'. - Specify Specific Directory. 4. Set Common Directory. (If required) The common directory is where generic files, relating to the ISPBX software package are stored. (e.g. CPU, CIE files etc.) These files are read only. The common directory (Default: C:\ ) may be new or existing and is set as follows: - From the 'File' menu, select 'Set Common Directory'. - Specify Common Directory. 5. Set Logging Requirements. The two levels of logging available in the DE are: Non-Detailed Logging and Detailed Logging. In Non-Detailed Logging, only connection setup and break events are recorded, whereas in Detailed Logging, all FM commands and responses are additionally recorded. - From the 'File' menu, select or deselect 'Detailed Logging', as required. 6. Copy Files Into Common Directory. (If necessary) Files are added to the Common Directory via Windows Explorer and not in the Disk Emulator. - Click 'Programs' from the 'Start Menu' and select 'Windows Explorer'. - Locate the Common Directory in the explorer. - Select the required generic files, usually located in the A: (Floppy) drive and drag and drop them into the Common Directory. 7. Close Disk Emulator window.
189
34.4.
TROUBLESHOOTING
POSSIBLE SOLUTION Is destination defined in Connection Manager? - Destination selected? - Common / specific directories specified? - Physical connection present? - Definition correct in Connection Manager? - Port assigned in ISPBX?
PROBLEM Destination not shown Connect menu option / toolbar button can not be selected Connection can not be made
190
35.
35.1.
During installation a "Management@Net Backup Task" (BUFrame.exe) is put in the Windows Scheduler. By default, this task runs the script Backup@Net.bat every Sunday evening at 23:00 hours. This script stops and starts the Management@Net processes, but does nothing else. In the script Backup@Net.bat, a section is reserved for own user specific backup commands. Both the script file Backup@Net.bat and the task BUFrame.exe are in the folder C:\Program Files\Philips\Management@Net. Some notes on backup jobs: Management@Net Files
Ideally, the complete Management@Net Data and Program file directories should be regularly backed up. The data files can be found by default in C:\Philips\Data Files\<Module>. The program files are located in C:\Program Files\Philips\<Module> . In case of re-installing the Management@Net software, or installing a later version, these files can be copied back into the appropriate directories. Operating System
It is also advisable to back up the Operating System, as a precaution against PC crash. Refer to the Windows documentation for further details.
35.2.
TROUBLESHOOTING
191
4. Start the monitor application for further diagnostic information when trying to re-establish the connection. 5. Test the COM ports by setting up a back-to-back connection and sending information between them using the HyperTerminal. (Refer to section 'Testing the COM Port'). If Management@Net is unable to contact the network, and the message 'Contacting Broker' is displayed for more than one minute, it may be necessary to change the TCP/IP settings, enabling the PC to operate independently of any DNS on the network. Proceed as follows: 1. 2. 3. 4. 5. 6. 7. In the 'Start Menu' area, select 'Settings' and 'Control Panel'. In the 'Control Panel' area, select 'Network'. In the 'Network' dialogue box, select TCP/IP and click 'Properties'. Open the 'IP Address' tab and select 'Specify an IP Address'. Enter the appropriate IP address. Open the 'DNS Configuration' tab and select 'Disable DNS'. Click 'OK'.
192
In the left pane, you can select a process and in the right pane you see the Events and Exceptions for that process as they happen. In the menu Options and Trace Level Settings, you can select more detailed monitoring (tracing) for some modules.
35.3.
Meser SQL View is a web tool that allows you to view tables and records from any SQL Server or MSDE database. The purpose of the tool is to allow service engineers to view records, to help in debugging customer's problems. Meser SQL View can be accessed through URL http://pc5/mesersql/, for example. For Meser SQL View to work you need the hostname of the SQL Server, a valid username and password and the database name you want to connect to. Furthermore, your SQL Server needs to have SQL Server Authentication on (which is mostly the case). The Meser SQL View will NOT allow you delete, update, insert new records into any database.
193
1. Using Internet Explorer, browse to http://pc5/mesersql/, for example. 2. Enter the SQL Server hostname, username and password and the database name. Press Connect. 3. From the drop down list, select the required table of the selected database. Press Get Records. 4. Now you see the contents. The 'Advance query' text box allows you to specify your own filter on the records returned from the database. It involves using the WHERE SQL clause to get a specific record which you can append to the existing query from the text box. (e.g. WHERE _extn_num = 1000) Sort buttons in each column header of the displayed table allows you to sort ascending on that specific column.
194
36.
OM LOGGING
OM Logging is an add-on feature that allows logging of sent OM commands and their results from a range of Management@Net applications. The OM Log files can be used to trace the user/application that performed certain operational maintenance actions on the PBX. OM Logging will log all OM commands sent to PBX. This includes both V.24 and IP connections from Management@Net. OM Logging will log the application, the user and the destination name of the OM session and the type of connection. By default, the log files are stored in the folder OM Logging . The permissions on the log files will automatically be set so that only the administrator can read or delete these files. The logged applications are: OM Terminal (Maintenance Manager OM@Net); MAC-Manager; Key Programming Manager; ISPBX Destination Activator.
Installation is from the CD-ROM folder 'OM Logging - 1.1.0' . OM Logging must be install by a user with administrator rights (e.g. member of Administrators group). Running setup.exe in the "Disk1" folder starts OM Logging installation. As soon as OM Logging is installed it will run. This means that stopping OM Logging is only possible by uninstalling it.
195
A.
Customers may have an existing SysManager 410 installation with TABS version 3.987 with settings and call data, that they want to reuse in Management@Net. You can upgrade (convert) this TABS version 3.987 data to TABS version 7.026 which runs as part of Management@Net. The principle is that you copy all TABS program directories and data directories from the PC on which SysManager 410 was installed onto the PC where Managerment@Net will be installed. This includes some registry keys and ini files. During installation of Management@Net, TABS will see that there is a previous version and will ask you to upgrade.
196
9. In the following screen, you have to choose a backup location. Just press Next.
197
10. In the following screen, you have to choose the convert options. Just leave it on Calls and press Next.
198
199
14. Wait for the upgrade procedure to finish and complete the Management@Net installation. Additional Information Take care that you take the same names for the site definitions as used in TABS.
200
B.
This section gives examples of hardware configurations that support V.24 connections. For cable details, see Appendix C . CABLES:
B.1.
CONFIGURATIONS
SysManager
iS3000
CPU ME/MT or Clx IAS FDCR OM/MAC IAS
SysManager
TOPS
Figure B-2 Local Connection with Announcement Manager and TOPS Box
201
B.1.3. Local Connection with EAI, DSM and External Application (PMS)
SuperVisor 60E iS3000
DTX - I CPU-ME/MT IAS-A FDCR/SS/OM COM 1 COM 2 Phoneware Directory Sharing via LAN
SysManager
Figure B-3 Local Connection with External Application (as in hotels) For Hospitality configurations with CRM and PMS Billing, one direct and non-buffered FDCR connection is used. The iS3000 can be a multi-unit system (FIN). One output device for FDCR for the complete FIN can be used with the restriction of 8 FDCR call records per second.
202
TOPS
IAS
iS3000
CPU ME/MT or Clx IAS OM/MAC FDCR IAS TOPS
Public Network
Modem 1 Modem 2
COM 3 COM 4
iS3000
Ethernet BIM Modem FDCR IAS/OM/MAC Modem IAS IAS
CIE
P375 LAMs If the customer has a private network, the P375 LAMs (in Hayes mode) can be used instead of modems. Settings for a P375 LAM are shown in Appendix D . SOPHO LAM P375 SETTINGS. For more information regarding the installation and programming of a LAM, refer to the
203
SOPHO LAM P375 Customer Engineer Manual. Note: Do not mix P375 LAMs and modems in one connection.
204
C.
CABLES
This section gives details of cables for Operational Maintenance and Call Reporting (FDCR) connections. For details of cables for the Announcement Management connection, see SOPHO VoiceManager 110 (IASA) Customer Engineer Manual, Appendix A.
C.1.
CPU-ME/MT TO Management@Net PC
Figure C-1 Cable for CPU-ME/MT to PC (If the PC has a 25 pin D-connector).
205
Figure C-2 Cable for CPU-ME/MT to PC (If the PC has a 9 pin D-connector).
206
C.2.
Clx TO Management@Net PC
Figure C-3 Cable for Clx to PC (If the PC has a 25 pin D-connector).
207
Figure C-4 Cable for Clx to PC (If the PC has a 9 pin D-connector).
C.3.
BIM TO Management@Net PC
208
C.4.
CPU-ME TO MODEM
C.5.
CIx TO MODEM
209
C.6.
BIM TO MODEM
C.7.
210
C.8.
C.9.
ComboX CABLES
The following cables are used for connecting the ComboX to a CPU or BIM in association with the Call Reporting Module.
It uses the following mappings: CPU F122 16 pin female 103 - RXD 105,303 - CTS,RTS 107 - DTR 301 - TXD 302 - GND 305 - DSR 307 - DCD ComboX SubD 9 pin male 3 - TXD 1 - DCD 6,9 - DSR,RI 2 - RXD 5 - GND 4 - DTR 7,8 - RTS,CTS
211
It uses the following mappings: BIM SubD 25 pin female 2 - TXD 3 - RXD 4 - RTS 5 - CTS 7 - GND 6,8 - DSR,DCD 20 - DTR ComboX SubD 9 pin male 2 - RXD 3 - TXD 8 - CTS 7 - RTS 5 - GND 4 - DTR 1,6 - DCD,DSR
C.10.
PMS to Management@Net
To connect a PMS to the Management@Net EAI-port, it is adviced to use the "null modem" cable from section.
C.11.
RadLinX to ComboX
To connect a RadLinX box to a ComboX, a null modem cable is needed. A 9 pin female connector is needed at the ComboX side and a 25 pin male connector is needed at the RadLinX box side. The same cable can be used during setup of the RandLinX box from a PC. To setup the RadLinX box, use the Network Add-On Kit supplied with the CD-ROM that contains the Service Tools.
C.12.
For safety reasons, a TOPS box may be needed also in a direct connection between the ISPBX and Management@Net. The ISPBX side can be found in and. The connection between TOPS and Management@Net can be found below. Note: DIP switch 7 on the TOPS box must be set to "ON": direct connection. It uses the following mappings: TOPS SubD 9 pin female 2 - RXD 3 - TXD Management@Net SubD 25 pin female 2 - TXD 3 - RXD
212
TOPS SubD 9 pin female 1 - DCD 7,8 - RTS,CTS 5 - GND 4 - DTR 6 - DSR
Management@Net SubD 25 pin female 4,5 - RTS,CTS 8 - DCD 7 - GND 6 - DSR 20 - DTR
213
D.
Configuration of the SOPHO LAM P375. Adjust the following parameters in the DTE CCT menu: CT108 as call request: CT108 on: CT105 as call request: CT103 as call request: CT107 as call clear: CT107 assumed on: Auto answer: Connect CT105-CT109: CT109 enables CT106: Connect CT105-CT106: CT105 on: Dataguarding: Inc guarding: Break call clear: Autobaud detect: Autoparity detect: Flow control: Dataguard (m): Inc. guard: Speed: Asynchroon: - Parity: - Stopbits: - Word length: Protocol: - AT command: Dialing options: - Echo: - Uppercase conversion: - Display calling number: Yes No No No Yes No (for BIM), Yes (for SSM) No No No No Yes No No No No No CT106 30 6 19200
No 1 8 Yes No No No
214
V.110 Yes No No
The corresponding CV value for the SOPHO LAM P375 at the: Management@Net side: CRCVAL:10, D, 000010001001, <SPEED+MODE>, 000018000011, <GUARD> Opposite side (OM): CRCVAL:11, D, 000000001001, <SPEED+MODE>, 001018000011, <GUARD> With auto answering on (for IAS(A)): CRCVAL:11, D, 000001001001, <SPEED+MODE>, 001018000011, <GUARD> For CCS systems: Init string, no auto answer (preferred): ATV0X4S12=40S0=0^M Init string, with auto answer:ATV0X4S12=40S0=1^M Reset string: ~~~+++~~~ATZ^M ATE0^M Hangup string: ~~+++~~ATH^M Connect string: 1,5,10,11,12 Error string: 3,4,6,7 The default rate is 19.2 kbps Flow control at Management@Net side is RTS/CTS For CPU-ME/MT systems (OM command: CHREMC): string 0: E0Q0V1X1_&C1_&D0&S0_M0 string 1: S0=1_S2=43
Note: In the above strings: '_' is a space. For the IAS(A) the string is the same as strings 1 and 2 except for Q0. This must be: Q1 (= don't send result codes.).
215
E.
E.1.
The following common settings must be programmed in all modem connections. Depending on the use of the modem, program the settings of one of the other sections accordingly. The values between brackets are for an external 3Com U.S. Robotics 56 K Voice Faxmodem that is compatible with ITU recommendation V.90 and X2 technology. Enable result codes (Q0). ITU answering order (B0). Decimal ASCII escape code is '+' (S2=43). Result code set X1. (Optional) Speaker off (M0). Online local echo disabled (receiving system sends possible echo) (F1). Echo off (E0). ARQ result codes disabled (&A0). Normal DTR operations (&D2). No data compression (&K0). DSR always on (&S0). Software flow control is off (&I0).
Example: To program a 3Com U.S. Robotics 56K Voice Faxmodem, perform: ATZ4Q0B0S2=43X1M0F1E0&A0&D2&K0&S0&I0 Z4 = use factory profile with hardware flow control. Write the settings to the modem profiles (&W0 and &W1)
E.2.
Make sure the modem has the common modem settings according to Section E.1. COMMON MODEM SETTINGS at the beginning of this appendix. Add: Verbal mode (V1); Fixed speed serial port (&B1); Normal Carrier Detect operations (&C1);
216
Hardware flow control (&H1); Send data when RTS is high (&R2); Auto Answer off (S0=0).
Example: To program a 3Com U.S. Robotics 56K Voice Faxmodem, perform: ATV1&B1&C1&H1&R2S0=0 Write the settings to the modem profiles (&W0 and &W1) Note: Management@Net sends by default: ATZ X1 V1 S0=0
E.3.
Make sure the modem has the common modem settings according to Section E.1. COMMON MODEM SETTINGS at the beginning of this appendix. Add: Verbal mode (V1); Variable speed serial port (&B0); Ignore Carrier Detect (&C0); No flow control (&H0); Limit maximum modem speed to 2400 bps (&N3); Modem ignores RTS (&R1); Auto Answer on (S0>0).
Example: To program a 3Com U.S. Robotics 56K Voice Faxmodem, perform: ATV1&B0&C0&H0&N3&R1S0=1 Write the settings to the modem profiles (&W0 and &W1)
E.4.
Make sure the modem has the common modem settings according to Section E.1. COMMON MODEM SETTINGS at the beginning of this appendix. Add: Verbal mode (V1); Variable speed serial port (&B0); Normal Carrier Detect operations (&C1);
217
No flow control (&H0); Modem ignores RTS (&R1); Auto Answer on (S0>0).
Example: To program a 3Com U.S. Robotics 56K Voice Faxmodem, perform: ATV1&B0&C1&H0&R1S0=1 Write the settings to the modem profiles (&W0 and &W1) Note: The init strings that the TOPS box sends to the modem are: AT B0 E0 M0 &D2 S0=2 and AT S7=60 S9=20 V1 X1 &C1. CAUTION: IF THE TOPS BOX MODEM IS USED FOR CALL BACK, IT MUST SUPPORT: STORAGE OF A TELEPHONE NUMBER (AT&Z0=TELEPHONE NUMBER), DISPLAY OF THE STORED TELEPHONE NUMBER (AT&Z0?) AND DIALLING BY USING THE STORED TELEPHONE NUMBER (ATDS0). THE CONFIGURATION OF THE CALL BACK NUMBER IS DONE BY THE "TOPS MODEM CALL BACK CONFIGURATOR" TOOL. ALSO THE CALLBACK DIP SWITCH ON THE TOPS BOX MUST BE SET TO 'ON'. CALL BACK IS ONLY SAFE ON TOPS EPROM VERSION 2EGTGL.
E.5.
Make sure the modem has the common modem settings according to Section E.1. COMMON MODEM SETTINGS at the beginning of this appendix. Add: Numeric mode (V0); Fixed speed serial port (&B1); Normal Carrier Detect operations (&C1); Hardware flow control (&H1); Send data when RTS is high (&R2); Auto Answer off (S0=0); Guard time for escape code sequence: 0.8 second (S12=40).
Example: To program a 3Com U.S. Robotics 56K Voice Faxmodem, perform: ATV0&B1&C1&H1&R2S0=0S12=40 Write the settings to the modem profiles (&W0 and &W1)
218
E.6.
Make sure the modem has the common modem settings according to Section E.1. COMMON MODEM SETTINGS at the beginning of this appendix. Let the CPU-ME/MT initialise the modem. Set speed with CHPORT. Modem port is then synchronised with the CPU-ME/MT port. Add: Verbal mode (V1); Fixed speed serial port (&B1); Normal Carrier Detect operations (&C1); Hardware flow control (&H1); Send data when RTS is high (&R2); Auto Answer on (S0>0).
Example: To program a 3Com U.S. Robotics 56K Voice Faxmodem, perform: ATV1&B1&C1&H1&R2S0=1 Write the settings to the modem profiles (&W0 and &W1)
E.7.
Make sure the modem has the common modem settings according to Section E.1. COMMON MODEM SETTINGS at the beginning of this appendix. Add: Verbal mode (V1); Fixed speed serial port (&B1); Normal Carrier Detect operations (&C1); Hardware flow control (&H1); Modem ignores RTS (&R1); Auto Answer off (S0=0).
Example: To program a 3Com U.S. Robotics 56K Voice Faxmodem, perform: ATV1&B1&C1&H1&R1S0=0 Write the settings to the modem profiles (&W0 and &W1)
219
F.
F.1.
The following common settings must be programmed in all modem connections. The Dynalink modem has to be configured for the country in which the modem is used. This can be done by using the so called 'Country Selection Control Panel'. This panel will become available after installing the Dynalink modem driver. Note: This procedure is also described in the Dynalink Hardware Installation guide. Please do the following to select the country settings: 1. Install the Dynalink V1456E-R2 modem driver according to the Dynalink Hardware Installation guide. This driver is available on the Dynalink CDROM. Both the Hardware Installation guide and the CDROM are delivered together with the modem. 2. Make sure that the Dynalink modem is connected to a COM port and powered on. 3. Go into the Windows "Control Panel" and double click "ACF2 Modem Regional Settings". 4. Select your country and press "OK". Now the modem is ready to be configured for the applications described in the other sections of this appendix. Note: The modem configuration can be read by Hayes command AT&V. This reports the current (active) configuration, the stored (user) profiles, and the first four stored telephone numbers.
F.2.
Make sure the modem has the common modem settings according to Section F.1. COMMON MODEM SETTINGS at the beginning of this appendix. For the modem connected to Management@Net, use the CM Modem Configurator, add a new modem, and define the following modem Init string: &FV1&C1&K3S0=0 . Assign this new modem to the COM port to which the Dynalink modem is connected. This string has to be used for all Dynalink modems connected to Management@Net.
F.3.
Make sure the modem has the common modem settings according to Section F.1. COMMON
220
MODEM SETTINGS at the beginning of this appendix. Before connecting the modem to the IAS (A), it must be initialised to a speed of 2400 bps. Take the following steps: 1. Connect to modem to a free COM port. 2. Start the Windows HyperTerminal on this COM port with a speed of 2400 bps. As a result the default V.24 interface speed of the modem will be set to the required speed of 2400 bps. 3. Type the following Hayes commands: - AT&F - ATS0=1 - AT&W 4. Stop HyperTerminal and disconnect the modem. The modem can now be connected to the IAS(A).
F.4.
Make sure the modem has the common modem settings according to Section F.1. COMMON MODEM SETTINGS at the beginning of this appendix. The TOPS box sends a hard coded initialisation string to the modem: AT B0 E0 M0 &D2
S0=2 S7=60 S9=20 V1 X1 &C1 and this string is correct.
Before connecting the modem to the TOPS box, set the modem in the 'default factory state' by using:
AT&F AT&W
CAUTION:
IF THE TOPS BOX MODEM IS USED FOR CALL BACK, IT MUST SUPPORT: STORAGE OF A TELEPHONE NUMBER (AT&Z0=TELEPHONE NUMBER), DISPLAY OF THE STORED TELEPHONE NUMBER (AT&Z0?) AND DIALLING BY USING THE STORED TELEPHONE NUMBER (ATDS0). THE CONFIGURATION OF THE CALL BACK NUMBER IS DONE BY THE "TOPS MODEM CALL BACK CONFIGURATOR" TOOL. ALSO THE CALLBACK DIP
221
SWITCH ON THE TOPS BOX MUST BE SET TO 'ON'. CALL BACK IS ONLY SAFE ON TOPS EPROM VERSION 2EGTGL.
F.5.
Make sure the modem has the common modem settings according to Section F.1. COMMON MODEM SETTINGS at the beginning of this appendix. Use the BIM configuration menus to add a new modem with the following strings: Init string: ATE0V0S0=0S12=40&C1&K3&W^M Reset string: ~~~+++~~~ATZ^M Hangup string: ~~~+++~~~ATH^M Connect strings: 1,5,10-19,33-209, Error strings: 3,4,6,7,8,24,32,
F.6.
Make sure the modem has the common modem settings according to Section F.1. COMMON MODEM SETTINGS at the beginning of this appendix. Perform CHREMC and use as modem initiation string: V1 &C1 &K3 S0=1 This modem string can be used for OM/MAC connections with or without call back.
F.7.
Make sure the modem has the common modem settings according to Section F.1. COMMON MODEM SETTINGS at the beginning of this appendix. Before connecting the modem to the ComboX, it must be initialised. Take the following steps: 1. Connect to modem to a free COM port. 2. Start the Windows HyperTerminal on this COM port with a speed of 19200 bps. 3. Type the following Hayes commands: - AT&F0 - ATQ0S2=43X1M0E0&D2%C0\N0&S0&Y0 - ATV1N0S37=0&C1&K3&R1S0=0 - AT&W 4. Stop HyperTerminal and disconnect the modem. The modem can now be connected to the ComboX.
222
G.
The Directory Distribution Service can be installed on Management@Net, SysManager 410, SuperVisor 60E or another PC. Part of the Directory Distribution Service is Electronic Data Transfer, which is used to update name-number relations in the ISPBXs if name-number information changes have been made in the PhoneWare database. The name-number relations in the ISPBXs are used for name/number display (CNND) and for name browsing on ErgoLines D325, D330 and D340 (CDD). Name browsing on the ErgoLines uses name-number information stored in the ISPBX name directory. This applies to both internal name-number relations (names and numbers inside the company) and external name-number relations (names and numbers outside the company). Name-number information is typically entered or changed in the PhoneWare database (Phonebook) by the operator, whereby the PhoneWare database is the leading database. Electronic Data Transfer (EDT) updates name-number relations in the ISPBXs if namenumber information changes have been made in the PhoneWare database. EDT consists of two types of components: an EDT server and one or more EDT clients. The EDT server queries the PhoneWare database retrieving the name-number relations and determines the changes since the previous time. The EDT clients will store these changes in the applicable ISPBXs. Because the EDT server and EDT clients perform these tasks independently of each other, the changes are temporarily saved in the transfer database. Also, the result of storing the changes in the ISPBXs by the EDT clients is put in the transfer database and the EDT server collects it for you to monitor. Further information can be found in the Customer Engineer Manual - Directory Services.
223
H.
ABBREVIATIONS
ActiveX control An ActiveX control is a component program object that can be re-used by many application programs within a computer or among computers in a network. The technology for creating ActiveX controls is part of Microsoft's overall ActiveX set of technologies, chief of which is the Component Object Model (COM). ActiveX controls can be downloaded as small programs or animations for Web pages, but they can also be used for any commonly-needed task by an application program in the latest Windows and Macintosh environments. In general, ActiveX controls replace the earlier OCX (Object Linking and Embedding custom controls). An ActiveX control is roughly equivalent in concept and implementation to the Java applet. An ActiveX control can be created in any programming language that recognizes Microsoft's Component Object Model. The distributed support for COM is called the Distributed Component Object Model (DCOM). In implementation, an ActiveX control is a dynamic link library (DLL) module. An ActiveX control runs in what is known as a container, an application program that uses the Component Object Model program interfaces. This reuseable component approach to application development reduces development time and improves program capability and quality. Windows application development programs such as PowerBuilder and Microsoft Access take advantage of ActiveX controls. ASP An Active Server Page (ASP) is an HTML page that includes one or more scripts (small embedded programs) that are processed on a Microsoft Web server before the page is sent to the user. An ASP is somewhat similar to a server-side include or a common gateway interface (CGI) application in that all involve programs that run on the server, usually tailoring a page for the user. Typically, the script in the Web page at the server uses input received as the result of the user's request for the page to access data from a database and then builds or customizes the page on the fly before sending it to the requestor. ASP is a feature of the Microsoft Internet Information Server (IIS), but, since the server-side script is just building a regular HTML page, it can be delivered to almost any browser. You can create an ASP file by including a script written in VBScript or JScript in an HTML file or by using ActiveX Data Objects (ADOs) program statements in the HTML file. You name the HTML file with the ".asp" file suffix. Microsoft recommends the use of the server-side ASP rather than a client-side script, where there is actually a choice, because the server-side script will result in an easily displayable HTML page. Client-side scripts (for example, with JavaScript) may not work as intended on older browsers. FQDN A Fully Qualified Domain Name (FQDN) is that portion of an Internet Uniform Resource
224
Locator (URL) that fully identifies the server program that an Internet request is addressed to. The FQDN includes the second-level domain name (such as "whatis.com") and any other levels (for example, "www.whatis.com" or "www1.somesite.com"). The prefix "http://" added to the fully-qualified domain name completes the URL. HTTP The Hypertext Transfer Protocol (HTTP) is the set of rules for exchanging files (text, graphic images, sound, video, and other multimedia files) on the World Wide Web. Relative to the TCP/IP suite of protocols (which are the basis for information exchange on the Internet), HTTP is an application protocol. Essential concepts that are part of HTTP include (as its name implies) the idea that files can contain references to other files whose selection will elicit additional transfer requests. Any Web server machine contains, in addition to the HTML and other files it can serve, an HTTP daemon, a program that is designed to wait for HTTP requests and handle them when they arrive. Your Web browser is an HTTP client, sending requests to server machines. When the browser user enters file requests by either "opening" a Web file (typing in a Uniform Resource Locator) or clicking on a hypertext link, the browser builds an HTTP request and sends it to the Internet Protocol address indicated by the URL. The HTTP daemon in the destination server machine receives the request and, after any necessary processing, the requested file is returned. IIS The Internet Information Server (IIS) is a group of Internet servers (including a Web or Hypertext Transfer Protocol server and a File Transfer Protocol server) with additional capabilities for Microsoft's Windows NT and Windows 2000 Server operating systems. IIS is Microsoft's entry to compete in the Internet server market that is also addressed by Apache, Sun Microsystems, O'Reilly, and others. With IIS, Microsoft includes a set of programs for building and administering Web sites, a search engine, and support for writing Web-based applications that access databases. Microsoft points out that IIS is tightly integrated with the Windows NT and 2000 Servers in a number of ways, resulting in faster Web page serving. A typical company that buys IIS can create pages for Web sites using Microsoft's Front Page product (with its WYSIWYG user interface). Web developers can use Microsoft's Active Server Page (ASP)technology, which means that applications - including ActiveX controls - can be imbedded in Web pages that modify the content sent back to users. Developers can also write programs that filter requests and get the correct Web pages for different users by using Microsoft's Internet Server Application Program Interface (ISAPI) interface. ASPs and ISAPI programs run more efficiently than common gateway interface (CGI) and server-side include (SSI) programs, two current technologies. (However, there are comparable interfaces on other platforms.) ISAPI
225
The Internet Server Application Program Interface (ISAPI) is a set of Windows program calls that let you write a Web server application that will run faster than a common gateway interface (CGI) application. A disadvantage of a CGI application (or "executable file," as it is sometimes called) is that each time it is run, it runs as a separate process with its own address space, resulting in extra instructions that have to be performed, especially if many instances of it are running on behalf of users. Using ISAPI, you create a dynamic link library (DLL) application file that can run as part of the Hypertext Transport Protocol (HTTP) application's process and address space. The DLL files are loaded into the computer when HTTP is started and remain there as long as they are needed; they don't have to be located and read into storage as frequently as a CGI application. Existing CGI applications can be converted into ISAPI application DLLs without having to rewrite their logic. However, they do need to be written to be thread-safe so that a single instance of the DLL can serve multiple users. A special kind of ISAPI DLL is called an ISAPI filter, which can be designated to receive control for every HTTP request. You can create an ISAPI filter for encryption or decryption, for logging, for request screening, or for other purposes. MSDE Microsoft Data Engine - Simple client/server data engine based on SQL Server. Portal Portal is a term, generally synonymous with gateway, for a World Wide Web site that is or proposes to be a major starting site for users when they get connected to the Web or that users tend to visit as an anchor site. There are general portals and specialized or niche portals. Some major general portals include Yahoo, Excite, Netscape, Lycos, CNET, Microsoft Network, and America Online's AOL.com. PVE Private Virtual Enhancements - SOPHO functionality as a TCP/IP service. Terminal Server / RDP The Microsoft Windows Terminal Server (WTS) is a server program running on its Windows 2000 Server operating system that provides the graphical user interface (GUI) of the Windows desktop to user terminals that don't have this capability themselves. The latter include the relatively low-cost NetPC or "thin client" that some companies are purchasing as alternatives to the autonomous and more expensive PC with its own operating system and applications. The Windows Terminal Server has three parts: the multiuser core server itself, the Remote Desktop Protocol that enables the Windows desktop interface to be sent to the terminals by the server, and the Terminal Server Client that goes in each terminal. Users will have access
226
to 32-bit Windows-based applications. Users of existing PCs running Windows 95, Windows 98, Windows NT or Windows 2000 Professional operating systems can also access the Server and its applications. TSAC The Terminal Services Advanced Client (TSAC) is a Win32-based ActiveX control (COM object) that is used to run Terminal Services sessions within Microsoft Internet Explorer. URL A Uniform Resource Locator (URL) is the address of a file (resource) accessible on the Internet. The type of resource depends on the Internet application protocol. Using the World Wide Web's protocol, the Hypertext Transfer Protocol (HTTP) , the resource can be an HTML page (like the one you're reading), an image file, a program such as a common gateway interface application or Java applet, or any other file supported by HTTP. The URL contains the name of the protocol required to access the resource, a domain name that identifies a specific computer on the Internet, and a hierarchical description of a file location on the computer. On the Web (which uses the Hypertext Transfer Protocol), an example of a URL is: http://www.pcc.philips.com/cordless which describes a Web page to be accessed with an HTTP (Web browser) application that is located on a computer named www.pcc.philips.com. The specific file is in the directory named /cordless and is the default page in that directory.
227
228