Introduction

Before beginning the install process for MileMaker Guide 19 for Linux there are a few requirements before you begin. These steps are important and are required in order to proceed with a proper installation. 

1. If you are migrating from an older build of MileMaker for Linux, please ensure you remove/archive the previous installation; do not overwrite the installation as some files will be incompatible.
   
   
2. Ensure the account you are logged on with has root, or the user account has full control for /usr/micro
   
   
3. Ensure you have storage available: 128 MB of Disk Space, Requires 9 - 12 MB minimum on one processor
   
   
4. Ensure 32-bit libraries for ncurses and glibc are installed.
   Note: If you are using PuTTY or any terminal emulator, in order for the main application to function properly, during user addition, or license management, please ensure your keyboard type is set to XTERM-R6.

Preparing for the Installation

Begin by downloading the ZIP archive provided by MileMaker support. You can request this file by opening a ticket, or by contacting us via email or phone at: Support@milemaker.com or 800-234-4069 option 3.

Create the micro user

You may need to have your system administrator create this user and assign a password if you do not have permissions. 

Creating the user:

useradd micro

Setting a password:

passwd micro

Create the default install path

You may need to have your system administrator create this directory if you do not have root permissions, if you opted to create the micro user, ensure to set folder ownership with the 'chown' command below.

mkdir /usr/micro

Set ownership of micro

If you created the micro user, you may now set ownership of the micro folder.

Step 1: Change directories to the usr path

cd /usr

Step 2: Set Ownership

sudo chown micro micro

Copying the installation files

In this example, our files are stored in /root/milemaker

To proceed, we'll need to extract these files, we can either copy them or move them. For the purposes of this documentation and to avoid duplicates, we'll move the extracted folder.

Extracting the installation files

In our local directory, we'll untar the file using the command below.

tar -xvf urrmg19_2025.tar

Once completed, if you view the current files, you should see a 'g19' folder.

Moving the install files to the default install path

Next, we'll move our binaries and directories to the micro folder. This can be achieved by running the command below.

First - Move the g19 folder

mv g19/ /usr/micro

Second - Verify the directory was moved

ls -la /usr/micro

If the move was successful, the g19 folder should be present.

Setting directory permissions

Set all files in the g19 folder to 755 and set the permissions recursively for all directories and files.
From the /usr/micro folder run the following command:

chmod 755 g19/ -R
chmod 777 g19/data -R

Running MileMaker for the first time

In this step, we'll proceed with setting the environment variables, starting the routproc process, and finally the main application.

Setting the Environment Variables

First, let's navigate to the g19 folder. If you opted for the default installation path, you may copy the command below.

cd /usr/micro/g19

Next, let's set the environment variables. (Please note the dual '.' (periods))

. ./profile.19

Running the Routproc Process

Next, let's start the routproc process. Without routproc, your MileMaker instance will not compute mileage, and other processes like the main application and aca will not function.

Navigate to the executables directory

cd exe

Next, run routproc. (Please note the position of the ampersand (&)

./routproc&

Before proceeding, ensure a Process ID is listed below your routproc command, and any error like "Segmentation Fault" or "Failed" is not present.

If starting routproc was successful, proceed to running the main application.

If starting routproc was unsuccessful, please follow the Common Linux Troubleshooting guide, or contact MileMaker Support.

Starting the Main Application

On the first start, the MileMaker application will require you to enter in licensing details. Please contact MileMaker Support for your license credentials.

To begin, run the following command

./main

You may now enter in your licensing details. You may use TAB or ENTER to move between fields.

Creating your Super User account

This account is important to keep track of, this account is the only user allowed to edit/delete other users and manage licensing. In this example, we'll be using some example credentials, we'll be using rand for the username and rand for the password. We may refer to this in other KB articles.

Once you've entered in the proper credentials, the PRESS F1 TO CONTINUE will appear. You may press F1 to continue.

Install Complete

The installation for MileMaker Linux has completed. If you ran into any issues during the installation process, please contact MileMaker Support.