Home
MATRIXX Administration
Appendixes
Traffic Routing Agent Administration Scripts
Use the following scripts to administer Traffic Routing Agents (TRAs), to check the status of a TRA server, or to validate the TRA configuration.
start_tra_cluster.py
The start_tra_cluster.py script starts both Traffic Routing Agent software stacks in an HA pair. Run this script as the tra user on a server hosting one of the Traffic Routing Agent nodes in any TRA HA cluster.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
- About MATRIXX Administration
  MATRIXX Administration describes how to monitor MATRIXX Engine components and to perform daily operations for maintaining a geographically redundant system. This includes administration for the engine, Traffic Routing Agent, MATRIXX gateways and web apps, and Notification Framework. It also provides information about recovering from a total system failure.
- Administering MATRIXX Engine
  The topics in this section have information about maintaining, managing, and resolving issues with a MATRIXX Engine installation.
- Administering MATRIXX Traffic Routing Agent
  The topics in this section describe administering Traffic Routing Agent (TRA) servers, including starting and stopping Traffic Routing Agent nodes and clusters. The information in this section applies to all Traffic Routing Agent functions unless otherwise noted.
- Administering the Route Cache
  The topics in this section describe administering the Route Cache.
- Administering US Tax Data
  US tax data is imported from CCH tax data, compiled in My MATRIXX, and output as compact MATRIXX Data Container (MDC) files, including an MDC file containing tax database metadata and status information. MDC files are packaged into a .zip file and loaded into the MATRIXX tax database.
- Troubleshooting Issues
  This section has information to help identify and resolve system issues.
- Appendixes
  - Admin Service Commands
    The Admin Service includes commands for administering MATRIXX components.
  - Engine Validation Error Codes
    The following return codes can be written to the system log when a network message is processed.
  - Python Value Type to AVP Type Mapping
    The following table describes how Python value types are mapped to AVP types.
  - MATRIXX Engine Scripts
    You can use the following scripts to support servers, clusters, engines, pricing domains, system logging, notification messaging, and event-repository storage. Use them to gather information, perform maintenance operations, such as starting and stopping servers, configure system behavior, and manage engine failover operations.
  - Scripts and Utilities for MATRIXX Gateways and Web Apps
    Use the following scripts to administer MDC Gateway, Gateway Proxy, RS Gateway, and other MATRIXX gateways and web apps.
  - Traffic Routing Agent Administration Scripts
    Use the following scripts to administer Traffic Routing Agents (TRAs), to check the status of a TRA server, or to validate the TRA configuration.
    - print_snmp_stats.py
      The print_snmp_stats.py script prints statistics for all MATRIXX Engine sub-domains configured for a domain, the Route Cache Controller, Route Cache Agent, Traffic Routing Agent HA pairs, Network Enabler, and any related MATRIXX Peer Manager instances, depending on the specified options. Run this script as the tra user on the server hosting any of these MATRIXX components.
    - print_tra_cluster_status.py
      The print_tra_cluster_status.py script displays the current status of all Traffic Routing Agent nodes configured as HA pairs. Run this script as the tra user on a server hosting one of these Traffic Routing Agent nodes.
    - start_tra_cluster.py
      The start_tra_cluster.py script starts both Traffic Routing Agent software stacks in an HA pair. Run this script as the tra user on a server hosting one of the Traffic Routing Agent nodes in any TRA HA cluster.
    - start_tra_node.py
      The start_tra_node.py script starts the specified Traffic Routing Agent software stack. Run this script as the tra user on the server hosting any Traffic Routing Agent node you want to start.
    - stop_tra_cluster.py
      The stop_tra_cluster.py script stops both Traffic Routing Agents in an HA pair.
    - stop_tra_node.py
      The stop_tra_node.py script stops a Traffic Routing Agent in any HA cluster. Run this script as the tra user on the server hosting the Traffic Routing Agent node to stop the Traffic Routing Agent.
    - validate_tra_config.py
      The validate_tra_config.py script checks the basic configuration settings for an HA pair of Traffic Routing Agent nodes, confirms that password-less SSH access is enabled, and that basic networking parameters are set. Run this script as the tra user on a server hosting Traffic Routing Agent to validate.
  - MATRIXX Data Container Field Data Types
    MATRIXX Engine supports several data types for its network message MATRIXX Data Containers (MDCs) and database object MDCs. When you define custom MDCs and MDC fields, you must specify one of these data types for the fields.
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

start_tra_cluster.py

The start_tra_cluster.py script starts both Traffic Routing Agent software stacks in an HA pair. Run this script as the tra user on a server hosting one of the Traffic Routing Agent nodes in any TRA HA cluster.

Syntax

start_tra_cluster.py [-h] [-v] [-u username][-w seconds]

Options

The start_tra_cluster.py script has the following options:

-h, --help: Help about the script options.
-v, --verbose: Verbose output.
-u username, --as_user=username: When this option is set, run the script as the specified user. The default is the current logged in user.
-w seconds: Wait the specified number of seconds before validating the start-up status of all nodes in the cluster.

Start and Wait Five Seconds

Start the local Traffic Routing Agent and wait five seconds before returning a confirmation that the software stack has started, for example:

start_tra_cluster.py -w 5
INFO:  starting node 1...
INFO:  node 1 is started
INFO:  starting node 2...
INFO:  node 2 is started
INFO:  verifying node run statuses (5 s)...
INFO:  node 1 is running ("mtx_process_ctrl (pid 10666) is running...")
INFO:  node 2 is running ("mtx_process_ctrl (pid 26495) is running...")