Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to...

72
nextiva.com/support USER MANUAL Nextiva Unity for Mac 3.3

Transcript of Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to...

Page 1: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

nextiva.com/support

USER MANUAL Nextiva Unity

for Mac 3.3

Page 2: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

2 | P a g e

© Nextiva, All Rights Reserved

Table of Contents

1 Introduction ................................................................................................................... 46

2 Overview ....................................................................................................................... 47

2.1 Key Features.......................................................................................................................... 47

2.2 System Requirements ........................................................................................................... 47

2.3 Software Requirement .......................................................................................................... 47

2.4 Hardware Requirements ....................................................................................................... 47

2.5 Network Requirement .......................................................................................................... 47

3 Install Java Provided by Apple Inc. .................................................................................. 48

4 Configure Security & Privacy ........................................................................................... 49

4.1 Allow Nextiva Unity app to be installed ................................................................................ 49

4.2 Allow network access to Nextiva Unity ................................................................................ 52

5 Installation ..................................................................................................................... 54

5.1 Introduction .......................................................................................................................... 54

5.2 License .................................................................................................................................. 54

5.3 Terms of the software license agreement ............................................................................ 55

5.4 Destination ............................................................................................................................ 56

5.5 Installation Type.................................................................................................................... 57

5.6 Confirm Login Details ............................................................................................................ 58

5.7 Summary ............................................................................................................................... 59

5.8 Launch Unity ......................................................................................................................... 60

5.9 Getting Started...................................................................................................................... 60

5.9.1 Entering Login Details ................................................................................................... 60

5.9.2 Entering Connection Details .......................................................................................... 61

5.9.3 Grant permission to access Mac Addressbook/Outlook contacts ................................ 63

5.10 Keep in Dock ......................................................................................................................... 63

Page 3: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

3 | P a g e

© Nextiva, All Rights Reserved

5.11 Check Java version from Nextiva Unity ................................................................................. 63

6 How to Retrieve Logs...................................................................................................... 64

6.1 From running application...................................................................................................... 64

6.2 Direct from “Nextiva Unity Client” folder ............................................................................. 66

7 How to Uninstall Nextiva Unity....................................................................................... 68

7.1 Go to Finder .......................................................................................................................... 68

7.2 Navigate to the Nextiva Unity application ............................................................................ 68

7.3 Move to Trash. ...................................................................................................................... 68

7.4 Authenticate file deletion ..................................................................................................... 69

7.5 Make sure that Nextiva Unity is not present in ‘Applications’. ............................................ 71

7.6 Clean-up ................................................................................................................................ 71

Page 4: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

4 | P a g e

© Nextiva, All Rights Reserved

List of figures

Figure 1 GateKeeper pop-up ........................................................................................................................ 49

Figure 2 Security & Privacy .......................................................................................................................... 50

Figure 3 Open with Installer ......................................................................................................................... 51

Figure 4 Firewall ........................................................................................................................................... 52

Figure 5 Allow incoming connections .......................................................................................................... 53

Figure 6 Introduction ................................................................................................................................... 54

Figure 7 License ............................................................................................................................................ 55

Figure 8 License Agreement ......................................................................................................................... 56

Figure 9 Destination ..................................................................................................................................... 57

Figure 10 Installation type ........................................................................................................................... 58

Figure 11 Confirm login details .................................................................................................................... 59

Figure 12 Summary ...................................................................................................................................... 60

Figure 13 Prompt to enter authentication details ....................................................................................... 61

Figure 14 Authentication settings ................................................................................................................ 61

Figure 15 Prompt to enter connection details ............................................................................................. 62

Figure 16 Network settings .......................................................................................................................... 62

Figure 17 Keep in Dock................................................................................................................................. 63

Figure 18 Check java version from Nextiva Unity ........................................................................................ 64

Figure 19 About Nextiva Unity ..................................................................................................................... 64

Figure 20 Logs Folder ................................................................................................................................... 65

Figure 21 Go to Folder ................................................................................................................................. 66

Figure 22 Enter path to Nextiva Unity folder ............................................................................................... 66

