How to register custom components on Unix and Linux platforms

Summary Unix platforms do not provide a windows registry mechanism. Instead the registry that your custom Unix application will use is implemented in the ArcGIS Engine Runtime installation. This registry is also where all of the Engine components are registered.

To register your custom components (shared libraries, DLL's, OCX's, etc.) you will need to perform these simple steps:
  1. Source the init_engine.csh script in your runtime installation's $AGSENGINEJAVA. This will set all of the necessary environment variables necessary to find the runtime libraries, executables and scripts:

    % source $AGSENGINEJAVA/init_engine.csh
  1. Modify the Unix library path so that any of your local library dependencies can be found during registration:

    % setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:
  1. Run the regsvr32 utility as you would on Windows. The regsvr32 utility is packaged with the runtime installation.

    % regsvr32 -c /libyourlibrary.so
These steps can easily be implemented as part of an installation script for your application. To get an idea how this is done see the engine registration scripts $AGSENGINEJAVA/.Setup/registerArcGISEngineRT and $AGSENGINEJAVA/.Setup/registerEngine.