Charisma Enterprise

- Ghid de instalare -

ISTORIC AL MODIFICARILOR

OBSERVATII

PREREQUISITES

Important

Mod de instalare pe Server

Mod de instalare pe Statii de lucru

COMPONENTELE KITULUI

CONFIGURARI PRELIMINARE

COMPONENTE CU CARACTER SPECIAL

CONFIGURARI SPECIALE

Application Server Service

Startul stand alone al aplicatiei Charisma , versiunea Delphi

Setarea foot-printului in memorie al aplicatiilor Charisma

INTREBARI FRECVENTE

ISTORIC AL MODIFICARILOR

1. 20050617 :
1. S-a adaugat capitolul "Configurari speciale" - primele 3 parti

i. Informatii despre Application Server Service

ii. Startul stand - alone al aplicatiei Charisma , versiunea Delphi ( setare in registry )

iii. Setarea foot-printului in memorie al aplicatiilor Charisma ( setare in registry )

2. Au fost modificate imaginile de la "Configurari preliminare".
1. 20050531 :
1. La "Mod de instalare pe server", punctul 4 a), s-a modificat informatia despre optiunea 'Allow inheritable permissions to propagate to this object'.
2. Au fost adaugate informatii noi in partea "Componente cu caracter special".

OBSERVATII

1. Incepand cu versiunea 1.17, kitul nu mai contine o parte de Delphi si una de DotNet. Totul este integrat in format DotNet.
2. Conexiunea la baza de date nu se mai face pe baza fisierului Charisma.udl pe fiecare masina client, ci pe baza fisierului Local.config al serviciului web de autentificare, instalat pe unul din servere, in calea C:InetpubwwwrootCharismaEnterprise.WebServicesConfigLocal. Avantajul acestui nou mod de conectare este ca gestionarea conexiunilor se face intr-un singur punct si se pot defini una sau mai multe conexiuni, identificabile de catre useri printr-un nume.
3. Fisierul Charisma.udl mai este inca folosit de catre doua aplicatii : PrinServer si Retail.
4. Pentru cazurile in care interfata aplicatiei trebuie sa apara si intr-o limba straina : traducerea se va citi din baza de date cu numele "Translation", de pe instanta de SQL Server pe care se face conectarea.

PREREQUISITES

Important

Pana la versiunea 1.16, cele 2 fisiere importante din kitul de Delphi - serverul de aplicatie (CharismaServer.exe) si aplicatia (Charisma.exe) se instalau ambele pe toate calculatoarele (atat pe "Server" cat si pe statii de lucru).

Incepand cu versiunea 1.17, Serverul de aplicatie se instaleaza doar pe un singur calculator. Acesta ar fi bine ( nu este obligatoriu ! ) sa fie diferit de cel pe care e instalat SQL Server.

Cand Serverul de aplicatie si SQL Server sint pe acelasi calculator, e foarte probabil ca acesta sa lucreze destul de greu (incet).

In urma instalarii va fi creat directorul C:Program FilesTotalsoftCharisma Enterprise Application Server, in care se gaseste noul Server de aplicatie: Charisma.Server.exe

Pe statii de lucru se va instala doar clientul de Windows. Dupa rularea kitului, in directorul C:Program FilesTotalsoftCharisma Enterprise Windows Client se poate gasi si executabilul care sta la baza aplicatiei : Charisma.WinUI.exe.

Mod de instalare pe Server

1. Pe un calculator pe care nu a mai fost instalata Charisma se vor instala, in ordinea prezentata mai jos, urmatoarele :
1. IIS 6.0
2. Windows installer 2.0
3. Internet explorer 6.0 , S.P 1
4. MDAC 2.8
5. Dotnet Framework 1.1 + S.P 1
6. Ultimul SP pentru sistemul de operare (recomandat de catre TotalSoft):

i. Windows NT 4 : SP6 , Windows 2000 : SP 4 , Windows XP : SP 2

