Toukokuu 2013 1 (21) Tikon Ostolaskujenkäsittely/Web-myyntilaskutus versio 6.3.0 Asennusohje
Toukokuu 2013 2 (21) Sisällysluettelo 1. Vaatimukset palvelimelle... 3 1.1..NET Framework 4.0... 3 1.2. Palvelimen Internet Information Services (IIS) palvelun käyttöönotto... 3 2. Ohjelman asennus... 7 3. Arkiston hakemistopolku... 14 4. Vaatimukset työasemalle (Microsoft Silverlight 5.0)... 14 5. Self-Signed sertifikaatin tekeminen... 15 6. Aditro Pankkipalvelut yhteensopiva versio... 18 7. Tarvittavat hakemistotason käyttäjäoikeudet... 18 7.1. Application Pool Identity... 18 7.2. Hakemistotason käyttäjäoikeudet... 19 8. Palomuurien konfigurointi... 19 8.1. Käytettäessä SLL salausta... 19 8.2. Tietokantapalvelin eri kun Web palvelin... 19 8.3. Hakemistot, jotka eivät sijaitse web (IIS) palvelimella... 19 8.4. Web myyntilaskutus ja automaattinen Ftp-lähetys... 20 9. Mahdollisia ongelmatilanteita:... 21
Toukokuu 2013 3 (21) 1. Vaatimukset palvelimelle Tikon Ostolaskujen kierrätysjärjestelmä ja Web-myyntilaskutus edellyttää, että ohjelmapalvelimelle on asennettuna.net Framework 4.0 alusta ja Internet Information Services palvelu on päällä. Internet Information Servicestä on oltava versio 6 tai uudempi. Palvelimen käyttöjärjestelmä on oltava Microsoft Server 2003 tai uudempi. 1.1..NET Framework 4.0 Ostolaskujen käsittely ja Web-myyntilaskutus ohjelmien asentaminen edellyttää että.net Framework 4.0 on asennettuna ennen asennusta. Mikäli.NET Framework 4.0 puuttuu ilmoittaa asennusohjelma tästä ja asennus keskeytyy. Ohjelma löytyy Tikon asennus DVD:ltä tai ohjelman saa myös ladattua Microsoftin sivuilta esim. osoitteesta: http://www.microsoft.com/downloads/en/details.aspx?familyid=9cfb2d51-5ff4-4491-b0e5- b386f32c0992&displaylang=en 1.2. Palvelimen Internet Information Services (IIS) palvelun käyttöönotto Web Server (IIS) rooli alla ruksitettuine role serviceineen pitää minimissään olla asennettuna ennen kuin ohjelma voidaan asentaa Windows Server 2008 palvelimelle. Rooli annetaan Administrative Tools ->Server Manager -toiminolla
Toukokuu 2013 4 (21)
Toukokuu 2013 5 (21)
Toukokuu 2013 6 (21)
Toukokuu 2013 7 (21) 2. Ohjelman asennus Tikon Ostolaskujen kierrätysohjelma asennetaan Tikon Self Service.exe tiedostoa klikkaamalla. Seuraava asennus dialogi saattaa tulla joissakin ympäristöissä, jatka painamalla Asenna. Jos alla oleva ilmoitus tulee, vastaa Yes ja asennus jatkuu normaalisti. Tarkista asennuksen jälkeen Ohjauspaneeli - Asennetut ohjelmat (Control Panel Programs), että komponentti on asentunut.
Toukokuu 2013 8 (21)
Toukokuu 2013 9 (21) Ohjelma pyytää kirjoittamaan lisenssinimen ja lisenssinumeron. Käytä samoja lisenssitietoja millä muutkin Tikon sovellukset asennetaan. Lisenssin haku: Tikon version 6.3.0 asennuksessa tarvittavan lisenssiavaimen tiedot haetaan Aditron asiakassivuilta kohdasta: Sovellukset -Tikon - Lisenssin haku Lisenssin voi tulostaa yrityksestä henkilö, joka on määritelty pääkäyttäjäksi tai tukipalveluyhteyshenkilöksi. Katso lisätietoja tarkemmin erillisestä Lisenssinhaku ohjeesta.
Toukokuu 2013 10 (21) Ohjelma kysyy Tikon Classic asennuskansiota. Halutessasi voit valita myös toisen kansion, mutta tällöin täytyy kansion alla olla tikon.net alikansio, sekä sieltä pitää löytyä ajan tasalla oleva Tikodnet.mdb tiedosto.
Toukokuu 2013 11 (21) Syötä Ostolaskujen käsittelyn/web-myyntilaskutuksen domain nimi. Domain nimi tarkoittaa sivuston nimen alkuosaa (esim. www.yourdomain.com ) jos ostolaskujen käsittely/web-myyntilaskutus julkaistaan internetissä. Jos ostolaskujen käsittely/web-myyntilaskutus julkaistaan vain lähiverkossa annetaan tässä palvelimen verkkonimi. Valitse HTTPS jos aiot julkaista Ostolaskujen käsittely/web-myyntilaskutus-ohjelman internetissä. Tällöin tietoliikenne työaseman ja palvelimen välillä on salattu SSL salauksella. Huom. HTTPS protokolla vaatii että web palvelimelle on asennettu sertifikaatti. Sertifikaatin voi ostaa joltakin viralliselta sertifikaatin toimittajalta esim: Verisign, Thawte, Comodo ym..) Jos sen sijaan käytät Ostolaskujen käsittelyä/web-myyntilaskutusta ainoastaan sisäisessä verkossa (ilman että ulkoverkosta on pääsyä ohjelmaan) voit jättää HTTPS valintalaatikon tyhjäksi. Jos Päivitä IIS suojausasetus... on valittuna, tulee kaikille käyttäjille oikeudet. Valitse tämä jollet tiedä/osaa Microsoft Silverlight suojausasetusten tekemistä. Jos Päivitä IIS suojausasetus... ei on valittuna ei kenelläkään ole käyttöoikeuksia, ennen kun oikeudet on käyty erikseen asettamassa.
Toukokuu 2013 12 (21) Tietokantapalvelimeksi asetetaan (ohjelma tarjoaa oletuksena) palvelin jossa Tikon tietokannat sijaitsevat. Syötä SQL serverin salasana. Mikäli tietokanta instansseja, joihin Tikon ohjelmat on asennuttu, on useampia valintalistasta valitaan haluttu tietokantapalvelin. Tämä ikkunan latautuminen saattaa kestää mikäli tietokantapalvelimia on useita.
Toukokuu 2013 13 (21) Valitse asenna.
Toukokuu 2013 14 (21) Varsinainen ohjelma-asennus on nyt suoritettu! Ohjelman käyttöönotosta kerrotaan erillisessä ohjeessa! 3. Arkiston hakemistopolku Päästäksesi kokeilemaan ohjelmaa on siirtotiedostomääritys Tikon KP-13 oltava määriteltynä. Muut ohjelmien vaatimat asetukset on kerrottu ohjeessa Tikon Ostolaskujenkäsittelyohjelman käyttöönotto. 4. Vaatimukset työasemalle (Microsoft Silverlight 5.0) Microsoft Silverlight 5.0 selainlaajennus on oltava asennettuna työasemalle. Ohjelman voi asentaa Microsoftin sivuilta.
Toukokuu 2013 15 (21) 5. Self-Signed sertifikaatin tekeminen On olemassa itse allekirjoitettuja ja luotettuja varmenteita. Suosittelemme että varmenne tilataan joltain viralliselta varmentajalta esim: Verisign, Thawte, Comodo ym..). Itse allekirjoitettu varmenne riittää suojaamaan tietoliikenteen salakuuntelua vastaan, mutta ei auta tilanteissa joissa kolmas osapuoli pystyy vapaasti manipuloimaan tietoliikennettä. Tästä syystä selain varoittaa, mikäli käyttäjä ottaa yhteyttä itseallekirjoitettua varmennetta käyttävälle palvelimelle. Käynnistä Internet Information Services Manager (Administrative Tools). Klikkaa hiirellä ensin vasemmalla näkyvää palvelimen nimeä. Sitten tuplaklikkaa Server sertificate ikonia. Klikkaa oikealla näkyvää linkkiä Create Self-Signed sertificate
Toukokuu 2013 16 (21) Anna sertifikaatille itse valitsemasi nimi Klikkaa web sivusi (esim. Default web Site) aktiiviseksi Klikkaa oikealta linkkiä Bindings
Toukokuu 2013 17 (21) kilkkaa Add Valitse type valikosta https sekä SSL certificate valikosta nimeämäsi sertifikaatti (Tikon). IP address kenttään voit halutessasi syöttää IP osoitteen tai listan IP osoitteista joista käsin voi käyttää palvelua. Port kentässä on oletuksena https liikenteen oletusportti 443. Paina OK Nyt pitäisi oikealla Browse Web Site osiossa näkyä Browse *:443 (https)
Toukokuu 2013 18 (21) 6. Aditro Pankkipalvelut yhteensopiva versio Jos käytössä on myös Aditro Pankkipalvelut, huomatkaa, että Tikon versio 6.3.0 on yhteensopiva ainoastaan Pankkipalvelut version 1.4.2 kanssa. Tikonin ja Pankkipalveluiden välinen integraatio (asiakas- ja tilitietojen siirrot sekä Ostolaskujen käsittelyn saldokysely ja maksatukset) vaatii, että Tikonin versio 6.3.0 ja Pankkipalvelut versio 1.4.2 otetaan käyttöön samaan aikaan. 7. Tarvittavat hakemistotason käyttäjäoikeudet 7.1. Application Pool Identity Ostolaskujen käsittely/web-myyntilaskutus toimii Tikon.API nimisen Application Pool:in alla. Application Pool:in identity on yleensä muutettu paikalliseksi tai AD:n Windows tunnukseksi. Ostolaskujen käsittely/web-myyntilaskutus asennusohjelma muuttaa Application Pool:in identityn oletusarvoksi (NETWORK SERVICE). Tarkista ennen asennusta onko Tikon.API Application Pool:in identity jokin muu kuin oletusarvo (NETWORK SERVICE). Jos on, niin tunnus on muutettava asennuksen jälkeen samaksi kuin se oli ennen asennusta. (kts. alla oleva kuva). Application Poolin identity tarkistetaan seuraavasti: Käynnistä Internet Information Services (IIS) Manager (Start -> Run -> INETMGR.EXE). Napsauta hiiren vasemmalla Application Pools. Lue Sarakkeesta Identity.
Toukokuu 2013 19 (21) 7.2. Hakemistotason käyttäjäoikeudet Tarkista että Application Pool Identity arvon käyttäjätunnuksella on luku/kirjoitusoikeus seuraaviin hakemistoihin: - Tikon asennushakemiston alikansion Tikon.Net hakemistoon - Web palvelimen windows\temp hakemisto. - web palvelimen Inetpub\wwwroot\Tikon hakemisto. - Tikonin arkistokansio KP 13 siirtotiedostoasetukset(ostolaskujen käsittely käyttää) - Web myyntilaskutus käyttää MT 5, MT 6 ja Ftp-parametri taulussa olevia hakemistoja - Tikonin siirtotiedostoasetuksissa määritelty WEB-käyttäjien tulostushakemisto" 8. Palomuurien konfigurointi 8.1. Käytettäessä SLL salausta Käytettäessä SLL salausta (https), Web palvelimella avataan palomuurista portti 443. 8.2. Tietokantapalvelin eri kun Web palvelin Jos tietokanta palvelin on eri kun Web palvelin avataan palvelimien välille sql serverin käyttämä portti (default portti 1433). Liikenne sallittava välillä *ANY* -> 1433 ja välillä 1433 -> *ANY* 8.3. Hakemistot, jotka eivät sijaitse web (IIS) palvelimella Kaikki hakemistot, jotka eivät sijaitse web palvelimella, kuten siirtotiedostohakemistot tai Ftp hakemistot tai Tikon ohjelmahakemisto vaativat seuraavat palomuuri asetukset: Avataan palvelimien välille tiedostojärjestelmän (filesystem) haun tarvitsemat portit. Microsoft file sharing SMB: User Datagram Protocol (UDP) ports from 135 through 139 and 445 and Transmission Control Protocol (TCP) ports from 135 through 139 and 445
Toukokuu 2013 20 (21) 8.4. Web myyntilaskutus ja automaattinen Ftp-lähetys IIS palvelimelta on avattava Ftp portit 21 (lähettävä) ja 20 (data) laskuhotellia varten
Toukokuu 2013 21 (21) 9. Mahdollisia ongelmatilanteita: Mikäli asennus ei löydä tai sillä ei ole oikeuksia Tikon Classic hakemistoon ja sen alihakemistoihin lähinnä tilanteessa, jossa Web-palvelin sijaitsee DMZ-alueella ja Tikon Classic ei DMZ-alueella tulee menetellä seuraavasti: Kopio Tikon Classic hakemistorakenne DMZ-alueelle, josta löytyy tikodnet.mdb, muita tiedostoja ei tarvita. Tämän jälkeen tee asennus normaalisti. Asennuksen jälkeen konfiguroi uudelleen web-palvelimen asetukset osoittamaan alkuperäiseen Tikon Classic hakemistoon. Ostolaskujen käsittelyn/web-myyntilaskutuksen login ruutu tulee näkyviin mutta käyttäjä ei pääse kirjautumaan ohjelmaan. tarkista että Application Pool identity:llä on luku/kirjoitusoikeus windows\temp hakemistoon (Internet Information Services (IIS) Manager -> Application Pools -> Tikon.Api -> Advanced Settings - > Identity) Jos IIS on asennettu.net Frameworkin jälkeen, voi tulla virheilmoitus HTTP-virhe 500.21 - Internal Server Error. Suorita silloin Dos kehotteessa (Dos prompt), Run As admistrator tilassa komento: 64 bit käyttöjärjestelmä %windir%\microsoft.net\framework64\v4.0.30319\aspnet_regiis.exe i 32 bittinen käyttöjärjestelmä %windir%\microsoft.net\framework\v4.0.30319\aspnet_regiis.exe -i