User Guide
User Guide
User Guide
Trademarks
The trademarks, service marks, logos and graphics (collectively “Trademarks”) appearing on Mitel's Internet sites or in its publi-
cations are registered and unregistered trademarks of Mitel Networks Corporation (MNC) or its subsidiaries (collectively "Mitel")
or others. Use of the Trademarks is prohibited without the express consent from Mitel. Please contact our legal department at
legal@mitel.com for additional information. For a list of the worldwide Mitel Networks Corporation registered trademarks, please
refer to the website: http://www.mitel.com/trademarks.
Chapter: 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Target Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Internet Browser Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Chapter: 4 Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Self Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
Adding Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
Viewing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Filtering Data in List Views . . . . . . . . . . . . . . . . . . . . . .13
Sorting Listviews . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Introduction
This user guide describes a recommended workflow for adding data into MX-ONE Provisioning Manager
and how to use the system. MX-ONE Provisioning Manager (PM) is a web-based management tool used
to manage users and administrators for both MX-ONE and MX-ONE Provisioning Manager.
Scope
The user guide contains:
• A workflow describing in which order to add data into PM
• A description of the navigation and the user interface in PM
• An overview of how to perform actions in PM
• Additional information for some tasks
• PM system messages and error handling
Target Group
This document is intended for users of MX-ONE Provisioning Manager and support personnel.
1
26/1553-ANF 901 15 Uen J6 2021-02-14
SYSTEM REQUIREMENTS
CHAPTER 2 MX-ONE PROVISIONING MANAGER OVERVIEW
System Requirements
MX-ONE Provisioning Manager can be accessed from anywhere using a commercially available browser.
The browser requirements are:
• Google Chrome (latest version)
• Microsoft Edge 80.0.361.48 (Official build) (64-bit)
• Mozilla Firefox 18 (or later versions)
• Microsoft Internet Explorer 8 (or later versions)
Both HTTP (TCP Port 80) and HTTPS (TCP Port 443) are supported. If HTTPS is used, it must be config-
ured. For higher security, it is recommended to use a commercial digital certificate issued by a commercial
Certification Authority (CA). For more information about PM security, see the description for MX-ONE
Provisioning Manager.
– Analog phones
– CAS phones
– Fax
– Digital phones
2
26/1553-ANF 901 15 Uen J6 2021-02-14
PREFERRED LANGUAGE
CHAPTER 2 MX-ONE PROVISIONING MANAGER OVERVIEW
– IP phones
– Cordless phones (DECT)
– Mobile phones/remote extensions.
• Backup functions
• MS Active Directory integration
• Comparison of PM data and subsystem data
• End user interface
• Efficiency enhancing features
• Web Service interface for external applications
• Configuration of Least Cost Routing for mobile extensions
• Assignment of function keys for digital and IP phones
• Configuration of personal number lists
• Configuration of parallel ringing
• Configuration of group membership
For more information about key features, see the description for MX-ONE PROVISIONING MANAGER.
Preferred Language
The language used in MX-ONE Provisioning Manager can be set per user in the User task under the
Advanced settings. The default language is English.
The sorting of the text columns in PM are by default done after the servers default language (en-US). To
sort after another language, the preferred language setting must be set in the web browser.
Getting Started
There are two ways to set up MX-ONE Provisioning Manager.
• Using the Wizard for Express and Express SAAS installation. A single page of entry fields helps you
to quickly set up the system. This is possible since the system is predefined.
• Manual set up for all other installation setups. You are forwarded to the start page where you can
access any task in the system to perform your configuration. See the Manual Workflow When Getting
Started section below for further details.
3. Optionally add additional departments in the Departments task. Alternatively the Import task can be
used.
3
26/1553-ANF 901 15 Uen J6 2021-02-14
INTEGRATING WITH MITEL CMG
CHAPTER 2 MX-ONE PROVISIONING MANAGER OVERVIEW
5. Optionally add users to promote to administrators with different security profiles. Use the User and
Administrator tasks.
6. Register subsystems
7. Add users and configure services such as extensions and mailboxes for the users using the User task.
Alternatively the Import task can be used.
NOTE: To quickly find the location in the menu for the different tasks, a tip is to use the site map available
at the top of MX-ONE Provisioning Manager.
NOTE: After installation it is recommended to create an extra super user to keep as backup if something
happens to the original super user account, for example if the password is lost, otherwise the whole
system must be reinstalled.
4
26/1553-ANF 901 15 Uen J6 2021-02-14
INTEGRATION WITH MICOLLAB ADVANCED MESSAGING
CHAPTER 2 MX-ONE PROVISIONING MANAGER OVERVIEW
5
26/1553-ANF 901 15 Uen J6 2021-02-14
INTEGRATION WITH SIP-DECT OMM
CHAPTER 2 MX-ONE PROVISIONING MANAGER OVERVIEW
6
26/1553-ANF 901 15 Uen J6 2021-02-14
LOGGING IN AND LOGGING OUT
CHAPTER 3 USING MX-ONE PROVISIONING MANAGER
7
26/1553-ANF 901 15 Uen J6 2021-02-14
NAVIGATING IN MX-ONE PROVISIONING MANAGER
CHAPTER 3 USING MX-ONE PROVISIONING MANAGER
Item Description
A Main menu
B Submenu
C Work area
D Help frame
NOTE: Do not use the Back and Forward buttons in the browser. Using these buttons will result in an
error message. Reload the page to go back to MX-ONE Provisioning Manager.
8
26/1553-ANF 901 15 Uen J6 2021-02-14
NAVIGATING IN MX-ONE PROVISIONING MANAGER
CHAPTER 3 USING MX-ONE PROVISIONING MANAGER
Table 3.2: Icons and Symbols in MX-ONE Provisioning Manager (Continued) (Sheet 2 of 3)
9
26/1553-ANF 901 15 Uen J6 2021-02-14
NAVIGATING IN MX-ONE PROVISIONING MANAGER
CHAPTER 3 USING MX-ONE PROVISIONING MANAGER
Table 3.2: Icons and Symbols in MX-ONE Provisioning Manager (Continued) (Sheet 3 of 3)
10
26/1553-ANF 901 15 Uen J6 2021-02-14
ENABLING THE AUTOMATIC LOGOUT INDICATOR
CHAPTER 3 USING MX-ONE PROVISIONING MANAGER
To be able to see this information, the browser must be configured for allowing status bar updates using
Java Script. For information on how to enable this function in the browser, see the browser documenta-
tion.
11
26/1553-ANF 901 15 Uen J6 2021-02-14
SELF SERVICES
CHAPTER 4 ACTIONS
Actions
This section describes the actions that can be performed in the different tasks. Most of the actions can be
performed at different stages, for example from a result screen or from a list view.
Figure 4.1: List view
Self Services
The Forgot your password link on the login page of the GUI, makes it possible for users to get a new
password. This is useful if the user has forgotten the password or if the user's account has been locked.
The following steps must be done to get a new password:
1. Click on the Forgot your password link. The Forgot Password screen is opened.
2. Enter a valid user id and press Submit.
3. A confirmation message are shown and a new password has been sent to the user's e-mail address.
NOTE: The Forgot your password link is only shown when a mail server is connected to the system.
Adding Data
Data can be added to a new configuration item in the following ways:
1. Click Add.... System default values are displayed for the new configuration item.
To create a configuration item without using a template, the value <No Template> must be selected
in the Using Template drop-down list before clicking the button. To create a configuration item using
a template, see 4.10.3 Using a Template to Create a Configuration Item on page 19.
2. From a result screen or a view details screen, click Add from this.... The previously added configu-
ration item is used as a template.
3. From a list view, click Add new using this as template icon. The selected configuration item is used
as a template.
Some configuration tasks have predefined values and can only be changed.
12
26/1553-ANF 901 15 Uen J6 2021-02-14
VIEWING DATA
CHAPTER 4 ACTIONS
NOTE: When a user is added in the User task, it is automatically assigned the security profile End User.
An end user can be promoted to administrator by assigning the user a different security profile and
defining access to departments and locations in the Administrator task.
Viewing Data
Configuration items can be viewed in the following ways:
• For some tasks the list view is displayed by clicking View. The list displays the existing configuration
items with a subset of the property values or all property values.
• From a list view, click ( View details). The details of the configuration item are displayed. Click on the
To filter the list, enter the search criteria in one or more fields and click Filter. Wildcards can be used in
the search criteria, a question mark (?) to replace one character or an asterisk (*) to replace zero or more
characters.
Sorting Listviews
The list in the listview can be sorted by clicking the arrows displayed for the columns:
• ( Sort by <column name>): the column is unsorted, clicking it sorts the list by the items in that column
in ascending order
• ( Sort descending): the column is sorted in ascending order, clicking it sorts the list by the items in that
Comparing Data
Configuration item properties can be compared with the compare function. The compare function is avail-
able in list views.
13
26/1553-ANF 901 15 Uen J6 2021-02-14
SEARCHING FOR USERS
CHAPTER 4 ACTIONS
A new screen with the result of the comparison is displayed. Property values that differ in the comparison
are highlighted. The property values can be changed by clicking one of the Change <item> ... buttons.
Changing Data
Configuration items can be changed in the following ways:
• From a list view, click ( Change). The configuration item is opened and the set values can be edited.
• From a list view, select one or more configuration items and click Change.... Makes it possible to
change values for all selected configuration items at the same time. If changing values for more than
one configuration item, ( Change) enables the field.
• From a result screen, click Change This.... The configuration item is opened and the set values can be
edited.
14
26/1553-ANF 901 15 Uen J6 2021-02-14
REMOVING DATA
CHAPTER 4 ACTIONS
Removing Data
Configuration items can be removed in the following ways:
• From a list view, click ( Remove).
• From a list view, select one or more configuration items and click Remove.
• From a result screen, click Remove This.
Printing Data
Configuration data can be printed in the following ways:
• From a list view, click Print.... Prints the properties of selected configuration items.
• From a list view, click the Print All link. Prints the properties of all existing configuration items.
• From a view details screen, click the Print link. Prints the properties of the configuration item.
Clicking Print..., Print All or Print opens a pop-up window that displays the print preview.
Example:
Printing Security Profile
1. Go to the Administrators tab and then Security Profile.
2. Select items to print.
Note:Select less then ten (10) items.
3. Click the Print link.
5. Click Print to open the browser print dialog box, make desired selections and print the page.
15
26/1553-ANF 901 15 Uen J6 2021-02-14
SWAPPING EQUIPMENT POSITIONS
CHAPTER 4 ACTIONS
Handling Templates
A template is a set of predefined values that can be used when a new configuration item is added.
Templates are used to simplify the process of adding many configuration items with similar property
values. Only property values that can be identical for several configuration items can be set in the
template. Property values set in templates will not be set in MX-ONE.
Click the Manage Templates link in a task to display the list view with the existing templates for that task.
In the list view, the templates are displayed with the defined name, the type, the user that created it, and
the date when it was created, for example,
Digital extension_DigitalExtension (by jsmith, 15/02/08)
16
26/1553-ANF 901 15 Uen J6 2021-02-14
USING A MULTISTEP BUTTON
CHAPTER 4 ACTIONS
2. Click Add New...and enter property values for the configuration item where applicable.
17
26/1553-ANF 901 15 Uen J6 2021-02-14
USING SHORTCUTS
CHAPTER 4 ACTIONS
Using Shortcuts
In the Add and Change pages of the Extension task there is a shortcut dropdown at the top that quickly
will take you to the selected task in MX-ONE to which the managed extension belongs. You will get auto-
matically logged in and navigated to the selected task.
18
26/1553-ANF 901 15 Uen J6 2021-02-14
SUBSYSTEM BACKUP
CHAPTER 4 ACTIONS
Subsystem Backup
Enables to take the backup of MiVoice MX-ONE subsystem and Service Node Manager data.
The icon ( Restore) is only displayed for the backup directories, which is used to restore the system.
The process of saving system data during a backup and the process of restoring data during a restore
may take a few minutes.
NOTE: It is not possible to alter system data during a backup or restore.
19
26/1553-ANF 901 15 Uen J6 2021-02-14
SUBSYSTEM BACKUP
CHAPTER 4 ACTIONS
The created backup files are stored in /var/opt/eri_sn the folder on the MiVoice MX-ONE and are
used when restoring the MiVoice MX-ONE database. You can restore MiVoice MX-ONE and Service
Node Manager using the Backup and Restore task in Service Node Manager.
20
26/1553-ANF 901 15 Uen J6 2021-02-14
IMPORTING DATA TO MX-ONE PROVISIONING MANAGER
CHAPTER 5 USING COMPARE WITH SUBSYSTEM
21
26/1553-ANF 901 15 Uen J6 2021-02-14
IMPORTING FROM D.N.A. AND CMG
CHAPTER 5 USING COMPARE WITH SUBSYSTEM
22
26/1553-ANF 901 15 Uen J6 2021-02-14
EXPORTING DATA FOR CMG
CHAPTER 6 EXPORTING DATA FROM MX-ONE PROVISIONING MANAGER
4. In step 2/2, select the data to include in the export, then click Next.
5. For exports using CMG data format, specify a definition file (this file is required for correct format of
the exported data). Then click Apply to initiate export.
6. On the Result page, click Done.
A user can be associated with several extensions in PM, but only one extension in CMG. For users asso-
ciated with more than one extension in PM, the export file will contain a separate record for each exten-
sion in PM.
For correct export file format, definition files for department and user data are required when exporting
data for CMG.
23
26/1553-ANF 901 15 Uen J6 2021-02-14
EXPORTING CALL ACCOUNTING DATA
CHAPTER 6 EXPORTING DATA FROM MX-ONE PROVISIONING MANAGER
Data exported as general data is stored using XML format. The following MX-ONE Provisioning Manager
data is included when exporting general data:
• Complete department data
• Complete user data
• System data: administrators, security profiles, locations, and subsystems.
NOTE: To get the cost center data into the COSTCEN.DAT file you need to set the UDF Field Type to
"COST CENTER" for the applicable UDF in the UDF Mapping task.
The exported files are stored in a .zip file, available for download on the first page of the Export Data task.
24
26/1553-ANF 901 15 Uen J6 2021-02-14
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
25
26/1553-ANF 901 15 Uen J6 2021-02-14
CREATE A SERVICE PROVIDER
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
1. Use the user created in the MX-ONE Provisioning Manager setup, i.e. System Setup Admin, to login
to the application.
26
26/1553-ANF 901 15 Uen J6 2021-02-14
CREATE A SERVICE PROVIDER
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
27
26/1553-ANF 901 15 Uen J6 2021-02-14
CREATE A SERVICE PROVIDER
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
5. Select the Security Profile "Service Provider" and promote the user to Service Provider.
28
26/1553-ANF 901 15 Uen J6 2021-02-14
CREATE A RESELLER
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
Create a Reseller
Figure 7.3: Create Reseller
29
26/1553-ANF 901 15 Uen J6 2021-02-14
CREATE A RESELLER
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
30
26/1553-ANF 901 15 Uen J6 2021-02-14
CREATE A RESELLER
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
5. Select the Security Profile Reseller and promote the user to Reseller.
31
26/1553-ANF 901 15 Uen J6 2021-02-14
CREATE A TENANT ADMINISTRATOR
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
32
26/1553-ANF 901 15 Uen J6 2021-02-14
CREATE A TENANT ADMINISTRATOR
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
33
26/1553-ANF 901 15 Uen J6 2021-02-14
CREATE A TENANT
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
Create a Tenant
1. Login with one of the Tenant Administrator Credentials.
34
26/1553-ANF 901 15 Uen J6 2021-02-14
CREATE A TENANT
CHAPTER 7 TENANT AND FEATURE CONFIGURATION
Tenant Configuration page is used to create the number series for the single customer.
4. Logout the Tenant Administrator login and logon with Tenant Viewer [End User] Credentials.
35
26/1553-ANF 901 15 Uen J6 2021-02-14
CHAPTER 8 SETUP A NEW MX-ONE PM TO MONITOR DIFFERENT SITES
36
26/1553-ANF 901 15 Uen J6 2021-02-14
CPE MODE SETUP
CHAPTER 8 SETUP A NEW MX-ONE PM TO MONITOR DIFFERENT SITES
37
26/1553-ANF 901 15 Uen J6 2021-02-14
CPE MODE SETUP
CHAPTER 8 SETUP A NEW MX-ONE PM TO MONITOR DIFFERENT SITES
38
26/1553-ANF 901 15 Uen J6 2021-02-14
CPE MODE SETUP
CHAPTER 8 SETUP A NEW MX-ONE PM TO MONITOR DIFFERENT SITES
39
26/1553-ANF 901 15 Uen J6 2021-02-14
CPE MODE SETUP
CHAPTER 8 SETUP A NEW MX-ONE PM TO MONITOR DIFFERENT SITES
NOTE: The Department Name can now hold up to 64 alphanumerical and special characters both. But,
the characters such as ", *, ?, \, < and > are not allowed.
1. Check the result.
2. Go to Users, Users and add a new user, select the correct department.
40
26/1553-ANF 901 15 Uen J6 2021-02-14
CPE MODE SETUP
CHAPTER 8 SETUP A NEW MX-ONE PM TO MONITOR DIFFERENT SITES
4. Go to Administrator Menu, Administrator and add the create user to a service profile.
5. Select the Security Profile, Access to Departments and Access to Subsystems in Locations.
41
26/1553-ANF 901 15 Uen J6 2021-02-14
CPE MODE SETUP
CHAPTER 8 SETUP A NEW MX-ONE PM TO MONITOR DIFFERENT SITES
8. Add the subsystem and select the location, if the setup is correct, only one appears.
10. Check the result by clicking the subsystem link (Stockholm - MX-ONE).
42
26/1553-ANF 901 15 Uen J6 2021-02-14
CPE MODE SETUP
CHAPTER 8 SETUP A NEW MX-ONE PM TO MONITOR DIFFERENT SITES
11. Access the subsystem that you created on the previous slide and logout.
15. Select the Security Profile, Access to Departments and Access to Subsystems in Locations
43
26/1553-ANF 901 15 Uen J6 2021-02-14
CHAPTER 9 END USER PROFILE SETTINGS TO MONITOR GROUP DATA
Log in to PM with end user privilege. The features under group setup heading shown in the figure below,
can be configured by the end user.
Figure 9.2: End User Extension page
44
26/1553-ANF 901 15 Uen J6 2021-02-14
LOGS
CHAPTER 10 SYSTEM AND ERROR MESSAGES
This message type can be displayed for procedures including several sub-procedures, where one or more
sub-procedures might be non-successful. Rollbacks are performed for non-successful sub-procedures
Figure 10.4: Other messages
For certain operations a pop-up window is displayed, please see the following example for invalid
template name.
Figure 10.5: Pop-up message
Logs
MX-ONE Provisioning Manager provides three logs with different information level:
• Audit trail: Information about all changes made by a user in the system
45
26/1553-ANF 901 15 Uen J6 2021-02-14
LOGS
CHAPTER 10 SYSTEM AND ERROR MESSAGES
Log files are created every day even if no data is logged. Logs older than 90 days are overwritten.
46
26/1553-ANF 901 15 Uen J6 2021-02-14
CHAPTER 11 POST-INSTALLATION CONFIGURATION TOOL
To start the tool, enter one of the following commands in a shell connected to the server:
• If logged in as root, enter the command mp_config.
• If logged in as eri_sn_admin, enter the command sudo -H mp_config.
47
26/1553-ANF 901 15 Uen J6 2021-02-14
GENERAL
CHAPTER 12 MX-ONE PROVISIONING MANAGER INTERFACE WITH WEBSEAL
General
The Provisioning Manager is used to manage and administer the Mitel MX-ONE communication system.
This enables you to connect the IBM WebSEAL to the Provisioning Manager for having a centralized
access management.
Requirements
IBM Tivoli Access Manager WebSEAL can be used for SSO authentication to log on to applications. The
purpose is to register with the PM via WebSEAL.
WebSEAL
WebSEAL is a high-performance, multi-threaded web server that applies a fine-grained security policy to
the Tivoli Access Manager protected Web object area. WebSEAL can provide SSO solutions and incor-
porate resources from a back-end web application server into its security policy.
To get more information on IBM Tivoli Access Manager and WebSEAL, click the following link:
https://publib.boulder.ibm.com/tividd/td/ITAME/SC32-1134-01/en_US/HTML/amweb41_admin04.htm
48
26/1553-ANF 901 15 Uen J6 2021-02-14
PM WEBSERVER_CONFIGURATION FOR LOGIN VIA WEBSEAL
CHAPTER 12 MX-ONE PROVISIONING MANAGER INTERFACE WITH WEBSEAL
Host name and IP refer to the service to be protected (PM). The IV-User Header is used as transfer
parameter for the service PM. The service (PM) evaluates the IV user header and determines the login
data from this.
49
26/1553-ANF 901 15 Uen J6 2021-02-14
PM WEBSERVER_CONFIGURATION FOR LOGIN VIA WEBSEAL
CHAPTER 12 MX-ONE PROVISIONING MANAGER INTERFACE WITH WEBSEAL
2. Select J for Other Utilities and Click OK. The following screen appears.
3. Select (C) for Webseal IP management. Click OK. The following screen appears.
50
26/1553-ANF 901 15 Uen J6 2021-02-14
PM WEBSERVER_CONFIGURATION FOR LOGIN VIA WEBSEAL
CHAPTER 12 MX-ONE PROVISIONING MANAGER INTERFACE WITH WEBSEAL
4. Select (A) to enter the address of Add Webseal IP and click OK. The following subsequent screen
appears.
Figure 12.4: Webseal IP/hostname Entry
51
26/1553-ANF 901 15 Uen J6 2021-02-14
REGISTRATION VIA WEBSEAL
CHAPTER 12 MX-ONE PROVISIONING MANAGER INTERFACE WITH WEBSEAL
8. Click OK. The following screen appears acknowledging that the deletion takes place without inquiry.
The webserver_config tool acknowledges the input with DELETE 1, the tool webserver_config is
closed.
52
26/1553-ANF 901 15 Uen J6 2021-02-14