Sovelluksen päivittää pääkäyttäjä välilehdellä Asetukset → Päivitykset. Päivitykset ladataan valmistajan palvelimelta. Uudet versiot asennetaan yhdellä klikkauksella (automaattinen asennusohjelma, yleensä ilman FTP:tä). FTP:tä tarvitaan tiedostojen siirtoon ohjelman ensiasennuksessa; päivityksen yhteydessä tekninen tuki on hyödyksi silloin, kun palvelin ei salli sovelluksen ylikirjoittaa omia tiedostojaan. Jos ladattu paketti ei sisältäisi automaattista asennusohjelmaa, sovellus näyttää ohjeet FTP:n kautta tehtävää siirtoa varten.

Päivityksen lataaminen edellyttää voimassaolevaa lisenssiä (samaa, joka avaa tallennuksen sovelluksessa). Valmistajan palvelin tarjoaa versioluettelon vain tämän asennuksen verkkotunnukseen liitetylle avaimelle. Kun avaimeen tallennettu päivitysoikeus on päättynyt, uuden version painikkeen tila on Lukittu, ja syy näkyy versionumeron alla sekä painikkeen päälle vietäessä.

Lisenssissä päivityksillä tiettyyn päivämäärään asti ratkaiseva on version julkaisupäivä (näkyy jokaisen version kohdalla listassa): lisenssi kattaa oikeuden päättymiseen mennessä julkaistut versiot, ei uudempia. Ohjelma toimii edelleen - et voi vain ladata uudempia versioita, kunnes uusit oikeuden (uusi avain toimittajalta, katso lisenssiä käsittelevä luku). Oikeuden voimassaoloajan viimeinen päivitys kannattaa asentaa ennen sen päättymistä: valmistajan palvelin tarjoaa yleensä vain uusimman julkaisun, joten tämän päivämäärän jälkeen vanhempaa ei välttämättä enää näytetä.

Automaattinen tarkistus ja ilmoitus

Sovellus tarkistaa päivitysten saatavuuden automaattisesti - asetuksiin ei tarvitse enää käydä joka kerta erikseen:

  • kirjautumisen jälkeen (sovellukseen saavuttaessa),
  • ajoittain, kun sovellus pysyy avoinna,
  • kun palaat selainvälilehteen (jos edellisestä tarkistuksesta on kulunut jonkin verran aikaa).

Kun uusi julkaisu ilmestyy, pääkäyttäjä näkee lyhyen ilmoituksen (”Päivitys saatavilla - versio X.Y.Z on valmis asennettavaksi”) ja painikkeen Näytä, joka avaa suoraan kohdan Asetukset → Päivitykset. Ilmoitus näkyy kerran per versio (se ei vaivaa joka kirjautumiskerralla) - seuraavasta julkaisusta saat uuden ilmoituksen.

Jos uutta versiota ei voi asentaa (esim. päivitysoikeus on päättynyt), ilmoitus kertoo sen suoraan: ”Versio X.Y.Z on saatavilla, mutta sitä ei voi asentaa: …” yhdessä syyn kanssa. Kun päivitykset eivät ole saatavilla lisenssiavaimen vuoksi (avain puuttuu, avainta ei tunnisteta, se on peruutettu, liitetty toiseen verkkotunnukseen tai palvelin ei tunne sitä), pääkäyttäjä saa yhden Päivitykset eivät ole saatavilla -varoituksen selityksineen - seuraavan vasta kun ongelma katoaa ja palaa.

Uuden version ilmaisin

Ilmoituksesta riippumatta, kun uudempi versio on saatavilla, pääkäyttäjä näkee punaisen pisteen hammasrataskuvakkeessa (⚙) yläpalkissa, ja asetukset avattuaan saman pisteen Päivitykset-välilehden vieressä. Piste häviää automaattisesti, kun uusin versio on asennettu. Ilmaisimen (ja ilmoituksen) näkevät vain pääkäyttäjät.

Saatavilla olevien versioiden tarkistus

  1. Napsauta hammasratas-kuvaketta (⚙) → välilehti Päivitykset.

