InfoHub Environment Setup

Your InfoHub distribution comes with three Bourne shell environment setup scripts that automatically define InfoHub environment variables and display the commands to create an InfoHub database and a global directory if they do not already exist. These scripts are designed to give you a friendly out-of-the-box InfoHub operations experience. Even though you can perform normal InfoHub operations without using these scripts, it is important to go through these scripts to understand the how to manage environment configuration for InfoHub. These scripts are as follows:

infohub_site.sh

Contains placeholders for defining ihsrcdir (the source directory of your InfoHub distribution), gtmgbldir (the InfoHub global directory which resides in the same directory as the InfoHub database and services), and gtm_dist (the GT.M distribution used to run InfoHub).

infohub_profile.sh

Sources $HOME/infohub_site.sh, creates an environment for InfoHub using the environment variables defined in infohub_site.sh. It displays commands to create an InfoHub database and global directory if they do not already exist. When it detects a misconfiguration, it displays the misconfigured environment variable name and stops execution.

To use these environment setup scripts, perform the following steps:

  1. Copy infohub_site.sh to $HOME/.infohub_site.sh.

  2. Use your favorite editor to open $HOME/.infohub_site.sh or customize it in place as 'custom_infohub_site.sh' and set appropriate values for:

    • ihsrcdir: Path to the directory holding your InfoHub distribution files.

    • gtmgbldir: Absolute path to the global directory where you want to place your InfoHub database and InfoHub services.

    • gtm_dist: Path to the directory of the GT.M distribution (V6.0-002 or above) used to run InfoHub.

  3. Source infohub_profile.sh on the command line or add the following command in your ~/.profile.

    $ source /path/to/infohub_profile.sh

    When you source a infohub_profile.sh, it displays the commands to set up a default InfoHub environment (global directory and a default database) if none exists.

  4. Execute the following command to load the server1.conf configuration file (discussed later in this document)

    $ $gtm_dist/mumps -run InfoHub --action=configure --file=$ihsrcdir/configs/server1.conf
  5. Execute the following command to start an InfoHub:

    $ $gtm_dist/mumps -run InfoHub --action=start 
  6. Execute the following command to display the status of InfoHub with process listing:

    $ $gtm_dist/mumps -run InfoHub --action=full 
  7. Execute the following command to shutdown an InfoHub:

    $ $gtm_dist/mumps -run InfoHub --action=shutdown 
  8. Execute the following command to rundown an InfoHub:

    $ $gtm_dist/mumps -run InfoHub --action=rundown

To perform any InfoHub operation without using the infohub_*.sh scripts, at a bare minimum, you need to set the following environment variables:

If you are not using the InfoHub environment setup scripts provided with your InfoHub distribution, set the minimum key and record sizes to 1000 and 4000 respectively and block size to 4096 for the global directory for your InfoHub database. The InfoHub Bourne shell Environment setup scripts run a GDE command file to automatically set these values for the InfoHub global directory.

For more information on performing InfoHub operations, refer to Starting an InfoHub, Monitoring (checking) an InfoHub, Restarting an InfoHub, Shutting down an InfoHub, Rundown an InfoHub, Troubleshooting (debugging) an InfoHub, and Purging an InfoHub.