Release Note
OmniVista 8770 Release 3.1
TC2246 ed. 01
INSTALLATION PROCEDURE FOR VERSION 3.1.08.00 – RELEASE 3.1
This is the installation procedure for Omnivista 8770 version 3.1.08.00 with patches A-G_V1.
It is available on Alcatel-Lucent Business Portal (https://businessportal2.alcatel-lucent.com) and on DVD-ROM with the reference 3BH 11669 AJAA.
Revision History Edition 01: November 24, 2016
creation of the document
Legal notice: The information presented is subject to change without notice. ALE International assumes no responsibility for inaccuracies contained herein. Copyright © ALE International 2016
Table of contents 1 GENERAL .............................................................................................................................................................. 4 2 CONTENT OF THE SOFTWARE PACKAGE ................................................................................................................. 5 2.1 References ..................................................................................................................................................... 5 2.2 Patches .......................................................................................................................................................... 5 2.2.1 Mandatory patches delivered with the DVD-ROM version .............................................................................. 5 2.2.2 Other optional patches .............................................................................................................................. 5 2.2.3 Anomaly Reports fixed in the patches ......................................................................................................... 5 2.3 License file ..................................................................................................................................................... 7 2.4 Versions of embedded software ........................................................................................................................ 8 3 PREREQUISITES .................................................................................................................................................... 9 3.1 Server PC prerequisites .................................................................................................................................... 9 3.1.1 Hardware and software ............................................................................................................................. 9 3.1.2 Software and hardware compatibility .........................................................................................................10 3.1.3 Configuring the Server PC .........................................................................................................................10 3.2 PCX compatibilities .........................................................................................................................................11 3.2.1 IP & IP/X25 connections to OmniPCX Enterprise .........................................................................................11 3.2.2 OpenTouch .............................................................................................................................................11 3.2.3 OmniPCX Office .......................................................................................................................................11 3.2.4 OmniPCX Enterprise and OpenTouch : software locks ..................................................................................12 There is locks for OXO. .........................................................................................................................................12 3.3 Prerequisites for administration Client PCs ........................................................................................................12 3.4 Prerequisites for Client PCs for directory consultation via WEB ............................................................................13 4 INSTALLATION AND UPGRADE ..............................................................................................................................13 4.1 Installation ....................................................................................................................................................14 4.2 Server Upgrade ..............................................................................................................................................15 4.3 Client upgrade ...............................................................................................................................................15 5 SERVER UNINSTALLATION ....................................................................................................................................16 6 MIGRATION FROM OmniVista 4760 ........................................................................................................................16 6.1 Description ....................................................................................................................................................16 7 SPECIFIC MANAGMENT .........................................................................................................................................17 7.1 SNMP Proxy feature ........................................................................................................................................17 7.2 Users management and OXE profiles ................................................................................................................17 7.3 Server IP address or server name modification .................................................................................................17 7.4 MSAD synchronization and CMISE security ........................................................................................................17 7.5 Backup on network drive.................................................................................................................................18 7.6 Disable Java update .......................................................................................................................................18 If the Java update parameters are not displayed in the Java control panel, you have to do the following: ................19 7.7 Internet Explorer configuration ........................................................................................................................19 8 NEW FEATURES IN 3.1 .........................................................................................................................................20 8.1 Accounting calculation evolution for the French market ......................................................................................20 8.2 Mass provisioning import/export improvements .................................................................................................20
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 2/35
8.3 Support of OpenTouch 2.2.1 (OT 12) / OXE 11.2.x / OXO 11 .............................................................................23 8.4 Multi-valued Primary link in the Directory to be consistent with 4760 ..................................................................24 8.5 Modification of all mapping attributes in Active Directory synchronization ............................................................24 8.6 Secure communication with 8770 server for MSAD plug-in .................................................................................25 8.7 Management of Active Directory users with the same name/surname for 8770 directory synchronization ...............25 8.8 Active Directory synchronization enhancement: synchronize the AD organization levels ........................................25 8.9 ONLY_RTU_CA_02 New RTU KPIS 2 ................................................................................................................26 8.10 Other KPIs ...................................................................................................................................................26 8.11 Upgrades .....................................................................................................................................................27 8.11.1 3.1 component updates ..........................................................................................................................27 8.11.2 From OV 8770 2.6/ 3.0 ...........................................................................................................................28 8.12 New license = 9 (from 3.1.08.00) ..................................................................................................................28 9 MISC INFORMATION & RESTRICTIONS ..................................................................................................................28 9.1 RTUM ............................................................................................................................................................28 9.2 OT Configuration ............................................................................................................................................28 9.3 OT Synchronization ........................................................................................................................................29 9.4 Performance Application .................................................................................................................................29 9.5 Re-hosting .....................................................................................................................................................29 9.6 Audit .............................................................................................................................................................29 9.7 OT Alarms .....................................................................................................................................................29 9.8 PKI ...............................................................................................................................................................30 9.9 OXO Configuration/ Accounting .......................................................................................................................30 9.10 MSAD - Active Directory Synchronization & Light Client for User Provisioning .....................................................30 9.11 SNMP Proxy .................................................................................................................................................30 9.12 Citrix Presentation server ..............................................................................................................................31 9.13 8770 UTF8 Characters in Web Directory .........................................................................................................31 9.14 SHA2 conformity ..........................................................................................................................................31 9.15 Limitation for displayed entries following a search by device type on OpenTouch ...............................................31 9.16 8082 MyIc Phone on OmniPCX Enterprise and Https requests ...........................................................................32 9.17 VOIP quality supervision................................................................................................................................32 9.18 Client launching failure due to memory lack ....................................................................................................32 9.19 Topology .....................................................................................................................................................33 9.20 USERS .........................................................................................................................................................33 9.21 OmniTouch 8400 ICS users management .......................................................................................................33 9.22 OpenTouch alarms display.............................................................................................................................33 9.23 Upgrade ......................................................................................................................................................34
10 KNOWN PROBLEMS IN 3.1.08.00 patches A-G_V1 ................................................................................. 34
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 3/35
1 GENERAL
Note
The final letter usually indicated in the version naming is not significant & can create confusion with the delivered patches. This document describes the installation procedure for OmniVista 8770 version 3.1.08.00 It refers to the Installation manual and Administrator manual. These documents are essential since this procedure does not provide full installation details. It is also highly recommended to consult Alcatel-Lucent Business Portal (https://businessportal2.alcatellucent.com). Some new information regarding OmniVista 8770 current version could be available. Our Technical Knowledge Center will help you to establish your technical diagnostics:
https://businessportal.alcatel-lucent.com/alugesdp/faces/gesdp/integration/KCSKnowledge.jspx
The following Technical Communications related to OmniVista 4760 could as well help for the OmniVista 8770 maintenance. However we do not guaranty that those documents are fully compatible with the OmniVista 8770 product. TG0029 Trouble shooting Guide TG0033 OmniPCX Enterprise Interworking TCV020 Emails sending by OmniVista 4760 TCV039 OmniVista 4760 licenses TCV060 Directory management TCV061 OmniPCX 4400/Enterprise to OmniVista 4760 alarm filtering TC0846 Accounting: Element investigations TC0858 Traffic observation: Element investigations TC1520 ed2 OpenTouch 1.2 Operation user creation TC1521 ed3 OpenTouch 1.2 Operation user mass provisioning
Warning
Each time you are requested to erase or edit a file, it is absolutely necessary to make a copy of the original. These operations must be performed by an expert (ACSE) trained on the product. You can also contact the "Professional Services" team (mailto:
[email protected] or your local Services representative).
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 4/35
2 CONTENT OF THE SOFTWARE PACKAGE 2.1 References -
OmniVista 8770 software DVD: 3BH 11669 AJAA
The documentation is available on the Alcatel-Lucent Business Portal, in the section Technical Support\ Technical Documentation Library : https://businessportal2.alcatel-lucent.com/technical_documentation_library
Security Guide
: 8AL90705USAF Ed.1.0
SNMP Proxy
: 8AL90708USAD Ed.1.0
Installation Manual
: 8AL90704USAH Ed.1.0
Administrator Manual
: 8AL90703USAH Ed.1.0
Accounting and VoIP ticket collector
: 8AL90709USAC Ed.1.0
Users management API
: 8AL90710USAC Ed.1.0
OpenTouch™ Suite RTU Metering Feature
: 8AL90712USAD Ed.1.0
2.2 Patches 2.2.1 Mandatory patches delivered with the DVD-ROM version In the \Patches\Mandatory folder you will find the following patches: Patch A to Patch G_V1 Reminder: On server side, all patches located in the Patches\Mandatory folder are automatically installed at the end of the installation.
Note
The manual patches files opening is failing when using the embedded Windows tool. It’s happening correctly when using an external tool like 7-Zip.
2.2.2 Other optional patches None
2.2.3 Anomaly Reports fixed in the patches The list below is included in the “readme” file “PATCHES\Mandatory” in the R3.1.08.00 delivery : Patches delivered with this build on 27Oct2016: ================================
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 5/35
[1] =========================================================== Release Name : Patch_310800A_SQL_JAR.zip Delivery date : 27 Oct 2016 =========================================================== crqms00206606 internTestManual Duplicate AdminNmc folder in reports crqms00206629 internTestManual OT Configuration: creation of user is not happening. [2] =========================================================== Release Name : Patch_310800B_LDIF.zip Delivery date : 27 Oct 2016 =========================================================== crqms00206717 internTestManual 8770 Users: Unwanted display of OTCt attributes during user creation [3] =========================================================== Release Name : Patch_310800C_EXE_JAR.zip Delivery date : 02 Nov 2016 =========================================================== crqms00206703 customerSite:CILOVA In reporting querytool, the "service tarif" name is not listed in carrier, and cannot be added in the customized report crqms00207067 customerSite:CILOVA 8770 R3.1/Accounting costs for specific French called numbers is not correct [4] =========================================================== Release Name : Patch_310800D_JAR.zip Delivery date : 02 Nov 2016 =========================================================== crqms00207313 internTestManual:in_house OT Configuration : export/import OXE SIP Subscribers gives random values for Video codec crqms00207395 valFuncManual:in_house OT Configuration: User import with minimum set of attributes is not ok [5] =========================================================== Release Name : Patch_310800E_EXE_JAR.zip Delivery date : 09 Nov 2016 =========================================================== crqms00207274 in_house: valNonRegression DM--Export operation getting failed for all devices(vhe and vle) from unallocated level crqms00203110 in_house: alpha 8770 Report :Report generation fails with "report error"
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 6/35
[6] =========================================================== Release Name : Patch_310800F_JAR.zip Delivery date : 09 Nov 2016 =========================================================== crqms00206894 betaSystem: ORANGE SA In report query tool, some service costs are still in english [7] =========================================================== Release Name : Patch_310800G_JAR_V1.zip Delivery date : 10 Nov 2016 =========================================================== crqms00208742 in_house: valFuncManual 8770 GUI completely freezes if tree search is initiated on OXE configuration filter
2.3 License file To install OmniVista 8770 and to access the various clients, you must have a specific license file for your PCX network and which describes the available modules. In ACTIS, choose one PCX in the network and specify in its configuration that it is the declaration node for OmniVista 8770 server. release OV8770 License version
NOTE
R1.0 1
R1.1 2
R1.2 3
R1.3 4
R2.0 5
R2.5 6
R2.6 7
R2.6.7 7
R3.0 R3.1 8 9
This 3.1.08.00 version does accept a fresh server installation using a version 8 license (OT2.2.1 & OV 8770 3.1 being maintenance/minor versions). However upgrade to version 9 will be necessary (to be requested through eBuy).
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 7/35
2.4 Versions of embedded software Component Apache Tomcat Apache Apache Axis 2 Apache Ant Jboss EJBCA
Version 7.0.70 2.4.20 1.5.1 1.8.0 6.1.0 Disabled.
Installshield Premier Oracle Directory Server Enterprise PHP JRE(Oracle) MariaDB MySQL ODBC driver Python 7 zip (7za – Command Line) Wodsftp.dll
2015 11.1.1.7.3 5.6.22 1.8.0_102 5.5.49 2.0.10 2.7.3 9.20 3.8.2
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
Comment
Disabled due to JRE/JBOSS incompatibility.
TC2246 ed. 01 page 8/35
3 PREREQUISITES This section describes the prerequisites required to install OmniVista 8770 server and client applications.
3.1 Server PC prerequisites 3.1.1 Hardware and software < 5000 users
> 5000 users
Windows7 SP1 Professional (64 bits) Windows 2008 Server R2 Std Ed. SP1 Windows 8 Professional (64bits) Windows 8.1 Professional (64bits) Operating System Windows 2012 Server Std Edition Windows 2012 Server R2 Std Edition Windows 10 Professional and Enterprise(64bits) Windows Server 2012 R2 DataCenter edition Processor
Windows 2008 Server R2Std SP1 Windows 2012 Server Std Edition Windows 2012 Server R2 Std Edition Windows Server 2012 R2 DataCenter edition
1 processor Dual-Core (frequency near 2 GHz, but 1 processor Quad-Core (frequency dependent on the processor architecture) near 2,5 GHz, but dependent on the processor architecture)
RAM (minimum) Minimal characteristics of Hard Disk Graphics board Network card Partition Internet browser
Drives
OmniVista 8770 - Release 3.1
6 GB
8GB
120 GB
120 GB (disk: RAID5) 128 MB Ethernet 10/100Base-T
1 NTFS partition for installation of the LDAP server Internet Explorer (version 9/10/11) Mozilla FireFox (up to version 49) Microsoft Edge and Google Chrome up to 54.x for the web directory A DVD drive is required
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 9/35
Warning
Windows 2008 server is not recommended and not supported any more by Microsoft. Due to the new apache version 2.4.20 and VC++2015 redistributable, the following hotfixes and service packs are mandatory. Operating System Windows 7 – Windows 2008R2 Windows 8.1 – windows 2012R2
Service Pack or Hotfix SP1 KB2919442 – KB2919355
All OS except Windows 10
KB2999226
Installation Installation order must be as follow : Windows8.1-KB2919442-x64.msu Windows8.1-KB2919355-x64.msu
3.1.2 Software and hardware compatibility The installation on a dedicated Server PC in accordance with the prerequisite allows a correct operation of the software. If the number of users is lower than 250 and if the Server PC must support other applications, you should analyze the compatibility, estimate the performance requirements of other applications and strictly follow the installation/un-installation procedure. Moreover, the operation of these other external applications is not supported. The Security Guide provides a description of parameters to take into account to study compatibility between an external application and OmniVista 8770 server.
3.1.3 Configuring the Server PC The space disk requirements and the rules of disks partitioning are described in the Installation manual. Here are the essential points: Hard disk. A NTFS partition must be set for installing the DSEE Oracle LDAP Server. When installing the server, it is better to keep the defaults directories and to change only the physical drives. The Path environment variable giving the access path to Windows and to its dll, which will receive the access path to OmniVista 8770 binary must be valid. The Path is managed through the System icon of Windows Control Panel. If the Path is too long, a blocking can occur during installation. The Path must not have obsolete path, ;; doubles or \\ doubles. If there is an error message regarding the Path on installation, change its value and keep only the access path to the operating system. C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System 32 \WindowsPowerShell\v1.0\ The name of the computer must NOT include the following characters: «/ \ [ ] " : ; | < > + = , ? * _ ».
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 10/35
3.2 PCX compatibilities 3.2.1 IP & IP/X25 connections to OmniPCX Enterprise From OXE R6.0 till R11.x and all associated OminVista 8770 releases the IP connection or IP/25 connection is ok
Warning
PPP connection is no not supported.
3.2.2 OpenTouch OV8770 Releases >=R1.0
OT Releases R1.0.1
Software version equal to or higher than … 1.0.100.040
>=R.1.1 >=R1.1 >=R1.2 >=R1.3
R1.0.1 R1.1 R1.2 R1.3
1.0.100.060 1.1.000.080 1.2.000.051 1.3.000.061
>=R2.0 and R2.5
R2.0
2.0.000.90/2.0.100.32/2.0.200.4x
>=R2.6
R2.1
2.1.000.092
R2.6.7 R3.0 R3.1
R2.1.1 R2.2 & R2.2.1 R2.2.1
2.1.100.042 2.2.017.004 2.2.110.001
3.2.3 OmniPCX Office OV8770 Releases
>=R1.2 >=R1.2 >=R1.2 >=R1.2 >=R1.2 >=R1.3 >=R2.0 >=R2.5 >=R2.6 R2.6.7 R3.0
OmniPCX Office RCE Releases 5.1 6.1 7.1 8.2 9.0 9.1 9.2 10.0 10.1 10.2 10.3
Software version equal to or higher than …
510/070.001 or 510/071.001 (wrong call duration fix) 510/053.001 or 610/054.001 (wrong call duration fix) 710/100.001 or 710/101.001 (wrong call duration fix) 820/090.001 or 820/091.001 (wrong call duration fix) Not supported – upgrade to 9.2 Not supported – upgrade to 9.2 920/089.001 Not supported – upgrade to 10.3 Not supported – upgrade to 10.3 Not supported – upgrade 10.3 103/009.002 – recommended: last maintenance version 103/024.001
OXO Connect Releases
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 11/35
OV8770 Releases
OmniPCX Office RCE Releases
R3.1
2.0
Software version equal to or higher than …
02.0/016.003
3.2.4 OmniPCX Enterprise and OpenTouch : software locks The modules of the OmniVista application are validated by the server license file. On the other hand the access to data of the various PCXs requires having appropriate software locks in each PCX:
OmniVista 8770 modules Configuration Accounting
Directory (STAP calls) Traffic observation VoIP Alarms
Software locks in OmniPCX Enterprise 50 – Configuration 42 - Accounting users 98 – Accounting for local calls (for local accounting use) 99 – Accounting for ABC calls(for network accounting use) 49 – Directory 42 - Accounting users 39 – Performance 42 - Accounting users 47 – Alarms
Secured SSH connection to OmniPCX No specific lock for OmniPCX Enterprise. Security license for Enterprise OmniVista 8770
OmniVista 8770 modules Configuration Alarms Performance
OpenTouch locks OAMP_CONFIG OAMP_ALARMS OAMP_VOIPPERF OAMP_PERFKPI and mlsnmp
Description Configuration GUI Alarms sending VOIP tickets sending (not used anymore since removal of Vital) SNMP data sending
There is locks for OXO.
3.3 Prerequisites for administration Client PCs Hardware and Software (Minimum required) Operating System
OmniVista 8770 - Release 3.1
Windows®7 SP1 Professional (32 or 64 bits) Windows® 8 Professional (32 or 64bits) Windows® 8.1 Professional (32 or 64bits) Windows® 10 Professional and Enterprise (64bits)
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 12/35
Processor
Intel® Core 2 GHz This processor type is given as example. The frequency clock is a minimum requirement.
RAM
4 GB
Hard drive
40 GB
Graphics board
4 MB video memory with a resolution of 1024 x 768, 16 million colors
Monitor
17 inches (19 inches recommended)
Internet browser
Internet Explorer® (version 9/10/11) Mozilla FireFox® (version 49.0.1) Microsoft Edge® (not compatible with the Web administration client) Google Chrome® 54 (not compatible with the Web administration client)
Free disk space
OmniVista 8770 client cannot be launched if the free space in the memory size is below 750MB. Minimum required memory space is to be 750MB to run the JVM application. Refer: crqms00191548
The use of Clients installed on a Citrix Presentation server XenApp 7.6 is validated. The number of clients is limited to 4. A minimum of 8 Gb dedicated RAM is required. The use of Clients installed on a Citrix server is not possible when we manage OmniPCX Office nodes. The OMC tool is not compatible with Citrix.
3.4 Prerequisites for Client PCs for directory consultation via WEB Hardware and Software (Minimum required) Operating System Internet browser (tested)
All Windows versions Internet Explorer® (version 11.0) Mozilla FireFox® (version 49.0.1) Google Chrome® 54.0.2840.59 Microsoft Edge®
4 INSTALLATION AND UPGRADE
Consult the Installation Manual (Business Portal) for the detailed operations for installation and upgrades.
Warning
Make sure that no client in local has opened a session otherwise there is a risk of database corruption !
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 13/35
4.1 Installation
Warning
During the installation, OmniVista 8770 checks the KB2919442 and KB2919355 are well installed. Otherwise a popup will indicate the hotfix requirements are not installed.
Do not continue : press “Ok” and “No” in the subsequent popup. Then install those kb listed in 3.1.1 chapter hardware and software.
Note
“crqms….” are internal anomaly reports references. Check with Tech. Support on which version/patch it is fixed or if correction is important for you.
Starting from Windows 7, when using an account different from “Administrator”, to start the server
installation or an Upgrade, right click on the ServerSetup.exe file and select the option Run as administrator. Otherwise the installation would fail.
8770 server Installation should start with the User Account Control (UAC) setting level “Do not notify “in Windows 7 professional machine. DAP manager support is not released on Windows 10 OS From 8770 R3.0.12.00a New password policy has been introduced and the policy is applicable for all the password changes which happens during the first login/ password resets. This password policy is not implemented during installation under 8770 InstallShield. Refer crqms00190423 The firewall may generate messages asking for allowing communication for Java.exe and bin_nsslapd.exe programs. You have to validate these requests. It’s mandatory to manage a fix IP address (and not a DHCP one) and also the default gateway before starting the server installation. The server name cannot contain the following characters: «/\[]":;|+=,?* _ ». In the opposite case, the server installation would fail.
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 14/35
If a previous Java version is already installed on a machine, it will be updated to the latest Java version during OV8770 server or client installation. As a consequence, to have OmniVista 8770 and OmniVista 4760 clients in the same machine then the clients have to be installed in the following order:
OmniVista 8770 client
OmniVista 4760 client
It is not allowed to modify the default HTTP (80) and HTTPS ports (8443) for compatibilities reasons with the Performance application. The port 443 has as well to be available for Apache.
During server installation, directory path should not contain any spaces. Incase other than default path is used for installation make sure new directory path doesn’t contain any spaces. Refer: crqms00149127
4.2 Server Upgrade Warning
The server upgrade from 2.0 releases to R3.1.08.00 brings a modification for the VOIP quality supervision
application. The Performance application based on a Vital Suite module has been removed. It has been replaced by a more simple and integrated module. Reports and data from the previous application will no more be available after the upgrade to R3.1. The data have to be processed before the upgrade.
The server can be upgraded to 3.1.08.00 from the following versions: 2.0.09.03.a 2.5.04.00.a 2.6.05.01.f 2.6.07.01.a 2.6.07.05.a 2.6.07.06.b 2.6.07.07.c 2.6.07.08.a 3.0.13.00.c Starting from Windows 7, when using an account different from “Administrator”, to start the server installation or an Upgrade, right click on the ServerSetup.exe file and select the option Run as administrator. Otherwise the installation would fail.
4.3 Client upgrade When a client connects to a server which has been upgraded, a proposal for the client update is suggested. - Accept the update - Once the installation file has been retrieved, the client relaunch is required
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 15/35
-
To relaunch the client, right click on the client launching icon and select the « run as administrator » option Then accept the next proposals.
5 SERVER UNINSTALLATION To automatically uninstall all the server components launch the command:
Start\Programs\OmniVista8770\Tools\Uninstall OmniVista 8770 Server The installation folder is not always deleted during the automatic server un-installation. In this case it has to be deleted before starting a new installation. In case of server un-installation failure it could be necessary to remove some registry keys. This can be done using the script 8770Cleanup.vbs from the DVD folder Tools\8770Cleanup.
6 MIGRATION FROM OmniVista 4760 6.1 Description
The goal of the OmniVista 4760 to OmniVista 8770 migration is to export the following data from an OmniVista 4760 R5.2 server to import them in a new OmniVista 8770 server. If an upgrade to OmniVista 4760 R5.2 from previous releases is required, a temporary license can be asked by an eSR. The following data is retrieved:
PCX tree and related management
Company Directory
Accounting carriers data
Personalized reports definitions
Accounting organization by levels
To retrieve the accounting tickets from an OmniVista 4760 server you need to archive them, and then restore them in the OmniVista 8770 server. (For the Restore operation the option “Label for records (tickets)” has to be equal to “Loaded records”) For the complete migration procedure, refer to the Installation Manual.
Warning
The Migration tool does not allow retrieving the directory replication management from OmniVista 4760. It has to be managed completely in OmniVista 8770 servers. In addition, during migration, the replicated sub-suffixes from OmniVista 4760 are created as normal entries in the OmniVista 8770 company directory. That’s why when the sub-suffix is created to reproduce the replication with the same name the system throws “The entry already exists”. The workaround for the issue is After migration : 1. Export the entries under the sub-suffix entry in the company directory (For eg., if it is a department sub-suffix, then export the department and its children). 2. Then delete the replicated entries (For eg., department sub-suffix and its children in this case) from
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 16/35
the company directory. 3. Now create the sub-suffix with the same name using the replication procedure. This will create the corresponding entry in the company directory. Then import the entries which were exported during step 1
7 SPECIFIC MANAGMENT 7.1 SNMP Proxy feature
If SNMP service is not started in the machine during OmniVista 8770 server installation, SNMP proxy registry entries are not created and hence SNMP proxy will not be installed. Then Windows SNMP service need to be started and script called inmcsnmpproxy.vbs (in the path: \8770\bin\) has to be run to create SNMP proxy entries in the registry.
7.2 Users management and OXE profiles You need to validate the following parameter on OmniPCX Enterprise : System\Other System Param\System parameters\Use profile with auto. Recognition=yes. Otherwise no data will be inherited from the profile at a user creation. The document TC1520-ed.02 describes the User’s management.
7.3 Server IP address or server name modification In order to change an OmniVista 8770 server name, you need to perform the following operations:
Backup the server data
Confirm the Directory Manager account password (launch the tool 8770\bin\ToolsOmnivista.exe)
Uninstall the server
Change the server name
Install the server taking the same installation paths than on the previous server as well as the same company directory root name. The password entered at the installation time (Directory Manager and other accounts) has also to be the same as the previous one.
Restore the saved data using the 8770 Maintenance application. Select the “Restore with rehosting” operation.
A Restore with rehosting operation has also to be launched when the server IP address has been changed. Note
The MSAD plug-in must be regenerated and installed again on the Active Directory server after rehosting.
7.4 MSAD synchronization and CMISE security In the case where a secured access for configuration is managed for an OXE PCX, the user” MSAD8770Admin” has to be added to the authorized users list at PCX side. This is mandatory to allow users creation from the Web client that can be launched from the MSAD server.
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 17/35
Warning
The password of the account MSAD8770Admin must not be changed in the Security application
7.5 Backup on network drive Network drives can’t be seen from Maintenance application. A network backup location must be identified by its own UNC (\\server_name\shared_drive).
The Security guide describes the preliminary operations management for the backups on network drives.
7.6 Disable Java update The installed java version must not be updated. The automatic update function must be disabled.
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 18/35
Note 7.6.1 If
the Java update parameters are not displayed in the Java control panel, you have to do the following:
Click Start. In the Start Search box, type command.
1. The result list will appear. Right-click Command Prompt in the Programs list. 2. Click Run as administrator 3. To open the Java Control Panel, in the Command Prompt window execute this program: " C:\Program Files (x86)\Java\jre1.8.0_102\bin\javacpl.exe" 4. In the Java Control Panel, click on the Update tab. 5. Uncheck the automatic updates. 6. Click Apply and then OK to save settings If the Update tab is still not displayed the solution is to change from 0 to 1 the value of the following registry key: [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\JavaSoft\Java Update\Policy]
7.7 Internet Explorer configuration -
When Internet Explorer 11 is the default web browser, the option "Use Microsoft compatibility lists" has to be enable and the server name or it’s IP address had to be added in the proposed list.
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 19/35
-
For users creation from the MSAD Web client, the OmniVista 8770 server name has to be inserted in the Trusted sites list.
8 NEW FEATURES IN 3.1 8.1 Accounting calculation evolution for the French market
For the French market, from the 1st October 2015, there are new tariffs for "colored numbers" (called in French “numéro vert, indigo, ...”). These tariffs are called "SVA" for “Services à Valeur Ajoutée” in French. They apply for specific numbers beginning by specific digits, like 08 XXXXXX. They are more expensive than normal numbers, whatever the Service Providers. OmniVista 8770 accounting allows to add a fee on a communication depending on the dialed number, but what is new for the SVA is that there is an additional cost depending on the duration, in addition to the Service Provider cost. So, there are two different duration costs calculations on the same call, that OmniVista 8770 will be able to calculate today. There are about 17 different tariffs /duration for the SVA, and hundreds of specific numbers 08 XXXXXX. These tariffs are the same for France, whatever the service provider.
8.2 Mass provisioning import/export improvements
mass provisioning improvements to do in OpenTouch configuration application to have the import/export features at the same level as Import/Export features from OXE Configuration - mimimum set of attributes - no reference to internal OpenTouch id Export a template from OpenTouch configuration application :
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 20/35
to easily create offline an import file for mass provisioning The enhancement here consists in generating a header without unnecessary information and in the most appropriate way for import file. However for clarity reasons the header can’t give all the information present in the datamodel (type, min, max, attributes dependencies, …). Keep in mind it is a text file that can’t replace the knowledge of the model and the meaning of all the attributes. Export Data from OpenTouch configuration application : to export data from OpenTouch configuration with the same header as with export template option so that it’s easy to duplicate data from the exported lines in a new import file created offline. The export data option, already available in OmniVista 8770< R3.1, is enhanced to get exported data under the same header as with “Export template” option. The administrator selects a datamodel or directly some instances and asks for an “Export data” operation. The result is a file (.txt, .csv or .prg) with exported data. Create/Modify/Delete instances by importing a file with a few attributes only from OpenTouch configuration application : to be able to easily build offline a mass pro file with few attributes only so that I can import it to quickly create, modify or delete some instances in OpenTouch configuration. In OmniVista 8770< R3.1, importing a file in OpenTouch configuration in order to create or modify instances always requires the full list of attributes, i.e. the complete header which can be retrieved by “export template” option. This constraint makes always to be totally dependent from the OpenTouch release, so it makes it difficult even impossible to reuse import files built for a former OpenTouch release, probably because one attribute at least is modified or added. The proposed enhancement aims to make it possible, as much as possible, to reuse existing import files (for creation or modification) whatever the OpenTouch release, because the risk to have a difference on a part of header is less than the risk on the full header. Import can be requested from a local file with immediate operation or from a server file and scheduled A log file is created for every scheduled import (same name with date indication). For immediate import, the status is given in the message area. Both cases are names log hereafter. Note that due to the header changed the import files used in previous OmniVista 8770 releases have to be updated. Complete and import a file from OpenTouch configuration in order to apply several modifications to OpenTouch node : to import a file with all possible action types mixed with several models from OpenTouch configuration so that I can apply a lot of modifications (creation, update, deletion) to an OpenTouch node from a single import file. The administrator completes an import file offline by mixing : All action types: create (with ‘+’ symbol) , modify (with ‘#’), delete (with ‘-‘) Several models The same model can appear several times in the file but each time with a different header. For instance, the same model appears once with a header for creation, another one for modification and a last one for deletion. During import, the actions are processed along with the order of the file, meaning that if the same datamodel appears several times in the file, eventually with different headers, the import starts with the first occurrence of this datamodel (and processes the actions from the below lines), then with the second, etc.
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 21/35
The datamodels are analyzed and executed in the file order : there is no lines reordering. This means that the possible dependencies must be solved with the file creation. Export a template from Users application : to export a user template in a file so that I can easily use it to populate it in off line mode for mass provisioning purposes. The file includes in the header all the possible attributes, whatever the type of the user (OmniVista 8770 or OXE or OT) plus an action in 1st column. Among all the attributes : action : Create, Modify, Delete userType : None, OXE, OT directoryLevel : the hierarchical directory level where the user is attached lastName : user’s name firstname : user’s firstname uid : login, built as “ ” by default Note that the user dn is no more present in the file as redundant with other attributes (uid, directoryLevel). Please note that this simplification makes the 3.1 file incompatible with the previous releases files. Note also that this format can induce some more for analysis and execution time (directory level to identify, uid and dn construction). Modify a user by importing a file with the minimum of attributes from Users application : to prepare offline a file, as simple as possible, and import it to modify user(s) from Users application so that I don’t waste time to export the user(s) to be modified first. In OmniVista 8770 < R3.1, if you want to modify the users by importing a file from Users application, you need to export them first, then edit the file and import it. The enhancement proposed by this US consists in allowing the administrator to prepare a file offline and import it to modify users with minimal attributes. In OmniVista 8770 < R3.1, if the administrator imports a file in order to modify users (action is set to “Modify”) and this file contains only the uid attribute (to identify the user(s) to be modified) and just one attribute, i.e. the attribute to modify (example : lastname), OmniVista 8770 considers as NULL all the missing attributes as it is for user creation. Generally, the file import fails because NULL is not accepted as a new value for a lot of parameters. The enhancement consists in managing properly the import of this kind of file : action = Modify uid is set (in order to identify the user to modify, thanks to uid uniqueness) only the attributes to change (meaning : not necessary to put the full header) NULL values are not considered during the update operation Empty value is considered as a clear value (removing the current value) Not all the attributes are editable : directoryLevel, OXE or OpenTouch instance, … This US makes the Users application be at the same level of service for modification by import as OXE configuration and OpenTouch configuration (refer to Erreur ! Source du renvoi introuvable.). However note that as the user dn is no longer part of the import file, the execution time for such a file is increased with a preliminary search to get the dn of the user to update. Export a user for template from Users application : to export a user from Users application so that I can use the exported user as a user template and easily duplicate it to create other users.
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 22/35
In OmniVista 8770 < R3.1, “user export” option exists and allows to export a user from Users application. This option is useful to modify the parameters of the exported user(s) in the export file and to modify it (them) by importing the file. But, this option doesn’t suit to another use case which is the user duplication. That’s why a second “export user” like option is proposed in the same contextual menu, in addition to “user export” option which is kept without any modification. This new option, called “user export for template”, is a little bit different. The result file is included 2 lines A header line limited to the columns relevant for the exported user, depending on his type (none, OXE or OT) and editable based on the presence or not of a meta profile A values line where : action is set to “add” Personal and mandatory values (name, firstname, uid, password, salutation (OTCV/CT), email(OTCV/CT)) are set to “XXXX” Personal attributes that can be overwritten from metaprofile are left blank (directory number, login (OTCV/CT) TUI and GUI passwords (OTCT/CV)), device number (OTCT) Other editable attributes are copied from the exported user : metaprofile, devicetype (OXE), key role (OXE), cost center Non editable attributes are not part of the file (header and value) When the exported user doesn’t own a metaprofile, the metaprofile column is removed and replaced the metaprofile attributes (node instances, user profiles) and the values copied from the exported user This export option is active only on a mono selection from the tree : one user at a time. When “user export for template” is complete, the administrator edits the export file (with text editor tools such as notepad or with spreadsheet tools such as MS Excel), replaces “XXXX” by values corresponding to new users to be created, saves the file and imports it : the users are thus created from the exported user, here used as a template. Remember that the goal of this US is to minimize the number of values to set in the export file in order to create new users from an exported user (used as a template). Also note that this new “user export for template” option is different from “export template” which generates the header only.
8.3 Support of OpenTouch 2.2.1 (OT 12) / OXE 11.2.x / OXO 11
OXE 11.2 All patches compatible in 11.2 including 11.2, 11.2.1 & 11.2.2 OT 12 OXO Connect R2 (ex. R11) This requirement is to support the OXO R11 in the OmniVista 8770 R3.1, in addition to the previous releases. It is an extension of the general support of the OXO by the OmniVista 8770. From the point of view of the administrator, the support of the new release is transparent, except the installation of the new OMC, used to the Configuration and Maintenance activities (backup/restore and software download).
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 23/35
8.4 Multi-valued Primary link in the Directory to be consistent with 4760
In 4760 the primary link attribute between a Person entry in Company Directory and an OXE Subscriber entry in Technical Directory was a multi-valued attribute allowing a person to be associated with several OXE devices with full name/firstname update. In OmniVista 8770 due to OpenTouch support, and its user-centric notion (1 user – n devices), the primary link is getting mono-valued. The primary link is also used within the Users application to manage a person, the OXE/OT user and his associated devices in a unified way. This means that during the 4760 to OmniVista 8770 migration, only 1 primary link value is kept, the other being discarded. Even if secondary manual links are set up after migration, the name/first name updates are not propagated from person to OXE devices. The requirement addresses this point with the addition of a new attribute – additionalResources – set up during migration with the extra primary link values, available for manual set up from Directory application, that ensures the update of name/firstname in the same way as the primary link.
8.5 Modification of all mapping attributes in Active Directory synchronization
to allow a more flexible mapping between the AD attributes and the OmniVista 8770 attributes, regarding the mapping direction as well as the default mapping The solution takes advantage of the solution put in place for the Erreur ! Source du renvoi introuvable. with the adjunction of the objectGUID attribute as a unique reference in AD. The following recommendations have to be considered to avoid data inconsistency - In case of migration to OmniVista 8770 R3.1, a 1st synchronization is done in 8770 R3.1 before any modification / deletion in the synchronization rules. - After any modification of the attribute mapping, a complete synchronization and the generation of the AD Plugin has to be performed Define the attribute mapping for AD synchronization so that the AD attributes and 8770 are kept consistent. AD synchronization : perform an AD synchronization so that the entries and their attributes are kept consistent according to the mapping rule. AD synchronization algorithm is described in Erreur ! Source du renvoi introuvable.. Once the correlation is done between the AD entry and the 8770 entry is done, the update of the entries is done in step 9. Special operation for uid update when rename operation is used. Already created entries are not impacted when one of the attributes firstname, name or uid is removed from the attribute mapping, whereas these created entries are impacted during a complete synchronization when the mapping is modified. AD Client : to create a user in the OXE/OT from the AD Client with attributes automatically copied from the AD entry to the 8770. From the selected AD user entry, from the menu "Alcatel-Lucent Enterprise Unified Users Management" the AD Client is launched in the default browser. The attributes defined in the mapping rule in the AD 8770 direction are searched from the AD entry and used to populate the 8770 entry. If no attribute mapping is defined for firstname attribute (givenname), it is considered as empty and non-editable in the AD Client.
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 24/35
If no attribute mapping is defined for name attribute (cn), it is valued with lastname (sn) + firstname (when it is exists).
8.6 Secure communication with 8770 server for MSAD plug-in
This is to prevent the AD Client url to be copied/passed/updated so that it is no more possible to use the URL outside the MSAD application and perform creation/deletion/update operation in the 8770 server.
8.7 Management of Active Directory users with the same name/surname for 8770 directory synchronization Use case : a first AD user with name John Doe is already created in OmniVista 8770 Directory, associated or not by a Primary link with an OpenTouch user. A second AD user is created thru the AD plug-in with the same Name and surname, but with different attribute from AD point of view, for example email address. Today, this second user is not created in OmniVista 8770. This second user should be created in OmniVista 8770 Directory as a new Entry. If a Primary link already exists with an OXE user, then no link should be added with this OXE user, the existing link should not be broken.
8.8 Active Directory synchronization enhancement: synchronize the AD organization levels
Up to 8770 3.0, the AD hierarchical organization is copied into the 8770 Company Directory during the AD synchronization with tree mode, only in creation mode. This means that any subsequent change in the AD hierarchy (delete, rename or move) nor the move of the inner users to another AD hierarchical level is not reflected in the 8770 hierarchy during the AD synchronization. The change introduced in the AD synchronization in 8770 3.1 is the support of the objectGUID attribute to keep the link between an AD entry and the associated synchronized 8770 entry. This binary attribute is unique over an AD server and remained unchanged over the whole life of an AD entry whatever the changes. The AD levels synchronization is the 1st step of the AD synchronization in case of a Tree mode synchronization, followed by the users synchronization and the 8770 AD update. Based on an ldif export file with the AD organizational levels, the AD synchronization expectation is to maintain the same hierarchy in AD and in 8770 Company Directory, for the parts of the AD and 8770 trees defined in the synchronization rule, with the assumption the AD hierarchy is the master to be replicated. Any change in the AD hierarchy will not be seen in the 8770 Company Directory as long as a 1 st AD synchronization is not run from 8770 R3.1, that brings in 8770 the linking attribute objectGUID. It is recommended for the Administrator to perform an AD synchronization from 8770 3.1, before he performs a change in AD hierarchy he would like to be automatically forwarded to 8770. The evolution applies mainly for a synchronization in hierarchical mode. Update the Department name : To have the update of a department name in AD be automatically reported in 8770. Note : After department name update, AD Synchronization needs to be performed before using AD Client. Create an AD department :
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 25/35
an AD Department newly created be automatically created in 8770 at next synchronization Move an AD department to another place : to move an AD Department to another place, either in the same root point covered by the synchronization, so that move is forwarded in the 8770 either outside the root point covered by the synchronization, so that the department is deleted or marked as deleted with its inner users Delete an AD department : the department deleted in AD is automatically deleted in the 8770 Move a user to another AD department : the AD user move to a department is forwarded to the 8770 directory
8.9 ONLY_RTU_CA_02 New RTU KPIS 2
US_RTU_Meter OPENESS APIS (CSTA/TxAPI/Recording) - get the following counter on APIS : - CSTA Monitor - TAPI Monitor - TsAPI - CSTA Pilot monitoring These KPI are available from OXE m1 (12.0), from OXE > System > Other System Param. > RTU Parameters instances US_RTU_Meter RSI /RSI Business counters - to see in the 8770 RTU reports, the average, maximum and minimum value of Agent logged as RSI Agent. So that we’ll able to see what it has been really used during the commercial period. US_RTU_Meter RSI Business counter - the aim of the KPI is to count the RSI entry points where the application is not Call center. KAT061 RSI BUSINESS : evaluated from the number of OXE > Applications > CCD > RSI instances where Application Type attribute is valued as different from Call Center
8.10 Other KPIs
US_RTU_meter DESKSHARING - The KPI is a concatenation for all device types, based on the number of OXE User instances with " Set function" parameter as Desk Sharing user. KAT067 DESKSHARING USER Early delivered as a TR+1 patch against 3.0 Count real users and DSS devices, based on the OXE Subscriber "Set function" parameter : count only Default and Desk Sharing Set. US_RTU_meter_SIP KPIs - to get a KPI calculate the real SIP devices whatever the level of service (SIP device or SIP extension), excluding the SIP devices for OTCv users and the OXE SIP nomadic device A counter KAT068 OXE STD USER EXTERNAL SIP DEVICE calculates the OXE SIP devices, not used for an OTCv user, ie. excluding the devices where the " Gateway type" attribute is valued as ICE type.
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 26/35
A counter KAT069 OXE NOMADIC SIP DEVICE calculates the size of the pool of OXE SIP devices declared for the Nomadic feature. This counter is evaluated from OpenTouch as the number of OXE SIP subscriber instances (OT > System services > Topology > OXE CS > OXE SIP subscriber ) US_RTU_meter_HOTEL ROOM - to get a KPI calculate the Room numbers so that it is possible to a differentiated price / per room for room with multi-devices Already some KPIS are provided up to 8770 3.0 KAT051 NUMBER OF DEVICES IN HOTEL MODE (GUEST OR ROOM) KAT052 NBR OF DEVICES IN HOTEL MODE (ADMINISTRATIVE) KAT053 NBR OF DEVICE GUEST OR ROOM IN CHECKIN The new counters have to differentiate the rooms and the guests, for the devices counter and the checkin counter. However the availability of separate checkin counters depends on the OXE release In addition a total counter for “Suite” type is added. New Counters are : KAT070 NUMBER OF CONFIGURED SUITES KAT071 NUMBER OF DEVICES IN HOTEL MODE (GUEST) KAT072 NUMBER OF DEVICES GUESTS IN CHECKIN KAT051 is replaced by KAT151 NUMBER OF DEVICES IN HOTEL MODE (ROOM) KAT053 is replaced by KAT153 NUMBER OF ROOMS IN CHECKIN These KPI are delivered as TR+1 patch against 3.0 US_RTU_meter MULTI_COMPANY - to get a KPI calculate the number of companies within and OXE with "multi-company" mode activated and configured The "Multi-company" feature is activated by the flag OXE > System > Other System Param. > Spec. Customer Features Parameters > Centrex Version No. Then an OXE Entity (OXE > Entities) can be declared as a company as soon as it assigned a Company Call Number value, except the entity 0. KAT073 MULTI-COMPANY US_RTU_Meter_NBR OF OXE /OTMS NODES in consolidated report
8.11 Upgrades 8.11.1 3.1 component updates Migration Migration Migration Migration Migration Migration
to to to to to to
MariaDB 5.5.48 at least easel.js 0.8.2 jQuery 2.2.3 SFTPdll 3.8.2 (wodSFTPdll) Apache 2.4.20 at least JRE 1.8u92 at least or better with Oracle Critical patch Updates ???
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 27/35
8.11.2 From OV 8770 2.6/ 3.0 The initial version can come from a R2.6.x or a R3.0 : 2.6.05.01 (TR), 2.6.07.01 (MD1), 2.6.07.05 (MD2), 2.6.07.06 (MD3), 2.6.07.07 (MD4), 2.6.07.08 (MD5) and 3.0.13.00 (TR) The supported versions of the license file are 8 (upgrade) and 9 (upgrade and fresh installation)
8.12 New license = 9 (from 3.1.08.00) License is now “9”
9 MISC INFORMATION & RESTRICTIONS Note
All the “crqms…..” ref. mentioned below are internal anomaly reports references. Check with Tech. Support on which version/patch it is fixed or if correction is important for you. In this chapter you will find misc information about applications, components that could be useful plus some restrictions.
9.1 RTUM
The Date and time of OmniVista 8770 server and OpenTouch sever should be synced for KPIs update in RTUM reports afterOpenTouchPartial sync (Global/Separate). Refer: crms00475759
9.2 OT Configuration
OT node number entered during the OpenTouch declaration should be numeric value. Otherwise the topology synchronization with the Performance application will fail. Templates Tab is changed to Profiles in OpenTouch Configuration object tree. User creation, the TUI password should not be trivial for security reason. It should not be of cyclic, repetition, increasing or decreasing fashion. services -> Security -> Password Management -> Allow trivial TUI check this attribute to allow trivial values to be used for TUI password. Uncheck this attribute doesn’t permit using trivial value for TUI password. For OTVM- Automatic creation of persons in directory is applicable for only for OXE with OTVM users. The connect operation of OpenTouch from 8770 will not work with the root user and password. The maintenance credentials should be used for login. While configuring OpenTouch server if ERROR_REMOTE_EXCEPTION error occurs then check following : Add the FQDN of OpenTouch in the hosts file of windows where the 8770 server is installed Restart of JBOSS service
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 28/35
A new tab „feature‟ is available for OpenTouch nodes which have the version greater than OpenTouch R 2.1. Tree will be segregated according to Tasks. New mass provisioning rules are implemented in R 3.1 to make ease of export/import operations. Improvements include: Import/export with minimum set of attributes New enhanced template “Action” attribute in first column, “displayname attribute” in second column No reference to internal OpenTouch id. For detailed change refer to chapter 8.2 Restriction: java.exe(Administrator-jboss) service utilizes maximum memory (1Gb) duringOpenTouchconfiguration basic operations with entries more than 1k. Refer crqms00205094 Scheduled export failure scenarios happens sometimes. Refer crqms00205095
9.3 OT Synchronization
User name for template management should be filled in the connectivity tab to get the templates during synchronization. After declaration of OXE node, OXE Complete Global synchronization will not synchronize associated OpenTouch node. OpenTouch node should be synchronized first. TUI voice mail should be declared in both OXE and OpenTouch for successful complete global synchronization.
9.4 Performance Application
OXE and OXO VoIP performance is now taken care of by NMC loader and other legacy applications. OpenTouch VoIP tickets are not handled.
9.5 Re-hosting
Execute the re-hosting script in the “Elevated command prompt” in Windows 7, otherwise script execution will be failed. Refer the below link for info: http://www.blogsdna.com/2168/windows-7-how-to-open-elevated-command-prompt-withadministratorprivileges.htm
9.6 Audit
After enabling the Global flag for audit process the 8770 client needs to be restarted to get the information of 8770 login/logout
9.7 OT Alarms
OT Alarms will not be received if two OT's have same username but different parameters (like encryption password, passphrase, etc..).To receive the OpenTouch alarms from all the declared OpenTouch nodes, there are two possible configurations: 1st option: use the same SNMP v3 user name and same associated parameters (security level, user password, passphrase, …) for all the OpenTouch nodes
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 29/35
2nd option : use a different SNMP v3 user name for each OpenTouch node Dashed Line style between two network elements will be supported with IE version 11 and above. Purge Alarms failed in Weekly & Daily Job. Refer: crqms00207081
9.8 PKI
PKI application is greyed out (disabled) in 8770.
9.9 OXO Configuration/ Accounting OXO software update through 8770 Network Maintenance application has some issue for ONE 2.0 version. Refer crqms00207774
9.10 MSAD - Active Directory Synchronization & Light Client for User Provisioning MSAD: Export of MSAD data is restricted to branch level; Refer: crqms00202328 MSAD: Deleted user information getting display in another browser; Refer: crqms00203486 MSAD: Performance Issue creations and modification of user in AD taking long time then general; Refer: crqms00202955 MSAD Client: 8770 Administrator is not allowed change the default password assigned to the MSAD8770Admin account. Changing the password will make AD Client inoperable. Workaround: If MSADAdmin password is changed then restart the Jboss service in 8770 server. The « user name » field managed at the Access Info level should contain the full DN and not the simple user’s name. Example : Cn=admin,CN=Users,DC=Alcatel-Lucent,DC=com The attributes « manager » and « assistant » can only be synchronized from MSAD to OV8770 When using Internet Explorer 9, it’s mandatory to validate the “active scripting” to allow the web client refresh after a meta-profile selection : Tools\Internet Options\Security\Internet\Custom level \scripting\enable “active scripting” When using Internet Explorer 11, the OmniVista 8770 server has to inserted in the Trusted sites list for the Web browser. Otherwise no data will be displayed after selecting a meta-profile.
9.11 SNMP Proxy
8770 SNMP proxy will be installed as a part of 8770 installation if windows SNMP Service are present in that machine. If SNMP service is already installed in a machine before installing 8770, then during 8770 installation SNMP proxy will be installed by creating necessary registry entries. If SNMP service is not installed in the machine, then during 8770 installation SNMP proxy registry
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 30/35
entries are not created and hence SNMP proxy will not be installed. So, to use SNMP proxy feature then Windows SNMP service need to be installed and script called inmcsnmpproxy.vbs (in the path: \8770\bin\) has to be run to create SNMP proxy entries in the registry External tools like TrapReceiver and iReasoning MIB Browser should not be installed to receive the traps from the 8770 server side rather we could install them in the client side machines. These tools by default take the port number 162 and due to this 8770 will not receive OpenTouch Alarms. This may be due to the port conflict between these two.
9.12 Citrix Presentation server
To run multiple 8770 clients in Citrix presentation server the minimum requirement is 8GB RAM; if the available RAM is less 8770 GUI will not perform as expected.
9.13 8770 UTF8 Characters in Web Directory DM Overview and Scope: The requirement addresses the need for a full UTF8 support in all applications for User names and firstnames. The objective is to manipulate user names/firstnames in UTF8 characters in the whole 8770 management platform and all the connected elements (OXE/OT) as well as an external corporate directory, from all the 8770 applications, Users as well as Directory, ... WebDirectory included, in both ways, meaning from 8770 to other elements as well as from network elements to 8770. The requirement is driven by the capability of the UA/NOE device to display non ASCII characters and the OXE management restrictions where the OXE User attributes vary from Directory name and firstname to UTF8 name and firstname depending on the character set used for the name/firstname In 8770 and OT, priority is given to UTF8 names, meaning UTF8 names are used preferably, at least in all Directory-based applications.
9.14 SHA2 conformity
SHA2 certificate would be installed by default during fresh installation of 8770 For 8770 upgrades from R2.6 SHA1 certificate would only be available. If administrator wants to migrate to SHA2 he should use toolsOmnivista.exe
9.15 Limitation for displayed entries following a search by device type on OpenTouch In the Devices application, the maximum of displayed entries following a search by device type can be limited to 70. This evolution has been made mandatory to prevent from a memory overload following some OpenTouch data model modifications. Coming back to the previous limitation to 200 entries needs some developments that will be available in a next version.
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 31/35
9.16 8082 MyIc Phone on OmniPCX Enterprise and Https requests
Http requests from 8082 MyIc Phone to OmniVista 8770 server are not supported. Https requests are now mandatory. The OmniVista 8770 server is checking the device certificate at each file downloading request.
Warning
A particular care has to be taken before doing an upgrade to R3.1. Make sure the devices are doing https requests and not http
9.17 VOIP quality supervision
The Performance application based on a Vital module being removed from the product as of 2.5 release. The reports and data from this application will no more be available after an upgrade to R2.5 and next releases. So they have to be used before the upgrade. The VOIP quality supervision is now managed thanks to predefined reports definitions included in the Reports application. The reports are only available for OmniPCX Office and OmniPCX Enterprise (version superior or equal to 8.0)
9.18 Client launching failure due to memory lack
At client starting, the Java application is requiring by default one 1Gb contiguous memory range. This value is defined is the client launching file: Client8770 R2.0\bin\runnmc.bat (-mx1024m). The Windows7 operating system being reserving more memory than Windows XP for all applications, the probability to not get the sufficient memory size is more important. In this case, the following message is displayed:
The proposed workarounds are: - Insert the OV8770 client in the programs list to be automatically launched at Windows starting. Modify the minimum required size for Java at starting. (Client8770 2.0\bin\runnmc.bat, javaw.exe" Xmx1024m)
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 32/35
-
Warning
-
Warning: decreasing this value may result in reduced client performances (to be reserved for limited uses) Close other applications
-
Web client that can be launched from the MSAD server.
With this 3.1.08.00 version the error message is no more displayed when the problem is happening. A command window is just appearing during a very short time.
9.19 Topology
The Topology application has been re-designed in R2.0. The customized views from releases older than R2.0 will be lost after an upgrade from these releases to R2.O and next versions. User with Read only rights is able to modify Topology. Refer to : crqms00188231
9.20 USERS Users creations fail when the Entity 1 does not exist on the OmniPCX Enterprise. The reason is that the user creation by profile is failing in this case. The system tries first to create the user, using the default parameters (including missing entity 1) before applying the profile’s parameters.
9.21 OmniTouch 8400 ICS users management
Warning
An OXE user with ICS rights will be counted for 2 users at the license level. This is not managed by ACTIS.
9.22 OpenTouch alarms display OT Alarms will not be displayed if two OpenTouch have same “SNMP v3 user name” but different parameters (like encryption password, passphrase, etc..). To receive the OpenTouch alarms from all the declared OpenTouch nodes, there are two possible configurations: 1st option: use the same “SNMP v3 user name” and same associated parameters (security level, user password, passphrase, …) for all the OpenTouch nodes
-
2nd option : use a different “SNMP v3 user name” for each OpenTouch node
Special character quotes (") will not be accepted by the SNMP. In-case either authentication password or encryption password includes quotes then OV8770 will not receive alarms from OT.
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 33/35
9.23 Upgrade Warning
Case of an upgrade with a local client already started ! it is mandatory to check that all the clients are stopped !!! Preconisation : if possible, reboot the server before doing the upgrade
10 KNOWN PROBLEMS IN 3.1.08.00 patches A-G_V1
Here is the list of the problems (major) that are not yet fixed. These are the problems detected in the current version
severity
id
headline
3_major
crqms00204179
UUM/mass pro: "Export user data" option must set action=Modify by default in the export file
crqms00203815
Users: Filter search on users takes longer time
crqms00208281
8770 : Impossible to disassociate the smartphone device from a user (OT issue)
crqms00205094
crqms00206396
java.exe(Administrator-jboss) service utilizes maximum memory (1Gb) during OT configuration with 1k entries 8770/MOT - Only one node status displayed in 8770 while 2 nodes connected, 2 statuses present on CMS side, and 8770 reports 2 instances received. Livré ?? Fix Delivered
crqms00207081
Purge Alarms failed in Weekly & Daily Job (Apache server stopped)
crqms00208987
RTU Purge Failed in Daily&Weekly Job
crqms00203709
8770 Perceived Quality: Client GUI hangs multiple times if multiple users access the server simultaneously
crqms00205864
8770/Users : OXE with OT user creation fails with error UnexpectedCharException: Unexpected character
crqms00206533
8770 : refresh button doesn't work in the scheduler
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 34/35
Follow us on Facebook and Twitter Stay tuned on our Facebook and Twitter channels where we inform you about: New software releases New technical communications AAPP InterWorking Reports Newsletter Etc.
twitter.com/ALUE_Care facebook.com/ALECustomerCare
Submitting a Service Request Please connect to our eService Request application. Before submitting a Service Request, make sure that: In case a Third-Party application is involved, that application has been certified via the AAPP You have read through the Release Notes which lists new features available, system requirements, restrictions etc. available in the Technical Documentation Library You have read through the Troubleshooting Guides and Technical Bulletins relative to this subject available in the Technical Documentation Library You have read through the self-service information on commonly asked support questions, known issues and workarounds available in the Technical Knowledge Center
- END OF DOCUMENT -
OmniVista 8770 - Release 3.1
Installation Procedure for version 3.1.08.00 – Release 3.1 Copyright © ALE International 2015
TC2246 ed. 01 page 35/35
