C4 - Kontrolny a Fix manual(v1.5p –Partneri, Dealeri)

Tento manual je urceny pre riesenie chyb, ktore indikuju nedostupnost alebo nefunkcnost Ozone C4 klienta, resp. C4 servera. Spravidla sa jedna o tieto chybove hlasky:

ObsahObsah..........................................................................................................................................20. Kontrola Konfiguracie PC......................................................................................................3

0.1 Kontrola dostatocnej RAM, Oper. System.......................................................................30.2 Kontrola verzie MS Word.................................................................................................40.3 Kontrola verzie Javy.........................................................................................................50.4 Kontrola konfiguracie C4 klienta......................................................................................6

1. Test prestupu portov:..............................................................................................................72. Overenie spustenych procesov v Task Manageri....................................................................8

2.1 Kontrola poctu spustenych procesov................................................................................82.3 Verifikacia spravnosti spustenych Java procesov.............................................................9

3. Java nieje spustena................................................................................................................103.1. Kontrola prav na Workspace adresar C4.......................................................................113.2. Kontrola dat v Workspace adresar C4...........................................................................12

4. Kontrola procesu Ec4u.C4.PrinterMonitoru.........................................................................145. Overenie tlace dokumentov, reinstalacia..............................................................................156. Odreportovanie problemu na Ozone ServiceDesk................................................................157. Zablokovana C4 Dll kniznica v MS Word...........................................................................178. Kontrola spravnosti nainstalovania MS Word DLL.............................................................199. Samovolne odklikavanie Ec4u AddIn..................................................................................20

V pripade nefunkcnosti tlace je potrebne vykonat nasledovne kroky, doporucujeme zachovat poradie v akom je manual napisany:

Pred zaciatkom kontroly C4 a konfiguracie PC sa prosim uistite ze ako partneri vyuzivate na pristup do Ozonu a test tlace tuto linku: https://ozone.sk.o2.com/prmportal_enu(na inych linkach, napriklad skoliace – EDU prostredie tlac nefunguje!)

0. Kontrola Konfiguracie PC

0.1 Kontrola dostatocnej RAM, Oper. System

Postup:. Skontrolujte parametre vasho PC, nasledovne:- spustite tento skript:

(potvrdte co system ziada: Yes/Run (Ano/Spustit))

o Alebo inym sposobom klinutim na: My Computer > Properties: (Moj Pocitac > vlastnosti)

- Zobrazi sa nasledovne okno:

Kontrola:- je Operacny System presne tejto verzie: Microsoft Windows XP ?- je velkost pamati minimalne 512 MB RAM

Doporucenie:- je nutne dodrzat tieto podmienky kompatibility

0.2 Kontrola verzie MS Word

Postup: spustite aplikaciu MS Word > Help > About Microsoft Office Word:

Kontrola:- je nainstalovana verzia: Microsoft Office Word vo verzii 2003?

Doporucenie:- je nutne dodrzat verziu MS Word 2003 (a nie vyssiu)- nainstalujte Word 2003 z instalacie Ozone

o Word 2003 je sucast balicka https://ozone.sk.o2.com/ecommunications_enu/client/C4.exe

0.3 Kontrola verzie Javy

Postup: - pouzite tento skript:

Zobrazi sa vam nasledovne okno, skontrolujte verziu v riadku zacinajuc java version...

Kontrola:- Java musi byt vo verzii rovnakej alebo vyssej ako 1.6.0_17.

Doporucenie:- Ak toto nieje splnene – treba z instalacneho baliku vyinstalovat JAVA a odtestovat

znovu.

0.4 Kontrola konfiguracie C4 klientaPostup:

- Potrebne subory C4 klienta najdete v adresari: c:\ec4u\C4 Correspondence\

Kontrola:- V adresari sa musi nachadzat subor certificate.jks (CRTL+Click na tuto linku)

Pokial sa tam nachadza, system sa bude snazit ho otvorit a hlaska bude cca takato:

(zatvorte okno – krizik vpravo hore)

- pokial sa certifikat nebude nachadzat v adresari, zobrazi sa cca taketo okno:

- V adresari sa musi nachadzat subor c4config.ini. (CRTL+Click). Ak sa zobrazi taketo okno, konfiguracny subor chyba

- Ak sa zobrazi taketo okno, kliknite na OKo V nasledne zobrazenom okne najdite zalozku [C4Server]. Pod touto moze byt

len jedno, alebo dve prostredia. V tomto ilustracnom pripade su to dve prostredia (Edu a Prod). Zapamatajte si kolko prostredi mate nakonfigurovanych.

