Associate an OmniPCX Enterprise equipment to a company

This article is intended for resellers who wish to associate an OmniPCX Enterprise equipment to a customer company.

To associate an OmniPCX Enterprise to a customer company:

1. On Rainbow, declare the OmniPCX Enterprise in the target customer company (see: Declaring the PBX in the customer company).
   This will generate an equipment ID and activation code for your OmniPCX Enterprise.
2. On the OmniPCX Enterprise, configure the public network parameters, enable the Rainbow agent, and enter the Rainbow connection settings (see: Connecting the OmniPCX Enterprise to Rainbow).
   The Rainbow agent, embedded in the OmniPCX Enterprise, is used to establish a permanent secure connection with the Rainbow Cloud infrastructure.

Before beginning, you must know the following:

• Dialing information (country, national prefix, international prefix, outbound prefix)
• Numbering rules
• 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 or FQDN, credentials, and port)

Declaring the OmniPCX Enterprise in the 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 to associate to the OmniPCX Enterprise.
3. In the left panel, click on Communication.
4. In the right part of the window, click on the Comm. Servers tab.
5. Click on Create.
6. In the Server name field, enter the name of the OmniPCX Enterprise.
7. In the Server type field, select OmniPCX Enterprise.
8. 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.
9. Leave the Specify equipment ID and activation code check box unselected. An equipment ID and activation code will be automatically generated after the OmniPCX Enterprise declaration in the customer company.
10. 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
11. Click on Next.
12. Define the numbering rules applying to outgoing communications from Rainbow (for details, see: How Do I Configure the PBX Numbering Rules ?).
13. Click on Create.
    A pop-up window opens with the equipment ID and activation code. Click on Close.
    
    Note: This information will be required when Connecting the OmniPCX Enterprise to Rainbow.

The OmniPCX Enterprise is created and displayed in the equipment list with the Pending status.

Connecting the OmniPCX Enterprise to Rainbow

Configuring network parameters

The DNS server IP address or HTTP proxy settings (if requested by the customer) must be configured on the OmniPCX Enterprise via the netadmin command. They are used when the Rainbow agent, embedded in the OmniPCX Enterprise, connects to the Rainbow Cloud infrastructure.

1. Connect to the OmniPCX Enterprise with the root account.
2. Run the netadmin -m command.
3. If the OmniPCX Enterprise is connected to the public network through an HTTP proxy, select 15. 'Proxy configuration' > 2. 'Create/Update Configuration', and enter successively:
   The HTTP proxy IP address or FQDN
   The port used to access the HTTP proxy
   The credentials (login/password) to access the HTTP proxy
   
4. If the OmniPCX Enterprise is directly connected to the public network, or if the HTTP proxy address is an FQDN, select 14. 'DNS configuration' > 2. 'Create/Update DNS setup', and enter the DNS server IP address:
   
5. If the communication server is duplicated, copy its network parameters to the twin communication server: select 10. Copy setup, then 2. ‘Copy to twin CPU (all).

Configuring the Rainbow connection settings

Before beginning, make sure you have the equipment ID and activation code generated on Rainbow for your OmniPCX Enterprise. You can get it from the equipment list on Rainbow: Select the OmniPCX Enterprise, and click on the Connection tab:

The copy/paste operation can be used to enter these connection settings in the following procedure.

Procedure:

1. Open the OmniPCX Enterprise configuration tool with the mtcl credentials (login and password).
2. From the configuration tool (for example: OXE WBM), select Rainbow.
3. In the Enable Rainbow Agent field, select YES.
4. Leave the Rainbow domain field to its default value: openrainbow.com.
5. In the Rainbow PBXID field, enter the target equipment ID.
6. In the Activation code field, enter the target activation code.
7. In the Phone-book sent to Rainbow, select YES to send the OmniPCX Enterprise directory to Rainbow.
8. Enter the activation code again.
9. Validate the changes.

Once the OmniPCX Enterprise connected to Rainbow, the connection status changes to Connected in the OmniPCX Enterprise configuration tool (for example: OXE WBM):

In the equipment list of the customer company in Rainbow, the OmniPCX Enterprise connection status changes to Running. To have a complete view of the connection status, click on the OmniPCX Enterprise, and click on the Connection tab: