138 | | - [wiki:Versions10Migration Incompatible changes and migration] |
139 | | |
140 | | '''Contributors (by number of patches):''' |
| 138 | === Incompatible changes |
| 139 | |
| 140 | - Deprecated tool rasdl has been removed, use rasql queries for type management ([https://doc.rasdaman.org/04_ql-guide.html#type-definition-using-rasql docs]) |
| 141 | |
| 142 | - Type coercion rules which govern the type of operation results based on the input data types have significantly changed, and may result in different behavior in existing queries; it is recommended to review the [https://doc.rasdaman.org/04_ql-guide.html#type-coercion docs] |
| 143 | |
| 144 | - Casting from larger to smaller type will lead to "clamping" of values outside of the valid range of the new smaller type, which may result in different behavior in existing queries ([https://doc.rasdaman.org/04_ql-guide.html#induction-all-operations docs]) |
| 145 | |
| 146 | - Subsetting has to be within the array spatial domain now, otherwise an error will be thrown ([https://doc.rasdaman.org/04_ql-guide.html#trimming docs]); when a subset needs to extend outside or intersect the array sdom, use the extend function. |
| 147 | |
| 148 | - Deprecated network protocols RNP and RPC have been removed; clients compiled against these old protocols will need to be recompiled with the latest client API libs in order to be able to communicate with v10.0 rasdaman servers ([https://doc.rasdaman.org/08_dev-guide-cpp.html#compilation-and-linkage-of-client-programs docs]) |
| 149 | |
| 150 | - Remove use of `petascope_admin_user` in petascope.properties ([https://doc.rasdaman.org/05_geo-services-guide.html#security docs]): |
| 151 | |
| 152 | ||= v9.8 =|| allows credentials configured by `petascope_admin_user` and `petascope_admin_pass` to be used for login as admin user in WSClient or execute write requests equivalently as the admin user configured by `rasdaman_admin_user` || |
| 153 | ||= v10.0 =|| `petascope_admin_user` and `petascope_admin_pass` are removed. These settings (if existing in the local system) will be copied as deprecated settings in the updated `petascope.properties`. Any requests using these deprecated credentials will be invalid. One has to the credentials from a valid rasdaman user with RW rights in WSClient; direct requests must include these credentials in the HTTP Authorization header in Basic authentication format || |
| 154 | |
| 155 | - Many non-OGC API supported by petascope have been redefined and consolidated under the `/rasdaman/admin` endpoint. Below all changes are listed (note that the server endpoint, e.g. `http://localhost:8080` has been omitted from the URLs). The v9.8 URLs will not work anymore, it is required to adapt to the new syntax. |
| 156 | |
| 157 | Create a non-existing WMS layer from an existing coverage ([https://doc.rasdaman.org/05_geo-services-guide.html#layer-management docs]): |
| 158 | |
| 159 | ||= v9.8 =|| /rasdaman/ows?service=WMS&version=1.3.0&request=InsertWCSLayer&wcsCoverageId=MyCoverage || |
| 160 | ||= v10.0 =|| /rasdaman/admin/layer/activate?COVERAGEID=MyCoverage || |
| 161 | |
| 162 | Remove an existing WMS layer ([https://doc.rasdaman.org/05_geo-services-guide.html#layer-management docs]): |
| 163 | |
| 164 | ||= v9.8 =|| /rasdaman/ows?SERVICE=WMS&VERSION=1.3.0&REQUEST=DeleteLayer&LAYER=MyLayer || |
| 165 | ||= v10.0 =|| /rasdaman/admin/layer/deactivate&COVERAGEID=MyLayer || |
| 166 | |
| 167 | Insert a WMS style to an existing layer ([https://doc.rasdaman.org/05_geo-services-guide.html#style-management docs]): |
| 168 | |
| 169 | ||= v9.8 =|| /rasdaman/ows?SERVICE=WMS&VERSION=1.3.0&REQUEST=InsertStyle&NAME=style1&LAYER=cov1 || |
| 170 | ||= v10.0 =|| /rasdaman/admin/layer/style/add?COVERAGEID=cov1&STYLEID=style1 || |
| 171 | |
| 172 | Update an existing WMS style of an existing layer ([https://doc.rasdaman.org/05_geo-services-guide.html#style-management docs]): |
| 173 | |
| 174 | ||= v9.8 =|| /rasdaman/ows?SERVICE=WMS&VERSION=1.3.0&REQUEST=UpdateStyle&NAME=style1&LAYER=cov1 || |
| 175 | ||= v10.0 =|| /rasdaman/admin/layer/style/update?COVERAGEID=cov1&STYLEID=style1&NEWSTYLEID=style2 || |
| 176 | |
| 177 | Remove an existing WMS style of an existing layer ([https://doc.rasdaman.org/05_geo-services-guide.html#style-management docs]): |
| 178 | |
| 179 | ||= v9.8 =|| /rasdaman/ows?SERVICE=WMS&VERSION=1.3.0&REQUEST=DeleteStyle&LAYER=cov1&NAME=style1 || |
| 180 | ||= v10.0 =|| /rasdaman/admin/layer/style/remove?COVERAGEID=cov1&STYLEID=style1 || |
| 181 | |
| 182 | Check if a coverage exists ([https://doc.rasdaman.org/05_geo-services-guide.html#check-if-a-coverage-exists docs]): |
| 183 | |
| 184 | ||= v9.8 =|| /rasdaman/ows/objectExists?coverageId=cov1 || |
| 185 | ||= v10.0 =|| /rasdaman/admin/coverage/exist?COVERAGEID=cov1 || |
| 186 | |
| 187 | Rename an existing coverage ([https://doc.rasdaman.org/05_geo-services-guide.html#renaming-a-coverage docs]): |
| 188 | |
| 189 | ||= v9.8 =|| /rasdaman/admin/UpdateCoverageId?COVERAGEID=cov1&NEWID=cov2 || |
| 190 | ||= v10.0 =|| /rasdaman/admin/coverage/update?COVERAGEID=cov1&NEWCOVERAGEID=cov2 || |
| 191 | |
| 192 | Update coverage metadata ([https://doc.rasdaman.org/05_geo-services-guide.html#update-coverage-metadata docs]): |
| 193 | |
| 194 | ||= v9.8 =|| /rasdaman/admin/UpdateCoverageMetadata || |
| 195 | ||= v10.0 =|| /rasdaman/admin/coverage/update || |
| 196 | |
| 197 | Create a pyramid member (a downscaled coverage) of an existing base coverage ([https://doc.rasdaman.org/05_geo-services-guide.html#pyramid-management docs]): |
| 198 | |
| 199 | ||= v9.8 =|| /rasdaman/ows?service=WCS&request=InsertScaleLevel&version=2.0.1&coverageId=cov_3D&level=4 || |
| 200 | ||= v10.0 =|| /rasdaman/admin/coverage/pyramid/create?COVERAGEID=cov_3D&MEMBER=cov_3D_4&SCALEVECTOR=1,4,4 || |
| 201 | |
| 202 | - rasdapy on Python 2 is not maintained anymore, migrating to rasdapy3 is recommended ([https://pypi.org/project/rasdapy3/ docs]) |
| 203 | |
| 204 | === Upgrading instructions |
| 205 | |
| 206 | TODO |
| 207 | |
| 208 | === Contributors |
| 209 | |
| 210 | Sorted by number of patches: |