The Master Genealogist

What works

Installer

Program

Help (but no buttons or menu appear)

What does not

Font issue as per bug 7156

Did not check for other bug

Workarounds

What was not tested

Not everything was tested

Hardware tested

Graphics:

• GPU:
• Driver:

Additional Comments

TMG 7.04 Installed with no special settings.

Today 25 March 2012, I succeeded installing TMG v7.04 in a fresh installation of wine 1.4.0 in Mint12KDE. This is based on Ubuntu 11.10, so recent Ubunutus should be fine. I used Kernel 3.0.0-15-generic-pae KDE version 4.7.4, but Xfce & LDME work too. All fonts displayed as I would have expected.
I would like to hear others experiences with this version of wine because this seems to vary.
I followed the same instructions as succeeded with wine v 1.2.2 which are detailed below. Note that TMG had not been previously installed. It is my experience that if an installation of TMG exists, say from a preexisting home directory, then the problem with fonts not displaying which is common does not occur.

1. Install wine 1.4.0. 
  I used the instructions for Ubuntu PPA given here: http://www.winehq.org/download/ubuntu to add the ppa to repository. You can choose the version to install in Synaptic, or downgrade this if a later version than 1.4.0 does not work for you.
  Make sure that winetricks is installed.
2. Configure wine
  Use winetricks to install DLL: gdiplus & vb6run. You should find this in main menu > Wine > Winetricks.
  Use winetricks to Change Setting of:  native_oleaut32. You can also use wineconfig, if you prefer. 
3. Install TMG
  Copy tmg704uksetup.exe (or the version without uk in it for most people) to ~/.wine/drive_c/
  R click on the tmg704uksetup.exe and use Wine Installer to install. (Probably you can do this from the download directory.)
