Uusasennusohje (pdf)

Asennusohje
Tikon 6.3.0
Toukokuu 2013
Tikon Ostolaskujenkäsittely/Web-myyntilaskutus
versio 6.3.0
Asennusohje
Tikon 6.3.0
Copyright © Aditro 2013
1 (21)
Asennusohje
Tikon 6.3.0
Toukokuu 2013
2 (21)
Sisällysluettelo
1.
1.1.
1.2.
2.
3.
4.
5.
6.
7.
7.1.
7.2.
8.
8.1.
8.2.
8.3.
8.4.
9.
Tikon 6.3.0
Vaatimukset palvelimelle ....................................................................................................................3
.NET Framework 4.0 ............................................................................................................................3
Palvelimen Internet Information Services (IIS) –palvelun käyttöönotto ............................................3
Ohjelman asennus ..............................................................................................................................7
Arkiston hakemistopolku ..................................................................................................................14
Vaatimukset työasemalle (Microsoft Silverlight 5.0) ........................................................................14
Self-Signed sertifikaatin tekeminen ..................................................................................................15
Aditro® Pankkipalvelut yhteensopiva versio ....................................................................................18
Tarvittavat hakemistotason käyttäjäoikeudet ..................................................................................18
Application Pool Identity...................................................................................................................18
Hakemistotason käyttäjäoikeudet ....................................................................................................19
Palomuurien konfigurointi ................................................................................................................19
Käytettäessä SLL salausta..................................................................................................................19
Tietokantapalvelin eri kun Web palvelin ..........................................................................................19
Hakemistot, jotka eivät sijaitse web (IIS) palvelimella ......................................................................19
Web myyntilaskutus ja automaattinen Ftp-lähetys ..........................................................................20
Mahdollisia ongelmatilanteita: .........................................................................................................21
Copyright © Aditro 2013
Asennusohje
Tikon 6.3.0
Toukokuu 2013
1.
3 (21)
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-b0e5b386f32c0992&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
Tikon 6.3.0
Copyright © Aditro 2013
Asennusohje
Tikon 6.3.0
Toukokuu 2013
Tikon 6.3.0
Copyright © Aditro 2013
4 (21)
Asennusohje
Tikon 6.3.0
Toukokuu 2013
Tikon 6.3.0
Copyright © Aditro 2013
5 (21)
Asennusohje
Tikon 6.3.0
Toukokuu 2013
Tikon 6.3.0
Copyright © Aditro 2013
6 (21)
Asennusohje
Tikon 6.3.0
Toukokuu 2013
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.
Tikon 6.3.0
Copyright © Aditro 2013
7 (21)
Asennusohje
Tikon 6.3.0
Toukokuu 2013
Tikon 6.3.0
Copyright © Aditro 2013
8 (21)
Asennusohje
Tikon 6.3.0
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.
Tikon 6.3.0
Copyright © Aditro 2013
Asennusohje
Tikon 6.3.0
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.
Tikon 6.3.0
Copyright © Aditro 2013
Asennusohje
Tikon 6.3.0
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.
Tikon 6.3.0
Copyright © Aditro 2013
Asennusohje
Tikon 6.3.0
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.
Tikon 6.3.0
Copyright © Aditro 2013
Asennusohje
Tikon 6.3.0
Toukokuu 2013
Valitse asenna.
Tikon 6.3.0
Copyright © Aditro 2013
13 (21)
Asennusohje
Tikon 6.3.0
Toukokuu 2013
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.
Tikon 6.3.0
Copyright © Aditro 2013
14 (21)
Asennusohje
Tikon 6.3.0
Toukokuu 2013
5.
15 (21)
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”
Tikon 6.3.0
Copyright © Aditro 2013
Asennusohje
Tikon 6.3.0
Toukokuu 2013
Anna sertifikaatille itse valitsemasi nimi
Klikkaa web sivusi (esim. Default web Site) aktiiviseksi
Klikkaa oikealta linkkiä Bindings
Tikon 6.3.0
Copyright © Aditro 2013
16 (21)
Asennusohje
Tikon 6.3.0
Toukokuu 2013
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)
Tikon 6.3.0
Copyright © Aditro 2013
17 (21)
Asennusohje
Tikon 6.3.0
Toukokuu 2013
6.
18 (21)
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.
Tikon 6.3.0
Copyright © Aditro 2013
Asennusohje
Tikon 6.3.0
Toukokuu 2013
7.2.
19 (21)
Hakemistotason käyttäjäoikeudet
Tarkista että Application Pool Identity arvon käyttäjätunnuksella on luku/kirjoitusoikeus seuraaviin
hakemistoihin:
8.
8.1.
-
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"
Palomuurien konfigurointi
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
Tikon 6.3.0
Copyright © Aditro 2013
Asennusohje
Tikon 6.3.0
Toukokuu 2013
8.4.
Web myyntilaskutus ja automaattinen Ftp-lähetys
IIS palvelimelta on avattava Ftp portit 21 (lähettävä) ja 20 (data) laskuhotellia varten
Tikon 6.3.0
Copyright © Aditro 2013
20 (21)
Asennusohje
Tikon 6.3.0
Toukokuu 2013
9.
21 (21)
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
Tikon 6.3.0
Copyright © Aditro 2013