Phonebook Sharing

Sharing phonebooks allows users of different XiVO servers to access the contacts in the phonebooks of the other XiVO servers.

../_images/phonebook_sharing_diagram.png

This procedure follows the Contact and Presence Sharing (but it’s not mandatory), so we will use the same conventions.

Open Phonebook Access

On each XiVO, you must have a Web Services User that authorizes access from another host (not by login/password). The phonebook access does not support login/password authorization.

../_images/create_user_ws_phonebook.png

This Web Services user will allow other XiVO servers to access the phonebook of this XiVO.

Configuring the Directories

For each remote XiVO a new phonebook has to be created in Configuration ‣ Management ‣ Directories

../_images/list_directory_phonebook.png
../_images/create_directory_phonebook.png

Note that the URL of the directory must contain restricted, not private, e.g:

http://192.168.1.125/service/ipbx/json.php/restricted/pbx_services/phonebook

Add a Directory Definition for Each Phonebook

To add a new directory definition, go to Services ‣ CTI Server ‣ Directories ‣ Definitions

../_images/list_definition_phonebook.png

In each directory definition, add the fields to match the other phonebooks:

../_images/create_definition_phonebook.png

Add the New Definitions to Your Users

We just defined the directories, now let’s use them:

../_images/list_direct_directories.png
../_images/create_direct_directories_phonebook.png

Check That Everything is Working

There is no further configuration needed, you should now be able to connect your XiVO Client and search phonebook contacts from the People Xlet.

Troubleshooting

Chances are that everything won’t work the first time, here are some interesting commands to help you debug the problem.

tail -f /var/log/xivo-dird.log
tail -f /var/log/nginx/xivo.access.log