| At line 1 changed one line |
| CrushFTP 5 is a separate install. Download a fresh copy of CrushFTP 5. |
| CrushFTP 10 is a separate install, and requires a CrushFTP 10 license code. Prior CrushFTP versions require purchasing an upgrade code to use in CrushFTP 10. [http://www.crushftp.com/pricing.html]. Download a fresh copy of CrushFTP 10 and extract it to a safe location. [http://www.crushftp.com/download.html] |
| ---- |
| At line 3 changed one line |
| 1.) Run CrushFTP 4, and uninstall the daemon or service if its installed. |
| Video covering the upgrade process: [https://youtu.be/k9BANsDsDZM] |
| At line 5 changed one line |
| 2.) Copy over your users folder, and prefs.xml file from CrushFTP 4 to your CrushFTP 5 folder. |
| !CrushFTP 6/7/8/9 Upgrade to CrushFTP 10: |
| At line 7 changed one line |
| 3.) Optionally, also copy over your stats.xml. |
| 1.) Register your CrushFTP 10 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 5 WebInterface folder is very different, and replacing it with the CrushFTP 4 folder would break CrushFTP 5. |
| 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 |
| 4.) Run CrushFTP 5. |
| *Do not replace your WebInterface folder, the CrushFTP 10 WebInterface folder is very different, and replacing it with the older folder would break CrushFTP 10.\\ |
| At line 13 changed one line |
| 5.) Go to server settings (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 "set" or ServerGroup of users. (Probably "MainUsers" or "lookup_21".) |
| 3.) Check on Services.msc under what exact OS user is the CrushFTP service running.\\ |
| At line 15 changed one line |
| This is an example of changing the server group from "lookup_21" to be "MainUsers" |
| 4.) Run CrushFTP 6/7/8/9 and click 'Remove Daemon / Service'. Alternatively you can run CrushFTP v10 and use its button to remove the service too.\\ |
| At line 17 changed one line |
| [attachments|fix_server_group.png] |
| 5.) Make sure you have the "Java" folder in the CrushFTP v10 folder. OpenJDK13+ is recommended. Follow the readme.txt file in the CrushFTP folder.\\ |
| At line 19 changed one line |
| 6.) Open the user manager, and notice the title of the window. It should be referencing your server group of users. Select Convert All Users to CrushFTP 5 from the convert menu. |
| 6.) Run CrushFTP v10.\\ |
| At line 21 changed one line |
| [attachments|edit_users.png] |
| 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]\\ |
| At line 23 changed one line |
| 7.) Test and verify things are working on the new server. If necessary, you can add or remove server groups in the [User Config] of the server prefs. |
| 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 10 license code if not registered on your prior CrushFTP version, from previous steps.\\ |
| At line 25 changed one line |
| In this example, I need to add a "MainUsers" server group. |
| 9.) Go back to the GUI window, and click 'Install Daemon / Service'\\ |
| At line 27 changed one line |
| [attachments|user_config.png] |
| 10.) Go to the services.msc and set the same user as you had on your prior CrushFTP 6/7/8/9 version, to run the CrushFTP 10 service. Restart the service for the changes to apply. |
| At line 31 added one line |
| 11.) Update any paths in the admin, Preferences for SSH keys or SSL keystores to point to your new CrushFTP 10 folder. |
| At line 30 changed one line |
| 8.) Install the daemon / service again. |
| ---- |
| At line 35 added 19 lines |
| !!v6/v7/v8/v9 to v10 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 10 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.\\ |
| \\ |
| 10.5.2 and above changes other defaults related to loading DB drivers that are not in your classpath has also changed. This means if your DB drivers |
| are not part of your plugins/lib folder, they will not be loaded by CrushFTP. (Statistics DB if you changed it, SQL Users if you are using that, etc.) |
| \\ |
| If you want your statistics for reporting to transfer over from v6/v7/v8/v9 to v10, then copy the statsDB folder too.\\ |
| \\ |
| If and __only if__ the SHA3 password hashing policy was enabled on the old version, and the users cannot log in after the upgrade, edit the main server configuration file prefs.XML locate the <sha3_keccak> key, change it's value from __false__ to __true__\\ |
| At line 33 removed one line |
|
| At line 56 added 2 lines |
| ---- |
| !Linux Upgrade:\\ |
| At line 36 changed one line |
| Could you expand the explanation a bit more (especially as it relates to upgrading to v.5) on what one needs to be looking out for to "verify that each port is set to use users from the correct 'set' of users"? |
| - download the crush package, unzip it into /var/opt \\ |
| At line 38 changed one line |
| --Peter Nelson, 18-Dec-2009 08:26 |
| - make it executable, as root : chmod +x crushftp_init.sh \\ |
|
| - register your CrushFTP 10 license key in your old CrushFTP WebUi\\ |
|
| - copy over the files from the above steps for the Windows / macOS upgrade\\ |
|
| - change dir into /var/opt/CrushFTP10/ \\ |
|
| - while as root, execute: ./crushftp_init.sh uninstall -- for all older versions daemon launch reference to be removed. (No CrushFTP app files are touched)\\ |
|
| - while as root, execute: ./crushftp_init.sh install -- to have latest CrushFTP installed daemon launch reference added. (No CrushFTP app files are touched)\\ |
|
| ---- |
|
| !!Critical Post Update Items:\\ |
| Copy over your TempAccounts folder if you have been using the WebInterface 'Share...' feature.\\ |
| \\ |
| Copy over your "s3" folder which has all the XML pointers to your S3Crush filesystem...only applies if you use S3Crush\\ |
| \\ |
| 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 10 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 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)\\ |
| \\ |
| Optional: If you want your statistics for reporting to transfer over from v6/v7/v8/v9 to v10, then copy the statsDB folder too.\\ |
| \\ |
