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 firstname.lastname@example.org 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 email@example.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
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.
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.
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
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.
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.
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:
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.