¶ Installation
¶ Introduction
The EasyConnect app is installed in just a few clicks and with some configuration in myApps the application will be up and running in no time.
The first step is to install the app. This can be done through the official innovaphone App Store or through XQTING’s App Store. Next, we have to create an instance for the application. Finally, we create a PBX app object so we can access the app for configuration.
We recommend reading through the installation chapter instead of following our instructions blindly from the get-go.
¶ Installing the App
Installing the EasyConnect app happens via the App Store. This requires a user with access to the AP Manager app.
Take the following steps to install EasyConnect from the App Store:
- Open the AP Manager app
The App Platform Manager (AP Manager) application is one of many apps included with the innovaphone PBX and can be accessed via the ‘Apps’ dashboard in the bottom-right corner of the myApps landing page. - Click on App Platform > App Store (2)
- On the left-hand side, click on All apps
- A list of companies should appear
- Click on XQTING (5)
- A list of apps developed by XQTING should appear
- Click on EasyConnect (7)
- In the dropdown menu on the right-hand side, select the latest version of EasyConnect (8)
- Click Install (9)
- Accept the terms of use
- Click Install
- Wait for the app to be installed
You now have EasyConnect installed.
The next step is to create an app instance (see “Creating an App Instance” on this page).
¶ Updating the App
Updating the EasyConnect app is done in just a few clicks using the official innovaphone App Store.
To get the latest version of the app, take the following steps:
- Open the AP Manager app
- Click on App Platform > App Store
- On the left-hand side, click on Installed apps
- A list of developers should appear
- Click on XQTING
- A list of installed apps developed by XQTING should appear
- Click on EasyConnect
- In the dropdown menu on the right-hand side, select the latest version of EasyConnect
- Click Update
- Wait for the app to be updated
You have updated EasyConnect to the latest version.
¶ Creating an App instance
To start using EasyConnect, an instance needs to be created and started.
Follow these steps to create an app instance:
- Open the AP Manager app
- On the left-hand side, select the EasyConnect app (2)
- Click on Instances > Add (3)
- Fill out the form:
- Name: easyconnect
- Domain: <your domain>
If you are unsure about what to fill out in Domain, you can find your domain by opening the hamburger menu (top-right corner) of the Users Admin app. - Password: <a random password>
- Database password: <a random password>
The passwords are required to save the form, but the values don’t matter as the PBX Manager plugin of EasyConnect will configure this for you.
The other fields (Webserver path, Database name and Database user) are automatically generated, and should not be modified.
- Click Save (5)
- Select the newly created instance (it should become highlighted in blue) (6)
- Click Manage > Start (7)
You now have an instance of EasyConnect running.
Next, we have EasyConnect’s PBX Plugin create a PBX App object for us (see “Creating a PBX App Object for the App Instance” below) so we can open the app and start to configure it.
¶ Creating a PBX App Object for the App Instance
To use the app of an App instance, an App object needs to be created on the PBX. Experienced users know how to do this themselves, but we discourage that because there’s a lot of configuration to be done on the object. Instead, we recommend creating an App object using EasyConnect’s PBX Manager plugin.
To create an App object, take the following steps:
- Open PBX Manager
- Click on AP easyconnect
- Click on Create the object now
You now have created an App object.
Next, we add the EasyConnect app to a user template so the app becomes visible to users created with that template.
If you get an error message saying an object with the same name already exists, it means there was a past installation of EasyConnect. EasyConnect is unable to delete its own app object, so the existing app object needs to be deleted manually before attempting to create the object for the new EasyConnect installation.
¶ Add the App to a Template
To make the app available from the home screen for users, we have to add it to a template. We recommend making the EasyConnect app available only to administrators.
To add the App to a user template, take the following steps:
- Open PBX Manager
- Click on Templates
- Select the template for users you want to give access to the App
- Open Apps
- Select easyconnect
- Click OK
The EasyConnect app is now available from the All apps page for users created with the template to which you’ve added EasyConnect.
¶ Using the XQTING App Store
Publishing a new version of EasyConnect to the innovaphone App Store can take some time. The fastest way to get access to the latest features and bug fixes is through the XQTING App Store. The following steps explain how to change the configuration of your App Store so it makes use of the XQTING App Store:
- Click on Settings in the App Platform section of the header menu
- In the General tab, replace the App Store URL with the URL that points to the XQTING App Store.
We recommend to safekeep the current value so you can restore it at a later time. Most likely, the URL https://store.innovaphone.com/release/download/apps.json is the current value.
After you have stored the current URL, replace it by the following and save the changes.
https://00056-apps.innovaphone.com/xqting.be/appstore/download/apps.json
Anytime you want to have access to the latest EasyConnect version, you can configure your App Store URL parameter to the XQTING App Store.
¶ Next chapter