Upgrading BaseX by several major versions

On 19/11/24 08:53, Rémy Delanaux wrote: > > Hello, > > I manage a project I've worked on from 2020 to 2022 and have recently > come back to (no one has really worked on since then). > The project currently runs BaseX 9.4, and we obviously would like to > catch up on versions of BaseX. > > But I'm wondering what is the best way to process here. I don't > remember upgrading major versions of BaseX during my time on project > (we changed servers so for BaseX 9 we did a fresh install and backup > restore) > > What is the correct way to do this? Should I straight up install the > latest version (probably BaseX at the time of writing) and find all > blocking migration changes, or gradually install major version after > major version (10 then 11 then 12 when available) and ook for smaller > migration processes? > I wasn't able to find migration guides except for upgrading from 9 to > 10 (although there are individual changelogs for each individual module). > > Thanks! > > Best, > Remy Delanaux

On Tue, Nov 19, 2024 at 9:51 AM Marco Lettere <m.lettere at gmail.com> wrote: > Hi Remy, > > we faced this issue several times. I can suggest you step up directly to > the target version and open your code in the BaseX Gui. There by just > following the parsing errors you can refactor your code and depending on > the code complexity this should not take too long. > > M. > On 19/11/24 08:53, Rémy Delanaux wrote: > > > Hello, > > I manage a project I've worked on from 2020 to 2022 and have recently come > back to (no one has really worked on since then). > The project currently runs BaseX 9.4, and we obviously would like to catch > up on versions of BaseX. > > But I'm wondering what is the best way to process here. I don't remember > upgrading major versions of BaseX during my time on project (we changed > servers so for BaseX 9 we did a fresh install and backup restore) > > What is the correct way to do this? Should I straight up install the > latest version (probably BaseX at the time of writing) and find all > blocking migration changes, or gradually install major version after major > version (10 then 11 then 12 when available) and ook for smaller migration > processes? > I wasn't able to find migration guides except for upgrading from 9 to 10 > (although there are individual changelogs for each individual module). > > Thanks! > > Best, > Remy Delanaux > >

> Dear Remy, > > As the database format has not changed since Version 9, the good thing is > that you won’t have to update your databases, so I would do what Marco > suggested. For the upgrade to BaseX 10, there is a page in our Wiki that > gives some further instructions [1]. > > Best, > Christian > > [1] https://docs.basex.org/main/BaseX_10 > > > On Tue, Nov 19, 2024 at 9:51 AM Marco Lettere <m.lettere at gmail.com> wrote: > >> Hi Remy, >> >> we faced this issue several times. I can suggest you step up directly to >> the target version and open your code in the BaseX Gui. There by just >> following the parsing errors you can refactor your code and depending on >> the code complexity this should not take too long. >> >> M. >> On 19/11/24 08:53, Rémy Delanaux wrote: >> >> >> Hello, >> >> I manage a project I've worked on from 2020 to 2022 and have recently >> come back to (no one has really worked on since then). >> The project currently runs BaseX 9.4, and we obviously would like to >> catch up on versions of BaseX. >> >> But I'm wondering what is the best way to process here. I don't remember >> upgrading major versions of BaseX during my time on project (we changed >> servers so for BaseX 9 we did a fresh install and backup restore) >> >> What is the correct way to do this? Should I straight up install the >> latest version (probably BaseX at the time of writing) and find all >> blocking migration changes, or gradually install major version after major >> version (10 then 11 then 12 when available) and ook for smaller migration >> processes? >> I wasn't able to find migration guides except for upgrading from 9 to 10 >> (although there are individual changelogs for each individual module). >> >> Thanks! >> >> Best, >> Remy Delanaux >> >>

