Recent changes to Install

Install modified by Tim Wahls

Tim Wahls — Sat, 08 Oct 2016 16:11:22 -0000

--- v33
+++ v34
@@ -137,11 +137,8 @@

 To upgrade from FARMDATA1.4 to FARMDATA1.5, you must adjust several tables in
 your farm information database.  The necessary commands are:
-
 
 alter table utilized_on modify fieldSpread float;
-alter table tSprayMaster drop crops;
-alter table tSprayField add column crops text after numOfBed;
 alter table dir_planted add column annual tinyint(1) default 1;
 alter table dir_planted add column lastHarvest date;
 update dir_planted set lastHarvest = concat(year(plantdate), '-12-31');

Install modified by Tim Wahls

Tim Wahls — Fri, 07 Oct 2016 17:17:27 -0000

--- v32
+++ v33
@@ -37,7 +37,7 @@
   to ensure that the install procedure can be executed
 3. execute the command:  ./install.sh
 4. the install procedure will prompt you for the information listed above
-5. after collecting all information, the install procedure will create and populate databases as needed, configure the source files and move them to the installation directory.  Additionally, the install procedure will create a file called config that contains the details of your FARMDATA configuration.  Copy this file to a safe location, as you will need it in order to upgrade to new FARMDATA versions in the future.
+5. after collecting all information, the install procedure will create and populate databases as needed, configure the source files and move them to the correct directory.  Additionally, the install procedure will create a file called config that contains the details of your FARMDATA configuration.  Copy this file to a safe location, as you will need it in order to upgrade to new FARMDATA versions in the future.
 6. report any installation issues by creating a ticket at: 
 https://sourceforge.net/p/farmdata/tickets/
 Make sure to copy and paste any error messages into your ticket.  Note that you need to be a sourceforge member to create a ticket.

Install modified by Tim Wahls

Tim Wahls — Fri, 07 Oct 2016 17:01:27 -0000

--- v31
+++ v32
@@ -87,18 +87,19 @@

 To upgrade to a new version of FARMDATA while keeping your existing databases (and their contents):

-1. download the new version of FARMDATA and unpack it
-2. copy the config file that was created when you installed FARMDATA into the FARMDATA1.1 directory that was created in the previous step
-3. cd into the FARMDATA1.1 directory
+1. download the new version of FARMDATA and unpack it.  We will refer to this version as FARMDATA1.X.
+2. copy the config file that was created when you installed FARMDATA from the original installation directory into the FARMDATA1.X directory that was created in the previous step.
+3. cd into the FARMDATA1.X directory
 4. execute the command:  ./install.sh
 5. the install procedure will ask you to accept the license agreement, and whether your web server supports SSL.  If you have obtained an SSL certificate since installing FARMDATA, you can upgrade FARMDATA to run over SSL by answering "y" here.
 6. the install procedure will detect the config file and ask you whether you wish to upgrade your existing FARMDATA or to do a new installation.  If you decide to do a new installation, delete both databases created during your initial FARMDATA installation before proceeding.  If you decide to upgrade your existing FARMDATA, the install procedure will configure the new source files and copy them to the installation directory, but will leave your existing databases unchanged.

+NOTE: to upgrade by multiple versions, follow the upgrade instructions for each intermediate version.  For example, to upgrade from FARMDATA 1.2 to FARMDATA 1.5, first make the table modifications specified below for upgrading from FARMDATA 1.2 to FARMDATA 1.3, and then the modifications for upgrading from FARMDATA 1.3 to 1.4 (none in that case), and then finally the modifications for upgrading from FARMDATA 1.4 to 1.5.  You only need to upgrade the code for the version you are upgrading to - that is, you do not need to download the code for and upgrade to FARMDATA 1.3 and 1.4 to upgrade from FARMDATA 1.2 to 1.5.
+
 #####Upgrading from FARMDATA1.0 to FARMDATA1.1#####

 If you are upgrading from FARMDATA1.0 to FARMDATA1.1, you must adjust several of the
-tables in your farm information database (in addition to the upgrading the code as in the previous section).  Connect to your farm information database from phpMyAdmin or a terminal and execute the the following commands.  In phpMyAdmin, paste the commands into
-the "Run SQL Query" box and click "Go":
+tables in your farm information database (in addition to the upgrading the code as in the previous section).  Connect to your farm information database from phpMyAdmin or a terminal and execute the following commands.  In phpMyAdmin, paste the commands into the "Run SQL Query" box and click "Go":
 
 alter table coverCrop drop column id;
 alter table coverCrop add column active tinyint(1) default 1 after legume;
