Article ID: 8667, created on Jul 9, 2010, last review on May 6, 2014

  • Applies to:
  • Business Automation 5.0

Problem statement

Provider has custom domain plug-in in PBA-E 4.4.x and want to use it in PBA-E 5.0.

Resolution

This article will help Provider to convert old (PBA-E 4.4.x) domain registration plug-in to a new one (PBA-E 5.0).

The example below is provided for plug-in MYTEST.

PREFACE

The whole idea is that you do not need to write anything in the file bodies.cc (except plug-in configuration methods), you need to implement several C++ methods in the files plugin.cc and plugin.h with simple input and output structures.

In this article you may find instruction how to convert plug-in to the new format.

BEFORE UPGRADE

1) Copy old plug-in (folder with sources MYTEST) to the folder /root/:

# cp -r /usr/local/bm/bm-sdk/DomainPlugins/MYTEST /root/

UPGRADE to PBA-E 5.0 or perform clean installation of PBA-E 5.0

2) Change current working dir to the folder ~bm/share/DomainPluginTemplate/

# cd ~bm/share/DomainPluginTemplate/

3) Generate new plug-in MYTEST:

# PROJECT_NAME=MYTEST REGISTRAR_NAME=MyTest sh create_plugin.sh

New plug-in will be created in the folder /root/DomainPlugins/MYTEST

4) It is necessary to reimplement all plug-in methods in terms of new PBA-E 5.0 SDK. There is a mapping between methods in bodies.cc (in the old plug-in) and new methods in plugin.cpp (in the new plug-in), they are provided in the table below. You need to analyse new method's structure and implement it (refer to SDK Documentation for Domain Plugins).

New method name (plugin.cpp) Old method name (bodies.cc)
 checkAvailability  CheckForRegister
 checkTransfer  CheckForTransfer
 register  SubmitForRegistration
 registerContacts  no
 registerNameServer  no
 transfer  SubmitForTransfer
 renew  SubmitForRenewal
 terminate  SubmitForTermination
 updateDomainContacts  UpdateToRegistrarContacts
 updateDomainNameServers  UpdateDomain
 getStatus  CheckRenewalStatus
 CheckRegistrationStatus
 CheckTransferStatus
 getContactsStatus  no
 getNameServersStatus  no
 getDomainContactsStatus  no
 getDomainNameServersStatus  no
 getDomainInfo  no
 setTransferLock  no
 setWhoisPrivacy  no
 validateExtData  GetAndCheckRegistrarServiceParams
 processCallback  no

'no' in the table above means that there were no appropriate methods in PBA-E 4.4.x.

For additional information refer to PBA-E Domain Plug-In SDK.

198398b282069eaf2d94a6af87dcb3ff d863a37023d0fbc15b909ef836e29214 92711db0799e8aefe8e51f12dace0496 caea8340e2d186a540518d08602aa065 e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF