Home
MATRIXX Web App Administration
Configuring My MATRIXX
Configure My MATRIXX by configuring properties, setting up a pricing repository, configuring authentication, and importing or exporting third-party pricing data.
Setting Up a Pricing Repository
MATRIXX uses the Apache™ Subversion™ source control system to maintain all pricing files contained in a pricing repository. The pricing repository is comprised of one or more independent pricing domains, each of which contains the files that make up a pricing plan for that domain. The pricing repository holds all the versions of files from all the pricing domains managed by an instance of My MATRIXX.
Verify Access to My MATRIXX
Use My MATRIXX to verify that the web services required by My MATRIXX are running and that My MATRIXX can read the pricing repository.

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.
  - Configure My MATRIXX Properties
    Perform this task to give My MATRIXX access to database schema extensions for validation purposes, define the location of the master data directory and the logging directory, and to define the number of pricing revisions to compile into a pricing XML configuration file.
  - Setting Up a Pricing Repository
    MATRIXX uses the Apache™ Subversion™ source control system to maintain all pricing files contained in a pricing repository. The pricing repository is comprised of one or more independent pricing domains, each of which contains the files that make up a pricing plan for that domain. The pricing repository holds all the versions of files from all the pricing domains managed by an instance of My MATRIXX.
    - MATRIXX Pricing Repository
      All items that comprise a pricing plan are based in XML and stored in a pricing repository in the Subversion version control system.
    - Pricing Domains
      A domain defines a single instance of a working pricing plan and provides access to all items in that catalog. You can have multiple domains in a pricing repository, each of which is independent from the other and is password-protected so only authorized users can gain access.
    - My MATRIXX Master Data Directory
      My MATRIXX has a master data directory that it uses to manage changes performed by multiple users on the same pricing domain. My MATRIXX supports hosting SVN repositories for pricing files in persistent storage outside of the My MATRIXX container.
    - Verify Access to My MATRIXX
      Use My MATRIXX to verify that the web services required by My MATRIXX are running and that My MATRIXX can read the pricing repository.
    - Administering the Pricing Repository
      Administering a domain includes adding domains to a pricing repository, enabling domain recreation, and importing and exporting domains.
    - Managing My MATRIXX Users
      Managing users in My MATRIXX includes tasks such as creating user accounts, granting access to pricing domains, assigning roles and privileges, resetting user passwords, and deleting user accounts.
  - Lock a Pricing Compilation by Default
    Pricing compilations created in My MATRIXX can be configured to be locked by default by defining the lockPriceCompilation property in the matrixx.yaml file. Locked pricing compilations cannot be deleted even if they are not in use. If the lockPriceCompilation property is not added to the matrixx.yaml file, then pricing compilations are unlocked by default.
  - Disable Schema Validation for Deployments
    Before deployment, the system and provider schema versions of pricing and tax compilations are validated against the system and provider schema versions of the engine on which these compilations are being deployed. This validation can be disabled by setting the pricingDeployment and taxDeployment properties in the matrixx.yaml file to false. Validation is enabled by default.
  - Configuring the Pricing Controller
    Before performing price compilation tasks in My MATRIXX, configure the _glossary/pricing_controller.html, which is responsible for retrieving an engine status, transmitting a pricing compilation to an engine, and loading a pricing compilation onto an engine. The configuration is done through the Pricing Controller Helm sub-chart. For more information, see MATRIXX Configuration.
  - Configure My MATRIXX Session Timeout
    You can configure the period of session inactivity after which a user is logged out of My MATRIXX.
  - Configuring the My MATRIXX Security Warning Message
    My MATRIXX administrators can enable and customize a security warning message that displays when logging into My MATRIXX by adjusting the settings in their Helm values file as follows:
  - My MATRIXX Connection Properties
    config/r_mm_config_properties.html#reference_bbm_ndg_zwb__table_wrb_fdd_mhb lists the connection properties for My MATRIXX.
  - Importing and Exporting Third-Party Data
    This section provides information about how to import pricing data into My MATRIXX and export the data into third-party software applications.
- 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.
- 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

Verify Access to My MATRIXX

Use My MATRIXX to verify that the web services required by My MATRIXX are running and that My MATRIXX can read the pricing repository.

About this task

As a system administrator who created a pricing repository and added a sample pricing domain to it, you can now verify access to My MATRIXX by logging in to the system as the Guest or Admin user defined for the sample pricing domains. These users were either created by importing the _configuration files when the local repository was created or they are created when you start the Gateway Proxy and RS Gateway for the first time. The first time you log in to My MATRIXX, you are prompted to enter a username and password. The password you enter for the initial login of the Admin or Guest user is set in the system for that user.

Procedure

In a web browser, go to the My MATRIXX Login page:
http://ipaddress:port/matrixx/login.html
The IP address and port are defined by the external load balancer.

If the Welcome page opens, the setup is correct. If it does not, log into the My MATRIXX pod as user matrixxsw and enter the following command to check if all required applications are running:

sudo systemctl status mtx_mymatrixx

Start any required application that is not running.
In Username and Password, enter guest (or admin) and a password, and click Log in to open the main console.
If you can log in, this verifies that a workspace for the guest (or admin) user sample domain was created successfully (by checking it out of the pricing repository). A successful login also verifies that the My MATRIXX master data directory is configured correctly. The My MATRIXX master data directory is used by My MATRIXX to determine what pricing domains exist and determine the credentials of users allowed to use My MATRIXX.

What to do next

By default, the admin user of a newly installed My MATRIXX system has all global role access privileges, including those required for managing My MATRIXX user accounts. When logged in as admin user, you can create My MATRIXX user accounts and assign roles to those accounts. See My MATRIXX Help for information about creating My MATRIXX users and assigning user roles.