tikon ostolaskujenkäsittely/web-myyntilaskutus versio...

Asennusohje

Tikon 6.3.1

Marraskuu 2013 1 (27)

Tikon 6.3.1 Copyright © Aditro 2013

Tikon Ostolaskujenkäsittely/Web-myyntilaskutus versio 6.3.1

Asennusohje

Asennusohje

Tikon 6.3.1



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. Windows Server 2012 JA IIS 8 ............................................................................................................. 7 2.1. Windows Process Activation Service (WAS) config-tiedoston muokkaus ........................................ 11

3. Ohjelman asennus............................................................................................................................. 12 4. Arkiston hakemistopolku .................................................................................................................. 20 5. Vaatimukset työasemalle (Microsoft Silverlight 5.0) ........................................................................ 20 6. Self-Signed sertifikaatin tekeminen .................................................................................................. 21 7. Aditro® Pankkipalvelut yhteensopiva versio ..................................................................................... 24 8. Tarvittavat hakemistotason käyttäjäoikeudet .................................................................................. 24

8.1. Application Pool Identity ................................................................................................................... 24 8.2. Hakemistotason käyttäjäoikeudet .................................................................................................... 25

9. Palomuurien konfigurointi ................................................................................................................ 25 9.1. Käytettäessä SLL salausta .................................................................................................................. 25 9.2. Tietokantapalvelin eri kun Web palvelin .......................................................................................... 25 9.3. Hakemistot, jotka eivät sijaitse web (IIS) palvelimella ...................................................................... 25 9.4. Web myyntilaskutus ja automaattinen Ftp-lähetys .......................................................................... 26

10. Mahdollisia ongelmatilanteita: ......................................................................................................... 27

Asennusohje

Tikon 6.3.1



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

http://www.microsoft.com/downloads/en/details.aspx?FamilyID=9cfb2d51-5ff4-4491-b0e5-b386f32c0992&displaylang=en

http://www.microsoft.com/downloads/en/details.aspx?FamilyID=9cfb2d51-5ff4-4491-b0e5-b386f32c0992&displaylang=en

Asennusohje

Tikon 6.3.1



Asennusohje

Tikon 6.3.1



2. Windows Server 2012 JA IIS 8 Mikäli asennus tehdään Windows Server 2012-koneeseen tai työasemaan, jossa käytössä IIS 8 tulee tehdä vähintään seuraavat asetukset, jotta Aditron web-sovellukset saadaan toimimaan. Tarvittavat asetukset voi tehdä polusta Settings => Control Panel => Programs => Programs and Features = > Turn Windows features on or off

Server Roles => Web Server (IIS)

Asennusohje

Tikon 6.3.1



Asennusohje

Tikon 6.3.1



Features => .NET Framework (3.5 & 4.5) Features

2.1. Windows Process Activation Service (WAS) config-tiedoston muokkaus

Asennusohje

Tikon 6.3.1



Windows Process Activation Servicen (WAS) config-tiedostosta täytyy muokata osiota, joka ei ole yhteensopiva .NET Framework 4.0 kanssa, jota taas tarvitaan Aditron web-sovellusten käytössä. Näin ollen WAS:n ApplicationHost.config-tiedostoon tulee tehdä muutos. Ennen muutosta sammuta IIS ja muutoksen jälkeen käynnistä IIS uudelleen. Muokattavan config-tiedoston löytää serveriltä/työasemasta polusta: %windir%\system32\inetsrv\config Etsi ApplicationHost.config tiedostosta seuraava kohta: <add name="ServiceModel" type="System.ServiceModel.Activation.HttpModule, System.ServiceModel, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" preCondition="managedHandler" />

Tee em. kohtaan seuraava muutos (tarvittava muokkaus alla Boldilla):

<add name="ServiceModel" type="System.ServiceModel.Activation.HttpModule, System.ServiceModel, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" preCondition="managedHandler,runtimeVersionv2.0" />

Ja talleta tiedosto.

3. 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”.

Asennusohje

Tikon 6.3.1



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.

Asennus jatkuu

Asennusohje

Tikon 6.3.1



Asennusohje

Tikon 6.3.1



Ohjelma pyytää kirjoittamaan lisenssinimen ja lisenssinumeron. Käytä samoja lisenssitietoja millä muutkin Tikon sovellukset asennetaan.

Lisenssin haku: Tikon version 6.3.1 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.

http://download.personec.com/FI/Tikon/Tikon631/Ohjeistus/Toimitussaatteet/Tikon_Lisenssin_haku_ohje.pdf

Asennusohje

Tikon 6.3.1



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.

Asennusohje

Tikon 6.3.1



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.

http://www.yourdomain.com/

Asennusohje

Tikon 6.3.1



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.

Asennusohje

Tikon 6.3.1



Valitse asenna.

Asennusohje

Tikon 6.3.1



Varsinainen ohjelma-asennus on nyt suoritettu! Ohjelman käyttöönotosta kerrotaan erillisessä ohjeessa!

4. 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”.

5. Vaatimukset työasemalle (Microsoft Silverlight 5.0)

Microsoft Silverlight 5.0 selainlaajennus on oltava asennettuna työasemalle. Ohjelman voi asentaa Microsoftin sivuilta.

Asennusohje

Tikon 6.3.1



6. 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”

Asennusohje

Tikon 6.3.1



Anna sertifikaatille itse valitsemasi nimi

Klikkaa web sivusi (esim. Default web Site) aktiiviseksi Klikkaa oikealta linkkiä Bindings

Asennusohje

Tikon 6.3.1



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)

Asennusohje

Tikon 6.3.1



7. Aditro® Pankkipalvelut yhteensopiva versio Jos käytössä on Aditro® Pankkipalvelut, huomatkaa, että Tikon versio 6.3.1 on yhteensopiva Pankkipalvelut version 1.5.0 kanssa. Suosittelemme, että Tikonin versio 6.3.1 ja Pankkipalvelut versio 1.5.0 otetaan käyttöön samaan aikaan.

8. Tarvittavat hakemistotason käyttäjäoikeudet

8.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.

Asennusohje

Tikon 6.3.1



8.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"

9. Palomuurien konfigurointi

9.1. Käytettäessä SLL salausta

Käytettäessä SLL salausta (https), Web palvelimella avataan palomuurista portti 443.

9.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*

9.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

Asennusohje

Tikon 6.3.1



9.4. Web myyntilaskutus ja automaattinen Ftp-lähetys IIS palvelimelta on avattava Ftp portit 21 (lähettävä) ja 20 (data) laskuhotellia varten

Asennusohje

Tikon 6.3.1



10. Mahdollisia ongelmatilanteita: 1. 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.

2. 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)

3. 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

4. Virheilmoitus “Could not load type 'System.ServiceModel.Activation.HttpModule” web-

sovelluksen kirjautumisruudulle mentäessä (IIS 8). Onko tehty kappaleessa 2.1 mainittu config-tiedoston muokkaus? Lisätietoja tästä ongelmasta alla olevasta linkistä: http://support.microsoft.com/kb/2015129

5. Web-sovellus ei käynnisty, Fiddler-lokiin tulee 500-sarjan virhettä.

Onko kaikki tarvittavat IIS-komponentit otettu käyttöön? Tarkista kappaleiden 1 ja 2 toimenpiteet.

http://support.microsoft.com/kb/2015129

tikon ostolaskujenkäsittely/web-myyntilaskutus versio...

Documents