@@ -117,8 +118,6 @@
 alter table distribution add column pricePerUnit double default 0 after unit;
 

-To upgrade from FARMDATA1.0 to FARMDATA1.2, first use the commands above to upgrade to FARMDATA1.1, then upgrade to FARMDATA1.2.  You do NOT need to install the code for FARMDATA1.1 before upgrading to FARMDATA1.2.
-
 #####Upgrading from FARMDATA1.2 to FARMDATA1.3#####

 To upgrade from FARMDATA1.2 to FARMDATA1.3, you must adjust several tables in your farm information database.  The necessary commands are:
@@ -130,18 +129,37 @@
 alter table tSprayMaster drop column crops;
 

-To upgrade from FARMDATA1.0 to FARMDATA1.3, first use the commands above to upgrade to FARMDATA1.1, then upgrade to FARMDATA1.2, then FARMDATA1.3.  You do NOT need to install the code for FARMDATA1.1 or FARMDATA1.2 to upgrade to FARMDATA1.3.
-
 #####Upgrading from FARMDATA1.3 to FARMDATA1.4#####

 No table modifications are necessary when upgrading from FARMDATA1.3 to FARMDATA1.4.  Simply follow the upgrading instructions above.
+
+#####Upgrading from FARMDATA1.4 to FARMDATA1.5#####
+
+To upgrade from FARMDATA1.4 to FARMDATA1.5, you must adjust several tables in
+your farm information database.  The necessary commands are:
+
+
+alter table utilized_on modify fieldSpread float;
+alter table tSprayMaster drop crops;
+alter table tSprayField add column crops text after numOfBed;
+alter table dir_planted add column annual tinyint(1) default 1;
+alter table dir_planted add column lastHarvest date;
+update dir_planted set lastHarvest = concat(year(plantdate), '-12-31');
+alter table dir_planted modify lastHarvest date not null;
+alter table dir_planted modify plantdate date not null;
+alter table transferred_to add column annual tinyint(1) default 1;
+alter table transferred_to add column lastHarvest date;
+update transferred_to set lastHarvest = concat(year(transdate), '-12-31');
+alter table transferred_to modify lastHarvest date not null;
+alter table transferred_to modify transdate date not null;
+

 ####Adding Farms to an Existing FARMDATA Installation####

 The procedure for adding a new farm will prompt you for the MySQL admin username and password, the user's database, and the full path to the installation directory.  The user's database is the first value in the config file that was created when you installed FARMDATA, and the installation directory is the second to last value in this file.  (The values in this file are separated by :'s.)  Make sure that you have this information before adding a new farm.

 To add a new farm:
-1.  in the FARMDATA1.4 directory, execute the command: ./addfarm.sh
+1.  in the FARMDATA1.X directory, execute the command: ./addfarm.sh
 2.  enter the information listed above when prompted
 3.  enter the name of the database for the new farm and the username and password for the initial user (admin) account when prompted
 4.  enter the full path to the installation directory when prompted

Install modified by Tim Wahls

Tim Wahls — Fri, 07 Oct 2016 16:50:31 -0000

--- v30
+++ v31
@@ -7,6 +7,8 @@
 * you have console (terminal) access to your web server
 * your server is running Linux or some other flavor of Unix
 * your server has PHP (version 5.3 or higher) and MySQL Server (version 5.1 or higher)
+* the PDO module for PHP and MySQL is installed.  You can check this by executing the command (from the terminal): php -m | grep pdo_mysql
+ If the command produces one line of output (containing: pdo_mysql), then the module is installed.
 * you have the PEAR PHP extension installed
 * you have the Mail and Mail_Mime PEAR packages installed (only for emailing invoices)
 * you know your domain name (i.e. web server hostname)
@@ -30,7 +32,7 @@

 ####Installing FARMDATA####

-1. cd into the FARMDATA1.1 directory (created when you unpacked the FARMDATA source)
+1. cd into the FARMDATA1.X directory (created when you unpacked the FARMDATA source).  The X represents the FARMDATA version number - currently 1 - 5.
 2. execute the command: chmod 755 install.sh
   to ensure that the install procedure can be executed
 3. execute the command:  ./install.sh
@@ -49,7 +51,7 @@

 * as described in Section "Planning Your FARMDATA Installation" above, create the user account and farm information databases and a database user for each.  You will likely do this via cpanel or some other control panel provided by your web hosting company.
 * use phpMyAdmin to log in to the user account database as either the user for the user account database that you created above or an administrative user. 
-* click the SQL tab, and copy and paste the contents of the file tables/userTables.txt (from the FARMDATA1.1 directory) into the "Run SQL Query" box.  Click "Go" and verify that the query executed successfully.
+* click the SQL tab, and copy and paste the contents of the file tables/userTables.txt (from the FARMDATA1.X directory) into the "Run SQL Query" box.  Click "Go" and verify that the query executed successfully.
 * clear the contents of the "Run SQL Query Box"
 * in the "Run SQL Query" box, enter:
 insert into farms values ('INFODB', 'INFODBPASS', 'INFODBUSER');
@@ -75,9 +77,9 @@
 * Click "Go" and verify that the query executed successfully.
 * log out of phpMyAdmin
 * use phpMyAdmin to log in to the farm information database as either the user for the farm information database that you created above or an administrative user. 
-* click the SQL tab, and copy and paste the contents of the file tables/baseTables.txt (from the FARMDATA1.1 directory) into the "Run SQL Query" box.  Click "Go" and verify that the query executed successfully.
+* click the SQL tab, and copy and paste the contents of the file tables/baseTables.txt (from the FARMDATA1.X directory) into the "Run SQL Query" box.  Click "Go" and verify that the query executed successfully.
 * clear the contents of the "Run SQL Query Box"
-* copy and paste the contents of the file tables/dfTables.txt (from the FARMDATA1.1 directory) into the "Run SQL Query" box.  Click "Go" and verify that the query executed successfully.
+* copy and paste the contents of the file tables/dfTables.txt (from the FARMDATA1.X directory) into the "Run SQL Query" box.  Click "Go" and verify that the query executed successfully.
 * proceed with normal FARMDATA installation as described in the previous section.
 * when you are finished, you should be able to log in to FARMDATA using the username you specified above and the unencrypted password that you specified.  That is, use the value that you typed for $str and not the encrypted value that the website returned.

Install modified by Tim Wahls

Tim Wahls — Sun, 20 Mar 2016 16:32:03 -0000

--- v29
+++ v30
@@ -130,12 +130,16 @@

 To upgrade from FARMDATA1.0 to FARMDATA1.3, first use the commands above to upgrade to FARMDATA1.1, then upgrade to FARMDATA1.2, then FARMDATA1.3.  You do NOT need to install the code for FARMDATA1.1 or FARMDATA1.2 to upgrade to FARMDATA1.3.

+#####Upgrading from FARMDATA1.3 to FARMDATA1.4#####
+
+No table modifications are necessary when upgrading from FARMDATA1.3 to FARMDATA1.4.  Simply follow the upgrading instructions above.
+
 ####Adding Farms to an Existing FARMDATA Installation####

-The procedure for adding a new farm will prompt you for the MySQL admin username and password, the user's database and username and password for the user's database user, and the full path to the installation directory.  The user's database and username and password for that database are the first three values in the config file that was created when you installed FARMDATA, and the installation directory is the last value in this file.  (The values in this file are separated by :'s.)  Make sure that you have this information before adding a new farm.
+The procedure for adding a new farm will prompt you for the MySQL admin username and password, the user's database, and the full path to the installation directory.  The user's database is the first value in the config file that was created when you installed FARMDATA, and the installation directory is the second to last value in this file.  (The values in this file are separated by :'s.)  Make sure that you have this information before adding a new farm.

 To add a new farm:
-1.  in the FARMDATA1.1 directory, execute the command: ./addfarm.sh
+1.  in the FARMDATA1.4 directory, execute the command: ./addfarm.sh
 2.  enter the information listed above when prompted
 3.  enter the name of the database for the new farm and the username and password for the initial user (admin) account when prompted
 4.  enter the full path to the installation directory when prompted

Install modified by Tim Wahls

Tim Wahls — Mon, 07 Sep 2015 20:08:01 -0000

--- v28
+++ v29
@@ -7,6 +7,8 @@
 * you have console (terminal) access to your web server
 * your server is running Linux or some other flavor of Unix
 * your server has PHP (version 5.3 or higher) and MySQL Server (version 5.1 or higher)
+* you have the PEAR PHP extension installed
+* you have the Mail and Mail_Mime PEAR packages installed (only for emailing invoices)
 * you know your domain name (i.e. web server hostname)
 * you know whether or not your web server provides Secure Sockets Layer (SSL) via an SSL certificate.  Running FARMDATA over SSL is highly recommended.
 * you know the full path to the document root directory for your web server (that is, the directory that your web server serves files from).  If you have a dedicated server, the document root directory will be something like "/var/www/html".  If you have a shared hosting account, the document root directory will likely be a subdirectory of your home directory.

Install modified by Tim Wahls

Tim Wahls — Fri, 29 May 2015 18:41:46 -0000

--- v27
+++ v28
@@ -115,7 +115,7 @@

 To upgrade from FARMDATA1.0 to FARMDATA1.2, first use the commands above to upgrade to FARMDATA1.1, then upgrade to FARMDATA1.2.  You do NOT need to install the code for FARMDATA1.1 before upgrading to FARMDATA1.2.

-#####Upgrading from FARMDATA1.2 to FARMDAA1.3#####
+#####Upgrading from FARMDATA1.2 to FARMDATA1.3#####

 To upgrade from FARMDATA1.2 to FARMDATA1.3, you must adjust several tables in your farm information database.  The necessary commands are:

Install modified by Tim Wahls

Tim Wahls — Fri, 29 May 2015 18:41:22 -0000

--- v26
+++ v27
@@ -122,8 +122,7 @@
 alter table comments add column id int auto_increment primary key;
 alter table product add column active tinyint(1) default 1;
 alter table tSprayField add column crops text;
-update tSprayField set crops = (select crops from tSprayMaster where
-  tSprayMaster.id = tSprayField.id);
+update tSprayField set crops = (select crops from tSprayMaster where tSprayMaster.id = tSprayField.id);
 alter table tSprayMaster drop column crops;

Install modified by Tim Wahls

Tim Wahls — Fri, 29 May 2015 18:40:38 -0000

--- v25
+++ v26
@@ -90,7 +90,7 @@
 5. the install procedure will ask you to accept the license agreement, and whether your web server supports SSL.  If you have obtained an SSL certificate since installing FARMDATA, you can upgrade FARMDATA to run over SSL by answering "y" here.
 6. the install procedure will detect the config file and ask you whether you wish to upgrade your existing FARMDATA or to do a new installation.  If you decide to do a new installation, delete both databases created during your initial FARMDATA installation before proceeding.  If you decide to upgrade your existing FARMDATA, the install procedure will configure the new source files and copy them to the installation directory, but will leave your existing databases unchanged.

-####Upgrading from FARMDATA1.0 to FARMDATA1.1
+#####Upgrading from FARMDATA1.0 to FARMDATA1.1#####

 If you are upgrading from FARMDATA1.0 to FARMDATA1.1, you must adjust several of the
 tables in your farm information database (in addition to the upgrading the code as in the previous section).  Connect to your farm information database from phpMyAdmin or a terminal and execute the the following commands.  In phpMyAdmin, paste the commands into
@@ -106,7 +106,7 @@
 alter table config add column gens tinyint(1) default 1 after bedft;
 

-####Upgrading from FARMDATA1.1 to FARMDATA1.2
+#####Upgrading from FARMDATA1.1 to FARMDATA1.2#####

 To upgrade from FARMDATA1.1 to FARMDATA1.2, you must adjust one additional table in your farm information database.  The necessary command is:
 
@@ -114,6 +114,20 @@
 

 To upgrade from FARMDATA1.0 to FARMDATA1.2, first use the commands above to upgrade to FARMDATA1.1, then upgrade to FARMDATA1.2.  You do NOT need to install the code for FARMDATA1.1 before upgrading to FARMDATA1.2.
+
+#####Upgrading from FARMDATA1.2 to FARMDAA1.3#####
+
+To upgrade from FARMDATA1.2 to FARMDATA1.3, you must adjust several tables in your farm information database.  The necessary commands are:
+
+alter table comments add column id int auto_increment primary key;
+alter table product add column active tinyint(1) default 1;
+alter table tSprayField add column crops text;
+update tSprayField set crops = (select crops from tSprayMaster where
+  tSprayMaster.id = tSprayField.id);
+alter table tSprayMaster drop column crops;
+
+
+To upgrade from FARMDATA1.0 to FARMDATA1.3, first use the commands above to upgrade to FARMDATA1.1, then upgrade to FARMDATA1.2, then FARMDATA1.3.  You do NOT need to install the code for FARMDATA1.1 or FARMDATA1.2 to upgrade to FARMDATA1.3.

 ####Adding Farms to an Existing FARMDATA Installation####

Install modified by Tim Wahls

Tim Wahls — Wed, 22 Apr 2015 17:02:44 -0000

--- v24
+++ v25
@@ -109,7 +109,6 @@
 ####Upgrading from FARMDATA1.1 to FARMDATA1.2

 To upgrade from FARMDATA1.1 to FARMDATA1.2, you must adjust one additional table in your farm information database.  The necessary command is:
-
 
 alter table distribution add column pricePerUnit double default 0 after unit;