(From v.5.x)
Back it up! Please make a backup of the following important files before proceeding (you might need them later, even if nothing goes wrong here):
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.
Get the files. The file you downloaded should be called tngupdate5x-701.zip. Extract or "unzip" the files included in tngupdate5x-701.zip to a temporary location on your hard drive. Some files should extract into subfolders called 'admin', 'English', 'font', 'googlemaps' and 'special'. There will also be folders containing updated files for all of TNG's prebuilt templates, and a folder for each language TNG supports.
Upload them. Copy all files in the admin, English, font and googlemaps folders to those same folders on your web site. Copy all files not in a folder to the main TNG area on your web site. For many of you, that will be the "public_html" folder. Be sure to overwrite existing files that have the same names.
The font and googlemaps folders are new in version 7. If your file uploader will not let you upload a new folder, you may need to create those folders on your site before you can upload the files within them. Both folders should be located in the main TNG area with the other folders mentioned above.
If you support other languages, also upload the files for those languages (also included in the update zip in their respective folders) to the proper folders on your site. 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. Or, you could put any custom messages you have created in the new file in each language folder called "cust_text.php"
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.
Convert Passwords. Passwords in 5.0 were encrypted using the "base64" method. Starting in 6.0, passwords encryption will use the stronger "MD5" method. In order for your existing logins to work, you will need to convert your existing passwords to MD5. In your browser run the script admin/pwdconvert5to6.php, which should now be in your admin folder (or just click on the link). 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, delete the admin/pwdconvert5to6.php file from your server.
IMPORTANT: This utility can only be run once! Due to the strength of this encryption method, your passwords will not be retrievable if you run it more than once! You will know it has completed successfully when you see the message "All passwords have now been MD5 encrypted." If you find yourself locked out after running this step, please go to the Admin login page and enter your e-mail address and username on the right and ask TNG to reset your password, then try to log in with your new temporary password. After that you can go to Admin/Users and set it back. If that happens, you may have to reset any other user passwords you have.
Add new table names and settings. A few new tables have been added in this version. Please go directly to your Admin area (your web address plus "admin/index.php") and log in. If you go to your home page first you may see an error!
From the Admin menu go to Setup/General Settings, then expand the line that says Table Names 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 the categories called "Paths and Folders", "Site Design and Definition" and "Media". Under Paths and Folders, make sure you fill in any blank folder names with new, unique names. Use the "Make Folder" button next to each new folder to create those folders (if this fails, please create the folders manually using your FTP program or online file manager).
The other new General Settings have default values, or they are optional and can be filled in later. 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.
IMPORTANT: Please do not miss any of the new table names! You will see database errors later on if you do! Also, don't forget to click the "Save" button at the bottom of the page to save your changes!
More new options have been added under Chart Settings (formerly "Pedigree Settings"), Import Settings and Log Settings. From the General Settings page, click on the "Configuration" tab to see the other settings buttons. Read the Help on those pages for more information. You may come back to these settings later as well.
Update the database structure. In your web browser, run the script admin/dbupdate5x-700.php (or just click the link). The file should now be in your admin folder. 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 this step is complete, it is recommended that you delete the admin/dbupdate5x-700.php file from your web site.
NOTE: Because this database update is compatible with several incremental versions, there may be some commands that have already been done, so don't be alarmed if some lines say "failed or done previously".
Permissions. There are three new files ("whatsnew.txt", "mapconfig.php" and "subroot.php") that require permissions changes. That should have been done during the database structure update you just performed. If the message says that the operation failed, please set the permissions on those file manually to 664 or 666.
Convert media. The Media structure has changed in 6.0, so you will need to convert your existing Photos, Documents, Headstones and Histories. In your browser run the script "admin/migratemedia6.php", which should now be in your admin folder. For example, I would run http://www.lythgoes.net/genealogy/admin/migratemedia6.php. If you copied the readme file to your site, you can run this conversion by clicking on this link: admin/migratemedia6.php. This will open a new window and convert your existing media to the new structure used in this version. You will see a short message during each stage of the conversion and when the script has finished. When this step is complete, delete the admin/migratemedia6.php file from your server.
NOTES: You will know the media conversion step has completed successfully when you see the message "Finished!" If you created a new "Documents" folder as an earlier part of this upgrade, this script will attempt to move your "documents" from the "photos" folder where they were before into the new "Documents" folder (along with any existing directory structure), so if you had any "documents" on your site previously, please make sure they are now located in the new "Documents" folder. If you are running your own server, please also make sure that the folders were created with the right "owner", or you may not be able to write to them. If you don't want your documents to be moved, edit your General Settings and make the Documents folder be the same as the Photos folder.
Style sheets. If you are using one of TNG's prebuilt templates, find the template folder from the upgrade that corresponds to the template you're using, then copy the templatestyle.css file from that folder to the main TNG folder on your site. In addition, if you are using the "squarish" tabs with your template instead of the slanted tabs, then also copy the "tngtabs2.css" file in the same template folder to the main TNG folder on your site. If you are using Template 6, please also copy the "tngtabs1.css" file from the template 6 folder to your site
Also, if you have made any custom changes to your genstyle.css file that were not part of any previous upgrade, you will need to copy those changes to your mytngstyle.css file if you have not done so already (if mytngstyle.css is not on your site already, use the one included with this upgrade). This upgrade contains a new genstyle.css file that will overwrite the version of that file already on your site. All future custom style changes should be made in mytngstyle.css and not in genstyle.css. If you have copied template-specific style blocks from genstyle.css to mytngstyle.css in the past, you may want to remove them so they do not override the rules now found in templatestyle.css.
meta.php, meta.html. This upgrade contains a new copy of meta.html (otherwise known as your "Custom Meta" file), as well as a new PHP equivalent, meta.php. Both are located in the "special" folder. If you have never changed your copy of meta.html, then you can simply upload either of these new files to the main TNG area. If you have made custom changes to this file, however, please merge those changes into this new file before uploading it (whichever one you decide to use). If you have changed the relative path of genstyle.css in your existing meta.html, be sure to make the same change to ALL style sheet references in this new file. If you decide to use meta.php, be sure to change the Custom Meta reference in your General Settings to reflect that.
Template updates. Due to some of the changes in this update, you may need to make a few formatting changes to your home page or custom header and footer. If you are using one of TNG's pre-built templates, please see the readme file included in this update in the folder corresponding to your template number (ie, "readme-template1.txt" in "template1") for instructions. If you're using a template but never made any changes to it, you can simply upload the files in that template folder. Can't remember which template you're using? Go to http://lythgoes.net/genealogy/templates.php page and see which one your page looks like the most.
Nuke updates. If you are running TNG as a Nuke module with the TNG Nuke Add-on by Robert Penrose, you should also download and install the updates for the TNG Nuke Add-on. The authors of other add-ons may also have updates, so please check with those authors.
The update should be complete. You did it! Before closing this page, please read the notes below.
NOTES:
1. If you'd like to use the new Google Maps feature, please go to Admin/Setup/Map Settings (new button) and read the Help screen attached to that page. You will need to get your own "key" from Google and enter it there in order to activate the feature. Note: If you were previously using a Google Maps addon, you can remove the related items from your customconfig.php and cust_text.php files, as they are no longer needed and may override the new conventions.
2.. 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. 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.
3. This version changes the default DOCTYPE declaration from HTML Transitional to XHTML Transitional. If you run into any problems related to this change, you may enter a different DOCTYPE in Admin/Setup/General Settings, or you may edit the tng_header() function in the genlib.php file and try restoring the old DOCTYPE (it has been left there, only commented out, along with a "strict" option you can also try).
4.If you look at your site after the upgrade and a bunch of menu text appears on top of the rest of the page, this means that either a) you did not complete the style sheet changes above, or b) the old style sheet is still in cache. To see if this is the case, simply refresh/reload your page.
5. If you were using the "photoblock.php" script to generate random photos somewhere on your site, you will need to paste the new code over what you were using before.
6. Obsolete Tables. The following tables are now obsolete and can be deleted as soon as you are satisfied that the upgrade was completely successful: tng_photos, tng_photolinks, tng_headstones, tng_hslinks, tng_docs, tng_doclinks. This can be done using phpMyAdmin or another similar database tool.
7. Data Security. If your Backups folder is named "backups", it is highly recommended that you rename it to something harder for hackers to guess, especially if you have your backup files stored there. You might aslo want to change the permissions on your backups folder to 771 or add a dummy index.html page to the folder to prevent anonymous online browsing.