Setup for Event Repository Administration Scripts

Event Repository administration scripts enable you to verify the Event Repository configuration and monitor its status (displaying server status and event-loading statistics). The administration scripts can be run from any machine that has a connection to the machine on which a mongod instance runs. After the event store is set up and you are logged on to a machine where the MATRIXX Engine software is installed, you can run the scripts with no further setup. To run the administration scripts on a machine where the MATRIXX Engine software is not installed, use the following setup tasks.

About this task

Perform this task to run Event Repository administration scripts from a machine where the MATRIXX Engine software is not installed.

For more information about the MATRIXX environment variables, see the discussion about container directories and environment variables in MATRIXX Installation and Upgrade.

Procedure

Log in to the machine from which you want to run the Event Repository administration scripts and create a directory on your local file system where you want to copy the Event Repository administration scripts (event_repository_script_directory).
Add the following in your ~/.bashrc file:
MTX_PYTHON_DIR=<event_repository_script_directory>

PATH=.:${PATH}:${MTX_PYTHON_DIR}

PYTHONPATH=${PYTHONPATH}:${MTX_PYTHON_DIR}:${MTX_PYTHON_DIR}/pymongo:${MTX_PYTHON_DIR}/python

export PYTHONPATH

export PATH

MTX_LIB_DIR=${MTX_PYTHON_DIR}

export MTX_LIB_DIR
For example:
```
MTX_PYTHON_DIR=/home/userbob/mongoTest
PATH=.:${PATH}:${MTX_PYTHON_DIR}
PYTHONPATH=${PYTHONPATH}:${MTX_PYTHON_DIR}:${MTX_PYTHON_DIR}/pymongo:${MTX_PYTHON_DIR}/python
export PYTHONPATH
export PATH
MTX_LIB_DIR=${MTX_PYTHON_DIR}
export MTX_LIB_DIR
```
Copy the administration scripts from ${MTX_BIN_DIR} located on a MATRIXX server to the directory you created. The administration scripts to copy are:
- configure_event_repository.py
- create_event_repository_partitions.py
- check_event_repository_configuration.py
- common_security_functions.py
- external_db_functions.py
- print_event_repository_loader_stats.py
- print_event_repository_loader_status.py
- print_event_repository_loader_trace.py
- print_event_repository_stats.py
- print_event_repository_status.py
Copy a shared library from ${MTX_LIB_DIR} located on a MATRIXX server to the directory you created. The shared library to copy is libMtxKeyUtil.so.
Set permissions for the administration-script files.
cd $MTX_PYTHON_DIR; chmod 755 *
Enter the following:
. ~/.bashrc

You can now run the Event Repository administration scripts from the machine.
The print_event_repository_status.py script obtains storage sizes in your mongod servers by using SSH. Ensure that the machine has SSH access to all the MongoDB host servers where mongod processes run.