Figure 23 Logs folder .................................................................................................................................... 67

Figure 24 Finder ........................................................................................................................................... 68

Figure 25 Applications .................................................................................................................................. 68

Figure 26 Move to Trash .............................................................................................................................. 69

Figure 27 Name and Password .................................................................................................................... 70

Page 5: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

5 | P a g e

© Nextiva, All Rights Reserved

Figure 28 Nextiva Unity is not present in ‘Applications’ .............................................................................. 71

Figure 29 Delete ‘Nextiva Unity Client' folder ............................................................................................. 72

Page 6: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

6 | P a g e

© Nextiva, All Rights Reserved

1 Introduction This document is intended for end users who wish to use the ‘Nextiva Unity for Mac’ product. The basic steps to install, configure settings, retrieve logs, and uninstall are covered in this document under their respective sections.

Page 7: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

7 | P a g e

© Nextiva, All Rights Reserved

2 Overview

Nextiva Unity for Mac

“Nextiva Unity for Mac” is a Java client that combines call control, instant messaging and presence (IM&P), service configuration, enterprise support, and click-to-dial busy lamp field to enhance the user experience. Nextiva Unity improves workgroup collaboration, bringing users closer to each other and simplifying internal and external communication.

2.1 Key Features

• Call control • Access to Nextiva Directories • User Status [Busy Lamp Field] – Displays up to 30 users • Instant Messaging & Presence • Nextiva service configuration

2.2 System Requirements • Mac OS X 10.7 or higher • Intel Processor

2.3 Software Requirement • Apple-provided Java SE 6

2.4 Hardware Requirements • Minimum 128 MB RAM • Minimum 200 MB of disk space

2.5 Network Requirement • A working network card or Wi-Fi and Internet connectivity is necessary for running this

software.

Page 8: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

8 | P a g e

© Nextiva, All Rights Reserved

3 Install Java provided by Apple Inc. Before beginning the installation of Nextiva Unity from the downloaded installer, the user is advised to check if Java provided by Apple Inc. is installed on the system.

This can be done by navigating to the folder “/System/Library/Java/JavaVirtualMachines” (Please note that this folder is different from Java provided by Oracle which will usually be installed to the folder “/Library/Java/JavaVirtualMachines”) and checking if a folder named “1.6.0.jdk” exists. If this folder exists, skip to the next “Installation” section. If this folder does not exist, search for the latest version of “Java for OS X” and install from the official site. For example, Java for OS X 2014-001 can be downloaded from the following link: http://support.apple.com/kb/dl1572. Click the download button, install the package, and follow the instructions.

Page 9: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

9 | P a g e

© Nextiva, All Rights Reserved

4 Configure Security & Privacy

4.1 Allow Nextiva Unity app to be installed By default, the Mac ‘Security & Privacy’ setting only allows apps downloaded from the Mac App Store, and hence will not allow the user to install Nextiva Unity so the below alert will appear.

Figure 1 GateKeeper popup

The user may either change ‘Security & Privacy’ preferences as shown in the screenshot below,

Page 10: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

10 | P a g e

© Nextiva, All Rights Reserved

Figure 2 Security & Privacy

or the user can click the package and choose ‘Open With Installer’ as shown below.

Page 11: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

11 | P a g e

© Nextiva, All Rights Reserved

Figure 3 Open with Installer

Both methods will allow the installer to be opened.

Page 12: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

12 | P a g e

© Nextiva, All Rights Reserved

4.2 Allow network access to Nextiva Unity After installation of Nextiva Unity, navigate to the ‘Firewall’ tab under ‘Security & Privacy’ in ‘System Preferences’.

Figure 4 Firewall

Choose ‘Firewall Options…’. Check the box “Automatically allow signed software to receive incoming connections” as shown below.

Page 13: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

13 | P a g e

© Nextiva, All Rights Reserved

Figure 5 Allow incoming connections

Page 14: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

14 | P a g e

© Nextiva, All Rights Reserved

5 Installation 1. Locate and double-click the UnityClient.mpkg.zip (Mac) file to begin. Please contact Nextiva

