BusinessPhone Communication Platform 7.0
Maintenance Instruction ASB 150 02

## IPU - Software licensing

### General

The number of the supported bi-directional Voice-over-IP channels on the IPU is defined by a license file on the Compact Flash Card.

The name of the license file as well as the number of the different licenses are dependent on the Release of the central software.

Release | File name | Application image (Firmware) RYS 102 541/1 | Number of licensed voice channels
12 | IPU.ULK | < R2A | 4, 8
LICCFG.ULK | ³ R2A | 4, 8
³ 13 | LICCFG.ULK | ³ R2A | 4, 8, 12, 16

#### Voice channel licensing in ASB 150 02 R12

The license file will only be delivered in conjunction with a Compact Flash card. In case of license upgrades, the Compact Flash card has to be replaced by the one with the higher license.

Article number of the license | Function
LZYBS 203 13/4 | 4 voice channels
LZYBS 203 13/8 | 8 voice channels

Note

The license file is linked to the unique serial number of the Compact Flash card and therefore does not work on any other Compact Flash card.

#### Voice channel licensing in ASB 150 02 R13/R14 or higher

Compared to ASB 150 02 R12 two different kind of licenses exist.

##### Temporary License

By default the Compact Flash card covers a temporary license file, which provides access to 16 voice channels for 672 operation hours (28 days).

The temporary license file gives the service technicians the possibility to set-up the system at the customer site without already having the final license file from the Ericsson License Center.

If no final license file is copied onto the Compact Flash card before the temporary license expires, the IPU board blocks automatically all VoIP traffic. In this case, every request for a voice channel will cause a new entry in the warning log (Fault DB with value D2=80H) and the call setup will be rejected.

Once the temporary license has expired, it cannot be reactivated by exchanging the Compact Flash card by another one with a temporary license, as the time-out handling is only managed by the IPU. The license can only be re-activated by replacing the temporary license file with a final license file

Note

The temporary license file is linked to the unique serial number of the Compact Flash card and therefore does not work on any other Compact Flash Card.
Since the I/O functionality on the IPU is not licensed at all, it will work even if the temporary license file has expired.

##### Final License

The final license file, which has to be ordered separately, is linked to the original unique MAC-address of the IPU (stated on the front panel of the board) and the serial number of the Compact Flash Card. The following licenses are available:

Release 13

Article number of the license | Function
FALBS 102 40/4 | 4 voice channels
FALBS 102 40/8 | 8 voice channels
FALBS 102 40/16 | 16 voice channels

Release 14 or higher

Article number of the license | Function
FALBS 102 47/G | 4 voice channels
FALBS 102 47/O | 8 voice channels
FALBS 102 47/R | 16 voice channels
FALBS 102 47/P | additional 4 voice channels
FALBS 102 43/16 | IPU Gateway license 16 channel*)

*) The IPU Gateway license also requires the corresponding VoIP Gateway system license (FALBS 102 50/G). See chapter ASB 150 02 Software key based licensing.

The licenses can be ordered via the normal order process, each license step is represented by an own article number. For each ordered article number a Unique Pick Number (UPN) will be delivered. This UPN is used for the the License Administration Tool on the Ericsson Partner Network) to create the customer’s license file with the bought features. The Ericsson License Center web page (http:\\enterprise.ericsson.net) provides authorized users the possibility to create the license file directly.

For each of the listed voice channels in Release 14 (or higher) one of the available color packs can be chosen. For optional expansions the plus pack can be added to one of the color packs - also multiply, if desired. For instance, in case of the feature VoIP channels either the green pack (4 voice channels), the orange pack (8 voice channels) or the red pack (16 voice channels) can be ordered. It is not possible to combine a green pack and a orange pack in order to gain 12 voice channels. But it is possible to add 3 times a plus pack (+ 4 voice channels) to a in order to expand from existing 4 voice channels to 12 voice channels. Such expansions are done in multiple steps, meaning one order for x plus packs causes a delivery of x UPN numbers.

Note

From functionality point of view there is no difference between the Release 13 and Release 14 article numbers, which means that also an Release 13 system can be upgraded by using the plus pack.

Before a final license can be requested from the Web page of the License Administration Tool, the IPU has to be installed once in an ASB 150 02 system, in order to export the temporary license by using the BusinessPhone Management Suite (BMS).

The exported license, which contains the MAC-address of the IPU, the serial number of the Compact Flash Card and the number of the temporary licensed voice channels (always 16 voice channels) will be used by the License Administration Tool to generate the final license which matches the customer’s IPU, Compact Flash Card, as well to the number of ordered voice channels.

### How to distinguish between the different licenses

#### ASB 150 02 R12

The license can be read from the sticker on the Compact Flash Card or in case of a running system by connecting the BMS (minimum Version 2.0), selecting the desired IPU. The reported name IPU4 or IPU8 always equals to number of licensed voice channels.

Note

Details about the IPU licensing can also be read out by clicking on the ’Voice Channel Licensing’ button in the Card information dialog. Please note that this button is only available if the IPU application image
RYS 102 541/1 ³ R2A is used.

The ASB 150 02 R12 licenses will always be indicated as License type ’Temporary’, however the time out counter will not be started in ASB 150 02 R12, which means that the shown license will be accessible unlimited.

Note

The final licenses for 4 and 8 voice channels of ASB 150 02 R13 are backward compatible and can be used in ASB 150 02 R12 as well, in this case the License type ’Final’ will be indicated. A temporary license for 16 voice channels of ASB 150 02 R13 is not supported in R12.

#### ASB 150 02 R13 or higher

In case of a running system the license can be read out by connecting the BMS, selecting the desired IPU and clicking on the ’Voice Channel Licensing’ button in the Card information dialog.

If the system is not running the license can be read out by viewing the content of the license file on the Compact Flash Card with MS Quickview (part of the operating systems Win9x, Win NT4 and Win2000). The same applies when retrieving the license file from the License Administration Tool .

Note

The license file can also be viewed by using any editor, however careless modifications might destroy the license file.

##### Temporary license

The temporary license is indicated in the BMS license data dialog of the IPU by the following information:

- License Type: Temporary
- Remaining operation hours: < 672 - 0 > (indication will be updated every 17 hours)

By viewing the LICCFG.ULK file with MS Quickview the temporary license is determined by the following text string

Feature | Expires [hours] | Rel. | No. of channels
FEATURE IPUVOICECHANNELS | 672 | 13 | 16

Note

The value of the remaining operation hours always shows the start value of 672 hours, the current remaining hours can only be read out by the BMS

If the temporary license has never been in use before, it misses the entry of the MAC-address.

Example

##### Final License

The final license is indicated in the BMS license data dialog of the IPU by following information:

- License Type: Final

By viewing the LICCFG.ULK file with MS Quickview, the final license is determined by the following text string:

Feature | Expires [hours] | Rel. | No. of channels
FEATURE IPUVOICECHANNELS | OPN | 13 | 8 *)

*) the number of available voice channels corresponds to the ordered license

Furthermore the license file states the MAC-address of the IPU the license belongs to.

Example

### Registration of a new IPU license

Every new Voice-over-IP function, in ASB 150 02 R13 or higher systems has to be registered, in order to enable the functionality at the customer site.

The following procedure has to be used for the registration:

1. Order the desired article number
   see chapter Voice channel licensing in ASB 150 02 R13/R14 or higher.
2. Connect the BMS to the system, select the desired IPU and click on the ’Board configuration’ button in the Card information dialog to modify the number ’Trunk individuals’,’IP-Extensions’ and ’IP-Extension threshold’ if necessary.

Note

A new IPU with a temporary license always reports itself with the name IPU16
(16 voice channels)

1. Click on the ’Board info’ button to move back to the Card Information dialog
2. Click on the ’Voice Channel Licensing’ button to read out the current license
3. Export the temporary IPU license to your local computer. By default the filename LICCFG.ULK is chosen, however any other name (*.ULK) can be used as well (e.g. the name of the customer).
4. Build up an Internet connection via the Service PC or the customer PC and login to the Ericsson Partner Network (http:\\enterprise.ericsson.net).
5. Open the Web page of the License Administration Tool and follow the offered instructions to create and download the desired license by using the available Unique Pick Numbers

Note

After the temporary license has been sent to the License Administration Tool, the board configuration should not be modified until the final license has been imported again.

1. Import the downloaded license file into the system.

Note

Before the BMS imports the new license, it performs automatically a check whether the MAC address and the serial number of the Compact Flash card matches with the data in the customer system and rejects the request with an Error message if the validation fails.

Note

The license file always has to be stored on the Compact Flash card by using the license import function of the BMS. It must not be copied manually to the Compact Flash card. The content of own defined filenames ( e.g. SMITH.ULK) will be imported in the LICCFG.ULK file.

1. Shut down the desired IPU.
2. Activate the IPU again
   Based on the used license the IPU reports itself with a different name. (IPU4 = 4 voice channels, IPU8 = 8 voice channels, IPU12= 12 voice channels, IPU16= 16 voice channels)