Kehitysversio. Jos sovellus toimii kehitystilassa (koodi suoraan repositoriosta), päivitysten tarkistus on pois käytöstä: punaista pistettä tai ilmoituksia ei ole, ja välilehti kertoo suoraan, että käytät kehitysversiota.

  1. Napsauta Tarkista päivitykset. Näet:
    • Asennettu versio - palvelimella käytössä oleva versio,
    • Koodin versio - sovelluksen tiedostojen versio,
    • Saatavilla olevat versiot - luettelo uudemmista julkaisuista, kunkin omalla muutoslokilla (changelog).

Versiot asennetaan peräkkäin - aktiivisena on vain seuraavan version painike. Seuraavat avautuvat sitä mukaa, kun edellinen on ladattu.

Task Manager: Päivitykset-välilehti versiolistalla ja asennuspainikkeella.
Päivitykset-välilehti: palvelimella oleva versio, uudemmat julkaisut ja muutosluettelo.

Paketin lataus

  1. Napsauta lähimmän saatavilla olevan version kohdalla Lataa.
  2. Näkyviin tulee varmuuskopiovaroitus - ota ennen päivitystä varmuuskopio tietokannasta sekä liitekansiosta (uploads/). Vahvista jatkaaksesi.
  3. Palvelin lataa paketin ja tarkistaa sen tarkistussumman (SHA-256). Sitten paketin tyypistä riippuen:
    • Automaattisen asennusohjelman paketti - näkyviin tulee painike Asenna (kuvattu alempana). Mitään ei tarvitse ladata FTP:n kautta.
    • Manuaalisesti ladattava paketti - selain tallentaa .zip-tiedoston koneellesi (voit tarvittaessa ladata sen uudelleen painikkeella Tallenna paketti (.zip)) ja näyttää FTP-ohjeet.

Asennus yhdellä klikkauksella (automaattiasennin)

Automaattista asennusta tukevissa versioissa et tarvitse FTP:tä:

  1. Napsauta latauksen jälkeen Asenna.
  2. Näkyviin tulee edistymispalkki (”Asennetaan…”), joka näyttää vaiheet: tietokannan migraatiot → tiedostojen kopiointi → viimeistely.
  3. Kun asennus on valmis, painike muuttuu muotoon Päivitä sovellus - klikkaa sitä ladataksesi uuden version (voit myös päivittää sivun näppäinyhdistelmällä Ctrl/Cmd + Shift + R).

Asennusohjelma ei koske tietojasi - se ohittaa tiedostot includes/config.php, uploads/, storage/ ja logs/, ja tekee tarvittavat tietokantamigraatiot itse. Varmuuskopio kannattaa silti ottaa (varoitus näkyy latauksen yhteydessä).

Huomaa: edistymispalkki toimii täysin ”reaaliajassa” vasta siitä lähtien, kun asennettu versio sisältää jo tämän mekanismin. Kun asennat vanhemmasta versiosta, palkin edistyminen voi näkyä hyppäyksittäin.

Asennus FTP:n kautta (paketit ilman automaattiasenninta)

Kun paketti ei tue automaattiasennusta, sovellus näyttää ohjeet manuaaliseen lataukseen:

  1. Ota varmuuskopio tietokannasta ja uploads/-kansiosta (jos et ole vielä tehnyt sitä).
  2. Pura ladattu .zip-tiedosto.
  3. Yhdistä palvelimeen FTP:n kautta ja lataa paketin sisältö sovelluksen hakemistoon korvaten nykyiset tiedostot.
  4. ÄLÄ korvaa (säilytä omasi):
    • includes/config.php - asetukset ja salaisuudet,
    • uploads/ - liitteet ja avatarit,
    • storage/ - työskentelytiedot,
    • logs/ - lokit.
  5. Päivitä sovellus selaimessa (Ctrl/Cmd + Shift + R) ja napsauta uudelleen Tarkista päivitykset vahvistaaksesi uuden versionumeron.

Jos julkaisu tuo muutoksia tietokantaan, kyseisen julkaisun ohjeet (changelog / versiotiedote) kertovat lisävaiheista. Epäselvissä tapauksissa palauta ensin varmuuskopio ja ota yhteyttä toimittajaan.