if unsure of the location of this file. 2. Double click the UnityClient.mpkg 3. Follow the prompts on the screen to install the software. 4. After completing installation, open the Applications folder and click the Nextiva Unity icon.

5.1 Introduction The first step outlines an introduction. Click the ‘Continue’ button to proceed to the next step.

Figure 6 Introduction

5.2 License The next step shows the Nextiva Unity application suite Software License Agreement. Please make sure that you read the license agreement carefully before clicking the ‘Continue’ button to go to the next step.

Page 15: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

15 | P a g e

© Nextiva, All Rights Reserved

Figure 7 License

5.3 Terms of the software license agreement This step asks for confirmation that you understand and accept the Nextiva Unity Suite License Agreement. Click ‘Agree’ to continue with the installation.

Page 16: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

16 | P a g e

© Nextiva, All Rights Reserved

Figure 8 License agreement

5.4 Destination This step allows you to change the location where Nextiva Unity is installed. Click the ‘Continue’ button to proceed.

Page 17: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

17 | P a g e

© Nextiva, All Rights Reserved

Figure 9 Destination

5.5 Installation Type This step confirms the installation details and prompts the user to continue with the installation. Click the ‘Install’ button to install Nextiva Unity.

Page 18: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

18 | P a g e

© Nextiva, All Rights Reserved

Figure 10 Installation type

5.6 Confirm Login Details When installing Nextiva Unity, you may be asked to confirm the username and password of your system. If so, please enter these details and click ‘Install Software.’

Page 19: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

19 | P a g e

© Nextiva, All Rights Reserved

Figure 11 Confirm login details

5.7 Summary Once completing the above steps, Nextiva Unity is successfully installed on your system.

Page 20: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

20 | P a g e

© Nextiva, All Rights Reserved

Figure 12 Summary

5.8 Launch Unity After completing the installation, you will find Nextiva Unity in Finder > Applications. Double click to on the icon to launch Nextiva Unity.

5.9 Getting Started The first time Nextiva Unity is launched, you may be asked to enter authentication and connection details. This can be obtained from Nextiva.

5.9.1 Entering Login Details You will be prompted to enter authentication details when you first start Nextiva Unity, or if the login details entered were incorrect.

Page 21: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

21 | P a g e

© Nextiva, All Rights Reserved

Figure 13 Prompt to enter authentication details

You may be required to include the domain as part of your login ID. Please contact Nextiva if you are unsure of what your domain is.

Figure 14 Authentication settings

5.9.2 Entering Connection Details If the Nextiva connection details are not pre-configured, you will be asked to enter them manually, as shown below.

Page 22: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

22 | P a g e

© Nextiva, All Rights Reserved

Figure 15 Prompt to enter connection details

Please ensure that the address of the VOIP server of Nextiva is entered when entering the VoIP server details. If you are unsure of these details, please contact your provider.

Figure 16 Network settings

Page 23: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

23 | P a g e

© Nextiva, All Rights Reserved

Please note that you are not required to enter the Nextiva Unity Server Connections Details.

5.9.3 Grant permission to access Mac Address Book/Outlook contacts After entering connection details, Nextiva Unity may require the user to grant it permission to access Mac Address Book/Outlook contacts if installed. The user will be prompted to grant permission to Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for integration with Nextiva Unity, the user needs to grant permission when asked for it. The user may also decide against granting permission to Nextiva Unity to access contacts from these applications, and by doing so, Nextiva Unity will be unable to access contacts from these applications. When installing Nextiva Unity, if the user finds that it is stuck on ‘Loading Contacts,’ he may try and open the Mac Address Book/Outlook app and check if the prompt to grant permission is present, to which he must respond for Nextiva Unity to continue.

5.10 Keep in Dock You can select the ‘Keep in Dock’ option from the context menu, which means Nextiva Unity will always appear in the dock. To do this, simply right click the Nextiva Unity icon when the application is running and select ‘Keep in Dock,’ as shown below.

Figure 17 Keep in Dock

5.11 Check Java version from Nextiva Unity The user can check if the correct version of Java is installed on the system from the ‘About’ window from Help -> About menu. The version of Java, and the provider, can be seen as shown below in the highlighted region. Ensure that the Java provider is Apple Inc..

Page 24: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

24 | P a g e

© Nextiva, All Rights Reserved

Figure 18 Check java version from Unity

6 How to Retrieve Logs

6.1 From running application Start the ‘Nextiva Unity for Mac’ app. From ‘Help’ menu, select ‘About Nextiva Unity’.

Figure 19 About Unity

From the ‘About Nextiva Unity’ window, click on the folder icon to show the working folder contents. You may also navigate to the working folder using ‘Finder’. You can find the “logs” folder inside the “Nextiva Unity Client” folder as shown below.

Page 25: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

25 | P a g e

© Nextiva, All Rights Reserved

Figure 20 Logs Folder

Create a Zip folder by right clicking, and then selecting ‘Compress’ from the context menu. This zipped folder should be sent to Nextiva if requested.

Page 26: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

26 | P a g e

© Nextiva, All Rights Reserved

6.2 Direct from “Nextiva Unity Client” folder If the user is unable to start the Nextiva Unity application itself, the user can retrieve the logs as follows:

Select “Go to Folder” from the “Go” menu, or use the short key .

Figure 21 Go to Folder

Enter the folder path “/Library/Application Support/Nextiva Unity Client/” and click “Go”.

Figure 22 Enter path to Unity folder

You can find the “logs” folder inside the “Nextiva Unity Client” folder.

Page 27: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

27 | P a g e

© Nextiva, All Rights Reserved

Figure 23 Logs folder

Zip this folder by right clicking and selecting ‘Compress’ from the context menu. This zipped folder should be sent to Nextiva if requested.

Page 28: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

28 | P a g e

© Nextiva, All Rights Reserved

7 How to Uninstall Nextiva Unity

7.1 Go to Finder Go to Finder from the main dock.

Figure 24 Finder

7.2 Navigate to the Nextiva Unity application • Locate Nextiva Unity in the Applications folder.

Figure 25 Applications

7.3 Move to Trash

• Drag the Nextiva Unity image to the Trash folder, or right click on the image and select ‘Move to Trash’.

Page 29: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

29 | P a g e

© Nextiva, All Rights Reserved

Figure 26 Move to Trash

7.4 Authenticate file deletion You may be prompted to confirm the username and password of your system. If so, please enter these details and click ‘OK’.

Page 30: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

30 | P a g e

© Nextiva, All Rights Reserved

Figure 27 Name and Password

Page 31: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

31 | P a g e

© Nextiva, All Rights Reserved

7.5 Make sure that Nextiva Unity is not present in ‘Applications’.

Figure 28 Unity is not present in ‘Applications’

If Nextiva Unity is no longer present in the Applications folder then it has been successfully uninstalled.

7.6 Clean-up Also, perform a clean up by navigating to ‘Library’/‘Application Support’ and deleting the ‘Nextiva Unity Client’ folder as shown below.

Page 32: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

32 | P a g e

© Nextiva, All Rights Reserved

Figure 29 Delete ‘Unity Client' folder

Page 33: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

33 | P a g e

© Nextiva, All Rights Reserved

Figure 30 Check java version from Unity

8 How to Retrieve Logs

8.1 From running application Start ‘Unity for Mac’ app. From ‘Help’ menu, select ‘About Unity’.

Figure 31 About Unity

From the ‘About Unity’ window, click on the folder icon to show the working folder contents in a file chooser. You may also navigate to the working folder using ‘Finder’. You can find the “logs” folder inside “Unity Client” folder as shown below.

Page 34: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

34 | P a g e

© Nextiva, All Rights Reserved

Figure 32 Logs Folder

Zip this folder by secondary clicking, then selecting ‘Compress’ from the context menu. This zipped folder should be sent to Nextiva if requested.

Page 35: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

35 | P a g e

© Nextiva, All Rights Reserved

8.2 Direct from “Unity Client” folder If the user is unable to start Unity application itself, user can still retrieve the logs as follows:-

