MiniM Getting Started Guide
Installation on Linux / FreeBSD
Installing MiniM Database Server and MiniMono for Linux is independent of Linux packages and has been built as executable, and can be installed to Debian-derived and RedHat-derived, or other Linux. This installer is self-extracting installer.
Before installation must be selected installer in depending of processor - i386, x86-64 or ARM. Current ARM version is 32 bit version and has been made for low version of processor, ARM6, so can be applied to all 32-bit ARM servers under Linux. If your Linux server is ARM64 (ARMv8), you must enable 32-bit support on the server before installing MiniM or MiniMono. All tools builtin into Linux version are made for the same processor - i386, x86-64 or ARM. Version for i386 can be installed onto Linux x86-64 too, but 32-bit support must be enabled in Linux too. 32-bit vesions of MiniM cannot use big cache memory such as 64-bit version, but each MiniM process have separate memory for local and internal variables, so ARM64 Linux servers with big memory can run many MiniM processes.
Unlike of MiniM installer for Windows, MiniM installer for Linux is console application and must be installed from command line. Installer have very simple interface and can be used to install MiniM on the Linux server remotedly via SSH or telnet.
After downloading installer need to be changed executable flag for this file:
chmod +x setup-minim_1.20_linux-i386
Installer through the process of installation must change access rights to internal files and subdirectories, so installer has been made to require sudo mode:
If MiniM installer will be run not under sudo, installer check it, does nothing and outputs diagnostic message.
After running installer offers to select action need to be done - install new MiniM instance or upgrade one of available on this computer:
MiniM Database Server 1.20 Installer. Copyright (C) 2019 Eugene Karataev http://www.minimdb.com Installer is switched to install mode. Select new installation or one of available to upgrade: +) New MiniM instance -) Cancel installation 0) TESTMNM2 ver 1.16 in /var/usr/minim/minimtest 1) MINIMLIN ver 1.15 in /var/usr/minim/minimlin Enter your choice:
Enter here "+" and press Enter to install new MiniM instance, enter "-" and press Enter to exit installer or enter number of MiniM instance to upgrade (enter "0" or "1" and press Enter).
If installer points to upgrade, it takes all information need for installation from this instance, otherwise, for new instance, will continue to ask need information.
After selecting install new MiniM instance installer need to know the name of this new instance:
Enter your choice: + Enter new MiniM instance name:
This name must bew unique inside of all available MiniM instances on this computer and must begin from the letter. This nmae will be used by MiniM instances to distinquish all internal shared memory objects. All MiniM instances can work independently from each other, so they does not intersects by memory.
MiniM installer uses this instance name to create default directory name to offer to install MiniM to, but asks confirmation. Here simply press enter if this default name is acceptable or enter other. Check your internal rules and conventions for software installation.
Enter your choice: + Enter new MiniM instance name: MINIM32 Enter installation directory or press Enter to use default /var/usr/minim/minim32 :
After this installer checks existing of this directory and, if it exists, asks confirmation to continue installation.
At the next install step installer asks collation of characters. MiniM does not use UNICODE encoding of symbols so MiniM server must know what need to do with symbols greater than 127 - how to collate them inside of indices and how translate to upper and lower case.
Processing database collation files... Enter key of database collation: A) Afrikaans, South Africa B) Albanian, Albania C) Arabic, Algeria D) Arabic, Bahrain ... P) Arabic, Tunisia Q) Arabic, U.A.E. R) Arabic, Yemen S) Armenian, Republic of Armenia T) Azeri (Latin), Azerbaijan Enter choice or empty to cancel or '+' to next or '-' to prior page:
Enter here letter of list item (A - T) and press Enter or enter "+" or "-" to show next or prior page with list of collations.
Installer offers to use one of known collations, and later this collation can be changed or may be created new custom character collation by using MiniM Collation Editor. It is special file with collation definition and after creation can be specified for this MiniM instance. If this new created collation definition is usable and you decide need to be included into next MiniM version, send your collation file with short description to firstname.lastname@example.org.
To illustrate collation selection I selected codepage CP1251 (it is used by default in Windows for Cyrillic):
Enter choice or empty to cancel or '+' to next or '-' to prior page: h H Collation selected: Russian, Russia (CP1251) Collation can be changed later as Locale name in minim.ini or in MiniM Control Center. Processing binary files... Run builtin MiniM Telnet Server [ Y / N]?
At the next step installer asks about running builtin telnet server. This is question not about internal Linux telnet server, it is internal MiniM part to accept incomint telnet connections to this new MiniM instance. If you select Y and press Enter, MiniM will start this internal server and you will be able to connect to MiniM throught telnet clients.
After selecting Yes installer asks about the number of the TCP/IP port need to be used for this incoming connection:
Run builtin MiniM Telnet Server [ Y / N]? y Enter telnet port number to be used:
Enter here the number of TCP/IP port and press enter. Default telnet software uses port of 23. But, unlike of Windows systems, Linux systems have own conventions about using TCP/IP ports by third-party software. Here can be recommended to specify the number of port greater outside of port numbers used by Linux, greater than 1024. This port number must be unique inside of all software running on this computer including other MiniM instances. Connection to this port will be accepted by this MiniM instance only, and other ports means telnet connections to the other MiniM instances.
After this step installer contunie installation, process internal files, run server, imports system routines, examples how to call MiniM fom other execution environment, process files for MiniM WEB Access and asks about language of offline documentation:
Processing binary files... Run builtin MiniM Telnet Server [ Y / N]? y Enter telnet port number to be used: 2325 Processing data files... MiniM Database Server for MINIM32 is started. Importing system routines... import %BACKUP import %CONX364 import %DB import %DBCLEAN import %DBCRC .... import %RSEL import %SHUTDOWN import %srv import %TNTX364 MiniM server. MiniM server ^%srv is running. Processing example's files... Processing MiniM Web Access files... Processing desktop files... Languages of documentation are available: 1) ENG (default) 2) RUS Enter your choice:
If no any choice will be entered, installer installs default localization. In depending of the MiniM version, this list can contain also other languages. Now MiniM offers only two localizations - in Russian and in English, and both variants has identical content.
After this step installer continue installation and updates menu items to run utilities for this MiniM instance:
Updating installed MiniM instance names... MiniM instance MINIM32 installation done. To uninstall MiniM Database Server 1.20 run this installer again with the -u option.
In depending of MiniM version, installation steps can be different from described here and can contain additional steps.
By default, MiniM installer installs internal GUI tools to use port 5000 for incoming TCP connections. All connection settings of GUI tools must use this port number or this port number must be changed. See special article about How to change MiniM Server Connect port. This port cannot be telnet port, becouse MiniM Server Connect use other protocol over TCP/IP.
After installation MiniM tools appears in the "Development" menu of common system menu:
Linux version of MiniM and MiniMono adds special applcation, launcher of MiniM and MiniM GUI tools:
This launcher shows by green color running state of the server and by gray color if this MiniM instance is stopped.
Press appropriate buttons to run MiniM GUI tools or simple MiniM Console:
Of course, real looks and feels of all screens on the real Linux may vary in depending of version of Linux and current localization.
To continue installation, in most cases, administrators must add starting of this MiniM instance into start secuance of the Linux. To do this, need to be used shell scripts from the /bin subdirectory of this MiniM instance:
start.sh restart.sh stop.sh
How to add this scripts to Linux start, see your Linux administration guide, becouse this steps may be different in depending of the Linux vendor and distribution.
Of course, all MiniM tools and MiniM console can be run not only from the Linux shell menu from MiniM Launcher, all this utilities are ordinal Linux applications and can be run from the /bin subdirectory of MiniM instance.