Visma GATEWAY INSTALLER asennusopas 1
Sisällys Tietoa dokumentista...3 Tuetut käyttöjärjestelmät...3 GATEWAY INSTALLER sovelluksen itselatausohjelma...3 GATEWAY INSTALLER sovelluksen suorittaminen...4 OnPremises Gatewayn asennus...7 Asennuksen tarkistaminen...12 Asennusvirheiden käsittely...13 Visma Update Clientin asennus...13 Asennuksen tarkistaminen...17 Asennusvirheiden käsittely...18 OnPremises Gatewayn asennus ei onnistu (#1)...19 OnPremises Gatewayn asennus ei onnistu (#2)...19 OnPremises Gatewayn asennus ei onnistu (#3)...20 2
Tietoa dokumentista GATEWAY INSTALLER on sovellus, jolla asennetaan Visman paikallisesti asennettavien sovellusten (On Premise) ja Visman Internetissä toimivien (On Demand) palveluiden välisen kommunikoinnin mahdollistavia työkaluja. GATEWAY INSTALLER ei itsessään asennu tietokoneelle, vaan sitä käytetään liikennöintiin tarvittavien sovellusten jakamiseen ja asentamiseen. Ohjelmalla voidaan myös myöhemmin poistaa suoritetut asennukset. Tässä dokumentissa kerrotaan, kuinka GATEWAY INSTALLER -sovellus suoritetaan ja mitä työkalujen asennusprosessin aikana tapahtuu. Dokumentti on tarkoitettu Visman tuotteiden ylläpitäjille. Tuetut käyttöjärjestelmät - Windows XP - Windows Vista (32 ja 64 bit) - Windows 2003 Server (32 ja 64 bit), Windows 2008 Server (32 ja 64 bit), Windows 2008 Server R2 - Windows 7 (32 ja 64 bit) Suosittelemme, että päivitätte käyttöjärjestelmäänne Windows Updatella uusimmat käytössä olevat päivitykset ja huoltopäivitykset (Service Pack) ennen GATEWAY INSTALLER -suoritusta. Vaatimukset - Asiakkaan asennusta tekevällä, tyypillisesti pääkäyttäjä, täytyy olla Visma OnDemand tunnukset ja tämä käyttäjätili täytyy olla aktivoitu. - Asennusohjelman ja OnPremise Gatewaylle täytyy sallia verkkoliikenne osoitteeseen odg.visma.net. Tämä voi vaatia muutoksia asiakkaan palomuuriasetuksiin. Verkkoliikenteen toimivuus voidaan todentaa ping-komennolla. (Tästä on tarkempi kuvaus kappaleessa: OnPremises Gatewayn asennus ei onnistu (#3) ) - mahdollisista virhetilanteista on myös tarkempia kuvauksia dokumentissa, joka tulee asennuspaketin mukana ja on samassa kansiossa, kuin itse asennusohjelma: OnPremises_Gateway_Installation_Guide.pdf GATEWAY INSTALLER sovelluksen itselatausohjelma Käynnistä asennuskansiosta löytyvä setup.exe (/OPG_INSTALLER/setup.exe), jolloin itselatausohjelma aloittaa GATEWAY INSTALLER -sovelluksen vaatimien ohjelmien asennuksen: 3
-.Net Framework 3.5 Service Pack 1 - Windows Installer 4.5 Kuva 1. Edellä mainitut ohjelmat täytyy asentaa samalle koneelle, jolle GATEWAY INSTALLERsovellus asentaa sovelluksia. Ilman näitä asennukset eivät onnistu. Jos asennusohjelma löytää molemmat ohjelmaversiot tai jommankumman jo asennettuina, niitä ei enää asenneta uudelleen. Jos molemmat ovat jo asennettuina, yo. ruutukuvassa näkyvää tilannetta ei tule ollenkaan, vaan GATEWAY INSTALLER sovelluksen aloitusruutu avautuu kohdan 4. mukaisesti. Ohjelmien asentamisen jälkeen asennusohjelma pyytää käynnistämään työaseman uudelleen. Huomaa, että asennuksen suorittavalla käyttäjällä täytyy olla järjestelmän pääkäyttäjän oikeudet. Windows Installerin ja.net Frameworkin asennus voi kestää useita kymmeniä minuutteja riippuen Internet-yhteyden nopeudesta ja asennuksessa käytettävän tietokoneen suorituskyvystä. GATEWAY INSTALLER sovelluksen suorittaminen Käynnistä GATEWAY INSTALLER -asennuskansiosta löytyvä setup.exe työkalun ohjatun suorituksen aloittamiseksi. Ohjelman käynnistyttyä sinua pyydetään valitsemaan asennuskieli, ks. kuva alla: 4
Kuva 2. Valitse käytettävä kieli ja paina Seuraava-painiketta. Seuraavassa vaiheessa valitset asennettavat sovellukset. Kuva 3. Valitse asennettavat ohjelmat (oletuksena kaikki) merkitsemällä valintaruudut ja paina Seuraava. Tällöin GATEWAY INSTALLER esittää listauksen asennettavista ohjelmista ja voit 5
käynnistää asennukset painamalla jälleen painiketta Seuraava. Tässä vaiheessa voit vielä muuttaa valintoja painamalla painiketta Takaisin. Kuva 4. Mikäli painat Seuraava, GATEWAY INSTALLER -sovellus käynnistää valittujen ohjelmien asennusohjelmat ja lukitsee siksi aikaa itsensä suoritukseen, ks. kuva alla. Kuva 5. OnPremises Gateway (OPG)- ja Visma Update Client -ohjelmien ohjatut asennukset on kuvattu tarkemmin jäljempänä tässä dokumentissa. 6
Mikäli tietokoneelle on aiemmin asennettu ohjelmia GATEWAY INSTALLER -sovelluksella, GATEWAY INSTALLER näyttää Valitse sovellus -vaiheessa myös mahdollisuuden niiden hallittuun poistamiseen. GATEWAY INSTALLERilla voit siis sekä poistaa että asentaa Visman sovelluksia. On huomattava, että ennen kuin Visma Update Clientin poistaminen onnistuu, tulee ko. sovellus sulkea. Ohjelman suorituksen aikaisia lokitiedostoja voit tarkastella seuraavista hakemistoista. - Mikäli kyseessä on Windows XP tai Windows Server 2003, lokit tallentuvat hakemistoon: C:\Documents and Settings\All Users\Application Data\Visma\Visma Installer\Log - Mikäli kyseessä on Windows Vista, Windows Server 2008 tai Windows 7, ne tallentuvat hakemistoon: C:\ProgramData\Visma\Visma Installer\Log Seuraavissa luvuissa on kuvattu tarkemmin GATEWAY INSTALLER -sovelluksen käynnistämien työkalujen ohjatut asennukset. OnPremises Gatewayn asennus OnPremises Gateway -asennusohjelman aloitusruudulla voit valita aloituksen painamalla nappia Seuraava tai lopettaa asennuksen painamalla Peruuta, ks. kuva alla. Kuva 6. Seuraavassa vaiheessa valitset, mihin OnPremises Gateway -ohjelma asennetaan. Valinnalla Vakio ohjelma asennetaan esivalittuun polkuun. Jos valitset Mukautettu sinulta kysytään 7
haluttu tiedostohakemisto asennettaville tiedostoille. Tässä ohjeessa ei erikseen kuvata Mukautettu -valintaa ja hakemiston antamista, vaan käymme läpi ainoastaan valinnan Vakio mukaiset toimet, ks. kuva alla. Kuva 7. Jatkaaksesi asennusta paina painiketta Seuraava. Asennus kysyy tässä vaiheessa, haluatko asentaa OnPremises Gateway -sovelluksen niin että sitä voi käyttää vain paikallisesta koneesta. Jos tarkoitus on suorittaa käytössä olevaa pankkisovellusta toisesta koneesta, kuten yleensä, tätä kohtaa EI SAA valita, kuten alla oleva kuva osoittaa. 8
Kuva 8. Seuraavassa vaiheessa sinulta kysytään rekisteröidyn Visma OnDemand -käyttäjän tunnukset. Nämä tunnukset myöntää asiakkaille Visma ja sinulla täytyy olla voimassa oleva ohjelmistolisenssi saadaksesi asennukseen tarvittavat tunnukset. Mikäli olet rekisteröitynyt käyttäjä, mutta olet unohtanut OnDemand-palvelun salasanasi, voit pyytää uutta seuraavasta osoitteesta: https://www.visma.net/web/guest/home Kuva 9. 9
Syötä Visma On Demand käyttäjätunnuksesi (sähköposti) sekä salasana ja paina Seuraava. Asennusohjelma varmentaa antamasi tunnukset ja alkaa ladata OnPremises Gatewayn tiedostoja Visman palvelimelta. Kuva 10. Jos olet useamman yrityksen pääkäyttäjä, asennusohjelma pyytää erikseen valitsemaan asiakaslistalta haluamasi asiakkaat, joille OnPremises Gateway -asennus suoritetaan (asiakas tarkoittaa tässä Visman asiakasta). 10
Kuva 11. Suorita valinta alasvetovalikosta ja paina Seuraava. Tämän jälkeen asennusohjelma lataa suojatun yhteyden luomiseen (OpenSSH) tarvittavia tiedostoja Visman palvelimelta. Kuva 12. Latauksen aikana voi tulla kuvan 13. mukainen Windows suojausvaroitus. 11
Kuva 13. Kun valitset Pura esto tai Kysy myöhemmin, asennus jatkuu. Asennuksen jälkeen asennusohjelma esittää yhteenvetonäkymän suorituksesta ja voit lopettaa asennusohjelman painamalla Valmis. Kuva 14. Asennuksen tarkistaminen Asennuksen jälkeen OnPremises Gatewayn pitäisi näkyä Windowsin palvelulistalla nimellä Visma OnPremises Gateway ja palvelun tilan pitäisi olla Käynnistetty. Voit tarkastaa tämän suorittamalla komennon services.msc (Käynnistä Suorita.. services.msc). 12
Kuva 15. Asennusvirheiden käsittely OnPremise Gatewayn asennusohjelma kirjoittaa suorituksesta lokitiedostoja. - Mikäli kyseessä on Windows XP tai Windows Server 2003, ne tallentuvat hakemistoon: C:\Documents and Settings\All Users\Application Data\Visma\OPGatewayService\ XXX\Logging\log...missä XXX merkintä tarkoittaa asennetun OnPremises Gatewayn versiota, esim. 1.1.1. - Mikäli kyseessä on Windows Vista, Windows Server 2008 tai Windows 7, ne tallentuvat hakemistoon: C:\ProgramData\Visma\OPGatewayService\XXX\Logging\log...missä XXX merkintä tarkoittaa asennetun OnPremises Gatewayn versiota, esim. 1.1.1. Ongelmatapauksissa ota yhteyttä Visman asiakaspalveluun luomalla HelpDesk-pyyntö ja liitä syntyneet lokitiedostot pyyntöön. Visma Update Clientin asennus Visma Update Client -asennus käynnistyy GATEWAY INSTALLER sovelluksesta, kuten yllä on kuvattu. Ensimmäisessä vaiheessa sinun tulee valita, mihin Visma Update Client - 13
ohjelma asennetaan. Valinnalla Vakio ohjelma asennetaan esivalittuun polkuun, mutta valitessasi Mukautettu sinulta kysytään tiedostohakemisto asennettaville tiedostoille. Tässä ohjeessa ei erikseen kuvata Mukautettu -valintaa ja hakemiston antamista, vaan käsittelemme vain valinnalla Vakio suoritettavan asennuksen, ks. kuva alla. Huom! Mikäli käynnistät Visma Update Client -ohjelman asennuksen ilman GATEWAY INSTALLERia, ennen asennuksen tyypin valintaa sinulta kysytään asennuksessa käytettävä kieli. Tätä asennusvaihtoehtoa ei kuvata tässä ohjeessa tarkemmin. Kuva 16. Valitse Vakio ja paina Seuraava, jolloin asennusohjelma käynnistää tiedostojen kopioinnin tietokoneelle, ks. kuva alla. 14
Kuva 17. Asennusohjelman suoritettua toimintonsa käyttäjälle näytetään seuraava ikkuna, ks. kuva alla. Paina Seuraava jatkaaksesi. Kuva 18. 15
Kuva 19. Päätä asennus painamalla Lopeta. Kuva 20. Valitse Seuraava. Tämän jälkeen avautuu vielä ruutu, jossa on yhteenveto tehdyistä asennuksista. 16
Kuva 21. Päätä asennus painamalla Lopeta. Lisätietoa Visma Update Client -ohjelman käytöstä löydät ohjelman käyttöoppaasta. Asennuksen tarkistaminen Asennuksen jälkeen Visma Update pitäisi näkyä Windowsin palvelulistalla nimellä Visma Update ja palvelun tila pitäisi olla Käynnistetty. Voit tarkastaa tämän suorittamalla komennon services.msc (Käynnistä Suorita.. services.msc). 17
Kuva 22. Asennusvirheiden käsittely OnPremises Gatewayn asennusohjelma kirjoittaa suorituksesta lokitiedostoja. Nämä lokitiedostot on syytä lähettää Visman asiakaspalvelun tutkittavaksi, mikäli asennuksessa tapahtuu virheitä eikä Visma Update Client käynnisty tietokoneella. - Mikäli kyseessä on Windows XP tai Windows Server 2003, lokitiedostot tallentuvat hakemistoon: C:\Documents and Settings\All Users\Application Data\Visma\Visma.Services.PackageManagement.UI\XXX\Logging\log...missä XXX merkintä tarkoittaa asennetun sovelluksen versiota, esim. 1.0. - Mikäli kyseessä on Windows Vista, Windows Server 2008 tai Windows 7, ne tallentuvat hakemistoon: C:\ProgramData\Visma\ Visma.Services.PackageManagement.UI \XXX\Logging\log...missä XXX merkintä tarkoittaa asennetun sovelluksen versiota, esim. 1.0. Ongelmatapauksissa ota yhteyttä Visman asiakaspalveluun luomalla HelpDesk-pyyntö ja liitä syntyneet lokitiedostot pyyntöön. 18
OnPremises Gatewayn asennus ei onnistu (#1) Ilmoitus: Käyttäjä on käynnistänyt Gatewayn asennusohjelman (tai GATEWAY INSTALLER asennuksen), mutta asennus pysähtyy Ei asiakkaita! virheilmoitukseen, ks. kuva alla. Kuva 23. Syy: Käyttäjällä ei ole tarvittavia käyttöoikeuksia Gatewayn asentamiseen. Käytännössä kyseinen käyttäjä on rekisteröity vain ns. Customer Contact henkilöksi yritykselle OnDemand järjestelmään. Tällä roolilla oleva henkilö ei saa asentaa yrityksen ympäristöön Gatewayta. Korjaustoimenpiteet: Asennus on suoritettava eri OnDemand tunnuksella tai käyttäjän rooli on vaihdettava OnDemand järjestelmään yrityksen/asiakkaan ylläpitäjäksi (Customer Administrator). Roolin vaihdoksen voi tehdä asiakkaan OnDemand ylläpitäjän roolin omaava henkilö osoitteessa http://www.visma.net/web/guest/home OnPremises Gatewayn asennus ei onnistu (#2) Ilmoitus: Käyttäjä on käynnistänyt Gatewayn asennusohjelman (tai GATEWAY INSTALLER asennuksen), mutta asennus pysähtyy error loading ra certificate virheilmoitukseen, ks. kuva alla. 19
Kuva 24. Syy: Hyvin harvinainen tilanne, mutta mahdollinen; OnDemand järjestelmässä on autentikointipalvelussa jotain ongelmia ja uusia sertifikaatteja ei juuri nyt voida myöntää asiakkalle. Korjaustoimenpiteet: Asiakas ei omilla toimenpiteillään voi korjata tilannetta ota yteyttä asiakaspalveluun. OnPremises Gatewayn asennus ei onnistu (#3) Ilmoitus: Käyttäjä on käynnistänyt Gatewayn asennusohjelman (tai GATEWAY INSTALLER asennuksen), mutta asennus pysähtyy palomuurivirheeseen. Syy: Gateway asennusohjelma yrittää ottaa yhteyttä Visman palvelimelle osoitteeseen 193.75.92.25. Korjaustoimenpiteet: Avataan palomuuriin portit 18181, 38181 ja 2233 TCP muotoiselle ulospäin menevälle liikenteelle, ainakin asennuksen ajaksi. Lisäksi ympäristössä on sallittava liikennöinti yrityksen koneiden välillä porttiin, jossa Gateway palvelu pyörii, tyypillisesti 55555. 20