(From v.4.x)
Back it up. Just in case, you might want to make a backup of the following configuration files:
Get the files. Extract all files to a temporary location on your hard drive. Some files should extract into subfolders called 'admin' and 'English'.
Admin files. Copy all files in the admin folder to the admin folder on your web site (overwrite files with same names).
Also copy the file called globallib.php (not in the admin folder) to the main TNG folder on your web site. Do NOT copy any other files from the main TNG folder at this point.
Display messages. Copy the files in the English folder to the English folder on your web site (overwrite files with same names). Again, do NOT copy any other files from your temporary location to your web site at this point. NOTES: If you support other languages, you will want to get updated versions of those files as well. If you have changed or added messages in your existing language files, you may want to copy those messages to the corresponding new language files.
Convert Passwords. Starting in 5.0, passwords in the database will be encrypted. In order for your existing logins to work, you will need to convert your existing passwords. In your browser run the script "admin/pwdconvert500.php", which should now be in your admin folder. For example, I would run http://www.lythgoes.net/genealogy/admin/pwdconvert500.php. If you copy this readme file to your site, you can run this conversion by clicking on this link: pwdconvert500.php. This will open a new window and encrypt your existing passwords. You will see a short list of messages detailing what is being done, as well as a message when the script has finished. When this step is complete, I recommend you delete the pwdconvert500.php file from your server.
New Tables and Settings. A few new tables have been added in this version. Please go to Admin/Setup & Configuration/General Settings (log in) and notice that the new table names will be blank. Please fill in unique names for these tables (make sure the new names are not shared by any existing tables).
New options have been added in each category of settings. Please find the option labeled "Tabs Style Sheet" and enter "tngtabs1.css" (no quotes) for slanted tabs or "tngtabs2.css" for square tabs, then save the changes (you can come back and change it later if you'd like to see the alternative). Also, the Server Time Offset setting has been moved here from the Log Settings, so you will need to fill that in again (check the backup you made of logconfig.php if you can't remember). The rest of the options have default values, so you don't need to change them now unless you want to. If you don't change them now, please come back later and familiarize yourself with these new settings. More information is available for each one in the Help files linked at the top of the settings pages.
Database structure changes. In your browser run the script "admin/dbupdate500.php", which should now be in your admin folder. For example, I would run http://www.lythgoes.net/genealogy/admin/dbupdate500.php. Alternately, you can copy this readme file to your site, load this file from there in your browser, then click this link: dbupdate500.php. This will open a new window and make a few database structure changes. You will see a short list of messages detailing what is being done, as well as a message when the script has finished. Your data should not be affected. When this step is complete, I recommend you delete the dbupdate*.php files from your server.
Convert Notes. The Notes structure has changed in 5.0, so you will need to convert existing notes. In your browser run the script "admin/noteconvert500.php", which should now be in your admin folder. For example, I would run http://www.lythgoes.net/genealogy/admin/noteconvert500.php. If you copied the readme file to your site, you can run this conversion by clicking on this link: noteconvert500.php. This will open a new window and convert your existing notes to the new structure used in this version. You will see a short message when the script has finished. When this step is complete, I recommend you delete the noteconvert500.php file from your server.
Style sheet updates. If you haven't changed anything in your TNG style sheet, you may skip this step (if you applied a pre-built template, then you *have* changed the style sheet). Otherwise, please continue in order to preserve your existing style elements. First, find the file genstyle.css that came with this update and open it in a text editor. Then open the copy of genstyle.css you're using on your web site. You should have both files open at the same time. Now look in the new file and search for this text:
/*these 2 lines added in 5.0*/
There should be 3 occurrences of that text. In each case, copy the note and the two lines immediately following, then paste it into the corresponding spot in your existing genstyle.css file. These lines provide shadowing for certain elements.
Next, look for this text a little further down:
/*added in 5.0.0*/
Copy that line and everything following it until the end of the file, then paste it at the end of your existing genstyle.css. Finally, save the file and copy it back to its previous location on your web site. Delete or rename the genstyle.css that came with the update so you don't accidentally overwrite the genstyle.css you want to keep.
Home page additions. This update will not overwrite your home page. However, some additions to the default home page have been made, and it has been included here as "index_new.php". Please feel free to copy any elements from index_new.php to your existing home page (index.php). You may do this later if desired. You will also notice that the default home page options have now been made language-independent. To make these elements work on your existing home page, you will need to integrate the PHP code at the top of the new home page to the top of your existing home page. Please back up your existing home page before making any changes. When your changes are complete, copy the edited index.php back to your web site.
Public files. Copy all remaining files in the temporary location (the ones *not* in a subfolder; see step 2 above) except genstyle.css (the style sheet, because you want to keep your original, with the changes made above) to the main TNG folder on your web site (overwrite files with same names). IMPORTANT: This update should not contain a copy of index.php, config.php, pedconfig.php, importconfig.php or logconfig.php. Make sure you do not copy any of those files to your TNG folder or you will lose your settings or your home page!
Convert Reports. If you have used TNG's report generator to create any reports, you will need to run this conversion routine or certain columns will no longer be displayed. If you don't have any reports, you can skip this step. Otherwise, in your browser run the script "admin/reportsconvert500.php", which should now be in your admin folder. For example, I would run http://www.lythgoes.net/genealogy/admin/reportsconvert500.php. If you copied the readme file to your site, you can run this conversion by clicking on this link: reportsconvert500.php. This will open a new window and convert your existing reports to the new structure used in this version. You will see a short message when the script has finished. When this step is complete, I recommend you delete the reportsconvert500.php file from your server.
Histories. If you have used TNG's history template to create histories in PHP, you will need to edit your existing history files. If you don't have any histories created in this manner, you can skip this step. Otherwise, start by opening the copy of historytemplate.php that came with this upgrade. Copy the "include" lines at the top of the page, as indicated by the instructions printed there. Now open each of your PHP histories stored in the "histories" folder and paste the copied "include" lines over the "include" lines found there. Save the files and copy them back to your "histories" folder. NOTE: Histories and other pages not stored in the "histories" folder do not need this conversion.
New images. The tabs used in the 5.0 interface make use of two new colored images. This update includes those images in a default color. If you applied a pre-built template, you can obtain these images in colors that match your template by installing the template update (see below). To obtain copies of these images that match a different color scheme, please run the script "switchcolor.php" in your browser. For example, I would run http://www.lythgoes.net/genealogy/switchcolor.php. If you copied this readme file to your site, you can run this utility by clicking on this link: switchcolor.php. You will see instructions on the screen for how to create and save the new images.
Nuke updates. If you are running TNG as a Nuke module, you should also download and install the updates for the TNG Nuke Add-on.
Template updates. If you are using one of TNG's pre-build templates, please also check the downloads page for updates to your template that you may wish to download and install. Instructions for the template updates are included on the downloads page.
The update should be complete. You did it!
Note on "getextras.php". The file "getextras.php" has become obsolete and has been removed. If you have linked to this page from any page on your site, you can keep the same functionality by substituting "getperson.php?tng_extras=1&" for the "getextras.php?" portion of these links.