Install and Basic Configuration

From Mupssoft Wiki
Revision as of 03:59, 11 July 2019 by Sergey (talk | contribs)
Jump to navigation Jump to search

How to install and Upgrade MupsBox

Install Firebird 3.x

There is a Firebird database used to store data like connection data to devices, temporary data, statistical data, etc. MupsBox uses version 2.5 and 3.x. Download the https://firebirdsql.org/en/server-packages/. When you start the installation, select a language, accept the terms of the agreement, select the installation folder, select which components to install (you can leave the default), create shortcuts in the menu, select additional tasks ( can be left by default).

Icon-warn.png

Warning: Use firebird ver. 3.x for faster and better work.


It's necessary to enable api or api-ssl port for communication between MUPSBOX application and RouterOS device. Use command on ROS: IP → Services

API

ip service disable www,www-ssl,ftp,ssh,telnet
ip service set api-ssl disabled=no address=1.1.1.1
1.1.1.1 - ip address of the PC where MUPSBOX is installed

The location of the program on the server.

You need to place the executable program files in the same folder with the following files

  • MupsBox.exe - is the main application, a device management GUI application.
  • MBTrafficser.exe - is a service for regularly receiving Traffic Accounting data.
  • MBBackupService.exe - is a service for running backup tasks.
  • MBFtpService.exe - is a service for running an ftp server on your PC.
  • MBSyslogService.exe - is a data collection service for the Syslog module.
  • Config.ini - application configuration file.
  • MBDB.FDB - application database file.
  • Fbclient.dll - is an application and database interaction library.
  • deftitle.rtf - File for editing the report title
  • defbottom.rtf - File for editing report style
  • ssleay32.dll and libeay32.dll - SSL libraries

Config.ini

[connection]

  • Database = C:\MupsBox\MBDB.FDB - the location of the program database file;
  • CharacterSet = UTF8
  • user_name = SYSDBA - the default login to the Firebird database
  • password = masterkey - the default password for Windows in the Firebird database

[backup]

  • backup_debug = no
  • backup_report = yes - create log files with reports on completed tasks (located in the log folder, which is located in the folder with the MupsBox program)

First start

When you first start MupsBox.exe, you should create a new database or open an existing database.

DataBase Settings

If you are installing the program for the first time, then click Create. If you already have a database, click Open.

After clicking on the selected button, a window will appear, where you need to select the path and name to save or open your database.

Select Path

After you have chosen a place to create or open your database and give it a name, click the Save or Open button. And you will see that the database was created (opened) as in the image below.

DB Created

Before install services

It's necessary to configure settings for services Syslog, FTP and also configure notifications.

Syslog

Syslog

  • 127.0.0.1 - your local IP or your IP address to listen all by UDP

  • 514 - UDP port to listen to messages

Local FTP

FTP Service

  • User - username to connect to the local FTP service

  • Password - Password to connect to the local FTP service

  • Directory - Folder in which they will connect via FTP

  • Port - FTP - port


Notifications

Notifications

  • Mail server - your mail server

  • Mail port - port without SSl

  • Mail user - username to logon to mail server

  • Mail password - password for your username

  • Mail From - Custom MAIL FROM

  • Mail global recipient - mail to send all notifications(can be redefined in jobs)

  • SSL port - port with SSl

  • Save - save your settings for notifications

  • Check - MupsBox will send test email

Install and Start services

  • To install the service, you must click on the install button next to the name of the service.

  • To start the service, you must click on the start button next to the name of the service.

Services

How to Upgrade MupsBox

  • The first step is to stop all services.

  • Next, you need to uninstall all services.

  • After downloading the archive of the new version of the program.

  • Unpack the contents of the archive into the folder where MupsBox software is installed.

  • After starting the program, the system will offer you to update the database. Click Update.

Upgrade DB

  • After updating the database, install and start the services.

Activation

Activation shows what level of license is installed in your copy of the MupsBOX program. To activate your license level, you need to fill your real email address, select the license level of the module you want to activate and click Save Level. After that, you need to generate your License ID by clicking the Get License ID button, you will receive a unique identifier that you need to send to email support@mupssoft.com, our specialists will generate a key that will send you back to email. The resulting key must be placed in the License key field, click the Save button and restart the program.

Activation