7. Daca pe Server e instalat SQL Server 2000, acesta trebuie sa aiba SP 3 a
8. Charisma Enterprise prerequisites - versiunea 1.8 (cea curenta)
1. Observatii :
1. Daca unii din pasii a - e nu functioneaza , e posibil ca aceasta sa nu fie o problema, daca se aplica sistemului de operare un SP foarte nou
2. Avertisment: aceste prerequisites sint cele corespunzatoare versiunii 1.17 ; este necesar sa se instaleze ulterior orice noua versiune care apare pentru ele
2. Pe un Server pe care e instalata Charisma pot exista urmatoarele 2 situtatii:
1. Are instalat IIS => e O.K.
2. Nu are instalat IIS =>

i. se instaleaza IIS 6.0

ii. se instaleaza DotNet Framework 1.1 + SP 1, in cazul in care nu sint instalate

iii. se ruleaza in linie de comanda C:WINNTMicrosoft.NETFrameworkv1.1.4322aspnet_regiis.exe -I ; pentru Windows XP se va rula : C:WINDOWSMicrosoft.NETFrameworkv1.1.4322aspnet_regiis.exe -I

4. Pe serverul unde e instalat IIS, se intra in C:Documents and SettingsAll UsersApplication DataMicrosoftCryptoRSA si se fac modificari pe directorul MachineKeys:
1. La Security : se dau drepturi de Read si Write - mai exact cele 4 bife din figura, pentru grupul local Users:

i.          Observatie : doar daca din anumite motive, la un anumit client nu este permisa acordarea acestor drepturi pentru grupul local Users, se poate crea un user local (Charisma, de exemplu), membru al grupului local Users. Se acorda numai acestui user drepturi de Read si Write pe directorul MachineKeys. In plus toti utilizatorii care acceseaza CharismaEnterprise.WebServices trebuie impersonati ca utilizatorul nou creat (Charisma). Pentru aceasta se intra in la Computer Management > Internet Information Service > Default Web Site > CharismaEnterprise.WebServices. Click-dreapta >Properties > Director Security. Aici se apasa pe butonul Edit ; in ferastra care apare trebuie bifata check-boxul "Anonymus access": Se apasa si aici pe butonul Edit; in fereastra care apare se foloseste butonul Browse pentru a pune alege userul Charisma; se scrie parola si se salveaza :

2. In acest ecran se apasa pe butonul Advanced si in fereastra care apare se bifeaza optiunea "Reset Permissions on all child objects and enable propagation of inheritable permissions" :

Mod de instalare pe Statii de lucru

Pe statii se instaleaza aproape toate prerequisitele prezentate la "Mod de instalare pe Server".

Nu se instaleaza : acele componente care tin doar de Server : SQL Server 2000, IIS 6.0

Modul de lucru este asemanator celui prezentat mai sus, la "Mod de instalare pe Server", punctele 1 si 2.

Important : nu se recomanda instalarea aplicatiei pe statii de lucru care au Windows 98.

Concluzie : Cand se ruleaza kitul de instalare a aplicatiei, se folosesc optiunile :

• Client cu interfata windows : se instaleaza pe statii de lucru (eventual si pe Server, daca se ruleaza aplicatia si pe acesta)
• Server de aplicatie : se instaleaza pe un singur calculator
• Acest calculator este recomandabil sa fie diferit de cel care gazduieste serverul de baze de date si / sau alte servere
• Servicii web: se instaleaza pe un singur calculator

Observatie : Trecerea de la versiunea 1.16 ( sau una mai veche) la 1.17 se face fara probleme, daca kitul se instaleaza manual.

Daca se doreste instalarea in sistem Autoupdate trebuie avute in vedere urmatoarele :

1. Trecerea de la Delphi la DotNet se poate face doar daca in Charisma Enterprise, la File > Actualizare > Configurare se inlocuieste numele fisierului msi ce contine imaginea, din "app.delphi.msi" in "app.uiwin.msi":

2. Nu se poate folosi metoda Autoupdate pentru a trece de la o versiune mai veche de DotNet la versiunea 1.17. Acest tip de update a versiunii se poate face doar manual.

