Your preparation to upgrade to version 6.1
- You need to have a "Version 6.1" license at hand, before starting the upgrade process.
- If you do not yet have a v6.1 license, then please request this from license@farmerswife.com once you are ready to upgrade.
- Take a look at the below pdf documents with details on system requirements and what is new in this version!
Note: the "Public Installers" section is open; see more info below!
Note: the previous version 6.0 _was_ a facelift version!
The user interface has changed, but it's still farmerswife.
Also the installer names and paths now use "farmerswife" IF installed from scratch.
The built-in auto-upgrade _is_ supported for all WIFE Clients on v5.2 Release or later!
The auto-WIFE-Client upgrade functionality is supported and works for all WIFE Clients which were once manually upgraded past 5.2 Beta 4.
Operating system "read and write" user permissions for installed software on the local machine are sufficient for the auto-upgrade functionality to work.
After the farmerswife Server has been upgraded to v 6.1 or later, log-in with the WIFE Client, and follow the instructions of the auto-upgrade dialogues.
A manual WIFE Client upgrade is only needed for OLD installations BELOW v5.2:
The auto-Client-upgrade functionality will NOT work for WIFE Clients below v5.2. A new SSL-based communication protocol has been implemented. Any WIFE Client has to be manually upgraded once to 5.2 Beta 4 or later. The auto-client upgrade will work again for any WIFE Client which was once manually upgraded past 5.2 Beta 4.
Any WIFE Client which was NOT manually upgraded, will state this message upon log-in: "Connection to the Server Timed Out"
The "Public Installers" section is open
The "Installers" section on support.farmerswife.com is open; you do not need any access credentials anymore. These are only needed for following "preview" or "beta" versions.
=> Go to: https://www.farmerswife.com/knowledgebase and click on the "Public Installers" button on the left side of the page.
You will then need to navigate to the folder named 601_SP1_rev16195
Upgrading step by step:
- Your WIFE Server needs to be at least on version 5.2 Release (if lower, contact support@farmerswife.com) to upgrade straight to the latest v6.1.
- 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 fw_InstallationInstructions_Window_Mac_Linux_61.pdf.
- 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.
IMPORTANT excursion - 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 Package Contents" > ... 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.
... continued from above:
Within the NEW farmerswife Server package use <Control> + click and select "Paste 2 Items".
- Now copy the new 6.1 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.
- -fter the upgrade, start the farmerswife Server as usual.
- Then once you've successfully upgraded, please inform us by sending a short email to support@farmerswife.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.1 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.
- Then once you've successfully upgraded, please inform us by sending a short email to support@farmerswife.com; this is very helpful information for us to improve our service to you.
The farmerswife Clients will auto-upgrade ...
... if already on version 5.2 or later: ... by using the "simple in-application" auto-upgrade process; "normal user" Operating System permissions (Read / Write) are sufficient.
IMPORTANT for the supported auto-upgrade functionality:
For the farmerswife Client applications the "simple in-application" auto-upgrade process to work (once supported in later versions), "normal user" Operating System permissions (Read / Write) are sufficient. You log-in, you confirm that you want to upgrade, the needed files are transferred, the WIFE Client restarts, done.
But when auto-upgrading on Mac with a mix of Admin and Standard users, 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 the Admin users credentials! The farmerswife Client will not work for the Standard user, if installed while being logged-in as the Admin user.
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 the Admin users credentials! The farmerswife Client will not work for the Standard user, if installed while being logged-in as the Admin user. For the farmerswife Client applications the "simple in-application" auto-upgrade process is supported, "normal user" Operating System permissions (Read / Write) are sufficient. You log-in, you confirm that you want to upgrade, the needed files are transferred, the WIFE Client restarts, done. This upgrade process is not explained in any further detail.
Once you've successfully upgraded, please inform us by sending a short email to support@farmerswife.com; this is very helpful information for us to improve our service to you.