Mobius Management Platform Installation
All Mobius products are designed as parts of a large distributed system installed as the cluster. It is up to you to decide which parts shall work together, and which parts shall remain standalone.
All parts (product servers) that are planned to work together should be set up as a single cluster sharing the same Cluster name (e.g. “main”). The Node ID should be unique for each product server (for example, “ussd001”), but the product servers that share the same cluster also share the same general configuration settings, authentication data, storage parameters, database etc. So during the installation of any Mobius product to the different server (node) on the same cluster (where you have another Mobius product operating already), you only need to confirm that you will use the same configuration database, and the Install wizard loads all required options from it automatically and requests only the data that lacks (for example, the new license).
The servers for the standalone products are to be set up independently, the single clustered server for the single product. That means you should specify different Cluster names (e.g. “cluster1”, “cluster2” etc.) when installing and configuring these products. The requirements for the cluster nodes remain the same (unique Node ID for each product server), however that does not make much difference, as there shall be only single standalone products, and their server cluster structure ensures only the operations reliability.
Product Installation Prerequisites
-
Linux (Ubuntu) operating system with Chrome browser installed
-
Mongo DB installed
-
Java 8 or higher version installed
General Product Settings
These settings are to be entered during the installation and can be tuned up later, too.
Connection string format
Mobius services use various data providers to store the required information and make access to this data distributed for a bunch of clients.
The different data providers may be used on different stages (e.g. you can have Mongo for Configuration and Authentication, and S3 for Storage).
To properly access that data the connection string is to be used. Depending on the data provider the connection string format differs as follows:
S3 (Amazon Web Services, AWS)
Value |
Definition |
Connection string format
|
s3://REGION.amazonaws.com/BUCKET?key=KEY&secret=SECRET |
REGION |
Amazon Web Services (AWS) region. For the list of region codes, see AWS service endpoints. |
BUCKET |
Bucket name that contains the files |
KEY, SECRET |
Login credentials. For information, see Using secrets from vaults in connections. The details on login credentials are also explained here: https://aws.amazon.com/blogs/security/wheres-my-secret-access-key/ and here: https://www.msp360.com/resources/blog/how-to-find-your-aws-access-key-id-and-secret-access-key/ |
Mongo
Value |
Definition |
Connection string format |
mongodb://[USERNAME:PASSWORD@]HOST[:PORT][/[DEFAULTAUTHDB][?OPTIONS]] |
USERNAME:PASSWORD@ |
Optional. Authentication credentials. |
HOST[:PORT] |
The host (and optional port number) where the Mongo is running. You can specify a hostname, IP address, or UNIX domain socket. If the port number is not specified, the default port 27017 is used. |
/DEFAULTAUTHDB |
The authentication database to use. |
?<OPTIONS> |
Optional. A query string that specifies connection specific options as <name>=<value> pairs. See Connection String Options for a full description of these options. |
JSON, XML
Value |
Definition |
Connection string format |
Local folder address (full path) where the json or xml config files are stored. |
Configuration Settings
Configuration provider defines where the master data related to Mobius products installation would be stored and how.
Term |
Definition |
Cluster Name |
The cluster your Mobius Management Platform is installed to |
Node ID |
The node ID your Mobius Management Platform is installed to. Node ID should be unique for each product server. |
Configuration Provider |
There are several types of providers that rely on various configuration sources. Mobius Management Platform uses the following:
|
Connection String |
Connection string used for configuration provider. See Connection string format for the details. |
Authentication Settings
Authentication providers define users and roles used for authentication. User names, IDs, and passwords are some examples of information stored in the providers.
Term |
Definition |
Authentication Provider |
Mobius Management Platform uses the following:
|
Connection String |
Connection string used for authentication provider. See Connection string format for the details. |
Storage Settings
A cloud storage provider hosts a customer's data in its own data center, providing fee-based computing, networking and storage infrastructure. Rather than store data on local storage devices, such as a hard disk drive, flash storage or tape, customers choose a cloud storage provider to host data on a system in a remote data center. These files can be accessed then from all servers where Mobius products are installed.
Term |
Definition |
Storage Provider |
Mobius U Management Platform uses the following:
|
Storage String |
Connection string used for storage provider. See Connection string format for the details. |
Images Settings
Some Mobius products require images for their work (e.g. icons, product logo, etc.). These images for better accessibility are stored in the Storage location (specified in Storage Settings before), but with some additional parameters.
Term |
Definition |
Images Host |
The host address (located at previously defined Storage) where your images are stored. |
Images Folder |
The folder (at the defined host) where your images are stored. |
GZIP |
Whether your images are to be stored in archived form. |
Store revalidation |
Whether the revalidation is required for Store operation.
|
Proxy revalidation |
Whether the revalidation is required for Proxy operation. |
Max Age |
Due to the storage service usage terms your images could be stored only temporarily. Please specify the “life period” after which they will be automatically deleted. |
Shared Max Age |
Due to the storage service usage terms your shared images could be stored only temporarily. Please specify the “life period” after which they will be automatically deleted. |
Web Settings
Parameters for Mobius Management Platform Web server configuration, used to manage the installed Mobius product via Web or API.
Term |
Definition |
Host |
IP address for the Mobius Management Platform. |
Port |
Port settings used to address the Mobius Management Platform on the IP address specified. |
HTTP/HTPPS |
Non-trusted or trusted connection. |
CORS |
Whether the cross-origin resource sharing (CORS) is to be enabled by your Mobius Management Platform. If several products are to be integrated, CORS is required for all of them. |
Client state password |
Data accessed via the web is to be additionally protected. Mobius uses 32-char long, strong, and unique passwords. You can set one, for example, via the Random Password Generator https://www.thebitmill.com/tools/password.html Note: one key is to be used for one cluster. |
SSL Settings
Additional parameters for Secure Socket Layer (SSL) connection to Mobius Management Platform. Used only if Trusted connection is chosen at Web Settings.
Note: The SSL data is provided in Privacy-Enhanced Mail (PEM) format which is de facto standard for storing and sending cryptographic keys, certificates, etc.
Term |
Definition |
Certificate |
Digital certificate that authenticates a website's identity and enables an encrypted connection. |
Certificate Chain |
An ordered list of certificates, containing an SSL/TLS Certificate and Certificate Authority (CA) Certificates, that enable the receiver to verify that the sender and all CA's are trustworthy. |
Private Key |
SSL uses two long strings of randomly generated numbers, which are known as private and public keys. A public key is available to the public domain as it is a part of your SSL certificate and is made known to your server; a private key remains a secret only you know. |
Whitelabel Settings
The parameters of the installed Mobius product as the user will see it.
Term |
Definition |
Product Name |
Name of the installed product reproduced on the general page. You may rename it for your own taste. |
Product Title |
Title of the installed product reproduced at the browser tab heading. You may rename it for your own taste. |
Product Icon |
The product icon shown in the main menu and browser tab heading. You may use the default icon or upload your own, and it will be stored with all product images, see Images_Settings. |
Favorites Icon |
The favorites icon shown in the main menu. You may use the default icon or upload your own, and it will be stored with all product images, see Images_Settings. |
Database Settings
Parameters used to control how the Mobius product is accessing the database.
Term |
Definition |
Core Workers
|
The number of core modules addressing the database, as planned. The range is 2-16, max value is 2 * number of processors (e.g. if the server has 4 CPU, the Core Workers number should not exceed 8). |
Initial Connections per Worker |
Total number of core-DB connections, initially. You can play with these values later if the connection to the database is slow. |
Max Connections per Worker |
Total number of core-DB connections, max. You can play with these values later if the connection to the database is slow. |
DB name |
The database where the main service information is stored. Mobius USSD Gateway uses only Mongo DB here. |
DB connection string |
Connection string used for data provider. See Connection string format for the details. |
Reporting Settings
Parameters used to control Mobius Management Platform reporting. The statistics reports are stored in a separate stats database.
Term |
Definition |
Periods
|
Reporting period. You can select whether it will be done once per minute, once per hour, once per day, or once per month. |
Stats Initial Connections |
Total number of Stats-DB connections, initially. You can play with these values later if the connection to the database is slow. |
Stats Max Connections |
Total number of Stats-DB connections, max. You can play with these values later if the connection to the database is slow. |
Stats DB name |
The database where the service stats information to be reported is stored. Mobius USSD Gateway uses only Mongo DB here. |
Stats DB connection string |
Connection string used for data provider. See Connection string format for the details. |
History Expiration |
Statistics report expiration period, in seconds (total). |
Hourly History Expiration |
Statistics report expiration period, in seconds (hourly stats). |
Daily History Expiration |
Statistics report expiration period, in seconds (daily stats). |
Monthly History Expiration |
Statistics report expiration period, in seconds (monthly stats). |
Statsd Host | Statictics database host address for external connection |
Statsd Port | Statictics database host port for external connection |
License Settings
The Mobius product license itself. All Mobius products require a valid license to be operable.
Term |
Definition |
Existing license
|
Optional field. Used only during the installation if you already have license data in your database (e,g, for the license that has been revoked), and this license has unused server nodes (for example, the license covers three servers, and only one is installed already). When selecting, the existing license also shows the number of used and remaining nodes, as each product license is issued for the strict number of server nodes to be active on. |
License key |
The key for the new license. |
License |
The new license. |
Install Wizard
-
Extract the installation package to the Mobius product folder on your server and launch startup.sh file.
-
Open Mobius product starting page in Chrome.
-
On the first launch, the initial configuration is to be performed. Proceed all pages one-by-one entering the data specified in appropriate settings tables.
-
After the initial configuration is performed, the Mobius Management Platform Login screen is displayed.
Start innovating with Mobius
What's next? Let's talk!