Home
MATRIXX Web App Administration
Configuring MATRIXX Backoffice Customer Tool
MATRIXX Backoffice Customer Tool can be deployed on the local host or a remote system that communicates with MATRIXX Engine through Gateway Proxy and RS Gateway.
Configuring Administrative Settings
Administrators that have access to the settings.json file can enable or disable administrative features of MATRIXX Backoffice Customer Tool. For example, viewing or deleting sessions can be enabled or disabled and debug mode can be enabled.
Configure the IMSI Requirement
When adding a device in MATRIXX Backoffice Customer Tool (either as a standalone device or as part of a subscription), providing the _glossary/imsi.html is required by default. You can make this optional by setting the IMSI_FIELD_REQUIRED flag in the settings.json file to false.

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
MATRIXX Web App Administration
- About MATRIXX Web App Administration
  MATRIXX Web App Administration describes the tasks required to install and administer MATRIXX web apps as containers, using Docker and Kubernetes.
- MATRIXX Web Apps
  MATRIXX includes the following MATRIXX web apps.
- Configuring MATRIXX Gateways and Web Apps
  In a non-containerized installation of MATRIXX, configure MATRIXX gateways and web apps using files in the /opt/mtx/conf directory in the pod(s) hosting those components. In a cloud native deployment, configuration files can be provided in the /opt/mtx/conf directory of the component container(s) using the following methods:
- Configuring My MATRIXX
  Configure My MATRIXX by configuring properties, setting up a pricing repository, configuring authentication, and importing or exporting third-party pricing data.
- Configuring MATRIXX Backoffice Customer Tool
  MATRIXX Backoffice Customer Tool can be deployed on the local host or a remote system that communicates with MATRIXX Engine through Gateway Proxy and RS Gateway.
  - Connect RS Gateway to the Event Repository
    Perform this task to configure the RS Gateway to connect to the Event Repository. The Event Repository is separate from MATRIXX Engine and is implemented in MongoDB. For information about configuring user credentials for general ledger (GL) utilities to connect to a MongoDB system, see the discussion about configuring general ledger information processing in
  - Configuring MATRIXX Backoffice Customer Tool UI
    Administrators who have access to the settings.json file can configure features of the MATRIXX Backoffice Customer Tool user interface. For example, the information that appears on the header of the UI screens, the format of balance charts, and date and time formats.
  - MATRIXX Backoffice Customer Tool Login Options
    You can log into MATRIXX Backoffice Customer Tool in two ways: using the web page login form and using a JSON POST request.
  - Simulate Payment Methods
    For testing purposes, you can simulate payment methods, such as Pay Now methods usage, if you are assigned the MTX_ROLE_SIMULATE role. To simulate credit card payments, MATRIXX Backoffice Customer Tool provides credit card icons that can be activated when you view Payment Methods for a subscriber or group.
  - Configuring Custom Settings
    MATRIXX Backoffice Customer Tool allows users to define custom event list views and additional or overriding fields for the event-details views. This setting allows users to define new list-view pages for events and define fields for the main key/value-pair view of the event-details pages.
  - Configuring Administrative Settings
    Administrators that have access to the settings.json file can enable or disable administrative features of MATRIXX Backoffice Customer Tool. For example, viewing or deleting sessions can be enabled or disabled and debug mode can be enabled.
    - Configure Viewing or Deleting Sessions
      MATRIXX Backoffice Customer Tool allows you to view or delete subscriber sessions. but this functionality is not provided in the default permissions.json file and is not included in any user role by default.
    - Simulate Usage
      For testing purposes, you can simulate subscription usage if you are assigned the MTX_ROLE_SIMULATE role.
    - Configure Debug Mode
      If you have access to the settings.json, you can enable or disable debug mode for MATRIXX Backoffice Customer Tool. When debug mode is turned on, you can display debug information at the bottom of pages where user input is required by entering the debug activation code. You can copy a page shot of the debug information and include it in correspondence with technical support or use it for reference when attempting to resolve issues. The debug information includes the URL of each request made to the specific MATRIXX Backoffice Customer Tool page and the response information.
    - Configure MATRIXX Backoffice Customer Tool Session Timeout
      You can configure the period of session inactivity after which a user is logged out of MATRIXX Backoffice Customer Tool. That is the amount of time allowed on the pod for an HTTP request to complete before timing out.
    - Configure MATRIXX Backoffice Customer Tool Request Timeout
      You can configure a request timeout for MATRIXX Backoffice Customer Tool. This is how long the UI waits for a response for a request from the pod before it gives up. To change this value, update the REQUEST_TIMEOUT argument to the settings.json file.
    - Configure Bulk Operation Settings
      For bulk operations, you can configure the options displayed in MATRIXX Backoffice Customer Tool for how many records can be processed per second and override the default location of the status files created during bulk operations, which is /opt/mtx/conf/BCT. The status files of bulk operations run on all instances of MATRIXX Backoffice Customer Tool are stored in this location.
    - Configure the IMSI Requirement
      When adding a device in MATRIXX Backoffice Customer Tool (either as a standalone device or as part of a subscription), providing the _glossary/imsi.html is required by default. You can make this optional by setting the IMSI_FIELD_REQUIRED flag in the settings.json file to false.
    - Display the Shopping Cart Flow Page
      Use the shopping cart in MATRIXX Backoffice Customer Tool to purchase the following in a single purchase request: one or more catalog items or a package containing one or more catalog items. To display the shopping cart flow page, set the SHOPPING_CART_ENABLED flag to true in the settings.json file. By default, this property is false and only the Add Offer page with catalog items displays.
- Troubleshooting
  This section has information to help identify and resolve web app issues.
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

Configure the IMSI Requirement

When adding a device in MATRIXX Backoffice Customer Tool (either as a standalone device or as part of a subscription), providing the International Mobile Subscriber Identity (IMSI) is required by default. You can make this optional by setting the IMSI_FIELD_REQUIRED flag in the settings.json file to false.

Procedure

Access the settings.json file located at /opt/mtx/conf/matrixxbct in the files for your configuration source. See the discussions about configuring MATRIXX web apps and the provided example for more information.
Update the IMSI_FIELD_REQUIRED flag to false to make defining a device's IMSI optional. This property is true by default.
Save the settings.json file.
Rebuild the configuration image and host it in your image repository.
Update your Helm values file with the new tag for the image, if necessary. See the discussions about configuring MATRIXX web apps and the provided example for more information.
Restart MATRIXX Backoffice Customer Tool.