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

From innovaphone wiki
Jump to navigation Jump to search
No edit summary
 
(121 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{FIXME|reason=This article is still work in progress and the documentation has to be finished}}
==Applies To==
==Applies To==
This information applies to
This information applies to
* V13r1 an up
<!-- Keywords: enter keywords, foreign translations and/or synoyms not appearing in the article here for better search results -->
== Objective ==
Setting up various PBXs for many customers, which are using only one AP!


* V13


<!-- Keywords: enter keywords, foreign translations and/or synoyms not appearing in the article here for better search results -->
'''System Requirements'''
 
Virtual Machines (HyperV, VMWare) or Physical Devices with SSD.


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


'''This article is still in progress !!!'''
==Setting up Application platform & administrative PBX ==


===Problem Details===
'''Download respective images'''


Setting up various PBX for many customers using one AP
Select in the [https://store.innovaphone.com/release/download.htm innovaphone store]


===System Requirements===
* Firmware / IPVA
* App Platform / App Platform x86_64
* Download Package


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


===Installation===
'''Setup administrative PBX & Application Platform'''


You already setup one PBX and one Application Platform (Used by provider)
Setup as learned in our courses.
In this manual I used:
*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!!!


PBX Name: hq
==Configuration of customer PBXs==


System Name: world.local
Every customer will get his own PBX


DNS PBX: hq.world.local


DNS App Platform: apps.world.local
''' Add domain to devices'''


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


1. Install a second PBX. Every customer receives his own Master PBX (Only network configuration, manual installation)
Add Customer Domain (company01.com).
[or through Gateway Provisioning.  (Punkt 3: oder besser im Install dasGerät einer bestehenden Konfiguration hinzufügen.)]]


In my case I use:
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.


PBX Name: stuttgart
[[Image:AddDomain.png]]


System Name: europe.local


DNS PBX: stuttgart.europe.local
'''Setup PBX'''


2. Add Customer Domain in Devices
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


[[Image:AddDomain.png]]


3. Insert device Registration URL into Gateway
'''Connect PBX to devices'''
 
Insert Device Registration URL


[[Image:DeviceRegistration.png]]
[[Image:DeviceRegistration.png]]


4. Assign category to device


[[Image:AddCategory.png]]
'''Edit device settings'''
 
Open devices on your adminpbx.
The MAC address of your new device is shown.
Choose Name and Domain.


5. Set redirection from PBX Advanced GUI to myApps when inserting DNS
[[Image:EditDeviceEntry.png]]


[[Image:ConfigChangeHTTP0.png]]


[[Image:ConfigWrite.png]]
'''Create new category and assign it to device'''


[[Image:ConfigActivate.png]]
[[Image:AddCategory.png]]


6. Admin User auf PBX anlegen
[[Image:AssignCategory.png]]


7. Log into myApps


Therefore use your new DNS. In my case stuttgart.europe.local
'''Change main page to myApps'''


8. Connect App Platform. SMTP has to be configured. Please use HTTPS.
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


Open PBX Manager
[[Image:ConfigChangeHTTP0.png]]


Add App Platform. Use Host of your AP Platform.


[[Image:PBXManager-AP.png]]
''' Connect new PBX to Application Platform'''


Now you can see in your Apps App that the Domain is registered:
Login to your new PBX, using HTTPS! (e.g. pbx.company01.com)
Open PBX Manager
Connect App Platform


[[Image:RegisteredAccessDomain.png]]
Use Host of your AP Platform.  


9. Create Devices instance and connect Devices and Devices API to instance
[[Image:ConnectAP.png]]


[[Image:ConnectAP2.png]]


Create a second Device Instance
Now you can see in your Apps App that the Domain is registered:


Start second Device Instance
[[Image:RegisteredAccessDomain.png]]


[[Image:CreateSecondDeviceInstance.png]]
Verify received eMail and check that App Platform is connected.


[[Image:CreateSecondDeviceInstance2.png]]


Create App Devices and DevicesApi
'''Create Devices & Devices Api Object'''


[[Image:DevicesAndDevicesApi.png]]
*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"


**Second Object "Devices Api**
***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"


10. Apps Instanzen in der App Platform für Kunden hinzufügen
[[Image:CreateApps.png]]


Both apps have to be connected.




11. Apps über PBX Manager auf der Kunden PBX anlegen
''' Open devices on your new PBX'''
12. Template anlegen (Admin und User) mit Visibility und Apps evtl. Lics
*Open new myApps and choose Devices for your home screen
13. Geräte Konfiguration definieren


== 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

Retrieved from "https://wiki.innovaphone.com/index.php?title=Howto13r1:Hosting_-_Central_AP_for_multiple_customers&oldid=69623"