Netcom MobileStatus Server Installation and Configuration...

14
www.BluePosition.com All company names, products, and services mentioned are the trademarks or registered trademarks of their respective owners. MobileCTI™, MobilePBX™, MobileIVR™, MobileStatus™ and BluePosition are registered trademarks and owned by BluePosition ApS. © BluePosition ApS, Denmark. 2006 - 2011. Subject to change without further notice. Netcom MobileStatus™ Server Installation and Configuration Guide Guide to installing and configuring the Netcom MobileStatus™ Server Version 2.6 – June 2011

Transcript of Netcom MobileStatus Server Installation and Configuration...

www.BluePosition.com All company names, products, and services mentioned are the trademarks or registered trademarks of their respective owners. MobileCTI™, MobilePBX™, MobileIVR™, MobileStatus™ and BluePosition are registered trademarks and owned by BluePosition ApS. © BluePosition ApS, Denmark. 2006 - 2011. Subject to change without further notice.

Netcom MobileStatus™ Server Installation and

Configuration Guide

Guide to installing and configuring the Netcom MobileStatus™ Server

Version 2.6 – June 2011

Page 2 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

1.0 Welcome ................................................................................... 3

1.1 Installation ................................................................................ 3

1.2 This Guide ................................................................................. 3

1.3 Introduction to MobileStatus™ ...................................................... 3

1.4 System Requirements ................................................................. 3

1.5 Intellectual Property .................................................................... 4

1.6 User License .............................................................................. 4

1.7 Limited Warranty ........................................................................ 4

1.8 Support ..................................................................................... 5

1.9 Used Syntax .............................................................................. 5

2.0 Installation ................................................................................ 6

3.0 Configuration of the MobileStatus™ Server ..................................... 9

3.1 MobileStatus™ Server Service ...................................................... 9

3.2 The MobileStatus™ Configuration Window ...................................... 9

4.0 Settings .................................................................................. 10

5.0 Operator ................................................................................. 10

6.0 E-mail ..................................................................................... 10

7.0 Web ........................................................................................ 12

8.0 Manage service ........................................................................ 13

Appendix A: Web Access to the MobileStatus Server ........................... 14

Page 3 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

1.0 Welcome

Congratulations with your new program Netcom MobileStatus™ Server, a gateway between the status services from Netcom and the Office Communications Server

MobileStatus product which utilizes status information to enrich the Microsoft Office Communication Server presence information.

1.1 Installation

This guide is a description of the installation process and the configuration facilities of the MobileStatus™ Server program.

1.2 This Guide

This guide is written with the purpose of guiding the user or administrator through the installation and configuration of MobileStatus™ Server.

This version of the Installation and Configuration Guide is written for version 2.6 of the MobileStatus™ Server. You can access the version number of the MobileStatus™ Server

in the menu item ’Help’ -’About’ in the MobileStatus™ Server Configuration menu.

1.3 Introduction to MobileStatus™

MobileStatus™ Server is developed with the purpose of distributing the status information from the mobile network operator to the client software applications

requiring status information. Currently:

OCS MobileStatus™ Microsoft Office Communications Server integration with mobile phone status. It enables

Office Communications Server clients such as Microsoft Office Communicator to display

contacts’ mobile phone availability.

1.4 System Requirements

For MobileStatus™ Server to work properly, the following requirements are necessary:

1) The MobileStatus™ Server is designed to be used on a PC with Microsoft Windows XP™, Windows Vista™, Windows 7™, Windows 2003™ Server, or Windows

2008™ Server.

2) The MobileStatus™ Server requires communication with the status service of the mobile network operator through an Internet connection.

3) The MobileStatus™ Server should be able to communicate with the products using status information including OCS MobileStatus™ and MobileStatus™ Viewer

through TCP/IP via the corporate network.

Communication is done using TCP/IP over TCP port 42331. If the MobileStatus™ Server is placed in a DMZ or similar configuration, firewalls and proxies located

Page 4 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

between MobileStatus™ Server client applications and the MobileStatus™ Server must be configured to allow TCP traffic on that port.

1.5 Intellectual Property

This program, including the user guides, manuals and other publications are copyright protected. No part of the software program or the publications may be reproduced or

transferred in any form electronically or mechanically, without prior written acceptance from BluePosition ApS.

1.6 User License This program is covered by a server license. The server license entitles you to install and

use the software on one single PC/server. The server license does NOT entitle you to have the program installed on several PCs at the same time, and the program must

under NO circumstances be used on several PCs at the same time. For further information please refer to the software license agreement:

MobileStatus™ Server Software license agreement: MSS-SLA-UK-220, or later.

1.7 Limited Warranty

Warning: BluePosition ApS disclaims all warranties, express or implied, including any implied warranties of merchantability or fitness for a particular purpose. BluePosition ApS

does not warrant errors in this document, the material delivered, including the software, or accidental damage in connection with the delivery or the use of this material or

software program. For further information please refer to the software license agreement:

MobileStatus™ Server Software license agreement: MSS-SLA-UK-220, or later.

Page 5 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

1.8 Support Support in relation to the installation or use of this software should be requested with

your reseller, or one of BluePosition’s support partners. Please visit www.blueposition.com for further information on this topic.

1.9 Used Syntax

In this user guide the following syntax is used:

Text in brackets i.e. [Answer] relates to a program button or keyboard key with the name included in the brackets.

Text in quotes i.e. ”Call notes / Message” relates to a dialog, status or input box with the name in question.

Page 6 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

2.0 Installation The MobileStatus™ Server program is installed by executing the installation program

