1.4.1 Install Mif2Go

If this is the first time you are installing Mif2Go, create a folder that will be the permanent home for your Mif2Go distribution files. This folder can be anywhere except under the FrameMaker plug-ins folder.

Note:

Install later Mif2Go versions over the original files, in the same folder.

For most Windows 2000 or XP systems, almost all you need to do is copy a few files from the Mif2Go distribution, and you can create an installation program to do that for you; see §1.1.3 Create or replace the Mif2Go installation script. Try §1.1 Quick start; then if you have questions, or if you run into trouble, follow the detailed instructions in this section.

Why no installer?

Omni Systems does not provide an installer for Mif2Go. This is for transparency: with a simple .bat file you know Mif2Go does not "call home", make changes to the Windows Registry, put files where your company policy does not permit them, nor alter any other files on your system. Information-system technicians can see exactly what will happen when you run the .bat file, and adjust the instructions as needed to comply with company policy.

No current installer handles FrameMaker plug-ins. This is a big problem on Windows XP, for which Microsoft says that if you use any installer, it must be based on their installer, which does not provide for installing FrameMaker plug-ins and deleting .cache files. Omni Systems programmers have spent weeks of engineering time evaluating alternatives, and it turns out that just copying a few files is best. The installation program you create yourself (see §1.1.3 Create or replace the Mif2Go installation script) does that for you, with just a double-click.

To install Mif2Go by hand:

1. Extract files. Extract the contents of the Mif2Go .zip file into your Mif2Go distribution folder. If this is not the first time you are installing Mif2Go, just copy the new files over previous files; there is no need to uninstall anything.

Note:

Keep the previous .zip file, in case you need to reinstall the old version, to check whether a new problem is related to the new version.

2. Check files. Check the extracted files against the list in §B Distribution files. If you find no .exe files, or no .dll files:

Received via e-mail	If you received the Mif2Go distribution via e-mail through a network, check with your system administrator to see if a firewall might have stripped out these files. If so, ask the system administrator how you can safely receive the files from Omni Systems.
Downloaded from Omni Systems	If you downloaded the Mif2Go distribution directly from the Omni Systems Web site, send an e-mail message reporting the problem to Omni Systems: info@omsys.com

3. Copy files from your Mif2Go distribution folder to the folders shown in Table 1-1, assuming drive C is where your operating system resides. All other extracted files can remain in your Mif2Go distribution folder. If you are installing on a Windows XP system that was upgraded from Windows NT or Windows 2000, check to make sure you are copying to the correct system folder, indicated by the value of environment variable windir. To find the value of windir, from Windows Control Panel choose:

System > Advanced > Environment Variables

Under System variables, scroll down until you see a line such as the following:

windir      C:\WINDOWS

Table 1-1 Where to place Mif2Go executable files

Executable file	Windows XP or Vista *	Windows NT or 2000	Windows 9x or ME
* Check the value of environment variable windir to determine which system folder to use.
dcl.exe exwmf.exe setini.exe	C:\WINDOWS\system32 or C:\WINNT\system32	C:\WINNT*\system32	C:\WINDOWS
dcx.dll drmif.dll dwhtm.dll dwinf.dll dwrtf.dll	C:\WINDOWS\system32 or C:\WINNT\system32	C:\WINNT*\system32	C:\WINDOWS\System
m2rbook.dll m2gframe.dll	\fm\fminit\Plugins	\fm\fminit\Plugins	\fm\fminit\Plugins
ugmif2go.chm	C:\WINDOWS\Help or C:\WINNT\Help	C:\WINNT*\Help	C:\WINDOWS\Help
msvcrt40.dll	Do not install	See Step 4	See Step 4

4. If you are installing on an older Windows system (9x, ME, or NT): look in the system folder on your hard drive for a copy of the file msvcrt40.dll. If drive C is where your operating system resides, the system folder is one of the following:

Windows 9x or ME:	C:\WINDOWS\System
Windows NT:	C:\WINNT*\System32

Not found: If you do not find msvcrt40.dll, copy the msvcrt40.dll you extracted from the Mif2Go distribution into the system folder.

Found: If you do find msvcrt40.dll, check the version number, as follows:

4.1. Right-click the msvcrt40.dll icon in Windows Explorer.

4.2. Go to Properties > Version.

4.3. Note the File version; it should be 4.00.5270 or higher.

4.4. If the file in the system folder has a version number lower than 4.00.5270, copy the msvcrt40.dll file extracted from the Mif2Go distribution into the system folder, replacing the older file. Otherwise, do not replace it.

5. Locate Mif2Go Help files. Copy ugmif2go.chm to the Windows Help folder, usually:

C:\Windows\Help

6. Review changes. Check history.txt to learn about new features and changes that are not yet covered in this guide.

If you are using FrameMaker 5.5 or a later version, follow these additional steps to set up Mif2Go as a FrameMaker plug-in:

7. Exit FrameMaker.

8. If you have not already done so, copy m2rbook.dll and m2gframe.dll from the Mif2Go distribution folder into this folder:

\framemaker\fminit\Plugins

where framemaker is the FrameMaker installation folder on your system.

9. If a file named .cache is present in the framemaker\fminit\Plugins folder, delete that file.

10. Open a document in FrameMaker, and look at the FrameMaker File menu. You should see two Mif2Go entries, as shown in Figure 1-2:

Set Up Mif2Go Export...	to set up a conversion
Save Using Mif2Go...	to run a conversion

11. Read at least §2.6 Establishing a conversion environment.

---

> 1 Getting started with Mif2Go > 1.4 What you need to do > 1.4.1 Install Mif2Go