### Upgrading of an existing IPU license

In order to enhance the number of voice channels at the customer site, the installed license has to be upgraded with requested functionality.

#### ASB 150 02 R12

##### Upgrade the license from 4 to 8 voice channels

In order to upgrade the license from 4 to 8 voice channels, please follow the procedure mentioned in the chapter Modification of the board functions.

#### ASB 150 02 R13/R14

##### Upgrade the license from 4 to 8, from 4 to 16 or from 8 to 16 voice channels

Follow the same steps as stated in the previous chapter Registration of a new IPU license”. The only difference is that the following article numbers have to be used instead and that the exported license file is not a temporary license file.

Release 13

Article number of the license | Function
FALBS 102 41/4U8 | Upgrade License 4 to 8 voice channels
FALBS 102 41/4U16 | Upgrade License 4 to 16 voice channels
FALBS 102 41/8U16 | Upgrade License 8 to 16 voice channels

Release 14

Article number of the license | Function
FALBS 102 47/P | Plus pack: additional 4 voice channels

Note

From functionality point of view there is no difference between the Release13 article numbers and the R14 article number, which means that also the Release 14 article number can be used for Release 13 systems.

##### Upgrade an ASB 150 02 R12 license with 4 voice channels to an ASB 150 02 R13 license with 8 or 16 voice channels

Follow the steps mentioned in chapter Update an ASB 150 02 R12 IPU license to a R14 or higher with the same number of voice channels”. The only difference is that the article numbers stated above have to be used instead.

### Updating of an existing IPU license

The update of an existing license is necessary in following cases:

- Update of an ASB 150 02 R12 system to R14 or higher
- Replacement of faulty hardware components (IPU or Compact Flash Card)

#### Update an ASB 150 02 R12 IPU license to a R14 or higher with the same number of voice channels

1. Article number of the license | Function
   FALBS 102 42/4 | IPU version update 4 voice channels
   FALBS 102 42/8 | IPU version update 8 voice channels

   Order one of the following ’Version update licenses’ at the orderdesk
2. Upgrade the application image RYS 102 541/1 on the IPU to at least R2A (has to be done locally or via FTP access)
3. Upgrade the central software to R14 (see chapter Upgrading of an ASB 150 02 Release 11 or Release 12 system to Release 14 or higher)
4. During start up of the IPU, a temporary LICCFG.ULK file (672 operation hours) will be generated with the same number of licensed voice channels as stated in the IPU.ULK file. The IPU.ULK will remain on the Compact Flash Card but it will further on not be used by the IPU application image.

Note

The difference between a temporary license file from a new Compact Flash card and a temporary license file which has been generated by the IPU itself due to the application image upgrade is based on the following:
- The number of voice channels is always 16 on a new license and 4 or 8 on a generated license
- By viewing the license file MS Quickview the generated license file has an additional entry in the
first line which says ’ ID: created from IPU’

1. Connect the BMS to the system, select the desired IPU and click on the ’Board configuration’ button in the Card information dialog to modify the number ’Trunk individuals’,’IP-Extensions’ and ’IP-Extension threshold’ if necessary.
2. Click on the ’Board info’ button to move back to the Card Information dialog
3. Click on the ’Voice Channel Licensing’ button in the Card information dialog to read out the current license.
4. Export the temporary IPU license to your local computer. By default the filename LICCFG.ULK will be chosen, however any other name can be used as well (e.g. the name of the customer).
5. Build up an Internet connection via the Service PC or the customer PC and login to the Ericsson Partner Network (http:\\enterprise.ericsson.net).
6. Open the Web page of the License Administration Tool and follow the offered instructions to create and download the desired license by using the available Unique Pick Numbers

Note

After the temporary license has been sent to the License Administration Tool, the board configuration should not be modified until the final license has been imported again.

1. Import the downloaded license file into the system.

Note

Before the BMS imports the new license, it automatically performs a check on whether the MAC address and the serial number of the Compact Flash card matches with the data in the customer system and rejects the request with an Error message if the validation fails.

Note

The license file always has to be stored on the Compact Flash card by using the license import function of the BMS, it must not copied manually to the Compact Flash card. The content of own defined filenames ( e.g. SMITH.ULK) will be imported in the LICCFG.ULK file.

1. Shutdown the desired IPU
2. Activate the IPU again

#### Update of the IPU license because of a faulty Compact Flash Card.

In case of an ASB 150 02 R12 system, the faulty Compact Flash Card has to be replaced by a new one with the same license.

