Portable Installation

In version 246, we added support for an installation that does not use the windows installer or write to the Windows registry. In this scenario, MARC Report can be installed anywhere on your computer, such as on a flash drive, a second hard drive, etc.1) The only requirement is that you (i.e. your windows login) has read/write/create/execute permission on the installation folder.

The download for this type of installation is available to customers with a MARC Global license, or a site license. Send us an email to request the link for the 'portable installer'.

Before using this installation you should make sure that the standard installation does not work. One good reason not to use this type of installation is that it will make program updates more complicated.

Back To Top

Set-up

Use the steps below to set-up a 'flash drive' installation.

The name of the download file for the flash drive installer is formatted like this2):

mrt246z.exe
  • Download the flash drive installer and save it to your desktop.
  • Double-click on the downloaded file. This will create a folder named 'MARC Report 246' on your desktop3)
  • Drag the 'MARC Report 246' folder to your flash drive, or wherever on your system you want to put it.
  • For the purposes of illustration, let's say we dragged this folder to a flash drive named F:\, thus creating
F:\MARC Report 246
  • Copy the MARC Report registration file(s) that we emailed to you into this folder (F:\MARC Report 246). If you have a MARC Global registration, copy it here also.

Back To Top

Test

Launch MARC Report by double-clicking the executable named

marcreportZ.exe

When the program starts, goto the Help menu and select the 'Tech Support info' option. Check that the paths displayed here match the location of your flash drive folder. Check that the 'Flash drive install' parameter is “yes”.

This check is extra important when adding a flash drive install to a system that already contains a standard installation of MARC Report. (For more details on the folder layout, see the next section).

When you are satisfied that everything is ship-shape, you may

  1. make a shortcut (right-click on marcreportZ.exe and select 'Send To … Desktop')
  2. move the shortcut to a convenient location
  3. use Windows 'Pin to Start menu' option by right-clicking the shortcut
  4. use Windows 'Pin to Task bar' option by right-clicking the shortcut
  5. any combination of the above

Back To Top

Layout

When the steps in the above example are complete, the resulting folder layout will be:

Do not change any of the folder names or relative locations in this layout.

Also note the slight difference in the naming of the folder that contains the application

MARC Report 246

and the name of the folder that contains the user's options

MarcReport

This difference is intentional and must be preserved.

Back To Top

Notes

Back To Top

File association

A problem specific to multiple MARC Report installations on the same computer is this: when you double-click on a file with the .mrc extension, which installation will open it?

The answer is: whichever installation last registered the .mrc file extension.

If .mrc is setup to open in the standard installation, follow these steps to associate .mrc with a flash drive installation:

  1. Open the standard installation
  2. Goto Options|Program Automation
  3. Click on the “Unregister” button in the File Association box (bottom left in 246)
  4. Close the options and close the program
  5. Open the flash drive installation
  6. Goto Options|Program Automation
  7. Click on the “Register” button in the File Association box (bottom left in 246)

Files ending in .mrc will now open in the flash drive installation when you double-click on them

Back To Top

Changing the program folder

If you need to rename the top folder ('F:\MARC Report 246' in the example), or move the whole directory tree to another location, we recommend that you start over from scratch.

If that's not feasible, these steps should work:

First

  1. Delete the file named 'redirectIni.txt' in the 'F:\MARC Report 246' folder
  2. Delete the file named 'marcreport.ini' in the 'F:\MARC Report 246\documents\MarcReport' folder
  3. Delete any shortcuts and remove any 'Pin to …' that you made
  4. If you have customizations, backup the folder 'F:\MARC Report 246\documents\MarcReport'
  5. Move the 'F:\MARC Report 246' folder where desired.
  6. Follow the steps in the 'Test' section above

Note: these steps must be executed in the order given.

Back To Top

Copying customizations between installations

In general, there is no problem with copying customizations as long as the files are copied into the same-named folders in the other installation.

There is one file which must NEVER be copied, in either direction:

marcreport.ini

because this file uses absolute pathnames.

Here are the steps for copying MARC Global saved reviews from a standard installation to a flash drive installation.

The first task is to identify the personal folder used for customizations in MARC Report.

To do this, start MARC Report (the standard install, not the flash drive install), and select 'Help|Tech Support Info'. Go down about 6 or 7 lines from the top; find the parameter named 'Options folder', and copy the value of the parameter to your clipboard. Now open an Explorer window (Win+E) and paste the copied path into the top bar of Explorer. This will navigate to your MARC Report options.

Copy the files

OutputOptions.dat
SavedReviews.dat
SavedReviews.dsc

to the same-named folder ('Options') in your flash drive installation.

Using the example layout in the snapshot above, the full-path of the options folder would be:
F:\MARC Report 246\documents\MarcReport\options

If you have created any autoreviews, copy them also. This would be any file in the standard installation option folder that ends with the file extension

.aut

That's it. Start the flash drive installation and you should now have all of your saved reviews.

Note to programmer: it would be nice if there was a 'sync tool' to take care of this!

Back To Top

Flash drive letter

If you are using a flash drive and launching the program from a shortcut, and the drive letter of the flash drive changes, the above steps will fail whenever the drive letter of the flash drive does not match the one in your shortcut.

To resolve this problem, assign a constant drive letter to your flash drive. It does not matter what the drive letter is–what matters is that it does not change, or conflict with another assignment.

Its not hard to do this, but it does require Admin rights on the computer that you are plugging the flash drive into. Your IT people should know the steps to do this (but if not, search the web for 'static flash drive letter').

Back To Top

Updating a flash drive installation

When updating an existing flash drive installation, for the same version of MARC Report, we recommend changing the setup steps slightly.

After the installation file has downloaded (e.g., mrt246z.exe), drag it to the folder where your flash drive MARC Report was installed, before double-clicking on it.

So, continuing with the example scenario:

  • Download the flash drive installer and save it to your desktop.
  • Drag the downloaded file to the flash drive (F:\)
  • Double-click on the downloaded file.

Using these steps will eliminate a lot of Windows messages about overwriting files, while not overwriting or deleting any files that you have added to your options folder yourself.

Back To Top

Error message

It might be possible that, while testing a flash drive install, an .ini could be created with invalid folder parameters; subsequent launches will not correct this kind of problem.

If you get the message

MARC Report is not installed or registered correctly.

go back thru the steps above carefully. Once you are sure everything is in order, before starting the program again, find the file called

marcreport.ini 

located in F:\MARC Report 246\documents\MarcReport (using the example layout above).

Delete this file, then start the program


1) Note: installing MARC Report on a network share is not supported and is a violation of the license agreement
2) , 3) where '246' is the current version
help/portable.txt · Last modified: 2018/07/25 10:10 (external edit)
Back to top
CC Attribution-Noncommercial-Share Alike 3.0 Unported
Driven by DokuWiki Recent changes RSS feed