System Administration Guide

45 Pages·2016·2.09 MB·English

akkadian Global Directory 3.0

System Administration Guide
Updated – July 19th, 2016
Copyright and Trademarks:
I. Copyright:
This website and its content is copyright © 2014 Akkadian Labs. All rights reserved.
Except with the prior written permission of Akkadian Labs, any redistribution or reproduction of
part or all of the contents of this website, including the redistribution or reproduction of any
documentation or other materials downloaded from this website, in any form and in any media, is
prohibited.
II. Trademarks:
Akkadian, the Akkadian logo and other trademark or service marks used on this website, whether
registered or not, are the property of Akkadian Labs and may not be used or reproduced without
the prior written permission of Akkadian.
aGD UG 07/10/2016 0001 © www.akkadianlabs.com/aGD
07/10/2016 0001 3.0.0 © 2016 Akkadian Labs

Task List for Installing and Configuring akkadian Global Directory 3.0 ............................................................ 5
Section 1.0 – System Requirements for akkadian Global Directory 3.0................................................................ 6
1.1 - Global Directory 3.0 – Server Requirements ................................................................................................. 6
1.2 – VMWare System Requirements ....................................................................................................................... 6
1.3 – Cisco Unified Communications Application Requirements ....................................................................... 6
1.4 – Supported Cisco IP Phones .............................................................................................................................. 6
1.5 – SMTP Requirements ........................................................................................................................................... 7
1.6 – Web Browser Requirements ............................................................................................................................ 7
1.7 – Firewall Ports ........................................................................................................................................................ 7
Section 2.0 – Deploying the akkadian Global Directory Virtual Appliance ........................................................... 8
Section 3.0 - akkadian Global Directory Initial System Configuration ................................................................. 18
3.1 – Logging into akkadian Global Directory ....................................................................................................... 18
3.2 – akkadian Global Directory Settings ............................................................................................................... 19
3.3 – akkadian Global Directory SSL Configuration ............................................................................................. 21
3.3.1 – akkadian Global Directory Certificate Signing Request ......................................................................... 21
3.3.2 – akkadian Global Directory Generating a Certificate .............................................................................. 22
3.3.3 – akkadian Global Directory Uploading Certificates.................................................................................. 22
3.4 – akkadian Global Directory Admin Users ...................................................................................................... 23
3.4.1 – akkadian Global Directory Create Admin User ....................................................................................... 23
3.4.2 – akkadian Global Directory Delete Admin User ....................................................................................... 23
3.5 – akkadian Global Directory Mobile Users Authentication ......................................................................... 24
3.5.1 – akkadian Global Directory Mobile User Authentication source .......................................................... 24
3.6 – akkadian Global Directory Licensing ............................................................................................................. 24
3.6.1 – akkadian Global Directory Add Admin User ............................................................................................ 24
3.7 – akkadian Global Directory Backup and Restore ........................................................................................ 25
3.7.1 – Generate Backup ........................................................................................................................................... 25
3.7.2 – Restore Database from Backup ................................................................................................................. 25
3.8 – akkadian Global Directory System Update.................................................................................................. 26
Section 4.0 - akkdian Global Directory Configuration ............................................................................................. 27
4.1 – Data Source ........................................................................................................................................................ 27
4.1.1 – Adding a Data Source ................................................................................................................................... 27
www.akkadianlabs.com 2
07/10/2016 0001 3.0.0 © 2016 Akkadian Labs
LDAP Data Source ....................................................................................................................................................... 28
CSV Data Source .......................................................................................................................................................... 29
Microsoft SQL Server Data Source .......................................................................................................................... 29
MySQL Server Data Source ....................................................................................................................................... 29
Cisco Communications Manager Data Source (UDS) ......................................................................................... 30
4.2 – Sync a Data Source ........................................................................................................................................... 31
4.2.1 – Schedule Data Source Sync ......................................................................................................................... 32
4.3.0 – Delete Data Source ....................................................................................................................................... 32
4.4 – Directory Listing ................................................................................................................................................. 33
4.4.1 – Directory Listing Search ............................................................................................................................... 33
4.5 – Dial Rules ............................................................................................................................................................. 34
4.5.1 – Add New Directory Dial Rules ..................................................................................................................... 35
4.5.2 – Edit Directory Dial Rules ............................................................................................................................... 35
4.5.3 – Delete Directory Dial Rules .......................................................................................................................... 36
4.6 – Directory Interface ............................................................................................................................................ 37
4.6.1 – Edit Default Directory Interface .................................................................................................................. 37
4.6.2 – Add New Default Directory Interface ........................................................................................................ 38
4.6.3 – Delete Directory Interface............................................................................................................................ 39
4.7 – Service URL's ...................................................................................................................................................... 40
4.7.1 – Add New Phone Services URL .................................................................................................................... 40
4.7.2 – Edit Phone Services URL .............................................................................................................................. 41
4.7.3 – Delete Phone Services URL ......................................................................................................................... 41
Section 5.0 - akkadian Global Directory User Profile............................................................................................... 42
5.1 – Edit Administrator User Profile ...................................................................................................................... 42
5.2 – Change Administrator User Password ......................................................................................................... 42
Glossary ......................................................................................................................................................................... 43
Authentication URL ................................................................................................................................................ 43
Cisco UDS ................................................................................................................................................................. 44
CSV ............................................................................................................................................................................. 44
CUCM ......................................................................................................................................................................... 44
Dial Rules .................................................................................................................................................................. 44
www.akkadianlabs.com 3
07/10/2016 0001 3.0.0 © 2016 Akkadian Labs
LDAP .......................................................................................................................................................................... 44
Login/Admin Roles.................................................................................................................................................. 44
MSSQL ....................................................................................................................................................................... 44
Publisher ................................................................................................................................................................... 44
Service URL .............................................................................................................................................................. 45
Subscriber ................................................................................................................................................................ 45

www.akkadianlabs.com 4
07/10/2016 0001 3.0.0 © 2016 Akkadian Labs
Task List for Installing and Configuring akkadian Global Directory 3.0

To install and configure akkadian Global Directory 3.0 complete the following tasks in the order
presented:

1. Review the requirements for deploying akkadian Global Directory in Section 1 – “System
Requirement for akkadian Global Directory”.
2. Install akkadian Global Directory 3.0. Refer to Section 2 – “Deploying the akkadian Global
Directory 3.0 Virtual Appliance”.

www.akkadianlabs.com 5
07/10/2016 0001 3.0.0 © 2016 Akkadian Labs
Section 1.0 – System Requirements for akkadian Global
Directory 3.0

1.1 - Global Directory 3.0 – Server Requirements
akkadian Global Directory is available as a Linux Virtual Appliance with support for VMware ESXi
4.x and above.

1.2 – VMWare System Requirements

akkadian Global Directory 3.0 virtual appliance is supported on the following:

 VMware vSphere 4.x/5.x(ESX/ESXi), vSphere 5.0 or higher
 8 GB virtual memory reserved
 80GB virtual disk
 2 virtual CPU with at least 2000 MHz reserved
 1 virtual NIC

1.3 – Cisco Unified Communications Application Requirements
Table 1.3.1
Application Supported Versions
Cisco Unified Communications 8.x – 11.x
Manager

1.4 – Supported Cisco IP Phones
 Cisco 7925
 Cisco 7937
 Cisco 794X/796X
 Cisco 797X
 Cisco 88XX
 Cisco 8961
 Cisco 9951
 Cisco 9971
 Cisco DX650
 Cisco DX70
 Cisco DX80
www.akkadianlabs.com 6
07/10/2016 0001 3.0.0 © 2016 Akkadian Labs

1.5 – SMTP Requirements
akkadian Global Directory requires an SMTP server to send users their initial password as well
as other important notifications. Ensure Global Directory is authorized to send mail via the
configured SMTP server.

1.6 – Web Browser Requirements
 Internet Explorer 9.x+
 Mozilla Firefox 20+
 Chrome

1.7 – Firewall Ports
If akkadian Global Directory is located behind a firewall, the ports in Table 1.6.1 are
required for proper communication.

Table 1.7.1
Traffic Port Direction
Application HTTP:80 Inbound  aGD
Web Access HTTPS:443
SSH TCP:22 Inbound  aGD
SMTP TCP:25 aGD  Outbound to Mail Server
FTP TCP:21 aGD  Outbound to FTP Server
SFTP TCP:22 aGD  Outbound to SFTP Server
LDAP TCP:389 aGD  LDAP Server
LDAP Global TCP:3268 aGD  LDAP Global Catalog Server
Catalog
HTTPS TCP:8443 aGD  CUCM UDS/AXL

www.akkadianlabs.com 7
07/10/2016 0001 3.0.0 © 2016 Akkadian Labs
Section 2.0 – Deploying the akkadian Global Directory Virtual
Appliance

akkadian Global Directory is supported as a virtual appliance on VMware ESXi versions 4.x and
above. The steps below will help guide you through the process of deploying the virtual
appliance; however, you should have an understanding of VMware or contact your VMware
administrator for assistance.

Table 2.0.1 – Akkadian Appliance Platform Login Credentials
Username: akkadianuser
Password: akkadianpassword

1. Download the latest akkadian Global Directory OVA to a location accessible by the
vSphere client.

2. From the vSphere client, select Deploy OVF Template from the File menu.

Figure 2.0.1 – Deploy OVF Template

3. Select the OVA from computer or network location and click Next to continue.

www.akkadianlabs.com 8
07/10/2016 0001 3.0.0 © 2016 Akkadian Labs
Figure 2.0.2 – OVA File Location

4. Review the License Agreement and click Next to continue.

Figure 2.0.3 – License Agreement

5. Specify the name and location for the VMware machine and click Next to continue.

www.akkadianlabs.com 9
07/10/2016 0001 3.0.0 © 2016 Akkadian Labs
Figure 2.0.4 – Specify name and location

6. Specify the VMware Host / Cluster and click Next to continue.

Figure 2.0.5 – Host/Cluster location

www.akkadianlabs.com 10