COMPONENTELE KITULUI

1. Client cu interfata Windows : Charisma.WinUI.exe
1. Se instaleaza pe statii de lucru ( si eventual pe Server)
2. Este in calea "C:Program FilesTotalsoftCharisma EnterpriseWindows Client" . Acest executabil le inlocuieste pe cele vechi : aplicatia in Delphi (Charisma.exe) si cea de DotNet (Charisma.WinUI.exe)
2. Serverul de aplicatie : Charisma.Server.exe
1. Se instaleaza doar pe Server
2. Este in "C:Program FilesTotalsoftCharisma EnterpriseApplication Server"
3. El ia locul celor doua vechi executabile : serverul de aplicatie Delphi (CharismaServer.exe) si serverul de aplicatie DotNet (Charisma.Server.exe)
3. Servicii Web : componenta ce contine Servicii de autentificare si Servicii de raportare
1. Se instaleaza pe Server.
2. Se gasesc in "C:InetpubwwwrootCharismaEnterprise.WebServices"

Sistemul Charisma Enterprise contine un utilitar foarte important :

System Configurator : Charisma.Tools.SystemConfigurator.exe

Poate fi instalat cu orice componenta a sistemului ( Client cu interfata Windows, Server de aplicatie, Servicii Web )

Se gaseste in 'C:Program FilesTotalsoftCharisma Enterprise' . Spre deosebire de componentele kitului prezentate mai sus, pentru el nu se poate alege calea de instalare

Dupa instalare, cu el se configureaza - atat pe server cat si pe statii - anumiti parametri necesari pentru buna functionare a aplicatiei:

• Client Windows : conexiunea cu serverul de aplicatie, cu serviciul de autentificare.
• Server de aplicatie : conexiunea cu serverul de autentificare .
• Servicii web : conexiunea cu baza de date.

Observatie : daca se doreste instalarea componentelor in alta cale decat cea standard sau nu se instaleaza complet (exemplu : se renunta la partea de Reporting Services) se instaleaza in format Custom ; altfel, se lasa setarile implicite (propuse de catre kit) .

CONFIGURARI PRELIMINARE

Dupa ce se instaleaza componentele kitului Charisma Enterprise, se foloseste System Configurator pentru urmatoarele configurari:

1. Client Windows :

Configurarile care se fac aici tin de Conexiunea cu serverul de aplicatie, cu serviciul de autentificare etc.Dupa orice schimbare care se face aici se apasa butonul "Testeaza"; daca totul e OK se salveaza schimbarile facute.

2. Server de aplicatie : . Configurarile facute in acest caz : parametri proprii si conexiunea cu serviciul de autentificare.

Servicii web : .

1. Acestea se refera la :

i. Date despre serviciile de raportare ( se stabilesc in partea de sus a ecranului)

ii. Conexiunile cu bazele de date : daca se doreste adaugarea unei noi conexiuni se face click - dreapta in dreptunghiul in care este lista cu conexiuni; se foloseste optiunea "Adauga" si se scriu anumite date : Instanta de SQL Server, utilizator si parola, Baza de date etc.

Observatii

Este foarte important ca dupa orice modificare importanta facuta pe SERVER , la System Configurator , sa se restarteze serverul de web ( comanda iisreset)

Dupa orice modificare facuta in System Configurator , trebuie testata corectitudinea schimbarilor prin butonul . Numai daca testul returneaza OK, se salveaza modificarile.

