| 41 | |
| 42 | === Incompatible changes |
| 43 | |
| 44 | - Ubuntu 18.04 and CentOS 7 are not supported anymore, rasdaman v10.2 packages are available only for Ubuntu 20.04 and 22.04 |
| 45 | - The server/client protocol has backwards-incompatible changes, so C++ / Java clients must be recompiled with the latest rasdaman client API libraries to be able to communicate with rasdaman v10.2 servers. Python clients will require updating rasdapy3 to the latest version with pip3. |
| 46 | |
| 47 | === Upgrading |
| 48 | |
| 49 | The sections below contain instructions on how to upgrade the software installation from a previous version to stable rasdaman v10.2. |
| 50 | |
| 51 | In addition, it is highly recommended to review the list of incompatible changes above. |
| 52 | |
| 53 | ==== From v10.1 |
| 54 | |
| 55 | To upgrade from the previous stable version v10.1 to stable v10.2: |
| 56 | |
| 57 | 1. Update the repository metadata with `sudo apt update` |
| 58 | 2. Stop rasdaman with `sudo service rasdaman stop`; make sure that the processes are really stopped: if `ps aux | grep -E 'ras(mgr|server)'` returns any processes, stop them with `pkill -9 -f 'ras(mgr|server)'` |
| 59 | 3. Install the new rasdaman version with `sudo apt install rasdaman` |
| 60 | |
| 61 | ==== From testing |
| 62 | |
| 63 | To upgrade from the testing repository to stable v10.2: |
| 64 | |
| 65 | 1. Change the testing package repository to the stable one in `/etc/apt/sources.list.d/rasdaman.list` |
| 66 | 2. Stop rasdaman with `sudo service rasdaman stop`; make sure that the processes are really stopped: if `ps aux | grep -E 'ras(mgr|server)'` returns any processes, stop them with `pkill -9 -f 'ras(mgr|server)'` |
| 67 | 3. Remove the current rasdaman package with `sudo apt remove rasdaman`; this is required because the stable package has the same version but a lower iteration number than the testing one |
| 68 | 4. Install the new rasdaman version with `sudo apt install rasdaman` |
| 69 | |
| 70 | ==== From previous Ubuntu version |
| 71 | |
| 72 | Check our [https://doc.rasdaman.org/02_inst-guide.html#migration migration guide] for hints on how to upgrade your Ubuntu OS, or migrate your installation from one machine to another. |