The license provides you with great flexibility when deploying the PortaSwitch installation on servers. It doesn’t constrain your business parameters (e.g., the number of concurrent calls, ports, minutes or end users) and it defines the type of PortaSwitch installation you have. The license is applied per PortaSwitch installation (site) and is defined by the following parameters:

  • The maximum number of servers (where you add any PortaSwitch applications) in your installation;

  • The maximum number of specific application servers in your installation. In particular:

    • The maximum number of servers where you can deploy a billing engine (RADIUS / Diameter).

    • The maximum number of servers where you can deploy PortaSIP (PortaSIP dispatching node or PortaSIP processing node).

    • For those products that have a bundled license for Oracle software – the maximum number of servers where you can deploy Oracle database cluster software may not exceed the number of billing engine servers (e.g., if your license includes five billing engine servers, then you can deploy a maximum of five servers with Oracle database cluster software).

Consider the following example:

A standard PortaSwitch Clustered installation license covers nine servers. Among them, two servers run the billing engine cluster, two servers run the web cluster and three servers run the PortaSIP cluster.

An ITSP decides to deploy PortaSwitch Clustered on only eight of their servers:

Server name

Running PortaSwitch applications



  • Billing engine



  • Billing engine
  • Master DB



  • Web server



  • Web server
  • Replica DB



  • PortaSIP dispatching node



  • PortaSIP dispatching node
  • PortaSIP processing node



  • PortaSIP processing node



  • Configuration server

This configuration will work just perfectly; furthermore, it is possible to easily add one more server and configure additional PortaSIP processing node instances there for enhanced productivity.

As you see, you can combine different PortaSwitch applications (e.g., web server and PortaSIP server instances) on a single server and easily add application instances to your servers to scale up your capacity and match your unique business requirements.

An exception is the Configuration server instance, which, due to its specific purpose, is only compatible with the Log server instance.

At the same time, the total number of servers in your installation and number of application servers with the billing engine and PortaSIP instances must not exceed the parameters defined by your license.

What's in it for me?

Link copied to clipboard

A license verification method is based on centrally distributed license files and provides the user with a flexible and convenient service management system. As PortaSwitch applications (e.g., PortaBilling OCS or PortaSIP) are not bound to a specific physical server, you can change the system configuration and launch applications on new servers without any need for your physical presence in the facility where your servers are located.

PortaSwitch applications can be moved between servers with ease – you can turn a server that used to be a web server into a PortaSIP or add any other applications with just a few mouse clicks on the web interface of the Configuration server.

The time required to deploy new applications after the license has been purchased is minimum. For example, if a rapid increase in traffic is anticipated this coming weekend, you can contact the PortaOne sales team and once your purchase has been finalized and the license information has been updated in our CRM, you can immediately add extra PortaSIP instances to your system in just a few minutes.

A hardware failure no longer causes a lengthy service outage. If, for example, the OCS server you were running goes down because of a hardware failure – you can promptly move the service to a different host. This eliminates several hours of potential downtime, since there is no need for someone to travel to the collocation facility where the servers are installed. While the OCS service is running on a different server, you have plenty of time to fix (or even replace) the defective one. By the same token, you can add new physical servers or perform maintenance on existing ones without interrupting the flow of your business, by reassigning the applications to other servers.

What is a License file?

Link copied to clipboard

It is a protected .xml file that contains the following information:

  • Component instances (e.g., PortaSIP, billing engine, DB, web, RT, etc.).

  • Instance options (e.g., cluster, SMP etc.).

  • Information about IPs.

  • Expiration date.

  • Information about the owner.

  • Encryption seed and signature.

In general, it is similar to an email signed with a PGP and looks like this:

license file sample

How does it work?

Link copied to clipboard

You can make changes to your “live” system at any time (e.g., add a new PortaBilling OCS instance or move it to a different physical server) using the Configuration server web interface (see Section 2 of the PortaSwitch Configuration Server Web Reference Guide). When you apply the change, the Configuration server will retrieve the license file from a centralized PortaOne Licensing Server and check whether all of the new configuration items (e.g., total number of OCS servers in the cluster) are in line with the license terms. If the configuration corresponds to your license, it will be applied; otherwise you will be prompted to change the configuration so that it meets license restrictions.

License check flow

A local copy of the license file is stored on the Configuration server and then distributed to the remaining servers. Each individual application uses it to verify that this service can run as a part of this installation – a valid license file is necessary for any application to operate. The local copy of the license file is updated every night to prevent it from expiration.

For your installation to work properly, PortaOne Licensing Servers (, should be accessible from all your hosts.

When none of the licensing servers are accessible, the monitoring system shows a corresponding warning message. To make sure your business is not affected by a problem with Internet connectivity, preventing your servers from contacting PortaOne Licensing Servers, the license file will be valid for a week after download. That is, even in the unlikely event that for several consecutive days your server does not have connectivity to the Internet and cannot access any of the licensing servers, your services will continue running for up to seven days, which is quite enough time to restore access.

On this page

What's new
Admin manuals
UI help
Back to main menu