Unify OpenScape Business V2 Installation and user guide

OpenScape Business V2
How To
OpenScape Business Connector
(based hUTC with dynamic registration)
Version 1.16

OpenScape Business V2 –How To: Circuit Interconnection
2
Definitions
HowTo
An OpenScape Business HowTo describes the configuration of an OpenScape Business feature
within the OpenScape Business administration. It addresses primarily trained administrators of
OpenScape Business.
Tutorial
Within the OpenScape Business tutorials procedures for installation, administration and operation
of specific devices, applications or systems, which are connected to OpenScape Business, are
described. The tutorial addresses primarily trained administrators of OpenScape Business.

OpenScape Business V2 –How To: Circuit Interconnection
3
Table of Contents
1. Introduction 6
2. Configuration of Circuit 7
2.1. Request Circuit Tenant 7
2.2. Circuit Licenses 8
2.3. Create Circuit User(s) 8
2.4. Request the Connectivity to OpenScape Business 10
3. Configuration OpenScape Business 12
3.1. Basic Installation / Network/Internet Wizard 12
3.2. Circuit Connectivity Wizard 13
3.3. Circuit User Instance 15
3.4. OSBiz Circuit CTI Features V2R6 FR2 16
3.5. OSBiz Circuit CTI Features V2R7 16
3.6. OSBiz Circuit CTI Feature Circuit Conference 16
3.7. OSBiz Circuit CTI Feature Circuit Voicemail 20
3.8. OSBiz Circuit CTI Feature OSBiz Voicemail 20
3.9. OSBiz V3 Features 21
3.9.1. OSBiz Circuit V3 Feature overview 21
3.9.2. OSBiz Circuit V3 Custom Conference Number 21
3.9.3. OSBiz V3 Circuit Voicemail in Call Management 22
3.9.4. OSBiz V3 Snooze Interworkin 24
3.9.5. OSBiz V3 Camp on 24
3.9.6. OSBiz V3 Alternative Number 25
3.9.7. OSBiz V3 Call Routing 26
3.9.8. Circuit teams 29
3.10. OSBiz Scenario Configuration 32
3.10.1. Scenario 1: Basic MULAP with system phone and Circuit User 32
3.10.2. Scenario 2: standalone Circuit User 34
4. Configuration in Expert Mode 36
4.1. OpenScape Business LCR Configuration (ROW) 36
4.2. OpenScape Business LCR Configuration (US) 37
4.3. Route Configuration 38
5. Special Configuration no DID 40
6. Firewall Rules 43
6.1. Outbound connection for https 43
6.2. Outbound connection for SIP signaling* 43
6.3. Outbound RTP Ports OSBiz 43
7. OpenScape Business Serviceability 44

OpenScape Business V2 –How To: Circuit Interconnection
4
7.1. Required trace configuration options for error reporting 44
7.2. Additional helpful data and files for error analysis: 44
8. Troubleshooting hints: 45
8.1. General Troubleshooting checklist and hints 45
8.2. Partner Administration Error, Unable to add OpenScape Business trunk 46
8.3. ** Numbers for Circuit user 46
8.4. Incoming Calls not possible 46
8.5. Direct Call to Circuit User in Team not possible 47
8.6. Phone Number from Circuit Client not shown for external calls (suppress calling ID) 47
8.7. Circuit connectivity Wizard Rest API Error 47
8.8. Circuit connectivity Certificate Error 47
8.9. Circuit connectivity Wizard starts with all fields filled out, but nothing ongoing 48
8.10. Firewall and General Problems after running Circuit Connector Wizard 48
8.10.1. Sophos XG Firewall 49
8.11. Incoming and Outgoing calls not possible 49
8.12. How to generate Server Certificate, not needed for OSBiz Circuit Connector 50
Table of History
Date
Version
Changes
09-03-2016
0.1
Initial Version of configuration hints
10-03-2016
0.2
Screenshots and examples added
23-09-2016
0.3
Screenshot for Route configuration corrected in Expert mode, add LCR example for US
05-10-2016
04
Screenshots examples for Circuit eu and na (Wulf)
02-11-2016
05
Hints for STUN (Wulf)
30.01.2017
09
Update Changes for Circuit release and Special Configuration (Wulf)
28.03.2018
1.0
Update multiple OSbiz and Circuit Screenshots (Wulf)
03.04.2018
1.1
Add Troubleshooting (Wulf)
16.04.2018
1.2
Add Screenshot Troubleshooting an Circuit License (Wulf)
08.05.2018
1.3
Add how many Users and Connectors (Wulf)
19.10.2018
1.4
Add additional IP Address Firewall rules (chapter 8.3) (Wulf)
07.02.2019
1.5
Add Enhanced Feature Interworking (Wulf)

OpenScape Business V2 –How To: Circuit Interconnection
5
01.04.2019
1.6
Circuit new IP Addresses and Ports (Wulf)
08.04.2019
1.7
Add Troubleshooting Firewall hints / Certificate Error (Wulf)
04.06.2019
1.8
Add Voicemail configuration / enhance troubleshooting / Certificate import (Wulf)
09.07.2019
1.9
Add V2R7 Features and Circuit Conference (Wulf)
12.07.2019
1.10
Partner Portal Error; Adding Picture for Circuit Conference (Wulf)
07.08.2019
1.11
Problem with Suppressed calling ID Circuit Client, Circuit Conference direction prefix
19.08.2019
1.12
**Numbers not allowed for Circuit User
07.10.2019
1.13
Adding IP Addresses and Port for additional SBC (important for Firewall)
18.10.2019
1.14
Some small text corrections
30.10.2019
1.15
Typo Error Ports
03.06.2020
1.16
OSBiz V3 Features

OpenScape Business V2 –How To: Circuit Interconnection
6
1. Introduction
To provide the Circuit solution with OpenScape Business several components are used and needs to configure. The solution consists
of the Circuit Server, the hUTC (Hosted Universal Telephone Connector) and the OpenScape Business communication system.
The hUTC is located in the Circuit cloud. The connection between the hUTC and the OpenScape Business system is a native SIP
trunk connected through the public internet.
You can also connect multiple OpenScape Business to one Circuit Tenant, by using the same API key for each OpenScape Business
System. Each OpenScape Business System will get automatically an own trunk after running the wizard.
On premise
Circuit
cloud UTC Native SIP trunk
Public
Internet
Office Router
For the solution, two configuration steps are necessary
1. Configuration of the Circuit environment (including hUTC)
2. Configuration of OpenScape Business system