Select “Go to Folder” from the “Go” menu or use the short key .

Figure 33 Go to Folder

Enter the folder path “/Library/Application Support/Unity Client/” and click “Go”.

Figure 34 Enter path to Unity folder

You can find the “logs” folder inside the “Unity Client” folder.

Page 36: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

36 | P a g e

© Nextiva, All Rights Reserved

Figure 35 Logs folder

Zip this folder by secondary clicking, then selecting ‘Compress’ from the context menu. This zipped folder should be sent to Nextiva if requested.

Page 37: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

37 | P a g e

© Nextiva, All Rights Reserved

9 How to Uninstall Unity

9.1 Go to Finder Go to Finder from the main dock.

Figure 36 Finder

9.2 Navigate to the Unity application • Locate Unity in the Applications folder.

Figure 37 Applications

9.3 Move to Trash.

• Drag the Unity image to Trash or secondary click on the image and select Move to Trash.

Page 38: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

38 | P a g e

© Nextiva, All Rights Reserved

Figure 38 Move to Trash

9.4 Authenticate file deletion You may be prompted to confirm the user name and password of your system. If so, please enter these details and click OK.

Page 39: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

39 | P a g e

© Nextiva, All Rights Reserved

Figure 39 Name and Password

Page 40: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

40 | P a g e

© Nextiva, All Rights Reserved

9.5 Make sure that Unity is not present in ‘Applications’.

Figure 40 Unity is not present in ‘Applications’

If Unity is no longer present in the Applications folder then it has been successfully uninstalled.

9.6 Clean-up Also, perform a clean-up by navigating to ‘Library’/‘Application Support’ and deleting the ‘Unity Client’ folder as shown below.

Page 41: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

41 | P a g e

© Nextiva, All Rights Reserved

Page 42: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

42 | P a g e

© Nextiva, All Rights Reserved

Figure 41 Delete ‘Unity Client' folder

Table of Contents 1 Introduction ................................................................................................................... 46

2 Overview ....................................................................................................................... 47

2.1 Key Features.......................................................................................................................... 47

2.2 System Requirements ........................................................................................................... 47

2.3 Software Requirement .......................................................................................................... 47

2.4 Hardware Requirements ....................................................................................................... 47

2.5 Network Requirement .......................................................................................................... 47

3 Install Java provided by Apple Inc. .................................................................................. 48

4 Configure Security & Privacy ........................................................................................... 49

4.1 Allow Unity app to be installed ............................................................................................. 49

4.2 Allow network access to Unity .............................................................................................. 52

5 Installation ..................................................................................................................... 54

5.1 Introduction .......................................................................................................................... 54

5.2 License .................................................................................................................................. 54

5.3 Terms of the software license agreement ............................................................................ 55

5.4 Destination ............................................................................................................................ 56

5.5 Installation Type.................................................................................................................... 57

5.6 Confirm Login Details ............................................................................................................ 58

5.7 Summary ............................................................................................................................... 59

5.8 Launch Unity ......................................................................................................................... 60

5.9 Getting Started...................................................................................................................... 60

5.9.1 Entering Login Details ................................................................................................... 60

5.9.2 Entering Connection Details .......................................................................................... 61

5.9.3 Grant permission to access Mac Addressbook/Outlook contacts ................................ 63

5.10 Keep in Dock ......................................................................................................................... 63

5.11 Check Java version from Unity .............................................................................................. 63

Page 43: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

43 | P a g e

© Nextiva, All Rights Reserved

6 How to Retrieve Logs...................................................................................................... 64

6.1 From running application...................................................................................................... 64

6.2 Direct from “Unity Client” folder .......................................................................................... 66

7 How to Uninstall Unity ................................................................................................... 68

7.1 Go to Finder .......................................................................................................................... 68

7.2 Navigate to the Unity application ......................................................................................... 68

7.3 Move to Trash. ...................................................................................................................... 68

7.4 Authenticate file deletion ..................................................................................................... 69

7.5 Make sure that Unity is not present in ‘Applications’. ......................................................... 71

7.6 Clean-up ................................................................................................................................ 71

