Associate an OmniPCX Enterprise to a company

This article allows to associate an OmniPCX Enterprise equipment to a customer company.

Management operations are performed from the communication server management window of the company.

To associate an OmniPCX Enterprise to a customer company:

1. On Rainbow, declare the OmniPCX Enterprise in the target 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.
   The Rainbow agent, embedded in the OmniPCX Enterprise, is used to establish a permanent secure connection with the Rainbow Cloud infrastructure.

Prerequisites

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 application, click on Manage your customers  in the left panel.
2. In the MY CUSTOMERS panel, click on Customers companies.
3. In the right part of the window, click on the name of the target customer company.
4. In the left panel, click on Communication.
5. In the right part of the window, click on the Comm. Servers tab.
6. Click on Create.
7. Review/modify the following parameters:

   Server name	Enter the name of the PBX
   Server type	Select: OmniPCX Enterprise
   Activate WebRTC gateway	Select the 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.
   Specify equipment ID and activation code	Leave this check box unselected. An equipment ID and activation code will be automatically generated after the OmniPCX Enterprise declaration in the customer company
   Dialing information
   Country	Enter the country used to translate national phone numbers into canonical numbers
   National prefix	Enter the first digit(s) dialed when calling a subscriber inside the country configured in the Country field
   International prefix	Enter the first digit(s) dialed when calling a subscriber outside the country configured in the Country field
   Outbound prefix	Enter the prefix used for outgoing calls
   Use the outbound prefix	If selected, the outbound prefix is used for outgoing calls
   Installation number	Enter the public number of the company
   CCD Agent
   When busy in a Rainbow call or conference
   CCD Withdraw	If selected: when CCD agents are in Rainbow communication or conference, their state switches to withdraw for CCD call distribution (i.e. they cannot receive CCD calls) If not selected: when CCD agents are in Rainbow communication or conference, their state remain to idle for CCD call distribution (i.e. they can receive CCD calls)
   When in DND
   Ignore IPbx VoIP calls	If selected: when CCD agents are in Do not Disturb (DND), calls from the PBX are ignored (no pop-up or ringing), except for CCD calls: they will be notified when a CCD call is received and can answer it, if desired If not selected: when CCD agents are in Do not Disturb (DND), they can receive calls from PBX
   CCD Withdraw	If selected: when CCD agents are in Do not Disturb (DND), their state switches to withdraw for CCD call distribution (i.e. they cannot receive CCD calls) If not selected: when CCD agents are in Do not Disturb (DND), they can receive CCD calls according to Ignore IPbx VoIP calls field
   Withdraw reason	When CCD Withdraw is selected for CCD agents in busy or DND state, select the withdraw type from 0 to 9. Each of these numbers represents a type of unavailability configured for CCD in PBX

8. 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: