Alpaca 10.1

Installation

Guides

Typographic Conventions

Normal text looks like this. Text that a computer outputs is in a fixed-width type like this. Text that you type into a computer is in key input like this, or strikethrough key input if you can't see it, such as with passwords. Code looks like this. Placeholders (text that should not be taken literally) is in fixed width italics like this.

Text Description
login: fflinstone The literal username is "fflinstone"
password: passwordherebutinvisible The password won't be displayed
bash:~$ cd /boot The command you'll enter is "cd /boot"
bash:/boot$ su
password: ProperRootPasswordHere The root password isn't provided here.
bash:/boot# mv vmlinux vmlinuz.YYYY-MM-DD-HHMMSS Replace the placeholder with the date.

Alpaca Server System Requirements

The minimum system requirements to run the Alpaca Server are as follows:

  • Storage: 100 GB
    • Make sure the partitions that contain the following directories have adequate space (minimum of 10GB per partition) for your setup.
      • /var/log/alpaca/
      • /var/alpaca/store/
      • /var/log/mongo/
      • /var/lib/mongo/
      • /var/lib/rabbitmq/
      • /opt/
  • CPU: 2
  • RAM: 4 GB + 2x PERM_ALLOCATED_SIZE

Determining PERM_ALLOCATED_SIZE

You can determine the current PERM_ALLOCATED_SIZE on a Broadworks Application server using the ttIsql command:

  1. bwadmin@as1.voip.net$ ttIsql
  2. Command> dssize

  3. Output

     The following values are in KB:

 PERM_ALLOCATED_SIZE:      1048576
 PERM_IN_USE_SIZE:         71861
 PERM_IN_USE_HIGH_WATER:   71944
 TEMP_ALLOCATED_SIZE:      348160
 TEMP_IN_USE_SIZE:         28888
 TEMP_IN_USE_HIGH_WATER:   32368

  4. Command> exit

In this example, our PERM_ALLOCATED_SIZE is 1048576 kB (1.05 GB), so this system requires 6 GB (4 + 2(1)) of RAM.

BroadWork's Host IDs

A perpetual ECG License requires the Host Ids of all of the BroadWorks Application Servers that Alpaca will be communicating with.

There are two ways to retrieve the Host IDs: From the XSP_CLI and directly off of the Application Server.

AS_CLI

All host ids used by an AS are located at: AS_CLI/System/Licensing.

  1. bwadmin@as1.voip.net$ bwadmin
  2. AS_CLI> cd System/Licensing
  3. AS_CLI/System/Licensing> get

  4. Output with legacy license

    AS_CLI/System/Licensing> get licenseType = Hard groupUserLimit = 999999 expirationDate = None systemId = None Host Id ==================================== AAAAAAAA-BBBB-1111-CCCC-123456ABCDEFG AAAAAAAA-BBBB-2222-CCCC-123456ABCDEFG

    2 entries found.

  5. Output with NFM license

     licenseType = Hard
 groupUserLimit = 999999
 expirationDate = Fri Sep 29 23:59:59 UTC 2023
 systemId = ABC1234DEFABC1234DEF
 Host Id
 =======

 0 entry found.

  6. If using a legacy license, the field needed to generate an ECG license is the Host Id field. If using an NFM license, the field needed to generate an ECG license is the systemId field.

AS

Specific AS host ids can be seen from the AS via /usr/local/broadworks/bw_base/sbin/bwdd | grep UUID or dmidecode | grep UUID.