Usein kysytyt kysymykset

  • ”Päivityspalvelimeen ei saatu yhteyttä” - tarkista internet-yhteys sekä lisenssin voimassaolo. Versioluettelo on saatavilla vain asennuksille, joilla on voimassaoleva avain. Yhteysvirheen tekninen kuvaus (esim. ”Could not resolve host…”) lisätään ohjelman toimesta suluissa sanan ”tiedot” jälkeen - tästä on hyötyä hostingin tekniselle tuelle.
  • ”Sinulla on uusin versio” - asennettua uudempaa julkaisua ei ole. Tämä viesti näkyy vain silloin, kun palvelin hyväksyi avaimen - avainongelman yhteydessä näet jonkin alla olevista viesteistä.
  • ”Tällä asennuksella ei ole lisenssiavainta…” - kirjoita avain kohtaan Asetukset → Lisäasetukset → Lisenssi; ilman sitä sovellus ei edes kysy palvelimelta versioita.
  • ”Päivityspalvelin ei tunnista lisenssiavainta…” - avaimen allekirjoitus ei täsmää valmistajan palvelimen kanssa (avain on viallinen tai muualta peräisin). Kirjoita toimittajalta saamasi avain tai ota yhteyttä häneen.
  • ”Tämän asennuksen lisenssiavainta ei löydy päivityspalvelimen tietokannasta…” - avain on oikein, mutta valmistajan palvelin ei tunne sitä. Toimittajan täytyy rekisteröidä se tai myöntää uusi.
  • ”Lisenssiavain… on peruutettu…” - toimittaja on peruuttanut tämän avaimen (yleensä uuden myöntämisen jälkeen). Kirjoita uusi avain.
  • ”Lisenssiavain on liitetty toiseen verkkotunnukseen…” - avain on myönnetty eri osoitteeseen kuin se, jossa ohjelma toimii. Pyydä toimittajalta avain tälle verkkotunnukselle.
  • ”Versio X.Y.Z on saatavilla, mutta sitä ei voi asentaa: päivitysoikeutesi päättyi PP.KK.VVVV…” - versio julkaistiin päivitysoikeuden päättymisen jälkeen. Ohjelma toimii edelleen; asentaaksesi version uusi päivitysoikeus (uusi avain toimittajalta). Luettelo ei yleensä näytä tällöin oikeuden voimassaoloajalta peräisin olevaa vanhempaa versiota - valmistajan palvelin tarjoaa vain uusimman julkaisun.
  • „Palvelimelta puuttuu PHP-laajennus „zip”…” - ilman tätä laajennusta sovellus ei voi purkaa pakettia. Ota se käyttöön hostingin hallintapaneelissa (PHP-asetukset → laajennukset) ja yritä uudelleen. Sovellus tarkistaa tämän ennen paketin lataamista.
  • Versio ei muuttunut lataamisen jälkeen - varmista, että tiedostot menivät oikeaan hakemistoon, ja päivitä sivu ohittaen välimuisti (Ctrl/Cmd + Shift + R).
  • Ilmoitus kirjoitusoikeuksista (esim. "Tiedoston … ylikirjoittaminen epäonnistui (kirjoitusoikeudet?)") - palvelin ei salli sovelluksen tallentaa omia tiedostojaan. Korjaa sovelluskansion oikeudet hallintapaneelissa tai FTP:n kautta ja yritä päivitystä uudelleen. Jo suoritettuja migraatioita ei toisteta.
  • ”Sovelluspalvelin palautti odottamattoman vastauksen (HTTP …)” - palvelimellasi toimiva ohjelma päättyi virheeseen ennen kuin se ehti vastata (päivityksiä tarkistettaessa tai ladattaessa). Syy tallentuu hostingin PHP-virhelokiin - toimita se tekniselle tuelle.
  • Painike ”Estetty” - syyn näet versionumeron alla (ja viemällä kursorin painikkeen päälle): ensin pitää asentaa aiempi versio, lisenssi ei enää kata tätä päivitystä (esim. päivitysoikeus on päättynyt) tai julkaisulla ei ole voimassa olevaa julkaisijan allekirjoitusta.