’Setup MobileStatus Server Netcom.exe’, supplied on CD-ROM or downloaded from the Internet.

Figure 2.1: MobileStatus™ Server setup wizard.

Please press [Next >] to continue the installation process.

Page 7 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

Figure 2.2: The MobileStatus™ Server software license agreement.

Please read the Software License Agreement carefully and only check ’I accept the terms in the License Agreement’ and [Next >] to continue the installation if you understand

and agree to the terms and conditions set forward in the agreement.

Figure 2.3: The MobileStatus™ Server program location.

MobileStatus™ installation program suggest per default to install the MobileStatus™

program in the folder ’C:\Program Files\MobileStatus Server’. Any other destination folder can be selected by using the [Browse…] button.

Please press [Install] to continue the installation process.

During the installation process, the installation program will ask if it should configure the

Windows™ Firewall. The modifications are necessary to allow the operator to push status

Page 8 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

messages to MobileStatus™ Server, and for the client applications to connect to the server.

If the computer on which you are installing MobileStatus™ Server does not have Windows™ Firewall installed or enabled, the installation program may display an error

message in that regards. This message can safely be ignored.

Figure 2.4: Installation of the MobileStatus™ Server program files.

The installation program subsequently installs the program and copies relevant files to

the installation directory.1

Figure 2.5: Finalizing the installation process.

It is recommended that the “Run configuration program” is executed automatically. Press [Finish] to finalize the installation process and start the configuration of the

MobileStatus™ Server program.

1 Note that if you are upgrading from a previous version, you must first stop the BluePosition MobileStatus

Server service from the Windows services control panel applet. Otherwise the installer is not able to overwrite

necessary files.

The installer will display a warning prompt with regards to the service already being installed. This is not an

error, and can safely be ignored.

Page 9 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

3.0 Configuration of the MobileStatus™ Server The MobileStatus™ Server program consists of two parts, one being the server running

as a Microsoft Windows Service, and the other being the configuration program which is a standard Windows application. The configuration program is installed on the same PC

as the service.

3.1 MobileStatus™ Server Service

The MobileStatus™ Server is deployed as a Windows service, and during the installation

it is configured to start automatically.

Services may be configured with service parameters by opening ’Services’ in Windows located under ’Administrative tools’ in the Control Panel.

3.2 The MobileStatus™ Configuration Window

The MobileStatus™ Server is configured and managed through the MobileStatus™ Configuration program.

Figure 3.2: The MobileStatus™ Configuration program.

The configuration of the MobileStatus™ Server is done by choosing the menu item ’Edit’

– ’Settings’.

Page 10 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

4.0 Settings

The configuration of the MobileStatus™ Server contains three tab sheets, which you

have to go through before completing the configuration:

1) Operator

2) E-mail 3) Web

The three tab sheets above are described in details in the following sections.

5.0 Operator On the ’Operator’ tab you can configure the web service URL, username and passwords

to the Netcom OpenAPI status web service. You must also input your Netcom customer ID.

Figure 5.0: MobileStatus™ Operator configuration.

6.0 E-mail On the ’E-mail’ tab you can specific configuration related to sending e-mails.

MobileStatus Server can send e-mail alerts in case of problems.

Page 11 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

Figure 6.0: MobileStatus™ E-mail configuration

Use e-mail alerting on errors:

If checked, MobileStatus Server will send e-mails to the recipients specified in the configuration in case of errors.

SMTP Server:

The SMTP server MobileStatus Server should use to send e-mails.

From address:

The e-mail address MobileStatus Server should use as the sender address.

Recipients: A semi-colon separated list of e-mail addresses which should receive e-mail alerts.

Username:

If your SMTP server requires login, enter the username here.

Password:

The password for the SMTP server.

Use SSL for SMTP: If checked, MobileStatus Server will use SSL encryption when communicating with the

SMTP server.

Port: The port number to connect to the SMTP server on. The default is 25.

Page 12 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

7.0 Web The 'Web' tab is used to configure the username and password for the web interface of the MobileStatus Server.

Figure 7.0: MobileStatus™ web interface configuration

If you want to use the web interface, you must configure a username and a password.

Without them, the web interface will be disabled. If you want to allow a support technician to log in to the web interface, you need to

enable the checkbox labeled "Allow remote support to access the web administration".

Username: The username you want to use to log in to the web interface.

Password:

The password you want to use to log in to the web interface.

Page 13 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

8.0 Manage service

Using the MobileStatus Server Configuration program you can stop and start the MobileStatus Server service. This provides a shortcut to managing the service state.

In the Edit menu open 'Manage service':

Figure 8.0: MobileStatus™ Server service management

Use the buttons to start and stop the MobileStatus Server service.

Page 14 of 14

MobileStatus™ Server Installation and Configuration Guide

© BluePosition ApS, Denmark, 2006 – 2011 – All rights reserved. MSS-NET-CG-UK-261

Appendix A: Web Access to the MobileStatus Server The MobileStatus™ Server can be accessed through the Internet via a standard web

browser, provided the firewall is configured for this facility, i.e. it is open for the specific source address.

The following syntax must be used:

http://IP address:Port/command, i.e. http://83.12.56.112:8093/administration

IP Address: The IP address is the official IP address or registered DNS name.

Port:

The port is the port number on which the MobileStatus Server web interface is

configured.

You must log in using the username and password configured using the MobileStatus Server configuration program.

Using the web interface it is possible to see debug information about the server's

knowledge of mobile phone status as well as configure the MobileStatus Server and any connected OCS MobileStatus clients.

It is also possible to stop and restart the MobileStatus Server and connected OCS

MobileStatus clients.