Doporucenie:- Pokial sa oba subory (certifikat + konfiguracny subor) nenachadzaju, resp.

Konfiguracne subor neobsahuje vyssie spomenute udaje, je potrebne reinstalovat C4 podla postupu instalacie (postup_instalacie.doc) kapitola 3 Instalacia C4 nastroja odsek 14) a 14b). Nasledne je potrebne vykonat restart PC.

1. Test prestupu portov:Postup:Zadajte do weboveho prehliadaca – Internet Explorer, tuto URL linku:

https://ozone.sk.o2.com:8444 (prip CTRL+Click)(prvy krat moze windows zobrazit chybovu hlasku – odkliknut OK a skusit znovu pokial sa nezobrazi okno Internet Exploreru)

Kontrola:Zobrazene okno Internet Explorera ma vyzerat nasledovne:

Doporucenie:- Ak sa vam tato stranka nezobrazila v Internet Exploreri (vypise ze je nedostupna, bude

sa snazit velmi dlho otvorit), tak ide o lokalny problem, napriklad: PC nie je zapojene v Internete, je zapnuty firewall bud na vasom PC alebo na lokalnom routri, Provider Internetu ma zablokovany port 8444 je treba riesit so spravcom PC, providerom

- Ak sa vam toto okno zobrazi, tak postupujte na krok 2

2. Overenie spustenych procesov v Task Manageri

2.1 Kontrola poctu spustenych procesov

- zmacknite CRTL + Lavy SHIFT + ESC, zobrazi sa nasledovne okno, zvolte druhu zalozku Processes:

- Ak mate nakonfigurovane iba jedno prostredie (bod 0.4): PROD, tak v Task manageri sa musia nachadzat min. 2x Java.exe procesy + 1x Ec4u.C4.PrinterMonitor.exe

- Ak mate dve prostredia (bod 0.4 PROD + EDU), tak v Task manageri sa musia stale nachadzat min. 2x Java.exe procesy + 1x Ec4u.C4.PrinterMonitor.exe. V pripade ze je na servroch spustene aj EDU prostredie, procesy ktore budete mat spustene budu 4. Nieje to vsak nutnost pre fungovanie standardneho – produkcneho prostredia (tam stale stacia 2 Java procesy).

Doporucenie:- Ak nieje spusteny Ec4u.C4.PrinterMonitor.exe, chodte na krok 4- Ak niesu spustene minimalne 2 java.exe procesy a nieje spusteny ani

Ec4u.C4.PrinterMonitor.exe, tak chodte na krok 5 (reinstalacia C4)- ak mate spusteny iba 1 alebo ziadny java.exe proces a je spusteny

Ec4u.C4.PrinterMonitor.exe pokracujte na bod 3- ak mate spustene aspon 2 java.exe procesy a je spusteny Ec4u.C4.PrinterMonitor.exe

, pokracujte nasledujucim bodom 2.3

2.3 Verifikacia spravnosti spustenych Java procesov

Nie vsetky spustene java.exe procesy musia byt naviazane na C4. Je potrebne spravit ich kontrolu.

Postup:- spustite nasledny skript:

(potvrdte zobrazene hlasky YES(ano), RUN(spustit))zmacknite lubovlnu klavesu pri okne Command line (cierne okno)

- vysledok tohoto testu sa zapise do novo-vytvoreneho suboru ProcessList.txt priamo na disk C:\ .Je potrebne otvorit si tento subor bud manualne na disku, alebo spustenim nasledovnej linky (zmacknite a drzte CRTL + kliknite na tuto linku) C:\ProcessList.txt Subor sa vam otvori do vasho predvoleneho textoveho editoru, najcastejsie WordPad, ktory sa vam zobrazi na pracovnej liste dolu – kliknite nan a porovnajte text v subore:

- v subore musia byt minimalne 2 riadky zacinajuce s “java.exe”. Na konci jedneho riadku sa musi vyskytovat tento text:

o de.ec4u.c4.proxy.Main start a na konci druheho (dlheho) riadku tento text:o de.ec4u.c4.tomcat.ServerStartup start

Doporucenie:- Ak riadky v ProcessList.txt nebudu obsahovat uvedene textove retazce, alebo subor

bude prazdny pokracujte na bod 3

3. Java nieje spustena

C4 Client sa pri spustani PC vzdy dotazuje C4 servra pre dostupne aktualizacie (prebieha na pozadi systemu, pre uzivatela transparente). Ak sa nepodari spojit s C4 servrom, tak sa C4 vypne. O opatovne spustenie C4 sa pokusi az pri dalsom starte PC, alebo pri spusteni skriptu ulozeneho nizsie.

