Your preparation to upgrade to version 6.4 SP1
You need to have a "Version 6.4" license at hand, before starting the upgrade process.
To be eligible for a 6.4 license you need to have a valid support subscription (Gold or Silver) with us, at least up to 20. June 2018 or later.
- If you do not yet have a 6.4 license, then please request this from email@example.com once you are ready to upgrade.
farmerswife Client Upgrade
IMPORTANT: The built-in farmerswife (fw) Client auto-upgrade process IS DIFFERENT!!!
The normal "simple in-application auto-upgrade" is NOT supported on the initial upgrade from lower version.
In order to upgrade, the fw Client applications either need to be ONCE manually upgraded (see direct links below).
Or each user can use the built-in FULL-installer-download auto-upgrade functionality (if allowed), which will be triggered upon first log-in to the already upgraded fw Server application.
This means, upon login with the fw Client Desktop app, the user has to choose a location where the installer file will be stored on the local machine ... to then automatically continue with the manual upgrade process.
The simple auto-fwClient upgrade will work again for any farmerswife Client which was once manually upgraded past 6.4 Beta 8 rev. 17068.
The auto-Client-upgrade functionality will NOT work for WIFE Clients below v6.1 SP1.
Direct download links for the farmerswife Client desktop applications:
Any WIFE Client which was NOT manually upgraded, will state this message upon log-in: "Connection to the Server Timed Out"
IMPORTANT when upgrading the WIFE Client on Mac: If you have a mix of Admin and Standard users on a Mac, make sure to be logged-in as a Standard user. Then after mounting the .dmg file, drag-and-drop it to the Applications folder. You then need to authenticate with theAdmin users credentials! The farmerswife Client will not work for the Standard user, if installed while being logged-in as the Admin user.
Download the "Public Installers"
Upgrading step by step
- Your WIFE Server needs to be running on version 6.3 Service Pack 1 rev. 17162 to be ready for the upgrade.
Every farmerswife version contains specific upgrade code. To ensure a properly running system, you need to always upgrade the farmerswife Server application to the last Public released version!
Here the general upgrade path for all farmerswife Server's since v5.2:
From 5.2 SP1 to 6.0 SP5
From 6.0 SP5 to 6.1 SP1
From 6.1 SP1 to 6.2 SP1
From 6.2 SP1 to 6.3 SP1
From 6.3 SP1 to 6.4 SP1
Please contact firstname.lastname@example.org should you have any questions.
Inform your colleagues about this new version BEFORE you upgrade.
Run a "Full Backup" BEFORE the upgrade. <= Use the "Full Backup Now" button located on the running WIFE Server application.
While the Full Backup is taking place, you could now take a look into the documents provided in the "Read And Use Me Upgrade Package"
you were issued together with your license of the previous Released version.
The upgrade itself might require a couple of "Forced Shutdowns" for it to finish; this depends on your usage of the system.
If needed, see more detailed information in the Installation Instructions.
Ensure you have the latest Java version (JRE on Windows/Linux, JDK on Mac OS X) installed, for the Web Client and Mobile Web Client and Play to work properly and in the most secure way. Watch out on Windows: here you can run the fw Server application in 32bit mode (farmerswife.exe) or 64bit mode (farmerswife 64bit.exe); and depending in which mode you're running the WIFE Server, you _must_ have JRE installed in the corresponding 32bit or 64bit version.
farmerswife Server upgrade on Mac
Copy the NEW farmerswife Server package to the machine hosting the WIFE Server.
Un-zip and rename it to include "NEW" in the package name.
Place it in the same location as the previous running farmerswife Server.
Quit the running WIFE Server.
Rename the previous farmerswife Server, to include "OLD" in the package name.
On both packages do <Control> + click and select "Show Package Contents" in the pop-up menu.
In the OLD package select the "system" and "files" folders and use <Control> + click and select "Copy 2 Items" in the pop-up menu.
Note: The "files" folder might not even exist within your WIFE Server's package, since it was possibly broken out to reside on some mounted storage device within your network. Ensure that this Volume is properly mounted.
Have any files been customized?
If any of the below points apply, then don't forget to manually migrate these files from the OLD WIFE Server package > "Show PackageContents" > ... to the new one.
a) Has anything been changed or customized within "html_templates"?
=> Ideally you compare first compare your customised files from within the "html_templates" with the new ones from us. There might be new functionality available; you'll need to adapt this. Then only migrate the customized files.
b) Did you "SSL-ify" your farmerswife system?
=> follow your own logged instructions in regards to which of these files "server.pem, skey.pem, keystore, jetty.xml" have to be migrated.
c) Are you using any 3rd party integration scripts?
=> browse to ... contents > lib > scripts > ... to get to the location where integration scripts are located. And then only copy the actual integration script files from the according sub-folder within the new farmerswife Server package.
Within the NEW farmerswife Server package use <Control> + click and select "Paste 2 Items".
Now copy the new 6.4 license files into the "system" of the NEW WIFE server, thus replacing the previous ones.
Double click on the NEW farmerswife Server package icon to start the actual upgrade process.
Once everything worked out fine, remove or update any Dock or Desktop links. And if needed remove the OLD Server package; because
up until now, this was a working "roll-back" backup, just in case something went wrong.
After the upgrade, start the farmerswife Server as usual. Then once you've successfully upgraded, please inform us by sending a short email to email@example.com; this is very helpful information for us to improve our service to you.
farmerswife Server upgrade on Windows and Linux
IMPORTANT: In case you have customised any files (e.g. some files within "html_templates", server.pem, skey.pem, keystore, jetty.xml 3rd integration scrips, etc.), ensure that they are set as "Read Only", so you don't overwrite them with our files included by default! During the installation process, simply then use the "Ignore" button when the Installation Wizard is not allowed to modify these "read-only" files.
Make sure you are logged into the host machine with the same admin user as on the initial installation of the fw Server application.
Copy the NEW farmerswife Server installer file to the machine hosting the WIFE Server.
=> On Windows this is a .exe file.
=> On Linux 64bit, this is also an executable file; use in a command shell: chmod +x Linux64_... to make it "installable".
Quit the running farmerswife Server.
Now copy the new 6.4 license files (license.dat and license.txt) into the "system" folder of your WIFE Server, thus replacing the previous ones.
Double click to run the installer file in the same manner as the previous installation (e.g. did you use "Run As Administrator" on Windows?).
Follow the instructions of the install wizard. IMPORTANT: While installing make sure the previous installation path is correctly set.
After the upgrade, start the farmerswife Server as usual.
Once you've successfully upgraded, please inform us by sending a short email to firstname.lastname@example.org; this is very helpful information for us to improve our service to you.
Use these article links to view installation instructions and download the WIFE Client installers; e.g. useful for colleagues working from home: