Howto13r1:Hosting - Central AP for multiple customers: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
 
(56 intermediate revisions by 5 users not shown)
Line 1: Line 1:
==Applies To==
==Applies To==
This information applies to
This information applies to
* V13r1 an up
* V13r1 an up
'''This article will be rewritten on 15.08.2019. On Friday 16.08.2019 all information is in.'''
<!-- Keywords: enter keywords, foreign translations and/or synoyms not appearing in the article here for better search results -->
<!-- Keywords: enter keywords, foreign translations and/or synoyms not appearing in the article here for better search results -->


Line 11: Line 7:


Setting up various PBXs for many customers, which are using only one AP!
Setting up various PBXs for many customers, which are using only one AP!


'''System Requirements'''
'''System Requirements'''
Line 16: Line 13:
Virtual Machines (HyperV, VMWare) or Physical Devices with SSD.
Virtual Machines (HyperV, VMWare) or Physical Devices with SSD.


If you set up a Hosting scenario, please check our [http://wiki.innovaphone.com/index.php?title=Howto:V13_Hosting Considerations]


==Setting up Application platform & administrative PBX ==
==Setting up Application platform & administrative PBX ==
Line 26: Line 24:
* App Platform / App Platform x86_64
* App Platform / App Platform x86_64
* Download Package
* Download Package
'''Considerations before setup'''
* Do you need an internal DNS? Are you using phones inside your LAN? [http://wiki.innovaphone.com/index.php?title=Howto:V13_Installation_Scenarios Installation Scenarios]
* Are you using a DHCP Server or fixed IPs? [http://wiki.innovaphone.com/index.php?title=Reference13r1:Concept_App_Platform#App_Platform_-_x86-64_.28Virtual_Machine.29 App Platform]
* Be sure that external DNS exists for every PBX, one for your adminpbx and one for your App Platform
* Think about your Internet Access Scenario and Certificates
* etc.
* etc.




Line 59: Line 47:
==Configuration of customer PBXs==
==Configuration of customer PBXs==


Every customer receives his own PBX
Every customer will get his own PBX




Line 66: Line 54:
Open devices in your admin PBX (adminpbx.cloud.com).  
Open devices in your admin PBX (adminpbx.cloud.com).  


Add Customer Domain (pbx.company01.com).
Add Customer Domain (company01.com).


Choose a password (will be used as admin password).
Choose a password. This password will be used for devices. If you select "Deploy the domain password on all devices" than it will be used as admin password as well.


[[Image:AddDomain.png]]
[[Image:AddDomain.png]]
Line 76: Line 64:


Setup another machine (e.g. IPVA) and choose "Do manual configuration" or "Update and network settings only"  
Setup another machine (e.g. IPVA) and choose "Do manual configuration" or "Update and network settings only"  
We used the following options:  
*Set pbx settings. We used the following options:  
*System name: pbx.company01.com
**System name: company01.com
*PBX name: pbx
**PBX name: pbx
*DNS PBX: pbx.company01.com
**DNS PBX: pbx.company01.com
*Use as Domain
*Set PBX password
*Create config template "Config Admin". Add Apps to template.
*Create admin user and add template to user




'''connect PBX to devices'''
'''Connect PBX to devices'''


Insert Device Registration URL
Insert Device Registration URL
Line 89: Line 81:




'''Edit device settings'''


 
Open devices on your adminpbx.  
4. Go back to your main PBX (hq.world.local). Open Devices App.  
The MAC address of your new device is shown.
You see the MAC of your new device
Choose Name and Domain.


[[Image:EditDeviceEntry.png]]
[[Image:EditDeviceEntry.png]]


5. Assign category to device


[[Image:AddCategory.png|1000px]]
'''Create new category and assign it to device'''


6. Set redirection from PBX Advanced GUI to myApps
[[Image:AddCategory.png]]
Therefore go to your new PBX.
Afterwards if you insert your DNS you get redirected to myApps directly.  


[[Image:ConfigChangeHTTP0.png]]
[[Image:AssignCategory.png]]


[[Image:ConfigWrite2.png]]


[[Image:ConfigActivate.png]]
'''Change main page to myApps'''


7. Activate PBX and create admin user for new PBX.
Till now, inserting the DNS of PBX shows Advanced GUI.
Therefore open Devices App and create a new User via Advanced GUI.
To change this insert the following commands:
In my case I used:
*!config change HTTP0 /home PBX0/APPCLIENT/appclient.htm
*!config write
*!config activate


''PBX Name: stuttgart''
[[Image:ConfigChangeHTTP0.png]]


''System Name: europe.local''


''DNS PBX: stuttgart.europe.local'
''' Connect new PBX to Application Platform'''


8. Assign Apps to User (inside Userobject) 
Login to your new PBX, using HTTPS! (e.g. pbx.company01.com)
 
Open PBX Manager
8. Log into myApps. Please use HTTPS.  
Connect App Platform
 
Therefore use your new DNS. In my case stuttgart.europe.local
 
9. Connect App Platform.


Open PBX Manager
Use Host of your AP Platform.


Add App Platform. Use Host of your AP Platform.  
[[Image:ConnectAP.png]]


[[Image:PBXManager-AP.png]]
[[Image:ConnectAP2.png]]


Now you can see in your Apps App that the Domain is registered:  
Now you can see in your Apps App that the Domain is registered:  


[[Image:RegisteredAccessDomain.png]]
[[Image:RegisteredAccessDomain.png]]


Verify received eMail and check that App Platform is connected.
Verify received eMail and check that App Platform is connected.


10. Create two new App objects on your new PBX via Device/Advanced GUI.
1. Object
Devices:
Long Name: Devices
name: devices
Critical activated
Hide from LDAP activated
Example URL: https://apps.world.local/world.local/devices/innovaphone-devices
Websocket activated
2.Object
Devices:
Long Name: DevicesApi
name: devices-api
Critical activated
Hide from LDAP activated
Example URL: https://apps.world.local/world.local/devices/innovaphone-devices-api
Websocket activated
11. Create new instance of needed App
Example: contacts
[[Image:ContactsInstance.png]]
Start instance
add Contacts, Contacts-Admin and Contacts-SearchApi


[[Image:Contacts3.png]]
'''Create Devices & Devices Api Object'''


*Create both App objects on your new customer pbx (you can use Devices App from your adminPBX to use the AdvancedGUI).
**First Object "Devices"''
***Long Name: Devices
***Name: devices
***Critical activated
***Hide from LDAP activated
***Example URL: https://apps.cloud.com/cloud.com/devices/innovaphone-devices
***Websocket activated
***Password has to be the same as you choosed when "adding your Domain to Devices"


12. Create App instances (for every customer and App you need)
**Second Object "Devices Api**
More information can be find here: [http://wiki.innovaphone.com/index.php?title=Course13:IT_Connect_-_13_Design_of_the_Application_Platform#Installing_an_App| Installing an App]
***Long Name: DevicesApi
***Name: devices-api
***Critical activated
***Hide from LDAP activated
***Example URL: https://apps.cloud.com/cloud.com/devices/innovaphone-devices-api
***Websocket activated
***Password has to be the same as you choosed when "adding your Domain to Devices"


12. Create Apps with PBX Manager (for every App you need)
[[Image:CreateApps.png]]


13. Create templates (Admin and User) with Visibility, Apps and Licenses.  
Both apps have to be connected.


14. Configure customers PBX / Device.


You can open an App via your Apps App
''' Open devices on your new PBX'''
*Open new myApps and choose Devices for your home screen


[[Image:Apps.png]]
== Create instances of needed App services ==
Create
*for every customer
*for every needed app
*a new app service instance


===Known Problems===
More information can be found here: [http://wiki.innovaphone.com/index.php?title=Course13:IT_Connect_-_13_Design_of_the_Application_Platform#Installing_an_App Installing an App]


<!-- == Related Articles == -->
== Related Articles ==
*[[Howto:V13_Hosting]]
* [[Reference13r1:Concept_App_Platform]]
* [[Howto:V13_Hosting_-_Dedicated_AP_for_every_customer]]
* [[Reference13r1:Concept_Talking_to_the_v13_Application_Platform_using_PHP]]


[[Category:Howto|{{PAGENAME}}]]
[[Category:Howto|{{PAGENAME}}]]

Latest revision as of 14:19, 10 November 2023

Applies To

This information applies to

  • V13r1 an up

Objective

Setting up various PBXs for many customers, which are using only one AP!


System Requirements

Virtual Machines (HyperV, VMWare) or Physical Devices with SSD.

If you set up a Hosting scenario, please check our Considerations

Setting up Application platform & administrative PBX

Download respective images

Select in the innovaphone store

  • Firmware / IPVA
  • App Platform / App Platform x86_64
  • Download Package


Setup administrative PBX & Application Platform

Setup as learned in our courses.

  • Master PBX to start a new system with external App Platform
  • Network settings
  • Connect AP platform
  • App Platform is being installed
  • innovaphone PBX options. We used the following options:
    • Domain name: cloud.com
    • PBX Name: adminpbx
    • DNS PBX: adminpbx.cloud.com
    • DNS AP: apps.cloud.com
  • Save passwords
  • E-mail account
  • Apps are installed
  • PBX and AP Certificates
  • Test mode
  • Done!!!

Configuration of customer PBXs

Every customer will get his own PBX


Add domain to devices

Open devices in your admin PBX (adminpbx.cloud.com).

Add Customer Domain (company01.com).

Choose a password. This password will be used for devices. If you select "Deploy the domain password on all devices" than it will be used as admin password as well.

AddDomain.png


Setup PBX

Setup another machine (e.g. IPVA) and choose "Do manual configuration" or "Update and network settings only"

  • Set pbx settings. We used the following options:
    • System name: company01.com
    • PBX name: pbx
    • DNS PBX: pbx.company01.com
  • Use as Domain
  • Set PBX password
  • Create config template "Config Admin". Add Apps to template.
  • Create admin user and add template to user


Connect PBX to devices

Insert Device Registration URL

DeviceRegistration.png


Edit device settings

Open devices on your adminpbx. The MAC address of your new device is shown. Choose Name and Domain.

EditDeviceEntry.png


Create new category and assign it to device

AddCategory.png

AssignCategory.png


Change main page to myApps

Till now, inserting the DNS of PBX shows Advanced GUI. To change this insert the following commands:

  • !config change HTTP0 /home PBX0/APPCLIENT/appclient.htm
  • !config write
  • !config activate

ConfigChangeHTTP0.png


Connect new PBX to Application Platform

Login to your new PBX, using HTTPS! (e.g. pbx.company01.com) Open PBX Manager Connect App Platform

Use Host of your AP Platform.

ConnectAP.png

ConnectAP2.png

Now you can see in your Apps App that the Domain is registered:

RegisteredAccessDomain.png

Verify received eMail and check that App Platform is connected.


Create Devices & Devices Api Object

  • Create both App objects on your new customer pbx (you can use Devices App from your adminPBX to use the AdvancedGUI).

CreateApps.png

Both apps have to be connected.


Open devices on your new PBX

  • Open new myApps and choose Devices for your home screen

Create instances of needed App services

Create

  • for every customer
  • for every needed app
  • a new app service instance

More information can be found here: Installing an App

Related Articles