Doporucenie:Tento postup aplikujte po kazdom spusteni PC, ak pri spustani PC nie je PC pripojene v Internete, resp. sa manualne zapina internet az po nastartovani PC (neplati ked ide PC do stand by, resp. Hibernate modu = nevypina sa uplne)

- Je potrebne v Task Manageri zastavit spusteny proces Ec4u.C4.PrinterMonitor.exe. Nasledne je potrebne znovu nastartovat proces ked je PC pripojene k internetu. Cely tento postup vykonate spustenim nasledovneho skriptu:

Po spusteni sa zobrazi nasledovne okno:(Pre partnerov sa v ceste nevyskytuje \Program Files\; spustacia cesta bude tiez ina,)

Ak okno obsahuje vetu “The system cannot find the path specified”, tak instlacia bola pravdepodobne spravena v inom adresari ako bolo pisane v pracovnom manuali. Priklad ked je obsiahnuty chybovy text:

- Ak vsetko prebehlo v poriadku (okno neobsahuje ”The system cannot find the path specified”) – vratte sa na krok 2

- Ak nie je umiestneny C4 klient v spravnom adresari = hlaska ”The system cannot find the path specified”, tak je treba preinstalovat C4 do spravneho adresara (odinstalovat staru instalaciu a nainstalovat nanovo), nasledne spravit test tlace

3.1. Kontrola prav na Workspace adresar C4

Je potrebne skontrolovat ci je spristupneny adresar C:\Temp\c4WorkspaceFolder a to na zapis a citanie, resp. full access (ulpny pristup). Ak nie, tak je potrebny cely adresar spristupnit.

Postup:- prava na zapis do adresara odtestujete najjednoduchsie tak, ze donho nakopirujete

lubovolny subor, ktory nasledne zmazete. Ak toto nieje mozne, spravte kroky popisane nizsie.

Doporucenie:Pridanie opravneni na zapis do adresara.

- kliknut na adresar C:\Temp\c4WorkspaceFolder pravym tlacitkom mysi- zvolit spodnu moznost Properties (Vlastnosti)- zalozka Security (Zabezpecenie)- Add (Pridat)

- Do okna vpisat “everyone”- KLIK: Check Names (Kontrolovat nazvy)- OK- Zvolit polozku Full Access (uplny pristup)- KLIK OK

3.2. Kontrola dat v Workspace adresar C4 V prípade, ak nebol skopirovany, resp. bol vymazany obsah adresara C:\Temp\c4WorkspaceFolder tak po restarte Java procesov, resp. restarte dochadza k automatickemu stahovaniu templatov kde pocas tohto ukonu aplikacia vyhadzuje Nemecku chybovu hlasku.

Postup:

- kliknite na adresar C:\Temp\c4WorkspaceFolder pravym tlacitkom mysi,- zvolit spodnu moznost Properties (Vlastnosti),- Adresar by mal vykazovat velkost cez 43 MB.

Doporucenie:- pokial adresar obsahuje menej MB, znamena to, ze na pozadi este stale prebieha

stahovanie templatov a je potrebne pockat,- ak aj po stiahnuti templatov vyhadzuje chybovu hlasku vratte sa do kroku 6)

4. Kontrola procesu Ec4u.C4.PrinterMonitoruJe potrebne skontrolovat v MsConfig, ci je prislusny proces nastaveny, ze sa ma automaticky spustat pri starte, tzn:

Postup:- pre spustenie msconfig spustite nasledovny skript:

- ak sa nepodarilo MsConfig spustit cez skript, postupujte nasledovne:Start > Run > msconfig => resp v SK Win: (Štart > Spustiť > msconfig)

- Zvolte zalozku Startup:

Doporucenie:- ak sa vyssie zvyrazneny riadok (Ec4u) nenachadza v danom okne, doslo k nekorektnej

instalacii C4 Printera, tzn. je potrebne odinstalovat C4 Printer a nainstalovat nanovo (Postup instalacie C4 3 kapitola: Inštalácia C4 nástroja).

- ak sa vyssie zvyrazneny riadok (Ec4u) nachadza a je vlavo zaskrtnuty, tak je potrebne restarovat PC a nasledne skontrolovat ci Ec4u.C4.Printer.exe je spusteny v task manageri – bod 2.1

- Ak ani po restarte sa vam nepodarilo spustit Ec4u.C4.Printer.exe, je potrebne ho spustit skriptom:

