This chapter explains how to install the Skype for Business Agent for Oracle Communications Enterprise Operations Monitor, and Oracle Communications Operations Monitor.
For Enterprise Operations Monitor (EOM) to monitor Skype for Business encrypted SIP messages, the user must install a Windows service (Agent) on the Skype for Business server. The Skype for Business Agent registers itself on the server and acts as a back-to-back user agent for the Skype for Business calls, obtaining access to the SIP message bodies. It then forwards the SIP messages to the EOM Mediation Engine, which analyzes them and displays them in the calls list alongside regular VoIP calls.
The Skype for Business Agent is distributed as a regular Windows .msi package which offers a wizard based installation.
Before installing Skype for Business Agent, ensure that you have the following:
Mediation Engine is installed on Linux and the Skype for Business Server machine is able to connect to the Mediation Engine.
To install Skype for Business Agent:
Download the Skype for Business installation file to a temporary directory (temp_dir).
Go to the temp_dir directory.
Unpack the Skype for Business to Skype Agent for Business (SFB) server.
Run the Skype for Business Agent file.
The Oracle EOM Skype for Business Agent Setup wizard appears.
Click Next.
The End-User License Agreement screen appears.
Accept the license agreement and click Next.
The ME Connection Settings screen appears.
In the ME Host Address field, enter host address.
It is recommended not to deselect Use TLS. When selected, the connection to Mediation Engine is encrypted.
Note:
If encryption is selected, you must generate a TLS certificate for the Skype for Business Agent which includes a Certificate. Upload the TLS certificate to the Enterprise Operations Monitor machine, and install it on the Skype Server in the local computer Trusted Certification Authorities store, and install the generated certificate including the private key permissions in the Personal Certificate store.Important:
Grant the read permissions for the private key to the OracleSkypeProbeUser account.
If encryption is not selected, the user must also select the Allow insecure connection checkbox in the Trusted certificates section in the Enterprise Operations Monitor setup.
The Ready to Install Oracle EOM Skype Agent screen appears.
Click Install.
The installation sets up a service on the windows server and creates an user account, OracleSkypeProbeUser for the service.
Click Finish.
The Skype for Business Agent installation is now complete and the calls made from Skype will appears as a Skype call in the call details window.
To uninstall Skype for Business Agent:
From your machine, click Start and then click Control Panel.
Click Programs.
Click Program and Features.
In the list of currently installed programs, select Oracle EOM Skype for Business Agent and then click Uninstall/Change.
A confirmation dialogue box appears. Confirm Uninstallation.
The Skype for Business Agent is uninstalled.
To edit the ME host address:
Open the configuration file, C:\Program Files\Oracle\Oracle EOM> Skype Probe\SkypeProbe.exe.config.
Change the value of the tag having key, apidAddr. For example,
<add key=”apidAddr” value=”192.168.123.120” />
Save the SkypeProbe.exe.config file.
Place the cursor on the Oracle EOM Skype Probe service name and right click to restart.
The Skype for Business Agent monitors only the SIP call flow. The call quality information is reported by the user agent, Skype for Business Desktop Client.
To get the call quality information:
Enable monitoring on the Skype server. See, https://technet.microsoft.com/en-us/library/jj687994.aspx
Install and configure the Skype for Business SDN API on the Skype Front-End Server, as described in the Skype for Business SDN API 2.4.1 Installation Admin Guide.
https://msdn.microsoft.com/en-us/library/office/dn785197(v=office.16) .aspx
After the installation, add the Mediation Engine machine to Skype for Business Server as a subscriber for the SDN API by running the following command in the Skype for Business Server console:
SDNManager.exe /p s EOM submituri=https://IP_address/sfb/
Where, IP_address is the IP address or the hostname of your Mediation Engine.
Result: The finished Skype calls show the MOS values and media summary.
Configure the SDN Manager to send QualityUpdate messages to the Mediation Engine by running the following command:
SDNManager.exe /p s EOM ”quality=True”
Operations Monitor reads the SDN Interface messages from the URL, https://<Mediation Engine Host>/sfb/.
After configuring the SDN Dialog Listener and SDN Manager, run the followingcommand for SDN Manager to forward the messages to Operations Monitor:
cd ”C:\Program Files\Microsoft Skype for Business Server\Microsoft Skype for Business SDN Manager\” SDNManager.exe /parameter subscriber ocom ”submituri=https://<MediationEngine Host>/sfb/”
Run the following command to verify SDN Manager configuration:
cd ”C:\Program Files\Microsoft Skype for Business Server\Microsoft Skype for Business SDN Manager\” SDNManager.exe /download subscriber
Result: You should get an XML describing the configuration. Pay attention to the value of the submituri parameter: does it match the address of the Enterprise Operations Monitor machine?
Check the SDN Manager and Dialog Listener log files at %LOCALAPPDATA%\Local\Temp\SDN after each Skype for Business call. Open the SDNManager.log file and search for the following:
Starting to transmit the message?
If the line does not exist, the SDN manager is configured incorrectly. Repeat the configuration process again.
This section provides guidelines for troubleshooting problems with Skype for Business Agent.
Perform the following if you are unable to view skype call data:
Verify that the SkypeProbe.exe.config file located in the installation directory has the correct IP address of Mediation Engine.
Verify Mediation Engine machine is reachable by pinging the Mediation Engine Machine from Skype for Business Server.
Verify the logs for any exceptions or connection errors in the following path:
C:\ProgramData\Oracle EOM Skype Probe\Logs
Ensure that OracleSkypeProbeUser is a member of RTC Server Applications local group. If not, add the user by doing the following:
From your computer, click Start and search for Computer Management.
Click Computer Management.
The Computer Management screen appears.
Click Local Users and Groups.
Select and right-click the RTC Server Applications group and click Add to Group.
Locate and add the OracleSkypeProbeUser and click OK.
The OracleSkypeProbeUser will be added to the RTC Server Applications group.
Verify the Enterprise Operations Monitor Skype for Business agent service is running in services.msc. by doing the following:
From your computer, click Start and search for Computer Management.
Click Computer Management.
The Computer Management screen appears.
Click Services and Applications.
Click Services.
Verify if Skype for Business Agent service is running, if not, right-click the service and click Start.
The Skype for Business Agent will start running.
Verify if the connection between Mediation Engine and Skype for Business Server is blocked by firewall. If blocked, disable the setting depending on your Operating System.
If you have selected Accept insecure connections from remote probes during Enterprise Operations Setup, set the UseTIs parameter to false in the SkypeProbe.exe.config file.