Upgrading MITS installed on Linux

Upgrading your MITS instance on Linux is usually a matter of downloading, setting the correct permissions, and running the installer for the newest version of MITS on the MITS server.  The installer will see your existing instance of MITS and pick up all of the same settings.

The following instructions assume you are familiar with navigating and issuing commands in Linux and that your account has the correct permissions are you are running as SU or ROOT.

While this process is straight forward, it can be technical for those who are unfamiliar with Linux.  If you'd prefer to have MITS conduct the upgrade for you, contact support@mits.com to see what options are available for your account.

For customers who are using Eclipse or Prelude at their ERP, there are additional considerations beyond the scope of this document.  Those customers should contact support@mits.com to discuss having MITS perform the upgrade on their behalf.

 

Find Your License Serial Numbers

But before you begin, you will want to gather your license serial number information for both MITS Discover and MITS Report.  At the end of the upgrade you'll need to reapply the licenses with new installation keys.  Having the license serial numbers before you upgrade will save you from having to contact Support after the upgrade to get them.

In both MITS Discover and MITS Report, you'll find the license information in the menu bar of the Admin tab.

MITS Discover has two license serial numbers you'll need.  One is labeled MITS Discover Activation and the other is labeled Dashboard Activation.

MITS Report just has one license serial number and it is labeled Product Activation.

For each of these licenses, click on the link in the menu to open the dialog box containing the license serial numbers and make note of them.  Also make note of the exact way the company name is listed.  It will be important this remain the same when you re-register the products after upgrade.  You do not need the key numbers since these will change with each new version of MITS.

 

Other Considerations Before You Begin

DDI customers

If you are using the DDI ERP, you'll need to determine if the MITS database accounts are on a different server than the rest of the MITS installation.  MITS Support can help you make this determination.

 

The Properties Files

We recommend backing up and having a readable copy of the mitsdiscover.properties and mitsreport.properties files.  These files can be viewed using the CAT command and contain configurations you will want to double check during the upgrade.

These files can be found in this path.

 

../mits/webserver/shared/classes/mitsdiscover.properties

 

../mits/webserver/shared/classes/mitsreport.properties

 

Discover, Report, or Both

Know if you have just MITS Discover, just MITS Report, or both products before running the installer.  You will be asked during the wizard which products you have licenses for.  If you don't have MITS Report but select it during the wizard, this will change the landing page MITS uses to login and could confuse your users.

Typically, the installer will pick up all of the settings of your current installation and fill those in.  But it is good to double check these settings.  This is why we suggest having a copy of the properties files and an understanding of which products you're using before starting.

 

Download the Installer 

Change directories to the current location of the MITS on your server.  You should see sub-directories such as "accounts' and "jre".  If you do, this means you're in the correct location.

You can download the installer for the latest version of MITS from our FTP website.

ftp://ftp.mits.com/MITS/Core_Software

  

Set the permissions on the installer

To be sure that the installer runs with the correct permissions, make sure the file is set to include the execute permission.  In the example below, we've use the switch +x to be sure it will execute.

chmod +x MITS_linux-x64_version_number.sh

 

Stop the MITS services

You will want to be sure the MITS services are stopped before running the installer. This will mean MITS is down and inaccessible to users during the upgrade.

Prior to stopping the MITS services, double check within MITS Discover there are no hypercube updates running and within MITS Report there are no sources updating.  Stopping the services while those are occurring can lead to broken hypercubes and sources.

Issue the systemctl commands as show below.

systemctl stop MITS

systemctl stop MITSCubeBuilder

 

Update Dependencies

There are some dependencies required that cannot be included in the MITS installation package.  Run the following command to update the required dependencies.

yum install font-config freetype xorg-x11-fonts-Type1 -y

Run the Installer

With the services stopped, your system is ready to run the installer and take the upgrade.

Use the ./ command to begin the installation process.

 

./MITS_linux-x64_12_0_3.sh

 

This will start the installer wizard.  You'll be asked along the way to approve the upgrade on the existing installation of MITS and also to agree to the EULA.

During the process, there will be options for various settings.  The installer will pick up the settings from the existing installation.  Press enter to accept the default for each of these settings.

One of the questions will ask for a username and password for the internal database. The installer will show you the username in use.  Make note of that username, you'll need it in the next section.

Do not change any settings unless directed to do so by MITS Support.  Changing them can lead to MITS not working after the installation process is finished.

  

Verify Permissions

After the installer has finished, make sure all the files in the accounts directory are set to the correct user and group ownership.  This is where you will need the username you made note of in the previous step.  In our example, it is "mits". The command to issue will look like this.

chown -R mits:mits accounts

 

Start the Services

You're now ready to start the MITS services.  Use the systemctl command again, this time with the start option.

systemctl start MITS

 

systemctl start MITSCubeBuilder

 

You can verify the services have started using the status option.

 

systemctl status MITS

 

systemctl status MITSCubeBuilder

 

License MITS Discover and MITS Report

 

Once MITS Discover has been updated, you'll need to relicense MITS Discover (and its Dashboards) as well as MITS Report.

 

You can find instructions on those process here:

 

Licensing MITS Discover After an Upgrade

Licensing MITS Report After an Upgrade

 

Finally, it is best to have your users empty their cached files for MITS on their web browsers.  There is no need to clear their cookies, history, or saved passwords. This ensures the web browser is using the most current components of MITS.