OpenScape Business V2 –How To: Circuit Interconnection
7
2. Configuration of Circuit
2.1. Request Circuit Tenant
To connect OpenScape Business with Circuit you need an active Circuit Tenant. If you have not yet signed up for Circuit, please
request a free Circuit Tenant to start the configuration steps. (https://www.circuit.com/home)
Please enter the requested data. At the end sign up in circuit and login as administrator.

OpenScape Business V2 –How To: Circuit Interconnection
8
2.2. Circuit Licenses
For Telephony with hUTC each Circuit User which shall be able to place telephone calls with OpenScape Business need to have the
right license. This can be either the UnifyTeam or the UnifyEnterprise or the UnifyProfessional license.
The current licenses shown under Administration->Domain.
If the required licenses are not available, press the button “Manage Packages”. This will forwarded you to the unifyportalshop where
you can order additional licenses.
2.3. Create Circuit User(s)
Login as Circuit Admin User and go to the Administration page: add at least the Circuit Users which should be able to place
telephone calls with OpenScape Business.

OpenScape Business V2 –How To: Circuit Interconnection
9
Add at least the Circuit Users, which should be able to place telephone calls with OpenScape Business.
Please assign the required licenses to the Circuit Users:

OpenScape Business V2 –How To: Circuit Interconnection
10
2.4. Request the Connectivity to OpenScape Business
Administration->Telephony
Please add under settings Telephony the telephony connector.
Per Circuit Tenant, max of 150 Connectors possible (Example 100 OSBiz Systems and 50 ATC)
Each OSBiz can only have one connector.
Please Generate the API Key

OpenScape Business V2 –How To: Circuit Interconnection
11
Now you can get the API Key, needed for further OpenScape Business configuration.
“use the same API Key for each OpenScape Business system”.

OpenScape Business V2 –How To: Circuit Interconnection
12
3. Configuration OpenScape Business
3.1. Basic Installation / Network/Internet Wizard
Circuit is connected via the internet, you have to configure the internet connection of the system. Enter the correct upstream value,
this is used later on to calculate the max amount of concurrent internet calls.
Connectivity to Circuit only via external Router permitted.
If OSBiz WAN Interface is active, Internet Access via WAN must be possible, If WAN is active, OSBiz Circuit connector is
only possible via WAN. If no Internet access via WAN OSBiz Circuit Connector will not work.
Please be aware that STUN is prerequisite in OSBiz and working.

OpenScape Business V2 –How To: Circuit Interconnection
13
3.2. Circuit Connectivity Wizard
Basic configuration settings for Circuit including native SIP trunk to hUTC. Connectivity wizard will configure and establish the
connection.
Actions:
Check “Enable Circuit”; Check “Use Circuit API-Key”;
New: Check Enable “Enhanced feature interworking” (Enable CTI features OSBiz-Circuit) (min OSBiz Version V2 R6.1.1_009)
Hint: If you run the Wizard first Checkbox “Enhanced feature interworking” is greyed out, you have to rerun the wizard.
select Domain (Get the Information from Circuit tenant Administrator)
insert the API Key via copy and paste; (Get the API Key from Circuit tenant Administrator)
select Number of simultaneous circuit calls.
The “upstream up to (Kbps)” value defines the overall bandwidth, which can be used for voice calls to the internet. This includes
Circuit calls as well as ITSP and/or Device@Home calls.

OpenScape Business V2 –How To: Circuit Interconnection
14
Hint:
If you want to connect multiple OpenScape Business Systems to one tenant, you must run on each system the Wizard and “use the
same API Key for each system”. Each System will create an own trunk to Circuit.
Press OK&Next
Press execute Function
Wizard configures the trunks and establishes the connection to Circuit:
Press OK&Next

OpenScape Business V2 –How To: Circuit Interconnection
15
Hint:
If needed IP and Ports hUTC can be verified through Expert Mode/Telephony Server/Voice Gateway/Native SIP Server
Trunk/Circuit UTC (Cloud), you can also find the Stun configuration here.
3.3. Circuit User Instance
Configure Circuit User instances
Note: for each Circuit User Instance you need a free internal call number to address the virtual station, which represents the Circuit
User in the system and max 150 User for OSBiz X Systems and 250 User for OSBiz S (per OSBiz System)
Actions: Add new Circuit User; Edit configured Circuit User

OpenScape Business V2 –How To: Circuit Interconnection
16
3.4. OSBiz Circuit CTI Features V2R6 FR2
3.5. OSBiz Circuit CTI Features V2R7
3.6. OSBiz Circuit CTI Feature Circuit Conference

OpenScape Business V2 –How To: Circuit Interconnection
17

OpenScape Business V2 –How To: Circuit Interconnection
18

OpenScape Business V2 –How To: Circuit Interconnection
19

OpenScape Business V2 –How To: Circuit Interconnection
20
3.7. OSBiz Circuit CTI Feature Circuit Voicemail
Disabling the OSBiz Voicemail settings of the specific Users (uncheck the Voicemail license and avoid forwarding to
OSBiz Voicemail via CFU and CFNR)
3.8. OSBiz Circuit CTI Feature OSBiz Voicemail
Configuration for Circuit Client (Precondition Voicemail is configured and running in OSBiz)