Nasledne opatovne skontrolujte ci je spusteny proces v task manageri – bod 2.1

5. Overenie tlace dokumentov, reinstalacia- Ak sa chyba neobjavil a tlac prebehla v poriadku, tak je koniec (nie je co riesit:).

o Kontrolu tlace mozte spravit podla manualu Kontrola C4.dochttps://ozone.sk.o2.com/ecommunications_enu/client/Kontrola C4.doc

- Ak tlac neprebehla a zobrazilo chybovu hlasku, tak spravte reinstalaciu celeho nastroja C4. Potrebne dokumenty a instlaciu najdete na stranke: https://ozone.sk.o2.com/ecommunications_enu/client/

- Konkretneo Stiahnite si poslednu verziu instalacneho balika C4.exe:

https://ozone.sk.o2.com/ecommunications_enu/client/C4.exe

o Postupujte podla manualu Postup_reinstalacie: (https://ozone.sk.o2.com/ecommunications_enu/client/Postup_reinstalacie.doc)

Po reinstalacii skuste opatovne tlac podla manualu. Ak nefunguje skuste opatovne prejst vsetky kontroly a v pripade ze ani tak sa vam nepodarilo najst a opravit chybu – pokracujte na bod 6.

6. Odreportovanie problemu na Ozone ServiceDeskK tomuto kroku pristupte az ked ste presli vsetkymi krokmi v tomto manuale a teda ste presvedceny ze mate aktualnu verziu C4 (resintalacia spravena), Port 8444 je dostupny, java je spustena a tlac stale nefunkcna.

Postup:- Je potrebne vypnut v Task manageri procesi Java. Pre technicky zdatnejsich –

manualne, alebo spustenim tohoto scriptu:

- Nasledne je potrebne spustit tieto subory dvojklikom (skripty su funkcne len pre dealerov a partnerov – nie TO2SK internu siet):

o Najprv spustime subor StartProxy.cmd:

(ak sa system zobrazi nejake hlasky – potvrdte co treba: Yes/Run/Ano/Spustit)

Ak proxy obsahuje nieco ine, prosime o zaznamenanie a zaslanie jeho znenia:- Screenshot, alebo

o vyznacenie textu (prave tlacidlo na myske > Select All; po oznaceni stlacit opat prave tlacidlo na myske;

- otvorit MS Word/E-mail a vykonat nakopirovanie / CTRL+V / alebo prave tlacidlo na myske > Paste) a zaslite na Ozone Service Desk (SD.SK@O2.COM).

o Nasledne spustime subor StartCorrespondence.cmd:

(ak sa system zobrazi nejake hlasky – potvrdte co treba: Yes/Run/Ano/Spustit)

Ak Corrrespondence obsahuje nieco ine, prosime o zaznamenanie a zaslanie jeho znenia:

- Screenshot, aleboo vyznacenie textu (prave tlacidlo na myske > Select All; po oznaceni stlacit

opat prave tlacidlo na myske- otvorit MS Word/E-mail a vykonat nakopirovanie / CTRL+V / alebo prave tlacidlo na

myske > Paste) a zaslite na Ozone Service Desk (SD.SK@O2.COM) spolu s vasim BSCS kodom, telefonnym cislom a nazvom predajne.

- Ak sa v tychto dvoch oknach zobrazilo vsetko v poriadku, potom vykonajte Tlac podla preddefinovaneho postupu az ku chybe ku ktorej dochadza

o Ak po zhliadnuti informacii v command line C4 correspondence skonci s textom “7.3.2010 20:01:33 de.ec4u.c4.model.rule.Data readValue INFO: Rule: property value: 'true' for Property: FS Repair.Return To Account Name Flg”Tak chodte do kroku 7)

o Ak prislusny log obsahuje ine informacie nasledne poslite texty z hore uvedenych Proxy a Correspondence command line na Ozone Service Desk.

- Ak tlac prebehla v poriadku, potom je potrebne urobit restart pocitaca a zopakovat tlac podla preddefinovaneho postupu a opatovne overit funkcnost

7. Zablokovana C4 Dll kniznica v MS Word

Postup:- Otvorte si MS Word 2003, nasledne v menu Nápověda > O aplikaci Microsoft Office

Word. V otvorenom okne stlacte “Zakázané položky ...” a v casti “vyberte položky, ktore chcete znovu povolit” sa nesmie nachadzat Ec4uC4 dll kniznica. Pokial ju tam vidite, je potrebne prislusnu DLL kniznicu povolit cez tlacidlo “Povolit”.

