Update UPDATE.txt

Author: craigdietrich

UPDATE.txt

@@ -7,10 +7,6 @@ Scalar is a PHP and MySQL application built with CodeIgniter.
 ***
 This document assumes that you have a working copy of Scalar operating on your server, and that you wish 
 to update to the most recent Scalar release. If you wish to install Scalar from scratch please see INSTALL.txt.
-***
-
-***
-A note on Scalar releases: 
 Of course, you can always update your Scalar install from the most recent build on GitHub.  However, 
 sometimes bugs can be introduced by commits to GitHub that haven't yet been verified by Scalar's development 
 team.  For this reason we keep checkpoints ("releases") of Scalar using GitHub Releases. Details below.
@@ -41,9 +37,33 @@ date that the codebase assumes that the update exists).
 ANY UPDATE TO SCALAR 2.1 FROM ANY PREVIOUS VERSION INVOLVES A NEW SET OF INSTRUCTIONS!
 ***
 
-INSTRUCTIONS FOR UPDATE TO SCALAR 2.1 FROM ANY PREVIOUS SCALAR VERSION:
+INSTRUCTIONS FOR UPDATING TO SCALAR 2.1 FROM ANY PREVIOUS SCALAR VERSION:
 
-(These instrucitons are pending; instructions will be written when the new release is made.)
+1) Extract the release ZIP file into a NEW folder; make sure that .htaccess is visible or transferable in the root folder so it doesn’t get left out
+3) Optional: open ‘codeigniter.php’ in the NEW root folder and change ‘production’ to ‘development’, to display PHP errors during development
+2) Copy ‘system/application/config/local_settings.php’ from the existing LIVE folder location to its corresponding NEW location
+4) Do not copy any other config files; rather, copy values kept in the files in the existing LIVE folder to the files in the NEW folder.  Unless you’ve made a lot of changes these are likely the only values you’ll need to migrate:
+system/application/config/config.php: $config['uri_protocol']
+system/application/config/config.php: $config['log_threshold']
+system/application/config/config.php: $config['encryption_key']
+system/application/config/config.php: $config['cookie_prefix']
+system/application/config/config.php: $config['cookie_domain']
+system/application/config/database.php: $db['default']['hostname']
+system/application/config/database.php: $db['default']['username']
+system/application/config/database.php: $db['default']['password']
+system/application/config/database.php: $db['default']['database']
+system/application/config/content_lang.php: $land[‘install_name’]
+5) Optional: edit .htaccess in the existing LIVE root folder, and remove the “#” comment characters that prepend the two lines under “# To route all requests to a maintenance page, uncomment these lines”, then save; this will temporarily make Scalar unavailable, routing all requests to maintainance.html.
+6) Delete the “system” folder from your existing IVE root folder (or, to be safe, rename the system folder to “system.bak”)
+7) Copy the NEW “system” folder to the existing LIVE root folder
+8) Overwrite the ‘codeigniter.php’ in the existing LIVE root folder with the ‘codeigniter.php’ in the NEW root folder
+9) In Scalar’s MySQL database, change the ‘ip_address’ field in ‘scalar_db_sessions’ to VARCHAR(45), or simply run this SQL statement:
+ALTER TABLE scalar_db_sessions CHANGE ip_address ip_address varchar(45) default '0' NOT NULL
+10) Optional: edit .htaccess in the LIVE location again; add the “#” comment characters back to the two lines under the maintenance comment; saving will bring Scalar back from being unavailable
+11) Check https://github.com/anvc/scalar/wiki/Changes-to-config-files-over-time to see if any other changes to the database or local_settings.php are needed
+12) Check to make sure Scalar is working properly.  If so, delete ‘system.bak’ (if applicable).  Enjoy!
+Note: you may need to change the permissions off system/application/logs so that CodeIgniter can write log files if you have them enabled in config.php.
+Note: you’ll need to reinstall the import/export transfer tool: download it from https://github.com/Michael628/scalar-book-transfer-tool and place in a new folder ‘transfer’ at system/application/plugins/transfer
 
 INSTRUCTIONS FOR UPDATING ANY SCALAR VERSION BEFORE 2.1 TO ANY OTHER SCALAR VERSION BEFORE 2.1: