Getting Started

After installation, you can quickly verify your MSGMX installation by performing the following tasks.

Enterprise Message Service (EMS) Considerations

If MSGMX is used to manage EMS, EMS must be installed. See the TIBCO Enterprise Message Service Installation Guide for details.

Environment Settings

If MSGMX is used to manage Apache Kafka or EMS, you need to set environment variables before starting MSGMX. Refer to the corresponding command reference document, Getting Started, for guidance and examples.

Python Virtual Environment

The Python virtual environment (venv) isolates the Python dependencies of MSGMX from other globally installed Python packages that may exist on your system. The Python virtual environment is automatically created during the installation process and is used when running MSGMX.

Starting MSGMX

Perform the following Procedure steps.

    Procedure
  1. Confirm that the messaging system is installed.
  2. In a local console window, either add the directory containing the MSGMX executable file to your PATH or navigate to the directory containing the executable. See the following examples.

    Default Unix location:

    cd /opt/tibco/msgmx/bin

    Default Windows location:

    cd C:\tibco\msgmx\bin

  3. Launch the MSGMX program using the msgmx command.

    Linux and macOS:

    ./msgmx

    Windows:

    msgmx.bat

  4. Use the manage command to select the component to manage.
    For example, to manage Apache Kafka:
    manage kafka

    To manage EMS:

    manage ems
  5. At the MSGMX prompt, initiate a connection to the system to be managed.
  6. To continue, see the appropriate command reference manual.
  7. Exit MSGMX by using the exit command or by selecting Ctrl+D.