On 19/11/24 12:50, Rémy Delanaux wrote: > Dear Christian and Marco, > > Thank you for the helpful replies. > It's reassuring if the maintenance would be mostly about code renaming > rather than heavy database editing. > Do you think there are notable breaking changes (other than function > renaming) to which I should be particularly careful? > > As for using the GUI, I never actually used it since the project I > work on is both developed and hosted on Linux machines, so I don't > think it's available, is it? > > Best, > Remy > > > Le mar. 19 nov. 2024 à 10:41, Christian Grün > <christian.gruen at gmail.com> a écrit : > > Dear Remy, > > As the database format has not changed since Version 9, the good > thing is that you won’t have to update your databases, so I would > do what Marco suggested. For the upgrade to BaseX 10, there is a > page in our Wiki that gives some further instructions [1]. > > Best, > Christian > > [1] https://docs.basex.org/main/BaseX_10 > > > On Tue, Nov 19, 2024 at 9:51 AM Marco Lettere > <m.lettere at gmail.com> wrote: > > Hi Remy, > > we faced this issue several times. I can suggest you step up > directly to the target version and open your code in the BaseX > Gui. There by just following the parsing errors you can > refactor your code and depending on the code complexity this > should not take too long. > > M. > > On 19/11/24 08:53, Rémy Delanaux wrote: >> >> Hello, >> >> I manage a project I've worked on from 2020 to 2022 and have >> recently come back to (no one has really worked on since then). >> The project currently runs BaseX 9.4, and we obviously would >> like to catch up on versions of BaseX. >> >> But I'm wondering what is the best way to process here. I >> don't remember upgrading major versions of BaseX during my >> time on project (we changed servers so for BaseX 9 we did a >> fresh install and backup restore) >> >> What is the correct way to do this? Should I straight up >> install the latest version (probably BaseX at the time of >> writing) and find all blocking migration changes, or >> gradually install major version after major version (10 then >> 11 then 12 when available) and ook for smaller migration >> processes? >> I wasn't able to find migration guides except for upgrading >> from 9 to 10 (although there are individual changelogs for >> each individual module). >> >> Thanks! >> >> Best, >> Remy Delanaux >

On Tue, Nov 19, 2024 at 12:50:35PM +0100, Rémy Delanaux scripsit: > As for using the GUI, I never actually used it since the project I work on > is both developed and hosted on Linux machines, so I don't think it's > available, is it?

Von: BaseX-Talk <basex-talk-bounces at mailman.uni-konstanz.de> Im Auftrag von Rémy Delanaux Gesendet: Dienstag, 19. November 2024 12:51 An: Christian Grün <christian.gruen at gmail.com> Cc: basex-talk at mailman.uni-konstanz.de Betreff: Re: [basex-talk] Upgrading BaseX by several major versions Dear Christian and Marco, Thank you for the helpful replies. It's reassuring if the maintenance would be mostly about code renaming rather than heavy database editing. Do you think there are notable breaking changes (other than function renaming) to which I should be particularly careful? As for using the GUI, I never actually used it since the project I work on is both developed and hosted on Linux machines, so I don't think it's available, is it? Best, Remy Le mar. 19 nov. 2024 à 10:41, Christian Grün <mailto:christian.gruen at gmail.com> a écrit : Dear Remy, As the database format has not changed since Version 9, the good thing is that you won’t have to update your databases, so I would do what Marco suggested. For the upgrade to BaseX 10, there is a page in our Wiki that gives some further instructions [1]. Best, Christian [1] https://docs.basex.org/main/BaseX_10 On Tue, Nov 19, 2024 at 9:51 AM Marco Lettere <mailto:m.lettere at gmail.com> wrote: Hi Remy, we faced this issue several times. I can suggest you step up directly to the target version and open your code in the BaseX Gui. There by just following the parsing errors you can refactor your code and depending on the code complexity this should not take too long. M. On 19/11/24 08:53, Rémy Delanaux wrote: Hello, I manage a project I've worked on from 2020 to 2022 and have recently come back to (no one has really worked on since then). The project currently runs BaseX 9.4, and we obviously would like to catch up on versions of BaseX. But I'm wondering what is the best way to process here. I don't remember upgrading major versions of BaseX during my time on project (we changed servers so for BaseX 9 we did a fresh install and backup restore) What is the correct way to do this? Should I straight up install the latest version (probably BaseX at the time of writing) and find all blocking migration changes, or gradually install major version after major version (10 then 11 then 12 when available) and ook for smaller migration processes? I wasn't able to find migration guides except for upgrading from 9 to 10 (although there are individual changelogs for each individual module). Thanks! Best, Remy Delanaux