4. Initial run of TMG
  In a terminal:
    cd ~/.wine/drive_c/Program Files/The Master Genealogist v7
  wine tmg7.exe (Then run the Sample TMG database)
  (There should be no errors (err) here only lots of fixme. There were a few err: related to ole, but they did not seem to matter.
   The above appears to run perfectly. You may need to change where your data is kept by TMG.
   If you see something like 'err:ole:TLB_ReadTypeLib Loading of typelib L"oleacc.dll" failed with error 0' then you need to set native_oleaut32 as described in 2 above.


Once you check tmg running in a terminal you can do this from the Wine menu. I prefer to start it from a terminal for the initial run so that I can see error messages.

Footnote re TMG v8.2. I tried this again. The installer fails as soon as it asks for which version to install. The public beta version which used another installer installed OK.

Wine 1.6.2 or greater is recommended
NOTE: Instructions vary depending on the version of The Master Genealogist (TMG) you install.

• For versions 5/6/7 you can install with no special settings;
• For version 8/9 direct installation is only possible with a workaround for the installer.

The advice listed below is only for
those who require help installing, running, or troubleshooting TMG.

Installation:

Run the installer (you download) using Wine (substituting the correct version name):

wine tmg7setup.exe

After installation and before running program for the first time

With Wine set to "Windows XP" use the script Winetricks to install the following:

• vb6run
• gdiplus
• msxml6  *  
• wsh56  *

(* Optional - only needed if you are installing On This Day/­Second Site/TMG Utility into the same wineprefix (See advanced howto )

Using the following command:

sh winetricks vb6run gdiplus

Then using winetricks choose: native_oleaut32

(Optional but recommended)If you have Windows XP Licence.  Copy the following font to your wine font directory ( c:\windows\Fonts\ )

• wingding.ttf

* Visual Chartform (Graphical Charts) just works in wine 1.6.2 or greater.
* Text Reports and Preview just works in wine 1.6.2 or greater

For Help to Work

To use help in TMG 7.04 (+Visual Chartform) or greater install the Linux program xCHM and then using xCHM navigate to the following directory in your wine install:

C:\Program Files\The Master Genealogist\TMG.chm

C:\Program Files\The Master Genealogist\Vcf2.chm

Note:Help file for TMG 5.15 & TMG 6.12.00 work with no additional programs needed (As they use the .hlp format for the help files)

Running TMG for the first time:

Use the icon created on your desktop "The Master Genealogist"

Or run the following command from a Terminal

wine "C:\Program Files\The Master Genealogist\tmg7.exe"

Note: Before running any reports/charts in TMG for the first time  go into TMG's File > "Printer Setup" and change the Printer to *selected and choose your printer eg:in my case "HP Laserjet PS" as well as choosing the correct paper size and tray. Other wise you will see the following error:

"no printer is installed so the document could not be constructed."

To workaround the installer bug 34989  for tmg8 & 9 installers

Run wine to create a profile.

wine tmg9setup.exe /extract

* This will create two files  tmg9setup.msi & drive.cab in the same directory.

Note tmg9setup.exe will not run without the /extract at the front. It will fail due to bug 34989

The above command extracts the MS installation file which runs OK with the following command (add path to file as required):

wine msiexec /i tmg9setup.msi

Follow TMG's installers prompts

(Based on Ians instructions in test https://www.codeweavers.com/co... )

Troubleshooting:

• Use the latest version of Wine. Type 'wine --version' if you are unsure.

Based on a codeweavers entry by Ian

TMG704 works in all the above. 

In addition SecondSite3 can be installed as below in wine running TMG704 & SecondSite2 OK:

*********** to set up SS3101.exe in wine 1.1.33BETA or Stable 1.0.1

Download test version http://ss.johncardinal.com/downloads.htm
Before running ss3101.exe, enter wine config and for this application set rpcrt4.dd to be "buildin then native". It may already be set like this so this step may be optional
Then run SS3 with a command like:
    wine ~/".wine/drive_c/Program Files/Second Site 3/2ndsite3.exe"
    or one generated by wine and placed on the desktop which looked like:
    env WINEPREFIX="/home/ian/.wine" wine "C:\PROG~FBU\SECO~LSM\2ndsite3.exe"
I found that a few times wind gave an error starting "wine: Unhandled page fault on read access to..." but this cleared after restarting wine or maybe after reinstalling SS3.

When I run it I first get the registration screen and
I say continue unregistered. Then this error comes up: Run time error
339: Component vbalTreeView6.ocx or one of its dependencies is not
correctly registered: a file is missing or invalid.

I downloaded a zip of the vbalTreeView6.ocx file from
http://realityripple.com/software/deps/ Unzip this and instructions
about where to put it in different windows versions are in ReadMe.txt
file. I am emulating WinXP so I copied it to  ~/.wine/drive_c/windows/system32/

After that SS3 worked perfectly.

***** As of mid June 2010 Problem with SecondSite v3: *********************

With wine 1.2 (and I think 1.1 too) SS3 will install but on running produces this error:

Second Site 3 Version 3.2 Build 02
> Error 50003 from vbalTreeViewLib6 [LOC=4]
> Unexpected error

Added 20130413
The same applies to SecondSite5.02 (I've not tried 4 but I am sure it applies.)
The problem seems to be system32/scrrun.dll. The version with wine is 26.4KiB 20140413.
You need to get legal copies which I obtained from: 
.cxoffice 128.0KiB 20040809 or from Q210WinXP it is 168.0KiB 20080509
See this: http://stackoverflow.com/questions/12018602/should-we-deploy-scrrun-dll-windows-scripting-runtime

Changing scrrun.dll in winecfg makes no difference

For TMG7+ the Font for "Detail View" ­is controlled by "app.ini"

Changing the font listed in "app.ini" allows you to use tmg without using winetricks allfonts and reduces your need for windows

Once tmg is run and depending on if you have used the data_paths.txt file. The app.ini you need to edit is located in the user program data folder.Under wine this is located:

C:\windows\profiles\username\Application Data\The Master Genealogist v7\app.ini

Backup and then open the  "app.ini" and find the following section:

[Fonts]
ListFontName=Tahoma

You can change the listed font "Tahoma" to one of the fonts installed on your linux system (this also changes you "List Font")

Please note: The copy of app.ini in the program folder is not used by the program.

For additional information see TMG's>Data File Storage topic in help.

* TMG7 needs more control of fonts (say from tmg:ini) eg:instead of relying on windows xp's arial & tahoma & wingdings etc fonts rely on the one shipped with tmg. (so we do not have to have a win xp licence to use our purchased program.)

Views & Windows & Tools Menu in TMG7

The following are under the "Windows" menu (note:may not be listed in order)

<*> = "file>preferences>Program Options>List" font=tahoma & size=8

{#} = "file>preferences>Program Options>Other" font size only & no selection of font type (which looks to be Tahoma)

---------

    |- Person (tab)(default) <*>
    |- Family (tab) {#}

    |- Tree (tab) {#}
---------
+ Children (View) <*>
---------
+ Siblings (View)<*>
---------
+ Associates (View) <*>
---------
+ Flags (View) <*>
---------
+ Project Explorer (interactive filter) ["file>preferences>Program Options>Project Explorer"  font=tahoma & size=8 ]
---------
+ Focus Groups (interactive filter) [not effected by "file>preferences>Program Options>List"]

The following are under the "Tools" menu (note:may not be listed in order)

Tools (Menu)
 * Master Source List (?) <*>
 * Master Repository List (?) <*>
 * Master Place List (?) <*>
 * Master Event List (?) <*>
 * Master Tag Type List (?) <*>
 * Master Style List [not effected by "file>preferences>Program Options>List"]
 * Source Types (?) <*>
 * Source Elements (?) <*>
 * Research Log (?)[not effected by "file>preferences>Program Options>List"]
 * Exhibit (multi-media) Log [not effected by "file>preferences>Program Options>List"]
 * DNA Log (?) <*>
 * State/province abbreviations [not effected by "file>preferences>Program Options>List"]
 * Timeline Manager (?) <*>
 * Check for Duplicate People (?) <*>
----------
Add (Menu)
 * Add Person (?) <*>
----------
View (Menu)
 * Bookmark Manager (?) <*>
----------
Report (menu)
 * Book Manager (?) <*>
----------
File (menu)
 * Data Set Manager (?) <*>
 * Flag Manager (?) <*>
 * Accent (Definitions) <*>

• see wine appdb: Wise Installation System v9.02

• Alinetmg.ttf
• Foxfont.fon
• helvsb75.TTF
• Helvss75.ttf
  

• ARIAL.TTF
• WINGDING.TTF
• TAHOMA.TTF
  

Below is a summary of how I installed TMG7 in a separate wine v1.1.15 directory (~/.wineTMG7Test1) in Ubuntu Hardy 804 on Acer Travelmate 3004 & a generic PC. This is based on method here by Nathan N. given on this site.
­
This shows how to install TMG7.04 in a separate wine-1.0 directory called .wineTMG7Test1. This will work for normal wine installation if "env WINEPREFIX=~/.wineTMG7Test1" is removed. It was installed in an Acer Travelmate 3004 & a generic PC in Ubuntu Hardy 8.04. Based on method here by Nathan N. However note some important modifications.
NB the changes that I have made from previous versions with respect to the Libraries and the removal of association of dll files from Default to tmg7.exe" This is important if you want to run other programs in the same wine installation directory.

  $env WINEPREFIX=~/.wineTMG7Test1 winecfg    (Using wineprefixcreate is now deprectated and winecfg does the same thing.)

  Get winetricks from http://wiki.winehq.org/winetricks or use:
  $wget http://www.kegel.com/wine/winetricks

  $env WINEPREFIX=~/.wineTMG7Test1 sh winetricks gecko ***
  $env WINEPREFIX=~/.wineTMG7Test1 sh winetricks dcom98
  $env WINEPREFIX=~/.wineTMG7Test1 sh winetricks fakeeie6
  $env WINEPREFIX=~/.wineTMG7Test1 sh winetricks gdiplus (important to do this)
  $env WINEPREFIX=~/.wineTMG7Test1 sh winetricks allfonts  ***
         (the lines marked *** are not needed in wine after version 1.1.12 - I think.)
$env WINEPREFIX=~/.wineTMG7Test1 sh winetricks msxml6 wsh56  (Required for Second Site & TMG Utility. See installation note by Nathan N above.)

  (Copy winding.ttf arial.ttf from WinXP)
  (On one of my PCs winetricks refuses to create the fonts, although it indicates no errors, so I had to copy these from a Win installation.)


   $cd /home/ian/.wineTMG7Test1/drive_c
   copy tmg7uksetup.exe to this directory

   $env WINEPREFIX=~/.wineTMG7Test1 winecfg
   Set Default to be WinXP
   Set tmg7uksetup.exe to run as Win98

   Install TMG7
   $cd ~/.wineTMG7Test1/drive_c
   $env WINEPREFIX=~/.wineTMG7Test1 wine tmg7uksetup.exe

   Select under Applications tab "tmg7.exe" then go to Libraries tab & set ole32.dll, oleut32.dll, rpcrt4.dll to be (native then build in).
   (It may be necessary to do this for Vcf2.exe and rrw/rrwrun.exe as well but it seems to be OK without this. The list of other .exe files which might be affected is viewer/tmgss.exe, /rrw/pdfinstall.exe, WiseUpdt.exe.)

NB Be careful here, if you select under the Libraries tab "Default" then some progs which run in this WINEPREFIX may stop working. This is known to be the case with these: set them back to builtin for Dreamweaver, Fireworks perhaps, Breeze Downloader, Photshop7 perhaps.

   $env WINEPREFIX=~/.wineTMG7Test1 wine tmg7uksetup.exe

   Create file:   NB See note below about UserData path & Backup problem.
   /home/ian/.wineTMG7Test1/drive_c/Program Files/The Master Genealogist v7/Data_paths.txt to contain: (replace ian with your linux login name)
       [ian]  
    SharedProgramData=C:\TMG7\SharedProgramData
    UserProgramData=C:\TMG7\UserProgramData
    UserData=C:\TMG7\UserData

   $env WINEPREFIX=~/.wineTMG7Test1 winecfg
       Go to C:\Program Files\The Master Genealogist v7\Vcf.exe
           Set Vcf.exe to run as Win98
       Go to C:\Program Files\The Master Genealogist v7\rrw\rrwrun.exe
           Set rrwrun.exe to run as Win3.1

   To run TMG7
   $cd     "/home/ian/.wineTMG7Test1/drive_c/Program Files/The Master Genealogist v7/"
   $env WINEPREFIX=~/.wineTMG7Test1 wine tmg7.exe

  To view TMG and other .chm help files install xchm (or gnchm if you prefer).
  Then $cd ~/.wine/drive_c/Program Files/The Master Genealogist v7  click on TMG.chm or Vcf.exe for Visual Chart Form and the help will appear.

**** The backup/restore problem has been corrected in tmg v7.04. Obtain these from:

http://www.whollygenes.com/files/tmg7setup.exe
http://www.whollygenes.com/files/tmg7uksetup.exe    for UK version

Do not attempt to use the tmg update facility it appears to break the installation. Use the setup program above. The 30 day trial is removed by entering your serial number and so on.

********** NB Backup problem before tmg v7.04 ***********************************
NOTE WELL: As yet, the Backup project does not function correctly under either Wine or Crossover. When a Backup is performed all appears to go correctly and the .sqz file is created. Restore works correctly but I find that I get the message "Nothing to Restore". The Backup has backup all configurations but ignored the Project files. I see no warning to this effect. I wonder if there is a dll relating to zip that has to be altered.
There is a workaround. All the Project files are in the directory UserData=C:\TMG7\UserData stated in Data_paths.txt.

Solution 1: just back these up periodically.

Solution 2: Change C:\TMG7\UserData to in, say, the home directory as UserData=z:/home/ian/TMG7Backups, or wherever seems best for you.

This problem exists when TMG7 is insalled for All User, or just for a single user, ian. The problem does not exist when using WinXP in Win4Lin with the UserData kept on the home directory so it is not a program error and does not seem to be related to permissions.
*****************************************************************

I have not found a way to uninstall  TMG7 from wine or in Crossover (by setting UNWISE.EXE to Win98, for example). It may be wise to install TMG7 in its own WINEPREFIX, as above, to avoid a broken wine installation after a failed uninstall.

Note: I have not succeeded in getting SecondSite version 2 or TMGUtility both by John Cardinal to run in wine-1.0 or any earlier version.  I gave got it them to install in Crossover v7.0. SS3 will install & run in Crossover v9.1.0 but fails to run in wine v1.2. (see additional notes above).  I have worked out how to install TMG7 in Crossover when that different components of it have to be run as different version of Windows. See the Crossover DB: http://www.codeweavers.com/compatibility/browse/name/?forum=1;app_id=874;mhl=28168;msg=28168#msg28168.  

[username]

SharedProgramData=C:\TMG7\SharedProgramData

UserProgramData=C:\TMG7\UserProgramData

UserData=C:\TMG7\UserData

Copy "Data_paths.txt" to "C:\Program Files\The Master Genealogist v7" or the path you installed TMG.

### Install TMG704 in own wine bottle directory. It is safer to do this especially if you are considering installing TMG8. They run fine in separate wine directories but seem to much each other up in the same directory. This can probably be resolved in winecfg, but is it worth it? You need a licence to run anything other than the time limited version of this program. Get it from www.whollygenes.com

export WINEPREFIX=~/.wineTMG7New20130807_1  ### create the WINEPREFIX to make the inst of wine
cd ~/    ### allows winetricks to run create the WINEPREFIX to make the inst of wine
env WINEPREFIX=~/.wineTMG7New20130807_1 sh winetricks  ### test winetricks works

env WINEPREFIX=~/.wineTMG7New20130807_1 sh winetricks ie7  ### install ie7 & run once.

env WINEPREFIX=~/.wineTMG7New20130807_1 sh winetricks winxp ### set bottle to winxp

env WINEPREFIX=~/.wineTMG7New20130807_1 sh winetricks corefonts

env WINEPREFIX=~/.wineTMG7New20130807_1 sh winetricks vb6run  ### install Visual Basic 6 runtime

env WINEPREFIX=~/.wineTMG7New20130807_1 sh winetricks vcrun6sp6 ### install VisualBasic 6 service Pack6 sets "*msvcrt"="native,builtin" ### change later in wineconfig in next line

export WINEPREFIX=~/.wineTMG7New20130807_1  ###  inst of wine
env WINEPREFIX=~/.wineTMG7New20130807_1 winecfg  ### change "*msvcrt" to "builtin then native" NOT NEEDED in TMG7 I think

env WINEPREFIX=~/.wineTMG7New20130807_1 sh winetricks native_oleaut32 ### without it shows no fonts

env WINEPREFIX=~/.wineTMG7New20130807_1 sh winetricks tahoma ### tahoma.ttf v1.00 works later ones do not check at website below for others
  ### http://www.microsoft.com/typography/fonts/font.aspx?FMID=238 in
  ### wine_tahoma work as well from https://aur.archlinux.org/packages.php?ID=28630

cd ~/.wineTMG7New20130807_1/drive_c/  ### change to dir of
cp /media/AcerWinData/Downloads/GenealogySoftware/TheMasterGenealogist/tmgv7/tmg704uksetup.exe .
dir
env WINEPREFIX=~/.wineTMG7New20130807_1 wine tmg704uksetup.exe

### copy wine fonts_tahoma,
cd ~/.wineTMG7New20130807_1/drive_c/windows/Fonts
  ### get fonts_tahoma.ttf & fonts_tahomabd.ttf from here:
  ### wine_tahoma work as well from https://aur.archlinux.org/packages.php?ID=28630  ###  copy them into this dirtory

### Now check permissions of font files
cd ~/.wineTMG7New20130807_1/drive_c/windows/Fonts
dir -l  ### they should be  -rw-r--r--

#### now run TMG7 - always remember to change WINEPREFIX before.
cd ~/.wineTMG7New20130807_1/drive_c/Program\ Files/The\ Master\ Genealogist\ v7/  ### change to wine installation
export WINEPREFIX=~/.wineTMG7New20130807_1   ### make sure your are using correct wine
env WINEPREFIX=~/.wineTMG7New20130807_1 wine tmg7.exe

### The best way to run this is like this from a terminal: NB Full dir path including /home - change to yours.

 env WINEPREFIX=/home/YOUR_HOME/.wineTMG7New20130807_1 wine '/home/YOUR_HOME/.wineTMG7New20130807_1/drive_c/Program Files/The Master Genealogist v7/tmg7.exe'

### Run winetricks or winecfg for this installation like this

env WINEPREFIX=~/.wineTMG7New20130807_1 sh winetricks

env WINEPREFIX=~/.wineTMG7New20130807_1 winecfg

You can also use CrossOver for all this - it might be easier:

http://www.codeweavers.com/compatibility/browse/name/?app_id=874

Ian