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 for Windows installation. This registry is also where all of the Engine components are registered.

To register your custom components (for example, shared libraries, DLLs, OCXs, and so on) do the following 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
  2. 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}:
  3. 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. For more information on how this is done, see the following Engine registration scripts:
  • $AGSENGINEJAVA/.Setup/registerArcGISEngineRT
  • $AGSENGINEJAVA/.Setup/registerEngine.