Share a PBX Equipment between several customer companies

This article is intended for resellers who wish to share a PBX (OXO Connect, OXO Connect Evolution, or OmniPCX Enterprise) between several customer companies (multi-company).

The numbering plan and telephony features provided by the PBX are common to all the customer companies.

To share a PBX between customer companies:

1. Declare the PBX in Rainbow (see: Declaring the PBX in Rainbow)
2. Connect the PBX to Rainbow (see: Connecting the OmniPCX Enterprise to Rainbow)
3. Associate the PBX to the target customer companies (see: Associating the PBX to the customer companies)

After sharing the PBX, you can:

• Display the number of customer companies to which the PBX is associated (see: Displaying the number of customer companies sharing a PBX)
• Remove the PBX from a customer company (see: Removing a PBX from a customer company)

Before beginning, you must know the following:

• Dialing information (country, national prefix, international prefix, outbound prefix)
• Numbering rules
• For OXO Connect/OXO Connect Evolution Evolution taken from your fleet: The couple fleet reference and installation reference enabling to identify the PBX in your fleet
• For OmniPCX Enterprise: The connection parameters to the public network:
  • In case of direct access: The DNS server IP address
  • In case of access via a HTTP proxy (on customer request): The HTTP proxy parameters (IP address, credentials, and port)

Declaring the PBX in Rainbow

1. From the Rainbow administration interface, click on Equipments in the left panel.
2. In the right part of the window, click on the Shared tab.
3. Click on Create.
4. In the Server name field, enter the name of the PBX.
5. In the Server type field, select the type of PBX.
   
6. Select the Activate WebRTC gateway check box (the WebRTC gateway is used for Rainbow VoIP call handling), read the license agreement, and click on I accept to continue.
   Note: This operation can also be performed later, when installing and configuring the WebRTC gateway.
7. If the PBX is an OmniPCX Enterprise, or an OXO Connect not taken from your fleet: Leave the Specify equipment ID and activation code check box unselected. An equipment ID and activation code will be automatically generated after the PBX declaration.
8. If the PBX is an OXO Connect/OXO Connect Evolution taken from your fleet: Select the Specify equipment ID and activation code check box, and complete the equipment ID and activation code with the same value: fleet reference-installation reference (for example: ALE12-1234.5678.90 where ALE12 is the fleet reference and 1234.5678.90 is the installation reference).
9. Complete the Dialing information:
   Country: This information is used to translate national phone numbers into canonical numbers
   National prefix: First digit(s) dialed when calling a subscriber inside the country configured in the Country field
   International prefix: First digit(s) dialed when calling a subscriber outside the country configured in the Country field
   Outbound prefix: Prefix used for outgoing calls
10. Click on Next.
11. Define the numbering rules applying to outgoing communications from Rainbow (for details, see: How Do I Configure the PBX Numbering Rules ?).
12. Click on Create.
    If the Specify equipment ID and activation code check box has not been selected, a pop-up window opens with the equipment ID and activation code generated by Rainbow. Click on Close.
    
    Note: This information will be required when Connecting the PBX to Rainbow.

The PBX is created and displayed in the equipment list of the Shared tab with the Pending status.

Connecting the PBX to Rainbow

Connecting an OmniPCX Enterprise to Rainbow

1. Connect to the OmniPCX Enterprise with the root account.
2. Run the netadmin -m command.
3. Configure the network parameters (DNS server or HTTP proxy).
4. Open the OmniPCX Enterprise configuration tool with the mtcl account (login and password).
5. Select Rainbow, enable Rainbow, and enter the equipment ID and activation code.

For more details on the OmniPCX Enterprise configuration, see: Associate an OmniPCX Enterprise Equipment to a Company.

Once the OmniPCX Enterprise connected to Rainbow, its connection status changes to Running in the equipment list.

Connecting an OXO Connect/OXO Connect Evolution to Rainbow

When the PBX (OXO Connect or OXO Connect Evolution) is taken from your fleet, no configuration is required: The Rainbow parameters are automatically filled on PBX, and Rainbow is enabled by default.

When the PBX is an OXO Connect not taken from your fleet, connect to the PBX via the OXO Connect Console Management (OMC), enable Rainbow, and enter the equipment ID and activation code generated at PBX declaration in Rainbow. For more details on the PBX configuration, see: Associate an OXO Connect or OXO Connect Evolution Equipment to a Company.

Once the PBX connected to Rainbow, the PBX connection status changes to Running in the equipment list.

Associating the PBX to the customer companies

1. From the Rainbow administration interface, click on Customer companies at the bottom of the left panel.
2. In the customer list, click on the name of the customer company to associate to the PBX.
3. In the left panel, click on Communication.
4. In the right part of the window, click on the Shared tab.
5. In the Server type field, select the type of PBX.
6. In the Equipment field, select the PBX.
7. Click on Create.
   The PBX is created and displayed in the equipment list of the customer company with the Shared column set to Yes.

Repeat the procedure above to associate the PBX to other customer companies.

Displaying the number of customer companies sharing a PBX

1. From the Rainbow administration interface, click on Equipments in the left panel.
2. In the right part of the window, click on the Shared tab.
   The Companies column indicates the number of customer companies sharing this PBX. In the example below, the PBX OXO90 is shared between three customer companies.

Removing a PBX from a customer company

1. From the Rainbow administration interface, click on Customer companies at the bottom of the left panel.
2. In the customer list, click on the name of the customer company associated to the target PBX.
3. In the left panel, click on Communication.
4. In the right part of the window, click on the Comm. Servers tab.
5. Move your mouse over the target PBX, click on , and select Remove an equipment.
6. Click on Remove.
   

   The PBX is removed from the equipment list (Comm. servers tab).