| At line 1 changed one line |
| CrushFTP 6 is a separate install, and requires a CrushFTP 6 license code. Prior CrushFTP versions require purchasing an upgrade code to use in CrushFTP 6. [http://www.crushftp.com/pricing.html]. Download a fresh copy of CrushFTP 6. [http://www.crushftp.com/download.html] |
| CrushFTP 8 is a separate install, and requires a CrushFTP 8 license code. Prior CrushFTP versions require purchasing an upgrade code to use in CrushFTP 8. [http://www.crushftp.com/pricing.html]. Download a fresh copy of CrushFTP 8 and extract it to a safe location. [http://www.crushftp.com/download.html] |
| At line 4 added one line |
| Video covering the upgrade process: [https://youtu.be/j4CAXYvDCm0] |
| At line 5 changed one line |
| !1.) Run your prior CrushFTP version, and uninstall the daemon or service if its installed. |
| !CrushFTP 6/7 Upgrade to CrushFTP 8 (scroll down below for upgrades from older versions): |
| At line 7 changed one line |
| 2.) Copy over your users folder, and prefs.xml file from the old version to the new version's folder. |
| 1.) Register your CrushFTP 8 license key within your current version at the admin>>about tab.\\ |
| At line 9 changed one line |
| ! *Do not replace your WebInterface folder, the CrushFTP 6 WebInterface folder is very different, and replacing it with the older folder would break CrushFTP 6. |
| 2.) Copy over your users folder, prefs.xml, ssh private keys, and ssl keystores files from the old version to the new version's folder (see Critical Post Update Items below).\\ |
| At line 11 changed one line |
| 3.) Run CrushFTP 6. |
| *Do not replace your WebInterface folder, the CrushFTP 8 WebInterface folder is very different, and replacing it with the older folder would break CrushFTP 8.\\ |
| At line 14 added 50 lines |
| 3.) Check on Services.msc under what exact OS user is the CrushFTP service running.\\ |
|
| 4.) Run CrushFTP 6/7 and click 'Remove Daemon / Service'\\ |
|
| 5.) Run CrushFTP 8 as OS admin user.\\ |
|
| 6.) If you have a 64 bit OS make sure that you remove all older 32 bit java and install the Oracle java 64 bit. |
|
| 7.) Click "Start Temporary Server". The server will now be running and ready for use as long as you keep this window open.\\ |
| [attachments|gui_setup.png]\\ |
|
| 8.) Login using the web browser to your server using your normal 'crushadmin' user. Go to the Admin, About tab and enter in your CrushFTP 8 license code if not registered on your prior CrushFTP version, from previous steps.\\ |
|
| 9.) Go back to the GUI window, and click 'Install Daemon / Service'\\ |
|
| 10.) Go to the services.msc and set the same user as you had on your prior CrushFTP 6/7 version, to run the CrushFTP 8 service. Restart the service for the changes to apply. |
|
| 11.) Update any paths in the prefs for SSH keys or SSL keystores to point to your new CrushFTP 8 folder. |
|
| ---- |
|
| !!v6/v7 to v8 Followup items:\\ |
| Copy over your TempAccounts folder if you have been using the WebInterface 'Share...' feature.\\ |
| \\ |
| Copy over your Previews folder so image previews don't need to be re-generated.\\ |
| \\ |
| Copy over any custom logo images from your WebInterface folder, but do not overwrite any login.html files as CrushFTP 8 is different.\\ |
| \\ |
| Copy over your SSL keystore if you had it in your CrushFTP folder, and update the prefs to point at the new location.\\ |
| \\ |
| Copy over your private SSH key files for the server if they are in their default location. (ssh_host_rsa_key, ssh_host_dsa_key)\\ |
| \\ |
| Copy over your Jobs folder if you have the enterprise version. Its in your CrushFTP folder.\\ |
| \\ |
| If you want your statistics for reporting to transfer over from v6/v7 to v8, then copy the statsDB folder too.\\ |
|
| ---- |
| ---- |
| !CrushFTP 4 or CrushFTP 5 Upgrade to CrushFTP 8: |
|
| 1.) Register your CrushFTP 8 license key within your current version at the admin>>about tab. |
|
| 2.) Run your prior CrushFTP version, and uninstall the daemon or service if its installed. |
|
| 3.) Copy over your users folder, and prefs.xml file from the old version to the new version's folder. |
|
| ! *Do not replace your WebInterface folder, the CrushFTP 8 WebInterface folder is very different, and replacing it with the older folder would break CrushFTP 8. |
|
| 4.) Run CrushFTP 8. |
|
| At line 15 changed one line |
| 4.) Click Create New Admin User. Create your own admin user that will be used for managing the server. |
| 5.) Click Create New Admin User. Create your own admin user that will be used for managing the server. Call it 'crushadmin'. |
| At line 17 changed one line |
| 5.) Click "Start Temporary Server". The server will now be running and ready for use as long as you keep this window open. |
| 6.) Click "Start Temporary Server". The server will now be running and ready for use as long as you keep this window open. |
| At line 19 changed one line |
| 6.) Login using the web browser to your server using the admin user you just created. Click the 'Admin' button. |
| 7.) Login using the web browser to your server using the 'crushadmin' user you just created. Click the 'Admin' button in the upper left. |
| At line 21 changed one line |
| 7.) Go to Preferences, and click on each server item. Verify to the right that each port (FTP,HTTP,SFTP) is set to use users from the correct User Connection Group. (Probably "MainUsers" or "lookup_21".) |
| 8.) Go to Preferences, and click on each server item. Verify to the right that each port (FTP,HTTP,SFTP) is set to use users from the correct User Connection Group. (Probably "MainUsers" or "lookup_21".) |
| At line 25 changed one line |
| 8.) Open the user manager, select the Convert All Users from the convert menu. |
| 9.) Open the user manager, select the Convert All Users from the convert menu. (If you were already using CrushFTP 5.5 and above, this can be skipped.) |
| At line 29 changed one line |
| 9.) Test and verify things are working on the new server. If necessary, you can add or remove server groups in the [IP Servers] of the server prefs. |
| 10.) Test and verify things are working on the new server. If necessary, you can add or remove server groups in the [IP Servers] of the server prefs. |
| At line 31 changed one line |
| 10.) Install the daemon / service again using the main CrushFTP application. |
| 11.) Install the daemon / service again using the main CrushFTP application. |
| At line 84 added 2 lines |
| ---- |
| Linux upgrade:\\ |
| At line 87 added 14 lines |
| - download the crush package, unzip it into /var/opt \\ |
|
| - make it executable, as root : chmod +x crushftp_init.sh \\ |
|
| - register your CrushFTP 8 license key in your old CrushFTP WebUi\\ |
|
| - copy over the needed files as presented at the windows /OSX upgrade\\ |
|
| - change dir into /var/opt/CrushFTP8_PC/ \\ |
|
| - while as root, execute: ./crushftp_init.sh uninstall -- for all older versions to be removed.\\ |
|
| - execute: ./crushftp_init.sh install -- to have latest CrushFTP installed.\\ |
|
| At line 36 changed one line |
| !!Followup items:\\ |
| !!Critical Post Update Items:\\ |
| At line 41 changed one line |
| Copy over any custom logo images from your WebInterface folder, but do not overwrite any login.html files as CrushFTP 6 is different.\\ |
| Copy over any custom logo images from your WebInterface folder, but do not overwrite any login.html files as CrushFTP 8 is different.\\ |
| At line 45 changed one line |
| Copy over your private SSH key files for the server if they are in their default location. (ssh_host_rsa_key, ssh_host_dsa_key)\\ |
| Copy over your Jobs folder if you have the enterprise version. Its in your CrushFTP folder.\\ |
| \\ |
| Your daemon/service may have been running with additional memory, reconfigure the new version with the equivalent memory.\\ |
| \\ |
| Your daemon/service may have been running as a domain user on Windows. Change the service to be running as that domain user again or UNC VFS paths will fail.\\ |
| \\ |
| Copy over your private SSH key files for the server if they are in their default location. (ssh_host_rsa_key, ssh_host_rsa_key.pub, ssh_host_dsa_key, ssh_host_dsa_key.pub)\\ |
| At line 121 added 17 lines |
| \\ |
| Optional: If you want your statistics for reporting to transfer over from v6/v7 to v8, then copy the statsDB folder too.\\ |
| \\ |
|
| ---- |
| !!CrushFTP4 upgrade troubleshooting tips. |
|
|
| v4 has a bit of a mess on its user connection groups. So when you look in the folder "users" you see MainUsers, lookup_21, lookup_80, etc. |
|
| Figure out which ones are correct. MainUsers is the default location since v5. But you can use the other named folders just fine too. |
|
| In the prefs, on the tab with the list of ports, down at the bottom is a list of the user connection groups. Remove or add them as appropriate to match up with the real ones you have based on the folder names in the users folder. |
|
| Then on each port, check to see what user connection group they are configured for. Assign them appropriately. |
|
| If you haven't done this then logins may fail when you start using CrushFTP8 as it can't find the users since they aren't associated to the port you are using. |
#