Learn about: RIMMF Installation

As outlined on the Download page, there are two methods of installing RIMMF. Whichever method you choose, the RIMMF install layout is basically the same.

In each case, the installation consists of one application named 'rimmf3.exe', support modules with the file extension '.dll', and two sub-folders included in the installation directory:

  1. a 'defaults' folder – a backup of the tables distributed with the program.
  2. a 'RIMMF' folder – the folder where all user modifiable data is stored

Because RIMMF installs files in the “Program Files” folder, you will need Administrative privileges to install the software. (If this is a problem, then use the 'Flash drive installation' instead).

If you are an Admin installing RIMMF for someone else, all you need to do is run the installer, and make sure the end-user has a shortcut with which to launch the program. Once they start the program, it will automatically generate all of the files and folders needed by the user.

Compatibility with RIMMF1 and RIMMF2

The RIMMF1 app is named rimmf.exe, the RIMMF2 app is named rimmf2.exe, and the RIMMF3 app is named rimmf3.exe

Similarly, note that RIMMF1 folders are simply named 'RIMMF'; whereas RIMMF2 folders will be named 'RIMMF2', and RIMMF3 folders will be named 'RIMMF3'. This note applies to both My Documents and Program Files.

Apart from this naming difference, all of the notes pertaining to the layout of the distribution folders, etc., are the same for all versions.

Installation folder

For the standard installation, the default location for the application and sub-folders is:

C:\Program Files\TMQ\RIMMF3

Note: in a Windows 64-bit environment, the default installation folder will be:

C:\Program Files (x86)\TMQ\RIMMF3

For the 'zipfile' or flash drive installation, the default installation location is whatever folder you unzip the download to. If you accept the default, the extraction folder will likely be named:

Z:\setupRimmf3\

where 'Z“ is whatever letter was assigned to your flash drive.

RIMMF Folder layout

In the standard installation, a 'RIMMF3' folder, along with a number of sub-folders (listed below), is created in the 'My Documents' library of the current Windows user the first time that the program runs. This is where the RIMMF records that you create will be stored.

The procedure is the same in the flash drive installation–the only difference will be the location of the folders.

The layout of the 'RIMMF2' folder is the same in both installations; it contains these sub-folders:

  1. ap (access-point profiles)
  2. data (where your records are stored)
  3. exports (where exported data is stored)
  4. imports (where imported data is stored)
  5. tables (the program tables)
  6. temp (where temporary files and folders, e.g., zip folders) can be stored)
  7. templates (the templates that come with RIMMF, plus any you create yourself),
  8. tmq* (a few test records)

*In RIMMF3, the 'tmq' folder was renamed to 'sample records'

The main folder also contains some important files that you should leave untouched:

  • options.ini
  • r2m-options.ini
  • rda2marc-Cdata.txt
  • RIMMF3.log

Technical notes

The program looks for the 'RIMMF3' folder in your 'My Documents' folder when it starts. If it does not find the folder there, it looks for it in its startup folder (the location of the 'rimmf3.exe' application). If it does not find a 'RIMMF3' folder there either, it will create a new layout (as above) in the My Documents area.

Both the windows installer, and the flash drive installation, will position and locate the support folder correctly. Do not move any of these folders around.

RIMMF does not use the windows system registry. Instead, all options are saved in an .ini file in the root of the support folder (eg. My Documents\RIMMF3\options.ini).

Uninstalling RIMMF

If you have created any records or templates with RIMMF that you want to preserve, then before uninstalling the program, copy or move the corresponding folders:

  • In the standard installation, preserve
    • My Documents\RIMMF3\data
    • My Documents\RIMMF3\templates
  • In the 'flash drive' installation, goto the folder where you unzipped the program archive and preserve
    • RIMMF3\data
    • RIMMF3\templates.

To uninstall RIMMF

Find the installation folder and delete it.

Optionally, in the standard installation, delete the RIMMF folder from your My Documents area.

Reset RIMMF3 to its default state

To restore RIMMF to its distributed state, follow these steps:

  1. Start the program
  2. Go to the menu Tools|Admin and select 'Restore default tables'
  3. Respond to the usual 'Are you sure?' pop-up
  4. Re-start RIMMF (it will close itself when the previous step completes)

Using this option does not affect any records or templates you have made.

Its possible that after such a reset–if you have created your own templates with elements that you added yourself–you may get messages about 'orphan' or 'undefined' elements when using these templates. This is because you added elements whichare no longer in the tables, yet still being referenced from the templates.

There are two solutions to this problem.

  1. Delete the template(s) that produce this message and create new ones.
  2. Open the template (File|Open template), dismiss the popup, then save the template.
installing.txt · Last modified: 2023/06/07 20:39 by 127.0.0.1
Back to top
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki