| At line 4 changed one line |
| Video covering the upgrade process: [https://youtu.be/j4CAXYvDCm0] |
| Video covering the upgrade process: [https://youtu.be/k9BANsDsDZM] |
| At line 6 changed one line |
| !CrushFTP 6/7/8/9 Upgrade to CrushFTP 10 (scroll down below for upgrades from older versions): |
| !CrushFTP 6/7/8/9 Upgrade to CrushFTP 10: |
| At line 18 changed one line |
| 5.) Make sure you have the "Java" folder in the CrushFTP v10 folder. OpenJDK13+ is recommended. Follow the readme.txt file.\\ |
| 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 31 changed one line |
| 11.) Update any paths in the prefs for SSH keys or SSL keystores to point to your new CrushFTP 10 folder. |
| 11.) Update any paths in the admin, Preferences for SSH keys or SSL keystores to point to your new CrushFTP 10 folder. |
| At line 48 added 3 lines |
| 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.) |
| \\ |
| At line 50 changed one line |
| 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__ |
| 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 54 removed 33 lines |
| !CrushFTP 4 or CrushFTP 5 Upgrade to CrushFTP 10: |
|
| 1.) Register your CrushFTP 10 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 10 WebInterface folder is very different, and replacing it with the older folder would break CrushFTP 10. |
|
| 4.) Run CrushFTP 10. |
|
| [attachments|gui_setup.png] |
|
| 5.) Click Create New Admin User. Create your own admin user that will be used for managing the server. Call it 'crushadmin'. |
|
| 6.) Click "Start Temporary Server". The server will now be running and ready for use as long as you keep this window open. |
|
| 7.) Login using the web browser to your server using the 'crushadmin' user you just created. Click the 'Admin' button in the upper left. |
|
| 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".) |
|
| [attachments|user_connection_group.png] |
|
| 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.) |
|
| [attachments|convert_users.png] |
|
| 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. |
|
| 11.) Install the daemon / service again using the main CrushFTP application. |
|
| ---- |
| At line 95 changed one line |
| - copy over the files from the above steps for the Windows / OSX upgrade\\ |
| - copy over the files from the above steps for the Windows / macOS upgrade\\ |
| At line 78 added 2 lines |
| Copy over your "s3" folder which has all the XML pointers to your S3Crush filesystem...only applies if you use S3Crush\\ |
| \\ |
| At line 121 removed 2 lines |
| ''On OS X, these are in the app bundle. CrushFTP5.app/Contents/Resources/Java/''\\ |
| ''On CrushFTP4, you only had a DSA key located in the "conf" folder. CrushFTP4.app/Contents/Resources/Java/conf/'' |
| At line 126 removed 14 lines |
|
| ---- |
| !!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 CrushFTP10 as it can't find the users since they aren't associated to the port you are using. |
