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 for your setup.
      • /var/log/alpaca/
      • /var/alpaca/store/
      • /var/log/mongo/
      • /var/lib/mongo/
      • /var/lib/rabbitmq/
      • /opt/
  • CPU:
    • Alpaca w/o Call History: 2 per Alpaca server instance
    • Alpaca w/ Call History: 4 per Alpaca server instance
  • RAM:
    • Alpaca w/o Call History: 16gb per Alpaca server instance
    • Alpaca w/ Call History: 32gb per Alpaca server instance

BroadWorks Host IDs

A perpetual ECG License requires the Host IDs of all 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.