Install and Basic Configuration

From Mupssoft Wiki
Revision as of 04:46, 6 June 2021 by Sergey (talk | contribs)
Jump to navigation Jump to search

How to install and Upgrade MupsBox

Starting with version 1.4, the program is shipped with the installer, which simplifies the process of installing and updating the program.


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 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: Firebird 2.5 database support terminated.


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

Icon-warn.png

Attention: If your antivirus warns that one of our services is Trojan or Malware, send these files to the antivirus vendor so that they add their signatures to the exceptions. We do not have Trojans and other filth.

  • 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.
  • MBPoolingService.exe - A service that polls devices for a given timer.
  • 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
  • libssh2.dll and libcrypto-1_1-x64.dll - library for the client part of sftp
  • msvcp110.dll, vcruntime140.dll, msvcr110.dll, msvcr100.dll - supporting libraries


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.

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 a test email

Local FTP/SFTP

FTP Service
SFTP 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

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

HotSpot

Hotspot

  • IP AddressSyslog for Hotspot gateway - your local IP or your IP address to listen all by UDP

  • Port Syslog for Hotspot Gateway - UDP port to listen to messages. Warning: The port must be different from the port for syslog

Options

Options

  • Number of device threads - How many threads to use for polling devices

  • Number of IP scaner threads - How many threads to use to search for devices

  • Web server port - port on which the web server will be launched

  • * debug - additional logs for services

  • Device service timer (min) - how often to automatically poll devices

  • Double click on device - choose what will happen when you double-click or when you click on enter

  • SSH/Telnet - which application will open when you click on the button Start ssh

  • Text Backup allert - Adds a warning with the given text to the message body

  • Size logs/tmp - shows folder size

  • Clear logs/tmp - clears all contents of folders

Users and permisions

When you click on the Add User button, you can add a user with defined access rights to the application.

Users and permisions

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