Stav ilustrovany na vyssie uvedenom obrazku je teda korektny = v zakazanych polozkach sa C4 dll nenachadza.

Doporucenie:- Pokial v roletovom menu MS Word v zalozke “Nástroje” nenajdete polozku “Doplňky

modelu COM ...”, tak je potrebne ju do tohoto roletoveho menu pridat. V roletovom menu MS Word zvolte:

o Nástroje > Vlastní ... (otvori sa vam nove okno) o v novo zobrazenom okne prekliknite na druhu zalozku Přikazy,o v casti kategorie (lave okno) vyberte “Nástroje” a nasledne v  casti “Příkazy“

(prave okno) oznacte „Doplňky modelu COM ...“o  Doplnky modelu COM presunte sposobom DragAndDrop do roletoveho menu

v casti Nastroje (kliknite na riadok COM moduly, drzte lavy gombik a presunte ho pohybom mysi do roletoveho menu v MS Word). Tymto sa Doplnky modelu COM zobrazia v standardnom menu Nástroje

- V menu “Nástroje zvolte > Doplňky modelu COM ...” a v otvorenom okne skontrolujte ci je zaskrtnuty text “Ec4u.C4.AddIn.3.4.0.8”.

o Ak sa tam nenachadza dany riadok, tak je zle nainstalovany Correspondence a je potrebne vykonat jeho preinstalovanie

o Ak nie je zaskrtnuty dany riadok, je potrebne zaskrtnut a stlacit tlacidlo OK Opatovne otvorte “Doplňky modelu COM ...” skontrolujte ci je este

stale zaskrtnute Ec4u.C4.AddIn.3.4.0.8. Ak ano, zatvorte MS Word a vykonajte retest tlace. Ak nie, tak chodte do kroku 8)

o Ak sa tam riadok nachadza a je zaskrtnuty, tak je potrebne stlacit OK a nasledne vykonat retest tlace.

8. Kontrola spravnosti nainstalovania MS Word DLL

Postup:- otvorte si instalacny subor z instalacneho balika C4 v adresari C4\O2003PIA\

O2003PIA.msi a postupujte v instalacii.- Po nainstlaovani O2003PIA.msi nasledne opatovne (tak ako je popisane v kroku 7)

skontrolujte v MS Word > Nastroje > “Doplňky modelu COM ...”ci je zaskrtnute Ec4u.C4.AddIn.3.4.0.8. Ak nie zaskrtnite a stlacte OK. Pockajte kym sa Vam okno same nezatvori a naslendne opatovne skontrolujte ci uz je Ec4.C4.AddIn.3.4.0.8. zaskrtnuty

- Ak je zapnuty, tak vypnite MS Word a vykonajte retest tlace- Ak stale nieje Ec4u.C4.AddIn.3.4.0.8 zaskrtnuty, pls. informujte Service Desk o

neuspesnosti

9. Samovolne odklikavanie Ec4u AddIn

Postup:- Aplikovanie Primary Interop Assemblies:

https://ozone.sk.o2.com/ecommunications_enu/client/c4_files/O2003PIA.msi(dajte pozor ze pred jeho instalaciou mate zavrety Winword.exe aj z TASK

MANAGERA)

- Visual Studio 2005 Tools for Officehttps://ozone.sk.o2.com/ecommunications_enu/client/c4_files/vstor.exe

- skontrolujte ci je nainstalovana aktualna verzia Correspondence 3.4.0.8, napriklad v Pridat/Odstranit Programy

- Dalej este je dobre skontrolovat v Pridat/Odstranit Programy aj tento MS Patch kb907417 odtialto sa da nainstalovat: http://www.microsoft.com/downloads/details.aspx?familyid=1B0BFB35-C252-43CC-8A2A-6A64D6AC4670&displaylang=en

(toto je doporucenie vyrobcu C4, ale este sme sa nestretli s pripadom ze by to nebolo nainstalovane, alebo ze by nam to finalne pomohlo vyriesit issue)

9. Vygenerovany dokument je necitatelnyDokument, ktory vam vygenerovalo sa podoba nasledovnemu:

Postup:- otvorte si instalacny subor z instalacneho balika C4 v adresari C4\

FileFormatConverter\FileFormatConverters.exe a postupujte v instalacii.- Po nainstlaovani FileFormatConverters.exe vykonajte retest tlace.

WEB LINK NA INSTALACNE SUBORY A DOKUMENTACIU OZONE:https://ozone.sk.o2.com/ecommunications_enu/client