Install New BDD

Instructions for installing a new Bulk Data Download (BDD) of the North American number portability database from NeuStar.

1. Download BDD from NeuStar and copy the BDD file into the $NumberUpdate_HOME/unix/utils directory of OSPrey server. Unpack the file and take note of the new transaction-ID in the file name.

   $ gunzip -c bdd.tar.gz | tar -xvf -
   ma/ma.block_BDD_PSTN_09-06-2010161947.145753389.bdd
   mw/mw.block_BDD_PSTN_09-06-2010161947.145753389.bdd
   

2. Stop the NumberUpdate application on the OSPrey server.

   $ cd $NumberUpdate_HOME/unix/run
   $ ./.stop_NumberUpdate.sh
   

3. Update the .last-transaction-id.memo file and replace the previous transaction-id with the new transaction-id which is provided in the BDD file name. Example:

   $ cd $NumberUpdate_HOME/etc
   $ vi .last-transaction-id.memo
   ~
   LastTransactionID=145753389
   

4. Navigate to the utils folder where you deposited the new BDD and generate new ported_regions.cfg & ported_numbers.cfg files.

   $ cd $NumberUpdate_HOME/unix/utils
   $ ./NPAC_BDD-2-OSPrey_ported_regions.sh
   $ ./NPAC_BDD-2-OSPrey_ported_numbers.sh
   

5. Copy new ported_numbers.cfg and ported_regions.cfg to $OSPrey_HOME/etc directory of each OSPrey server.

6. Delete all partial-update files (i.e. ported_numbers.part.00042) in the OSPrey_HOME/etc folder of each OSPrey.

7. Manually test process to get number portability updates from NeuStar

   $ cd $NumberUpdate_HOME/unix/bin
   $ ./start_npac_download.sh
   

   If the test is successful a new update file will be found in the $NumberUpdate_HOME/WORK directory.

8. Stop and restart each OSPrey one at a time. Don’t restart the next OSPrey until you can get to the web user interface of the previous OSPrey.

   $ cd $OSPrey_HOME
   $ ./stop_osp_server.sh
   $ ./start_osp_server.sh
   

9. When the web user interface becomes visible after restarting each OSPrey, restart the NumberUpdate application.

   $ cd $NumberUpdate/unix/run
   $ ./run_NumberUpdate.sh