Data modyfikacji: 2013-08-14 Co zawiera ten dokument: Ten dokument przedstawia, w jaki sposób zainstalować program Kancelaris PLUS 4 za pomocą standardowego instalatora na serwerze MySQL w wersji 5.0 i 5.1. Instalacja i działanie zostały przetestowane na wersji 5.0.60 oraz 5.1.71. Program w wersji 4.x nie może być zainstalowany na wersji serwera 5.5 i wyższych ze względu na zmiany w sposobie obsługi deklaracji typu silnika bazy danych. Zapis istniejący w skrypcie instalacyjnym przestał być obsługiwany i generuje błąd. Program nie jest na bieżąco testowany na wersjach serwera innych niż 4.0.22 Windows/4.0.16 Linux. Dlaczego instalacja na serwerze 5+ jest taka nietypowa? Ze względu na to, że standardowy instalator jest przewidziany na serwer 4.0 nie zawiera on żadnych ustawień związanych z kodowaniem polskich znaków. Od wersji 4.1 serwer wymaga ustawiania kodowania znaków dla klienta, połączenia, bazy danych, tabel i kolumn. Przy standardowych ustawieniach serwera stosowane jest kodowanie UTF8 co powoduje, że błędnie są rozpoznawane polskie znaki wysyłane na serwer przez instalatora, który koduje znaki w systemie Windows1250 (win1250, cp1250). Konieczne są wobec tego następujące operacje: Przestawienie parametrów serwera tak, aby nowe bazy danych były tworzone z ustawieniami cp1250 i jego zrestartowanie, Ręczne założenie źródła ODBC po stronie klienta i ustawienie w nim inicjującego polecenia "set names 'cp1250';", dzięki czemu serwer zostanie poinformowany, że program instalacyjny używa takiego właśnie kodowania Zainstalowanie programu Przywrócenie domyślnych ustawień na serwerze dla ewentualnych innych baz danych i zrestartowanie serwera. Instalator Punkty oznaczone (I) można wykonać za pomocą instalatora programu Kancelaris 1
Procedura: 1. Serwer 1.1. Serwer MYSQL 1.1.1. Instalacja serwera 1.1.2. Standardowa konfiguracja serwera 1.1.3. Ustawiamy w my.ini [mysqld] character-set-server=cp1250 collation-server=cp1250_polish_ci 1.1.3.1.W serwerze 5.0 sortowanie polskich znaków w opcji cp1250_general_ci dalej zawiera błędy. Problem został rozwiązany poprzez wprowadzenie w wersji 5.1 odrębnego sortowania cp1250_polish_ci. Jeżeli chcemy poprawić polskie sortowanie w wersji 5.0 należy podmienić pliki z folderu mysql5\share\charsets na odpowiednie z serwera 5.1: index.xml, żeby powiedzieć, że będzie cp1250_polish_ci cp1250.xml, żeby pokazać jak wygląda 1.2. Zainstalować narzędzia do MySQL 1.2.1. MySQLAdministrator 1.2.2. MySQLQueryBrowser 1.3. Założenie użytkownika Admin 1.3.1. Zalogować się na serwer QBrowserem na root@localhost 2
1.3.2. Założyć użytkownika CREATE USER 'Admin'; GRANT ALL on *.* to 'Admin' IDENTIFIED BY '' WITH GRANT OPTION; 1.4. Restartujemy serwer za pomocą MySQLAdmin'a 1.5. Folder na dane (I) Założyć na komputerze serwerze folder na współdzielone dane np. C:\kancelaris i udostępnić go wszystkim osobom w sieci tak, żeby nie dziedziczył z nadfolderów, ale żeby podfoldery dziedziczyły z niego. 2. Klient 2.1. Driver MySQL ODBC 2.1.1. Instalacja drivera do windowsa w wersji 3.51.12, koniecznie dwanaście (I) 2.1.2. Źródło ODBC Teraz należy ręcznie założyć 32 bitowe źródła ODBC o nazwie "kancelaris_mysql" i odpowiednio je skonfigurować. 2.1.2.1.Uruchomienie Administratoa ODBC W tym celu należy uruchomić administratora źródeł ODBC: dla systemów 32 bitowych c:\windows\system32\odbcad32.exe lub Panel sterowania\narzędzia Administracyjne\Źródła danych ODBC dla systemów 64 bitowych c:\windows\syswow64\odbcad32.exe 2.1.2.2. Założenie źródła ODBC "Kancelaris_mysql" serwer nazwa serwera lub IP user: Admin password: port: 3306 Initial Statement: set names 'cp1250'; Advanced: 3
o Flags1: Włączone opcje 1, 2, 3 o Flags2: Włączona opcja 2 o Dla serwera 5.1 i wersji Kancelarisa mniejszej niż 3.04 koniecznie Flags2: włączona opcja 4 User Manager Cursors Force use of ODBC manager cursors (experimental). Naciskamy TEST żeby sprawdzić połączenie 2.2. Instalacja programu (I) Krok2: wpisujemy klucz CD Krok 3: wskazujemy LOKALNY folder na program (Może zostać "Program Files\Kancelaris) Krok 4: Wybieramy "Chcę zainstalować bazę danych" oraz wskazujemy folder na współdzielone dane założony w 1.4. Krok 5: Podajemy dane do logowania o serwer: nazwa serwera lub IP o user: Admin o password: Krok 6: Program się instaluje. Dane kopiują się do: o systemu (C:\windows\system32 itp.) komponenty JET40 itp. o "Program Files\Kancelaris" Kancelaris.exe, skins, itp. o Katalogu współdzielonego raporty, wspólne szablony, itp. 3. Wracamy na serwer 3.1. Sprawdzić za pomocą QueryBrowsera, czy tabelki są w cp1250: zalogować się Wyedytować tabelkę Adresy 4
Zobaczyć szczegóły jakiegoś pola CHAR Uwaga, jeżeli w punkcie 1.1.3 wybrano polskie sortowanie to zamiast Cp1250_general_ci może być cp1250_polish_ci. Zobaczyć opcje tabeli Uwaga! Jeżeli w punkcie 1.1.3 wybrano polskie sortowanie to zamiast Cp1250_general_ci może być cp1250_polish_ci 5
3.2. Wykomentowanie (#) zmiennych w my.ini ustawionych w 1.1.3 3.3. Restart serwera za pomocą MySQL Administratora 4. Wracamy na klienta 4.1. Sprawdzić działanie programu - logowanie Admin bez hasła 4.2. Za pomocą programu zmieniamy hasło administratora na własne 5. Aktualizacja programu (I) 1.1. Po instalacji program jest w wersji 3.00. 1.2. Program należy zaktualizować do wersji 3.04 dla osób posiadających licencję na 3.00 3.40 dla osób posiadających licencję na 3.40 4.20 dla osób posiadających licencję na 4.20 6. Stanowiska 6.1. Instalujemy program w wersji 3.00 na kolejnych stanowiskach 6.1.1. Krok 4: Wybieramy "Nie chcę instalować bazy danych" i wskazujemy plik Kancelaris.dat w folderze współdzielonym 6.2. Dokonujemy aktualizacji do wersji 3.04 albo 3.40 albo 4.20 Uwagi o działaniu Kancelarisa Ze względu na fakt, że w niektórych sytuacjach numery błędów zwracane przez serwer MySQL są inne dla serwera 4.0.22 i inne dla serwera 5.0/5.1 może nastąpić różnica w informowaniu użytkownika o przyczynach błędów i braku możliwości wykonania jakiejś operacji. Na przykład podczas usuwania klienta, który posiada sprawę Kancelaris na MySQL 4.0.22 pokaże: Natomiast dla serwera MySQL 5.1.41 ze względu na to, że błąd nie został rozpoznany po numerze zwraca się standardowy komunikat MySQL w postaci: 6