TNG 8.0.1 Upgrade

(From v.7.x)

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 or meta.html (custom meta data & scripting)
   • mytngstyle.css (style sheet)
   • pedconfig.php (pedigree 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.

   If you were using the "Mod Manager" add-on, it is recommended that you uninstall all your mods before beginning. For more information, see the TNG wiki article TNG V8 Impacts.

   
   

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

3. Upload them. Upload all the files and folders (except the "templates" and "special" folders--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. Move custom language files.   |   Show instructions

   In your web browser, run the script upgrade_migratelangs.php (or just click the link). This operation will open a new window and attempt to move the "cust_text.php" files from your existing language folders to corresponding new folders within the "languages" folder. If you previously used any non-standard language folder names, this operation will attempt to copy the entire folders. When the operation is complete, it is recommended that you remove the upgrade_migratelangs.php file from your web site. Also, your old language folders are now obsolete. Please see the related note at the end of these instructions.

   NOTES:

   If your web server disallows this operation, you will need to move these files yourself. For example, if one of your languages was "Dutch", you would move the Dutch/cust_text.php file to languages/Dutch/cust_text.php. If you called the Dutch folder something else (like "Nederlands"), or if you have a language folder not found within "languages" (like "Creole" or "Swahili"), move the entire folder into the new "languages" folder. You will also want to review the standard language files and create translations for all the messages added in version 8.

   The new language folders include an ISO-8859-1 version and a UTF-8 version of most languages. The "UTF-8" is now included in the folder name for the UTF-8 versions. If you previously used UTF-8 but did not include that in the folder name (eg, "German" instead of "German-UTF8"), you will want to make sure that your custom text files get moved to the right location. You will also want to make sure you are using the correct file set. If this applies to you, you might also want to see the Wiki article Setup - Languages.

   
   

6. Update your template.   |   Show instructions

   If you're using a TNG template, you'll need to locate the folder for your template within the upgrade files. It should contain two additional folders, called css and img (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 them, do the following:

   1. Upload all files in these css and img folders to the new css and img folders on your site.

   2. Copy any custom images you were using with your home page or custom header or footer from the main TNG folder into the new img folder. Do not delete them from their original locations just yet. If you changed the color of your TNG tabs, then also copy the tngtab.png and tngtabactive.png files to the img folder.

   3. If you want to use the new Template Settings capability in TNG 8, copy the new footer.php, index.php, and topmenu.php files to your TNG folder, overwriting existing files with the same names (see Template Settings on the TNG Wiki for more information). If you have previously customized your template home page or header and footer, overwriting these files will cause you to lose your customizations, so in that case you might decide to skip this step. If you do skip this step, the new Template Settings will NOT update your home page or headers.

   
   

7. "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). They have been updated to load the style sheets from the new css folder. 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.

      NOTE: A few of you may still be using meta.html as your Custom Meta file instead of meta.php. If colors and fonts look wrong after the upgrade is finished and refreshing your browser does not fix it, you might still be using meta.html. You can tell by looking in the General Settings, under "Site Design and Definition", or by editing your config.php file and looking at the $custommeta value there. It MUST now say meta.php there, so if it still says meta.html, change the setting to meta.php. If you made changes to the old meta.html file, merge those changes into the new meta.php.

   2. tngrobots.php. This file gives instructions to search engines about which pages they can index and which ones they should avoid. If you have never made changes to this file in the past, just upload it from the special folder to your main TNG folder. If you have made changes to this file, do not upload the new version. Instead, just insert an entry for the new calendar page in the top section as has been done in the new file, then save it to the main TNG folder on your site.

   
   

8. Other file operations.   |   Show instructions

   In your web browser, run the script upgrade_fileops7x-8x.php (or just click the link). This operation will open a new window and attempt to do the following:

   1. Set permissions on a new configuration file called templateconfig.php. If you are keeping all your "config" files in a separate location, you will need to move this new file to that same location and make sure it still has 666 or 664 permissions.

   2. Move your mytngstyle.css file into the new css folder.

   3. Move the tngtab.png and tngtabactive.png files (the background images for the tabs that appear at the top of most pages) into the new img folder. If you've never manually changed the color of your tabs, then you don't need to worry whether this step succeeds or fails.

   4. Move your admin/genlog.txt file down into the main TNG folder and rename it to "adminlog.txt". It will also attempt to enter this new name in your Log Settings. If your admin log file was named something other than "genlog.txt", you will need to move the file and update the log settings yourself. If you have trouble updating the settings using the Admin menu (could happen while everything is in transition), you may edit the logconfig.php file directly to change this value.

   5. Update your General Settings to include two new path names ("mods" and "extensions").

   6. Update the default subroot setting in subroot.php from "../" to just "".

   When the operation is complete, it is recommended that you remove the upgrade_fileops7x-8x.php file from your web site. If any of these operations fail because your server will not allow them, you will need to perform them yourself.

   
   

9. Update the database structure.   |   Show instructions

   In your web browser, run the script upgrade_db7x-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_db7x-8x.php file from your web site.

   
   

10. LDS temple codes.   |   Show instructions

    If you want TNG to analyze your Place list and flag any 5-character, all-uppercase place names as LDS temple codes, run the script upgrade_templeconvert.php (or just click the link).

    
    

11. Map pins.   |   Show instructions

    If you previously added more than the default number of pin images for your Google Maps, move all of those .png files from the googlemaps folder over to the new img folder.

    
    

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.

NOTES:

New folders, obsolete files. This version of TNG contains several new folders. Many of the old files have been moved to these new folders, and many other files have been renamed. As a result, many of the files left over from previous versions are now obsolete and can be removed if desired. This is completely optional, and your software should run just fine with those files there. They should not pose any security risk. If you do want to remove them, however, the main groups of files that can be deleted are:

1. the entire admin folder (with the possible exception of the "index.php" and "login.php" files, which will help redirect users with the old links to the correct new locations; if you delete the entire folder, you will need to change any static links to "admin/index.php" to now point to "admin.php")
2. the googlemaps folder
3. all language folders *not* within the new "languages" folder
4. all .css and .js files *not* within the new "css" and "js" folders
5. all .jpg, .png and .gif files *not* within the new "img" folder that came with TNG. In other words, if you put your own image in the main area, you might need to keep it there.

A list of the files that can be removed from the main TNG folder can be found in obsoletefiles.txt. For more information on which files are still needed by TNG, see the appendix.html page.

Index files in media folders. Starting in Version 8, all media folders will come pre-created and will include a "dummy" index.html page. That will prevent anyone from obtaining a file listing of your media folders. Those files are not included in your upgrade, but if you would like to benefit from the same protection, just create any file called "index.html" (it can be a very short web page, or it could even be blank file saved with that name) and upload it to each of your media folders.

New Settings. New options have been added in just about every "Settings" category. Default values will be used if you don't change them, but you might want to take a look. Read the Help screens attached to those pages for more information.

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