> Dear Rémy, > > A particular change in BaseX 11.4 that took me a while to find, is a > change in http:send-request. So this is only relevant if you use that > function. > If you send a JSON body, previously you had to serialize it, like: > > http:send-request( > <http:request method='put'> > <http:body media-type='application/json'/> > </http:request>, > $url, > serialize($body-map, map{'method':'json'}) > ) > > This has changed, and the right way to call this is now: > > http:send-request( > <http:request method='put'> > <http:body media-type='application/json'/> > </http:request>, > $url, > $body-map > ) > > If you use http:send-request, I hope this will save you a bit of time. > > Best regards, > Nico Verwer >

> Thanks for pointing this out, Nico. This one should have been documented > indeed, or changed with the next major release. > > > > Nico Verwer (Rakensi) <nverwer at rakensi.com> schrieb am Mi., 20. Nov. > 2024, 08:46: > >> Dear Rémy, >> >> A particular change in BaseX 11.4 that took me a while to find, is a >> change in http:send-request. So this is only relevant if you use that >> function. >> If you send a JSON body, previously you had to serialize it, like: >> >> http:send-request( >> <http:request method='put'> >> <http:body media-type='application/json'/> >> </http:request>, >> $url, >> serialize($body-map, map{'method':'json'}) >> ) >> >> This has changed, and the right way to call this is now: >> >> http:send-request( >> <http:request method='put'> >> <http:body media-type='application/json'/> >> </http:request>, >> $url, >> $body-map >> ) >> >> If you use http:send-request, I hope this will save you a bit of time. >> >> Best regards, >> Nico Verwer >> >

On Tue, Dec 17, 2024 at 2:22 PM Rémy Delanaux <delanaux.remy at gmail.com> wrote: > Dear Christian and Nico, > > To follow-up on that JSON issue: I think I'm having some trouble with that > one. > > As Nico suggested, I directly switched my serialization to put the map > variable as parameter to 'http:send-request' (a map previously created > with map:merge in my code). > > But I have the following errors: > * When I don't serialize and directly send the map, I get an "*Atomic > item required, function item found*" error at request time. > * When I *do* serialize it, like I did (with success) in BaseX 9, I get > an "*Invalid json message received*" error at request time. > The API I query hasn't changed since my BaseX update, and that code was > working fine before, so the data I send most likely isn't the problem here. > I tried printing the map that is sent/serialized and it's perfectly valid > JSON. > > How can I solve this problem? > > Thanks > > Remy > > > > > Le mer. 20 nov. 2024 à 09:14, Christian Grün <christian.gruen at gmail.com> > a écrit : > >> Thanks for pointing this out, Nico. This one should have been documented >> indeed, or changed with the next major release. >> >> >> >> Nico Verwer (Rakensi) <nverwer at rakensi.com> schrieb am Mi., 20. Nov. >> 2024, 08:46: >> >>> Dear Rémy, >>> >>> A particular change in BaseX 11.4 that took me a while to find, is a >>> change in http:send-request. So this is only relevant if you use that >>> function. >>> If you send a JSON body, previously you had to serialize it, like: >>> >>> http:send-request( >>> <http:request method='put'> >>> <http:body media-type='application/json'/> >>> </http:request>, >>> $url, >>> serialize($body-map, map{'method':'json'}) >>> ) >>> >>> This has changed, and the right way to call this is now: >>> >>> http:send-request( >>> <http:request method='put'> >>> <http:body media-type='application/json'/> >>> </http:request>, >>> $url, >>> $body-map >>> ) >>> >>> If you use http:send-request, I hope this will save you a bit of time. >>> >>> Best regards, >>> Nico Verwer >>> >>