TNG 8.1.0 Upgrade

(From v.8.0.2 )

Installation Instructions

1. Back up settings and custom files, other preparation.   |   Show instructions

   Please make a backup of the following important files before proceeding (you might need them later, even if nothing goes wrong here):

   • config.php (general settings)
   • footer.php or footer.html (custom footer)
   • importconfig.php (import settings)
   • index.php or index.html (your home page!)
   • logconfig.php (log settings)
   • mapconfig.php (map settings)
   • meta.php (custom meta data & scripting)
   • mytngstyle.css (style sheet)
   • pedconfig.php (pedigree settings)
   • templateconfig.php (template settings)
   • topmenu.php or topmenu.html (custom header)

   You might also want to back up your database tables (using Admin/Utilities), your table structure (same place), and any TNG files that you may have altered, although the risk for data loss during this upgrade is very minimal.

   
   

2. Get the upgrade files. The file you downloaded should be called tngupdate802-810.zip. Extract or "unzip" the files included in tngupdate802-810.zip to a temporary location on your hard drive. Some files should extract into subfolders called 'css', 'js', 'languages' and 'templates'.

3. Upload them. Upload all the files and folders (except the "special" folder--some of those files will be uploaded later) to the main TNG area on your web site. For many of you, the main TNG area will be the "public_html" folder. Be sure to overwrite existing files that have the same names.

4. Open this readme file from your site. If you previously opened this file from your local computer, close it now and open it again from your web site. It should be among the files you just uploaded.

5. "Special" Files - IMPORTANT!   |   Show instructions

   Do not skip this step! Some of your upgrade files should have unzipped into a folder called special. These are:

   1. meta.php and adminmeta.php. These files existed in older versions of TNG and load most of the TNG style sheets (.css files). If you have never edited the contents of these files before, just upload both of them from the special folder to your main TNG folder, overwriting any existing files with those names. If you have made changes to these files, first merge the changes you made into the new files and then upload them both to the main TNG folder.

   2. index.php. If you want to take advantage of the new template switching capability (optional!), you will either need to upload the index.php file included in the special folder, or you will need to add a few lines of code to your existing index.php page. To see what those lines are, open this index.php file in a text editor and look for the comments near the top. WARNING: If you upload this copy of index.php, you will lose any customizations you made previously to your home page!

   
   

6. Update your template.   |   Show instructions

   If you're using TNG template #4 or #5 and have never manually edited your template home page or custom header (not counting anything changed in the Template Settings), you have the option to update your template files by completing this step. It is not necessary, but it does fix a few minor issues. If you *have* made changes to your template files, you should skip this step so as not to overwrite any customizations you have made. If you proceed, locate the folder for your template within the upgrade files (if you don't remember which template you're using, compare your site to this page: http://lythgoes.net/genealogy/templates.php). Once you have found it, do the following:

   1. Upload the files in your template folder to your main TNG folder. Overwrite any existing files with the same names.

   2. If you want to use the new Template Switching capability, go to Admin/Setup/Template Settings and set "Enable Template Switching" to Yes. If you then select a template number on that same page, TNG will use the home page, header/footer and style sheet for that template from the "templates" folder. To customize any of those templates, edit the files in the corresponding folder within "templates". Selecting no template number will show your site as it is now.

   
   

7. Update the database structure.   |   Show instructions

   In your web browser, run the script upgrade_db802-8x.php (or just click the link). You will be asked to log in at this point if you haven't already. This operation will open a new window and make a few database structure changes. Your data should not be affected. You will see a short list of messages detailing what is being done, as well as a message when the script has finished. When the operation is complete, it is recommended that you remove the upgrade_db800-8x.php file from your web site.

   
   

The update should be complete. You did it! If anything doesn't look right, please try the following before asking for support:

1. Review all the instructions again. Make sure you didn't miss something!
2. Edit your browser history and delete the temporary Internet files (sometimes called the "cache"), then refresh the page.

Convenience Links:
Go to your home page
Go to the Admin menu (address is now "admin.php" instead of "admin/index.php")