Welcome to Maxim Help Articles > MXUPG Maxim Version Upgrade Procedures

Procedures For Upgrading Maxim

Version upgrades must be applied in order. The latest version does not contain data fixes for prior versions. A version upgrade cannot be skipped. You must have access to the File Viewer Application ( factl.mcf file), for the required version, for a version upgrade to proceed.

Version Upgrade Files

A version upgrade will generally comprise the following zipped files:

Fictl.zip

Factl.zip

Sysfiles.zip

Help.zip

This is the Maxim application

This is the File Viewer application with version file upgrade programs

This comprises a number of .txt files

This is the latest Maxim Help files

Where Do You Put These Files

File

Fictl.zip and Factl.zip

Sysfiles.zip

Help.zip

Copy To Folder

Maxim\Ctls

Maxim\Data\Sysfiles

Maxim\Help

You will probably be replacing existing .zip files. This is OK.

Preparing To Apply The New Version

1.	Ensure that there are no users logged onto Maxim.

2.	It is highly recommended that you stop and start the Pervasive engine. This will ensure

that there are no files held open by this engine. On a NT server the Pervasive Engines

(Both SQL & Transactional) are stopped and started via Services in the Control Panel.

Under W95/98 the engine can be stopped via the Close Program Window <Ctrl + Alt + Del>.

To start the engine go to Start | Programs | Startup | Pervasive. SQL Workstation Engine.

3.	Copy the current fictl.mcf and factl.mcf files from the Maxim\ctls folder to the Maxim\ctls\backup folder.

4.	Unzip the fictl.zip and factl.zip files. This will replace the fictl.mcf and factl.mcf files.

5.	Unzip Sysfiles.zip. This will replace approximately 15 files.

6.	Unzip Help.zip. This will replace all files in the Maxim\Help directory.

7.	Copy any other files as per the version release notes.

Applying New Version

Read the version release notes supplied before continuing with the upgrade.

1.	Run Maxim and note the Corporate Group selected.

Until the data fixes are applied the Data Mismatch window will be displayed.

The Maxim application will close when trying to initiate a Log in.

2.	Go to File / Open Application and select File Viewer from the Application List.

Verify that the Viewing Database is the same name as the Corporate Group selected.

3.	Go to Data Fix / Run Data Fixes

Note: Refer to the Version Release Notes for any specific instructions regarding applying

the data fixes. A number of windows will be displayed indicating the files that are being rebuilt.

The last process includes rebuilding some system files using the.txt files supplied in the

Sysfiles.zip file. When this phase has been completed a Data Conversion Finished window is

displayed.

Note: If the system files mentioned above need to be reloaded

Go to Programs / ImportControl() This will rebuild those system files using the supplied .txt files.

4.	Select Continue to complete the upgrade for the Corporate Group. Once all data fixes have

been applied a Data Conversion Finished window will be displayed.

5.	Go: File / Open Application. Select Maxim from the Application List. You will now be

able to log in to the Corporate Group.

To select another Corporate Group

From within the Maxim application:

Go to File / Open Business. Select the required Corporate Group and repeat the Applying New Version upgrade process.

Errors

1.	Data Conversion Already Run window.

The Data Fix cannot be run more than once.

2.	Version Mismatch window

The correct data version is required to be updated. If a version upgrade is skipped, you will need to apply the Data Fixes from all the released

Maxim File Viewer applications, in the correct version order.

______________________________________________________________________________________________________________________________

Maxim Folders and Structure Overview

Maxim Folders

Maxim\

Ctls\

Backup

Data\

(Corporate Group Name 1)

(Corporate Group Name 2)

…………

Sysfiles

Reports

Magic

Temp

Folder Contents

Ctls

Fictl.mcf Is the Maxim application.

Factl.mcf Is the MaximFile Viewer and upgrade programs.

Ctls\backup

The prior version of Fictl.mcf and factl.mcf.

Data

Data\(Corporate Group Name)

Contains the data files for all companies within the Corporate Group structure. There can be multiple Corporate Group folders.

Data\sysfiles

Contains Maxim system data files that are common to all Corporate Group structures. Also contains a number of .txt files that are used to create

the first Corporate Group structure and to create default tables for all companies.

Data\reports

Holds user originated reports as controlled by Maxim's Report Output Control (ROC) for all Corporate Group structures.

Magic

Contains a MAGIC.INI and other .eng, .bmp and .atr files used by Maxim to interface with Magic.

Temp

Used by Maxim for temporary work files.

NOTE: Do not use long names for folders. The name of the Corporate Group folder is restricted to a maximum of 6 characters.

The Corporate Group Name Structure

The name given to the Corporate Group folder is the same as the name given to the Corporate Group table entry within Maxim.

Within a Corporate Group there can be any number of companies.

There can be multiple Corporate Groups.

Maxim Files That Control Corporate Groups and Companies

SYCOR:Corporate Groups

This tables contains the Corporate Groups entries. Each row has a Version column.

USER:Business Details

This table contains the companies within the selected Corporate Group.

The Basis Of Rebuilding Data Files

When a user logs into Maxim, Maxim checks the Version on the SYCOR table for the Corporate Group selected, with its internal version number.

If these is a mismatch the user log in will not proceed.

Access to the File Viewer application is required to enable a rebuild of any data files and to update the SYCOR version number.

All company files within the Corporate Group are automatically rebuilt.

A copy of the file to be rebuilt is retained with the extension .org. The files that are to be rebuilt for an upgrade are noted in the release notes.