Page 44: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

44 | P a g e

© Nextiva, All Rights Reserved

List of figures

Figure 1 GateKeeper popup ......................................................................................................................... 49

Figure 2 Security & Privacy .......................................................................................................................... 50

Figure 3 Open with Installer ......................................................................................................................... 51

Figure 4 Firewall ........................................................................................................................................... 52

Figure 5 Allow incoming connections .......................................................................................................... 53

Figure 6 Introduction ................................................................................................................................... 54

Figure 7 License ............................................................................................................................................ 55

Figure 8 License agreement ......................................................................................................................... 56

Figure 9 Destination ..................................................................................................................................... 57

Figure 10 Installation type ........................................................................................................................... 58

Figure 11 Confirm login details .................................................................................................................... 59

Figure 12 Summary ...................................................................................................................................... 60

Figure 13 Prompt to enter authentication details ....................................................................................... 61

Figure 14 Authentication settings ................................................................................................................ 61

Figure 15 Prompt to enter connection details ............................................................................................. 62

Figure 16 Network settings .......................................................................................................................... 62

Figure 17 Keep in Dock................................................................................................................................. 63

Figure 18 Check java version from Unity ..................................................................................................... 64

Figure 19 About Unity .................................................................................................................................. 64

Figure 20 Logs Folder ................................................................................................................................... 65

Figure 21 Go to Folder ................................................................................................................................. 66

Figure 22 Enter path to Unity folder ............................................................................................................ 66

Figure 23 Logs folder .................................................................................................................................... 67

Figure 24 Finder ........................................................................................................................................... 68

Figure 25 Applications .................................................................................................................................. 68

Figure 26 Move to Trash .............................................................................................................................. 69

Figure 27 Name and Password .................................................................................................................... 70

Page 45: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

45 | P a g e

© Nextiva, All Rights Reserved

Figure 28 Unity is not present in ‘Applications’ ........................................................................................... 71

Figure 29 Delete ‘Unity Client' folder .......................................................................................................... 72

Page 46: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

46 | P a g e

© Nextiva, All Rights Reserved

Introduction This document is intended for end users who wish to use the ‘Unity for Mac’ product. The basic steps to install, uninstall, configure settings and retrieve logs are covered in this document under their respective sections.

Page 47: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

47 | P a g e

© Nextiva, All Rights Reserved

10 Overview

Unity for Mac

“Unity for Mac” is a Java client that combines call control, instant messaging and presence (IM&P), service configuration, enterprise support, click-to-dial busy lamp field to enhance the user experience. Unity improves workgroup collaboration, bringing users closer to each other and simplifying internal and external communication.

10.1 Key Features

• Call control • Access to BroadWorks Directories • User Status [Busy Lamp Field] – Displays up to 30 users • Instant Messaging & Presence • BroadWorks service configuration

10.2 System Requirements • Mac OS X 10.7 or higher • Intel Processor

10.3 Software Requirement • Apple-provided Java SE 6

10.4 Hardware Requirements • Minimum 128 MB RAM • Minimum 200 MB of disk space

10.5 Network Requirement • A working network card or Wi-Fi and internet connectivity is necessary for running this

software.

Page 48: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

48 | P a g e

© Nextiva, All Rights Reserved

11 Install Java provided by Apple Inc. Before proceeding with the installation of Unity from the downloaded installer, the user is advised to check if Java provided by Apple Inc. is installed on the system.

This can be done by navigating to the folder “/System/Library/Java/JavaVirtualMachines” ( Please note that this folder is different from Java provided by Oracle which will usually be installed to the folder “/Library/Java/JavaVirtualMachines” ) and see if a folder named “1.6.0.jdk” exists. If such a folder exists, skip to the next “Installation” section. Otherwise, search for the latest “Java for OS X” and install from the official site. For example, Java for OS X 2014-001 can be downloaded from the following link:- http://support.apple.com/kb/dl1572 . Click the download button, install the package and follow instructions.

Page 49: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

49 | P a g e

© Nextiva, All Rights Reserved

12 Configure Security & Privacy

12.1 Allow Unity app to be installed By default, the Mac ‘Security & Privacy’ setting is to allow only apps downloaded from Mac App Store and hence will not allow user to install Unity and shows an alert as below.

Figure 42 GateKeeper popup

The user may either change ‘Security & Privacy’ preferences as shown in the screenshot below,

Page 50: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

50 | P a g e

© Nextiva, All Rights Reserved

Figure 43 Security & Privacy

or can alternative click the package and choose open with Installer as shown below.

Page 51: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

51 | P a g e

© Nextiva, All Rights Reserved

Figure 44 Open with Installer

Either method will allow the installer to be opened.

Page 52: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

52 | P a g e

© Nextiva, All Rights Reserved

12.2 Allow network access to Unity After installation of Unity, navigate to ‘Firewall’ tab under ‘Security & Privacy’ in ‘System Preferences’.

Figure 45 Firewall

Choose ‘Firewall Options…’. Enable the check box “Automatically allow signed software to receive incoming connections” as shown below.

Page 53: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

53 | P a g e

© Nextiva, All Rights Reserved

Figure 46 Allow incoming connections

Page 54: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

54 | P a g e

© Nextiva, All Rights Reserved

13 Installation 5. Locate and double-click the UnityClient.mpkg.zip (Mac) file to extract. Please contact

Nextiva if unsure of the location of this file. 6. Double-click the UnityClient.mpkg 7. Follow the on-screen prompts to install the software. 8. After completing installation, open the Applications and click Unity icon.

13.1 Introduction The first step outlines an introduction. Click the ‘Continue’ button to proceed.

Figure 47 Introduction

13.2 License The next step shows the Unity application suite Software License Agreement. Please make sure that you read the license agreement carefully before proceeding to the next step by clicking the ‘Continue’ button.

Page 55: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

55 | P a g e

© Nextiva, All Rights Reserved

Figure 48 License

13.3 Terms of the software license agreement This step asks for confirmation that you understand and accept the Unity Suite License Agreement. Click ‘Agree’ to continue with the installation.

Page 56: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

56 | P a g e

© Nextiva, All Rights Reserved

Figure 49 License agreement

13.4 Destination This step allows you to change the location where Unity is installed. Click ‘Continue’ button to proceed.

Page 57: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

57 | P a g e

© Nextiva, All Rights Reserved

Figure 50 Destination

13.5 Installation Type This step confirms the installation details and prompts the user to proceed with the installation. Click the ‘Install’ button to install Unity.

Page 58: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

58 | P a g e

© Nextiva, All Rights Reserved

Figure 51 Installation type

13.6 Confirm Login Details When installing Unity, you may be prompted to confirm the user name and password of your system. If so, please enter these details and click Install Software.

Page 59: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

59 | P a g e

© Nextiva, All Rights Reserved

Figure 52 Confirm login details

13.7 Summary At this point Unity is successfully installed on your system.

Page 60: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

60 | P a g e

© Nextiva, All Rights Reserved

Figure 53 Summary

13.8 Launch Unity After completing the installation, you will find Unity in Finder > Applications. Double click to launch Unity.

13.9 Getting Started The first time Unity is launched, you may be prompted to enter authentication and connection details.

13.9.1 Entering Login Details You will be prompted to enter authentication details when you first start Unity or if the login details entered were incorrect.

Page 61: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

61 | P a g e

© Nextiva, All Rights Reserved

Figure 54 Prompt to enter authentication details

You may be required to include the domain as part of your login ID. Please contact Nextiva if you are unsure what this is.

Figure 55 Authentication settings

13.9.2 Entering Connection Details If the Nextiva connection details are not pre-configured, you will be prompted to enter them manually, as below

Page 62: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

62 | P a g e

© Nextiva, All Rights Reserved

Figure 56 Prompt to enter connection details

Please ensure that the address of the VOIP server of Nextiva is entered when entering the VoIP server details. Please contact your provider to confirm these details if unsure.

Figure 57 Network settings

Page 63: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

63 | P a g e

© Nextiva, All Rights Reserved

