Symptoms

It is required to install PBA REST API container (bm-restapi), e.g. for WAP deployment. Choosing the component and running configuration script configure.pl does not give any result - the service is not created, container not installed.

Cause

The issue is a bug with id #PBA-56154.

Resolution

Until the bug is fixed, follow the steps below to install REST API:

  1. Make a backup of the configuration script <PBA_path>\tools\configure.pl
  2. Edit the initial configure.pl according to the diff below:

    --- tools/configure.pl  (initial file)
    +++ tools/configure.pl  (working copy)
    @@ -514,7 +514,7 @@
       $ssmcmd = "ssm" if ($pba_os eq &OS->{WIN});
    
     my @all_containers = ();
    -  my @sys_containers = qw/ssm atm muxd www xmlrpcd scheduler pba-core pba-gates pba PSS/;
    +  my @sys_containers = qw/ssm atm muxd www xmlrpcd scheduler restapi pba-core pba-gates pba PSS/;
       if (-f "$pba_root/etc/ssm.conf.d/xmlrpcd_auth.conf") {
         push @sys_containers, 'xmlrpcd_auth';
         my $ini_default = new ini("$pba_root/etc/ssm.conf.d/.global.conf");`
    
  3. Make a backup of the global configuration file <PBA_path>\etc\ssm.conf.d\.global.conf
  4. Edit an initial .global.conf according to the diff below:

    --- etc/ssm.conf.d/.global.conf (initial file)
    +++ etc/ssm.conf.d/.global.conf (working copy)
    @@ -15,7 +15,7 @@
     logging = true
     minidump = true
     bootstart = false
    -startdep = atm muxd www xmlrpcd scheduler
    +startdep = atm muxd www xmlrpcd scheduler restapi
     summary = PBA $(_name) Container
     user = pba
     group = pba
    
  5. Stop PBA.
  6. Run configure.pl script.
  7. Start PBA, REST API shall be available.

Internal content