Datele stabilite in System Configurator, la Servicii web, se salveaza in fisierul Local.config, al serviciului web de autentificare. Acesta se afla pe calculatorul unde a fost instalata componenta "Servicii web" , in C:InetpubwwwrootCharismaEnterprise.WebServicesConfigLocal (daca la instalare nu s-a ales alta cale pentru serviciile web. Imaginea contine 3 conexiuni : Main, Main2 si MyDB.

COMPONENTE CU CARACTER SPECIAL

Exista anumite componente al sistemului Charisma Enterprise, care lucreaza intr-un mod special, in privinta conectarii la serverul de aplicatie si la serviciile web.

Se vor aminti aici urmatoarele componente :

• Clientul Web
• Charisma Mobile

Incepand cu versiunea 1.17, pentru ca aceste componente sa functioneza corect, una din conditiile de baza este ca in fisierul Local.config , aflat pe calculatorul unde a fost instalata componenta "Servicii web" , in    C:InetpubwwwrootCharismaEnterprise.WebServicesConfigLocal, sa existe obligatoriu o conexiune denumita "Main".

Aceste componete se vor conecta doar prin Main , nu si cu alta conexiune.

Observatii :

• Conexiunile se stabilesc cu System Configurator, la Servicii web :
• Numele coenxiunii este Case-sensitive ( Main nu este acelasi lucru cu MAIN sau main).

CONFIGURARI SPECIALE

Application Server Service

Pe calculatorul unde este instalat serverul de aplicatie , in calea C:Program FilesTotalsoftCharisma EnterpriseApplication Server , se pot observa 3 executabile :

1. Charisma.AppServer.exe
1. In urma instalarii , acest executabil va rula ca un serviciu windows
2. Utilitate : acest serviciu face ca la initializarea sistemului de operare sa porneasca automat si serverul de aplicatie
3. Anterior se punea in Startup un shortcut catre Charisma.Server.exe => serverul de aplicatie pornea NUMAI dupa ce cineva se loga pe calculatorul respectiv
2. Charisma.Server.exe
1. Este consola prin care se poate porni Serverul de aplicatie
3. Charisma.ServiceManager.exe
1. Este un Manager cu care se poate porni / opri serviciul windows amintit la punctul 1

Kitul de instalare seteaza servicul windows Charisma Enterprise Application Server ca sa porneasca automat la initializarea SO :

Observatii :

1 : Pentru acest serviciu sa poata functiona, trebuie ca pe calculatorul respectiva sa ruleze IIS Server; aceasta se traduce si prin dependenta pe care o are servicul windows Charisma Enterprise Application Server fata de serviciile World Wide Web Publishing Service.

2. Serviciul poate fi apelat prin Start > Programs > TotalSoft > Charisma Enterprise > Application Server Service Manager. Apare un mic ecran de configurare :

Se apasa pe butonul Start si se asteapta pana cand porneste serverul. Dupa pornire, se observa in coltul din dreapta jos starea serverului : Pornit = , Oprit = .

3. Charisma.Server.exe si Charisma.ServiceManager.exe se exclud reciproc ; ceea ce inseamna ca in Startup nu trebuie sa existe shortcuturi catre ambele executabile.

Startul stand alone al aplicatiei Charisma , versiunea Delphi

Exista cazuri in care pe unele statii de lucru este necesara ca aplicatia de Delphi ( exemplu: componenta de Retail din Charisma ) sa porneasca independent de partea de DotNet.

Acest mod de lucru se stabileste prin adugarea unei chei in registri, la HKEY_LOCAL_MACHINESOFTWARETotalSoft.

Key : InteropStandalone

Value : 1

Observatie : pornirea doar a plicatiei de Retail se poate face prin Start > Programs > TotalSoft > CharismaEnterprise > Charisma Enterprise (stdl. mode).

Setarea foot-printului in memorie al aplicatiilor Charisma

By default, la interval de 15 secunde, aplicatiile Windows in general ( Charisma.exe si Charisma.WinUi.exe in particular) , isi reduc la minim footprint-ul in memorie, de la 80M la sub 10M.

In situatiile in care ar putea aparea probleme de performanta pe servere de terminal services spre exemplu, acest feature poate fi configrat din registry prin adaugarea a doua chei, in HKEY_LOCAL_MACHINESOFTWARETotalSoftCharisma Enterprise:

1. Key : DisableTrimWorkingSet
1. Value : 1 (dezactiveaza acest caracteristica)
2. Key : TrimWorkingSetDelay
1. Value : 15000 ( este valoarea default, in milisecunde)
2. se poate configura un nr. de ms mai mare intre apelurile de reducere a working setului aplicatiei.

INTREBARI FRECVENTE

1. La Computer management se da Browse pe Logon.asmx si nu se intampla nimic:
1. Observatie : kitul aplicatiei Charisma Enterprise configureaza un director virtual CharismaEnterprise.WebServices (vezi figura de mai sus). Se verifica ce culoare are directorul CharismaEnterprise.WebServices:
2. Albastru => e corect
3. Galben => nu e corect
2. Cum se testeaza in browser serviciul web:
1. https://localhost/CharismaEnterprise.WebServices/ Authentication/logon.asmx
2. se alege linkul GetPublicData
3. la "Parameter / request" se introduce valoarea : <DbConnections/>. Atentie : este CaseSensitive !
4. se apasa pe butonul Invoke
5. daca apare o pagina web cu conexiunile setate in fisierul Local.config, este OK
3. La pornirea aplicatiei Charisma Enterprise apare eroarea din imaginea de mai jos :    
1. Cauza ar putea fi o configurare gresita in System Configurator ( Exemplu: la Client Windows, in rubrica "Conexiunea cu serviciul de autentificare" e scris un text gresit - WebSevrices , in locWebServices )
4. La Login in Charisma Enterprise, dupa selectarea unei conexiuni aparea eroarea: Lista de conexiuni nu a fost citita, "SQL does not exist or access is denied". Cauze :
1. In fisierul Local.config al serviciului web este salvat un connection string eronat
2. Daca se poate deschide totusi conexiunea cu Query Analyzer inseamna ca masina SQL server are un firewall care blocheaza accesul TCP. Rezolvarea problemei: se face in primul rand pe masina Server SQL, unde firewall-ul va trebui configurat astfel incat sa ofere acces TCP/IP pentru clientii SQL Server. In mod exceptional, se poate face direct in connection stringul din Local.config, prefixand numele Data Source cu "np:" spre exemplu Data Source=np:Dcerpd.
5. La versiunea 1.16 (sau mai vechi), se puteau folosi 2 parametri in shortcutul catre Charisma.exe : server=*** , database=***, unde Server = instanta de SQL Server pe care era baza de date , iar database = acea baza de date. Acesti parametri faceau ca cei care foloseau acel shortcut sa se logheze automat la baza de date respectiva. Se pot folosi astfel de parametri si in shorcutul catre Charisma.WinUI.exe , insa acum acesti parametri se scriu la Target astfel : user=*** connection=***, unde
1. User = un user al aplicatiei Charisma Enterprise
2. Connection = o conexiune cu baza de date, stabilita cu utilitarul System Configurator, la Servicii web :
3. Parametrii stabiliti in shortcutul catre Charisma.WinUI.exe ar putea arata astfel :
6. Unde se gasesc vechile fisiere ( Accounting.dll , Asset.dll ., PrintServer.exe etc) ?
1. In "C:Program FilesTotalsoftCharisma EnterpriseWindows ClientInterop"
7. La pornirea aplicatiei Charisma Enterprise apare o eroare de genul :
1. 
2. Cauza : probabil ca serverul de aplicatie nu este pornit
8. In timp ce se instaleaza componenta "Servicii web", apare mesajul de eroare:
1. Cauza : nu a fost instalat Reporting Services
2. Mod de rezolvare :

i. Daca e necesar, se instaleaza Reporting Services si apoi se reia instalarea

Observatie : Reporting Services este necesar doar daca la clientul respectiv se folosesc rapoarte in forma DotNet sau se utilizeaza Assistant Manager.

ii. Daca nu , se instaleaza componenta "Servicii web"in format Custom, iar la pasul de selectie a componentelor se renunta la Reporting Services:

Dupa ce se dezactiveaza Reporting Services ( optiunea SS2KRS ) se apasa pe butonul Next si se continua instalarea.