Please note that you are not required to enter the Unity Server Connections Details.

13.9.3 Grant permission to access Mac Addressbook/Outlook contacts After entering connection details Unity may require the user to grant it permission to access Mac Addressbook/Outlook contacts if installed. The user will be prompted to grant permission to Unity by the corresponding application to which the user has to respond. If the user wants Mac Addressbook/Outlook contacts available for integration with unity he has to grant permission when asked for. The user may also decide against granting permission to Unity to access contacts from these applications by doing so Unity will be unable to process contacts from thse applications. While installing Unity if the user finds that Unity is stuck on ‘Loading Contacts’ he may try and open Mac Addressbook/Outlook app and check if the prompt to grant permission is present to which he has to respond for Unity to continue.

13.10 Keep in Dock You can select the ‘Keep in Dock’ option from the context menu meaning Unity is always shown in the dock. To do this, simply secondary click the Unity icon when running and select Keep in Dock, as below.

Figure 58 Keep in Dock

13.11 Check Java version from Unity The user can check if the correct version of Java is installed on the system from About window from Help -> About menu. The version of Java and the provider can be seen as below in the highlighted region. Ensure that the Java provider is Apple Inc.

Page 64: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

64 | P a g e

© Nextiva, All Rights Reserved

Figure 59 Check java version from Unity

14 How to Retrieve Logs

14.1 From running application Start ‘Unity for Mac’ app. From ‘Help’ menu, select ‘About Unity’.

Figure 60 About Unity

From the ‘About Unity’ window, click on the folder icon to show the working folder contents in a file chooser. You may also navigate to the working folder using ‘Finder’. You can find the “logs” folder inside “Unity Client” folder as shown below.

Page 65: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

65 | P a g e

© Nextiva, All Rights Reserved

Figure 61 Logs Folder

Zip this folder by secondary clicking, then selecting ‘Compress’ from the context menu. This zipped folder should be sent to Nextiva if requested.

Page 66: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

66 | P a g e

© Nextiva, All Rights Reserved

14.2 Direct from “Unity Client” folder If the user is unable to start Unity application itself, user can still retrieve the logs as follows:-

Select “Go to Folder” from the “Go” menu or use the short key .

Figure 62 Go to Folder

Enter the folder path “/Library/Application Support/Unity Client/” and click “Go”.

Figure 63 Enter path to Unity folder

You can find the “logs” folder inside the “Unity Client” folder.

Page 67: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

67 | P a g e

© Nextiva, All Rights Reserved

Figure 64 Logs folder

Zip this folder by secondary clicking, then selecting ‘Compress’ from the context menu. This zipped folder should be sent to Nextiva if requested.

Page 68: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

68 | P a g e

© Nextiva, All Rights Reserved

15 How to Uninstall Unity

15.1 Go to Finder Go to Finder from the main dock.

Figure 65 Finder

15.2 Navigate to the Unity application • Locate Unity in the Applications folder.

Figure 66 Applications

15.3 Move to Trash.

• Drag the Unity image to Trash or secondary click on the image and select Move to Trash.

Page 69: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

69 | P a g e

© Nextiva, All Rights Reserved

Figure 67 Move to Trash

15.4 Authenticate file deletion You may be prompted to confirm the user name and password of your system. If so, please enter these details and click OK.

Page 70: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

70 | P a g e

© Nextiva, All Rights Reserved

Figure 68 Name and Password

Page 71: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

71 | P a g e

© Nextiva, All Rights Reserved

15.5 Make sure that Unity is not present in ‘Applications’.

Figure 69 Unity is not present in ‘Applications’

If Unity is no longer present in the Applications folder then it has been successfully uninstalled.

15.6 Clean-up Also, perform a clean-up by navigating to ‘Library’/‘Application Support’ and deleting the ‘Unity Client’ folder as shown below.

Page 72: Nextiva Unity for Mac 3 · Nextiva Unity by the corresponding application to which the user has to respond. If the user would like Mac Address Book/Outlook contacts available for

72 | P a g e

© Nextiva, All Rights Reserved

Figure 70 Delete ‘Unity Client' folder