In case of an ASB 150 02 R13 or a higher system, the faulty Compact Flash card with the final license has to be replaced by a new one (LZYBS 203 13) with a temporary license.
As the license is always based on the MAC-address of the IPU and the serial number of the Compact Flash Card, and one of these components is still the same, the former license functionality can be easily requested again from the License Administration Tool.

Use the following procedure to request the former license again:

1. Modify the license file on the new Compact Flash Card by using any available editor, to the values of the previous defined number of trunks individuals and IP-Extension individuals.
   Exchange the values 8 and 32 in the following text string

   CONFIGURATION |  | IPUTRUNKS |  | OPN |  | 13 |  | 8 |
   CONFIGURATION |  | IPUEXTENSIONS |  | OPN |  | 13 |  | 32 |

2. Exchange the faulty Compact Flash Card by a new one (including a temporary license) and place the IPU into the former board position.
3. Connect the BMS to the system and activate the IPU. According to the new temporary license, the IPU reports itself as IPU16=16 voice channels
4. Click on the ’Voice Channel Licensing’ button in the Card information dialog to read out the current license.
5. Export the temporary IPU license to your local computer. By default the filename LICCFG.ULK is chosen, however any other name can be used as well (e.g. the name of the customer).
6. Build up an Internet connection via the Service PC or the customer PC and login to the Ericsson Partner Network (http:\\enterprise.ericsson.net).
7. Open the Web page of the License Administration Tool and follow the offered instructions to create a repair license. As the license is always based on the MAC Address and the serial number of the Flash Disk, and one of these components is still the same, the former license file can easily be recovered.
8. Import the downloaded license file into the system.
9. Shutdown the desired IPU.
10. Activate the IPU again
    Based on the used license the IPU reports itself with a different name. (IPU4 = 4 voice channels, IPU8 = 8 voice channels, IPU12= 12 voice channels, IPU16= 16 voice channels)

#### Update of the IPU license because of a faulty IPU board

In case of an ASB 150 02 R12 system, the faulty IPU has to be replaced by a new one, whereby the Compact Flash card with the current license can be reused on the new board.

In case of an ASB 150 02 R13 or a higher system, the faulty IPU has to be replaced by a new one, whereby the Compact Flash card with the previous final license can be reused on the new board.
Due to the fact that the MAC-address stored in the license file does not match the one of the new IPU, the IPU will automatically reconvert the previous final license to a temporary one during start up, additionally a backup copy of the previous final license will be created in the TRACE directory of the CF card (the file will be named LICCFG.BAK).
The new temporary license covers the same amount of voice channels as previously defined in the final license.
As the license is always based on the MAC-address of the IPU and the serial number of the Compact Flash Card, and one of these components is still the same, the former license functionality can be easily requested from the License Administration Tool.

Use the following procedure to request a replacement license:

1. Exchange the faulty IPU but keep the previous Compact Flash Card.

- Consider that the replacement IPU has to be new, i.e. trial-time not expired yet.

1. Connect the BMS to the system and activate the IPU. According the previous final license, the IPU reports itself with the same name.

Note

Before exchanging an IPU board against a new one, it is necessary to inform the LAN administrator about the new MAC address of the IPU board. This activity is necessary if command 2151 is set to BOOTP or DHCP in order to secure that the new IPU card will get the prior defined IP-address from the server. If the BOOTP or DHCP server is not updated with the new MAC-address, the IPU board will start up but will not get an IP-address assigned from the server.
In order to solve this problems one the following scenarios can be chosen:
A) Update the BOOTP or DHCP server with the current MAC address and perform an
individual board restart
B) Change command 2151 to the value ’no protocol’, configure the commands 2152, 2153, 2154
manually with the prior values and perform an individual board restart.

1. Click on the ’Voice Channel Licensing’ button in the Card information dialog to read out the current license.
2. Export the temporary IPU license to your local computer. By default the file name LICCFG.ULK is chosen, however any other name can be used as well (e.g. the name of the customer).
3. Build up an Internet connection via the Service PC or the customer PC and login to the Ericsson Partner Network (http:\\enterprise.ericsson.net).
4. Open the Web page of the License Administration Tool and follow the offered instructions to create and create a repair license. As the license is always based on the MAC Address and the serial number of the Flash Disk, and one of these components is still the same, the former license file can easily be recovered.
5. Import the downloaded license file into the system.
6. Shutdown the desired IPU
7. Activate the IPU again

Revision: T © Ericsson Enterprise 2005