Wprowadzenie
W artykule opisana została instrukcja instalacji aktualizacji oprogramowania wraz z możliwymi problemami/błędami, które mogą wystąpić.
Wymagania wstępne
Podstawowa wiedza na temat aktualizacji oprogramowania, logistyki oprogramowania i obiektów deweloperskich.
Opis
Instalacji manualna
Domyślnie aktualizacje oprogramowania powinny być instalowane automatycznie. Jeśli podczas automatycznej instalacji wystąpią błędy, można wykonać poniższe kroki i wznowić instalacje automatyczną. W Comarch ERP Enterprise istnieje możliwość całkowicie manualnego importu i instalacji aktualizacji oprogramowania. W tym celu należy postępować zgodnie z poniższą instrukcją:
- Zapisać aktualizacje oprogramowania w katalogu:
semiramis\refreshes\import
- Uruchomić serwer aplikacji za pomocą następującego wywołania:
semiramis -tool -upgradeMode -logfile:<ścieżka pliku dziennika>\<nazwa pliku dziennika> -tooluser:<nazwa> <nazwa serwera komunikatów>.
- Zaimportować aktualizacje oprogramowania sys:
imprfr -codeclass:sys -all -verbose
- Wykonać restart w przypadku gdy zaimportowane aktualizacje oprogramowania zawierają paczki plików, które wymagają ponownego uruchomienia serwera aplikacji:
restart
- Przygotować instalację aktualizacji oprogramowania sys:
upgaps -codeclass:sys -verbose -prepare
- Zakończyć przygotowanie aktualizacji oprogramowania sys:
upgaps -codeclass:sys -verbose -upgrade
- Zrestartować serwer aplikacji, jeśli to konieczne, narzędzie wyśle odpowiedni komunikat:
restart
- Aktywować instalację aktualizacji oprogramowania sys:
upgaps -codeclass:sys -verbose -activate
- Uruchomić ponownie serwer aplikacji, jeśli to konieczne, narzędzie wyświetli odpowiedni komunikat:
restart
- Zwolnić instalację aktualizacji oprogramowania sys:
upgaps -codeclass:sys -verbose -release
- Zaimportować aktualizacje oprogramowania aplikacji:
imprfr -codeclass:app -all -verbose
- Przygotować instalację aktualizacji oprogramowania aplikacji:
upgaps -codeclass:app -verbose -prepare
- Zakończyć przygotowanie aktualizacji oprogramowania aplikacji:
upgaps -codeclass:app -verbose -upgrade
- Zrestartować serwer aplikacji, jeśli to konieczne, narzędzie wyśle odpowiedni komunikat:
restart
- Aktywować instalację aktualizacji oprogramowania aplikacji:
upgaps -codeclass:app -verbose -activate
- Uruchomić ponownie serwer aplikacji, jeśli to konieczne, narzędzie wyświetli odpowiedni komunikat:
restart
- Uruchomić instalację aktualizacji oprogramowania aplikacji:
upgaps -codeclass:app -verbose -release
- Uruchomić ponownie serwer aplikacji:
restart
Instalacja automatyczna
Automatyczna instalacja aktualizacji oprogramowania
Aktualizacje oprogramowania mogą być instalowane automatycznie za pomocą narzędzia insrfr:
- Zapisać aktualizacje oprogramowania w katalogu:
semiramis\refreshes\import
- Rozpocząć instalację aktualizacji oprogramowania:
insrfr -codeClass:app -codeClass:sys
USER@SYSTEMNAME>Information: install system file deliveries
SYS: file delivery restart
Błąd: Nieprawidłowe zakończenie serwera aplikacji SERVERNAME
Instalację można kontynuować dopiero po wykonaniu wymaganych czynności z rozdziału: Ręczne kroki podczas instalowania skryptów startowych i/lub środowiskowych.
Zalecanym jest również zapoznanie się z rozdziałem: Zmniejszanie liczby zadań powodujących konflikty podczas instalacji.
Po ich wykonaniu instalacja jest przeprowadzana automatycznie. System może zostać ponownie uruchomiony podczas fazy aktywacji instalacji. Jednocześnie można zaplanować rozpoczęcie fazy aktywacji.
Kontynuacja instalacji automatycznej
Jeśli automatyczna instalacja zostanie anulowana z powodu błędu, można kontynuować/wznowić instalację w dowolnym momencie. Proces instalacji rozpoznaje, kiedy zostały wykonane ręczne kroki rozwiązywania problemów.
Instrukcja:
- Usunąć przyczynę błędu.
- Użyć polecenia upgaps -undo -codeClass:xxx, aby cofnąć instalację aktualizacji oprogramowania klasy kodu xxx.
- Po anulowaniu instalacji aktualizacji oprogramowania uruchomić ponownie instalację za pomocą polecenia insrfr -continue.
- Jeśli instalacja była już tak zaawansowana, że nie można już wykonać polecenia upgaps -undo, kontynuuj instalację ręcznie.
Instalowanie aktualizacji językowych
W systemie zawsze dostarczane są tłumaczenia w języku niemieckim, aby otrzymać dodatkowe paczki językowe np. PL, EN należy skontaktować się z Asystą Techniczną.
Aktualizacje językowe to dedykowane aktualizacje oprogramowania, które są:
- niezależne od statusu aktywnego kodu systemu
- udostępniane w dowolnym czasie
- udostępniane do dowolnego systemu, niezależnie od jego użycia
Aktualizacja języka nie prowadzi do żadnych konfliktów w systemach deweloperskich, ponieważ nie są instalowane żadne wersje odpowiednich obiektów tekstowych.
Aktualizacja językowa zawiera tłumaczenia dostępne w dniu wydania wersji. Po zainstalowaniu aktualizacji językowej obiekty tekstowe w danym języku są nadpisywane; teksty niestandardowe są zachowywane. Jeśli zainstalowany zostanie język, który wcześniej nie był dostępny w systemie, zostanie on automatycznie dodany do bazy danych repozytorium jako język dodatkowy. Zajmuje to również więcej miejsca w pamięci bazy danych repozytorium. Ponieważ systemy mogą zawierać różne języki w różnych stanach, zalecamy instalowanie tylko niezbędnych języków w celu zaoszczędzenia pamięci.
Paczka typu LNG zawsze zawiera aktualizację językową oraz teksty w danym języku. Możliwość ich instalacji jest uzależniona od aktywnej licencji systemu.
Jednoczesna instalacja kilku języków zajmuje znacznie mniej czasu niż instalacja sekwencyjna. Zalecanym jest aktualizowanie wszystkich języków wymaganych w systemie podczas aktualizacji języka.
Jeśli podczas instalacji aktualizacji języka brakuje tłumaczeń dla obiektów deweloperskich, brane są pod uwagę alternatywne języki wyświetlania ustawione w aplikacji Konfiguracja. Jeśli zostanie znalezione alternatywne tłumaczenie zostanie ono aktywowane. Jeśli alternatywne tłumaczenie nie jest dostępne, tekst jest aktywowany w języku, w którym obiekt programistyczny został pierwotnie utworzony.
Jeśli system został zawiera rozszerzenia/dodatki, dla których istnieją aktualizacje oprogramowania, które również zawierają nowe lub zmodyfikowane teksty. Sposób tłumaczenia tych tekstów, musi zostać uzgodniony indywidualnie z właścicielem dodatku, zazwyczaj są one dostarczane w ramach zwykłych aktualizacji oprogramowania.
Teksty mogą być również zmieniane, a tłumaczenia dostosowywane w systemach testowych i produkcyjnych. Oznacza to, że klienci mogą również dokonywać tych adaptacji samodzielnie. Jeśli wymagany język nie jest dostępny, może on zostać dodany przez klienta. Jeśli na przykład kilka aplikacji ma zostać przetłumaczonych dla danego oddziału, odpowiednie teksty można wyeksportować do tłumaczenia.
Możliwe jest tworzenie aplikacji dla dowolnego języka docelowego. Czasami brane są również pod uwagę języki niestandardowe, zwłaszcza w kontekście programowania niestandardowego. Języki niestandardowe to języki wyświetlania, które nie są oferowane przez Comarch.
Instrukcja:
Aktualizacja językowa dostarczona przez Comarch nie musi być najbardziej aktualna. Na przykład, nowa aktualizacja językowa może wynikać z systemu testowego partnera, który poprzedza system Klienta. Dlatego dla każdego języka należy użyć aktualizacji językowej, która została ostatnio utworzona do tego systemu.
- Umieścić dokładnie jedną aktualizację językową dla każdego aktualizowanego języka w następującym katalogu
<Comarch ERP Enterprise>/refreshes/import
- Wprowadzić następujące polecenie narzędziu Toolshell:
inslng -languages -importStart:<timeStamp>
Aktualizacje językowe są instalowane w tle w określonym czasie.
Aktualizacja systemów docelowych
Zautomatyzowaną instalację aktualizacji oprogramowania na systemach docelowych można przeprowadzić w aplikacji Panel Aktualizacja oprogramowania po wybraniu widoku Aktualizacja systemu docelowego.
Dostępne metody aktualizacji
- automatyczna
- ręczna
Obie metody wykorzystują informacje o stanie oprogramowania systemu docelowego w celu automatycznego określenia zakresu aktualizacji oprogramowania.
Tylko systemy docelowe, które są wprowadzone jako system docelowy aktualizacji oprogramowania w konfiguracji (w aplikacji Panel System) w systemie źródłowym, mogą być aktualizowane automatycznie.
Systemy docelowe, do których nie ma bezpośredniego dostępu, mogą być aktualizowane tylko ręcznie. W tym celu należy podać informacje o bieżącym stanie oprogramowania systemu docelowego. Można je znaleźć w pliku informacyjnym (*.rfr) w katalogu \semiramis\refreshes\import systemu docelowego.
Automatyczna aktualizacja systemów docelowych
Aby instalacja zakończyła się powodzeniem, warunkiem wstępnym jest, aby system źródłowy posiadał informacje o wszystkich systemach docelowych, które mają zostać zaktualizowane. Systemy źródłowe są rejestrowane w aplikacji Panel System.
Instrukcja:
- Otworzyć aplikację Panel Aktualizacja oprogramowania, widok Aktualizacja systemu docelowego
- W polu Metoda aktualizacji wskazać metodę Automatyczna (ustawienie domyślne)
- W polu System docelowy wskazać system docelowy, który ma zostać zaktualizowany. Pole Status autoimportu prezentuje informacje, czy system docelowy jest gotowy do aktualizacji (Gotowy do importu).
- Wybrać przycisk [Aktualizuj] na standardowym pasku narzędzi.
- System automatycznie określi wszystkie aktualizacje oprogramowania, które są dostępne w systemie źródłowym i nie zostały jeszcze zainstalowane w systemie docelowym. Aktualizacje oprogramowania, za pomocą których aktualizowany jest system docelowy, można wybrać z listy.
- Wykonać akcję [Ustal zależności] na standardowym pasku narzędzi.
Zależne aktualizacje oprogramowania są automatycznie uwzględniane (zaznaczony parametr z opcją wyboru).
- Wykonać akcję [Przekaż do systemu docelowego] na standardowym pasku narzędzi.
- W oknie dialogowym należy wskazać, czy eksportowane mają być źródła pomocy, czy źródła (Java). W zależności od przeznaczenia systemu, wybór jest wstępnie inicjowany.
- Wybierać przycisk [OK]. Aktualizacje oprogramowania zostaną skopiowane do katalogu importu systemu docelowego.
- Wykonać akcję [Aktualizacja systemu docelowego] na standardowym pasku narzędzi.
- W oknie dialogowym należy wybrać typ instalacji: Równoległa, aby zminimalizować czas instalacji lub Sekwencyjna, aby najpierw zainstalować aktualizacje oprogramowania SYS, a następnie aktualizacje oprogramowania APP. Wprowadzić datę rozpoczęcia instalacji i, jeśli to konieczne, początek aktywacji. Rozpoczęcie aktywacji można wprowadzić tylko wtedy, gdy konieczne jest ponowne uruchomienie systemu. Można pracować w systemie podczas fazy przygotowawczej, ale nie jest to możliwe podczas fazy aktywacji.
- Wybierać przycisk [OK].
Jeśli aktualizacje danych nie zostały jeszcze przeprowadzone w systemie docelowym, wyświetlone zostanie ostrzeżenie. Należy je przeprowadzić przed kontynuowaniem instalacji.
System instaluje aktualizacje oprogramowania w systemie docelowym i jeśli to konieczne, kilkakrotnie restartuje docelowy SAS podczas fazy aktywacji.
USER@SYSTEMNAME>Information: install system file deliveries
SYS: file delivery restart
Błąd: Abnormal end of application server SERVERNAME
Instalację można kontynuować dopiero po wykonaniu wymaganych czynności, opisanych w rozdziale. Ręczne kroki podczas instalowania skryptów startowych i/lub środowiskowych.
Zalecanym jest również zapoznanie się z rozdziałem: Zmniejszanie liczby zadań powodujących konflikty podczas instalacji.
Instalacja jest przeprowadzana automatycznie, a serwer aplikacji jest automatycznie uruchamiany ponownie po pomyślnej aktualizacji.
Ręczna aktualizacja systemów docelowych
Instrukcja:
- Zapisać plik informacyjny dla wersji oprogramowania systemu docelowego w katalogu Knowlegde Store systemu źródłowego.
- Otworzyć aplikację Panel Aktualizacja oprogramowania, widok Aktualizacja systemu docelowego.
- Wybrać metodę Ręczna w polu Metoda aktualizacji.
- Wybrać odpowiedni plik informacyjny w polu Informacja o instalacji.
- W polu Folder docelowy wybierz folder, w którym mają być przechowywane aktualizacje oprogramowania do zainstalowania.
- Wybrać zakładkę Aktualizacje oprogramowania.
- Wykonać akcję [Aktualizuj] na standardowym pasku narzędzi.
System automatycznie określi wszystkie aktualizacje oprogramowania, które są dostępne w systemie źródłowym i nie zostały jeszcze zainstalowane w systemie docelowym. Aktualizacje oprogramowania, którymi ma zostać zaktualizowany system docelowy, można wybrać z listy.
8. Wykonać akcję [Ustal zależności] na standardowym pasku narzędzi.
Zależne aktualizacje oprogramowania są automatycznie uwzględniane (zaznaczony parametr z opcją wyboru).
- Wykonać akcję [Przekaż do systemu docelowego] na standardowym pasku narzędzi.
Aktualizacje oprogramowania zostaną zapisane w określonym folderze docelowym.
Aktualizacje oprogramowania z folderu docelowego można skopiować do katalogu importu systemu docelowego. - Instalację można przeprowadzić w systemie docelowym.
Zmniejszanie liczby zadań powodujących konflikty podczas instalacji
Podczas automatycznej instalacji może wystąpić kilka zadań powodujących konflikty. Dzieje się tak zawsze, gdy aktualizacje oprogramowania klasy kodu Aplikacja nie są instalowane w jednym procesie. Jeśli pojawi się kilka zadań powodujących konflikt, może to potencjalnie prowadzić do problemów:
- aktualizacje oprogramowania, które mają zostać zainstalowane, zawierają kilka wersji obiektu programistycznego, który został zmodyfikowany. W takim przypadku instalacja nie może być kontynuowana, dopóki zadanie konfliktu nie zostanie przetworzone z pierwszą zaimportowaną wersją. Ponadto przetwarzanie konfliktu musi być wykonywane kilka razy dla jednego i tego samego obiektu deweloperskiego.
Aby zapewnić, że istnieje tylko jedno zadanie konfliktu, wszystkie aktualizacje oprogramowania do zainstalowania powinny być instalowane za jednym razem. Może to być jednak niemożliwe, ponieważ niektóre aktualizacje oprogramowania muszą być instalowane oddzielnie od innych aktualizacji. W takich przypadkach można zminimalizować liczbę zadań konfliktowych lub nawet poradzić sobie z jednym zadaniem konfliktowym, umiejętnie dystrybuując aktualizacje oprogramowania między instalacjami.
Aktualizacje oprogramowania dzielą się na dwie kategorie. Aktualizacje oprogramowania klasy kodu Aplikacja i aktualizacje oprogramowania klasy kodu System. Instalacja aktualizacji oprogramowania klasy kodu System nie może prowadzić do zadania konfliktu. Ponadto aktualizacje oprogramowania klasy kodu Aplikacja, które zawierają wydania dla księgowości, również nie generują żadnych konfliktów.
Jeśli określono, które aktualizacje oprogramowania mają zostać zainstalowane, a nie mogą zostać zaimportowane za jednym razem, podział powinien nastąpić w poniższy sposób:
- wszystkie aktualizacje oprogramowania o klasie kodu System („*-sys-*”)
- wszystkie aktualizacje oprogramowania klasy kodu Aplikacja („*-app-*”), które zawierają paczki księgowe.
- pozostałe aktualizacje oprogramowania klasy kodu Aplikacja.
Przykładowa instalacja może wyglądać jak niżej:
- zainstalować powiązane aktualizacje oprogramowania z punktu 1 i 2 równocześnie.
- powtórzyć proces z pozostałymi aktualizacjami oprogramowania z punktu 1. i 2.
- zainstalować aktualizacje oprogramowania z 3.
Powinno pojawić się jedno zadanie konfliktu.
- W pierwszym uruchomieniu zainstalować księgowość w wersji 2 i wszystkie aktualizacje oprogramowania systemowego, w tym poprawkę do księgowości w wersji 3.
- W drugim uruchomieniu zainstalować księgowość w wersji 3.
- W trzecim uruchomieniu zainstalować wszystkie aktualizacje oprogramowania aplikacji.
Dzięki tej procedurze zwrócone zostanie tylko jedno duże zadanie konfliktu, ale są trzy procesy instalacji, które musisz zainicjować jeden po drugim.
Ręczne kroki podczas instalowania skryptów startowych i/lub środowiskowych
Jeśli skrypty startowe lub środowiskowe są zawarte w paczce, nie można ich zainstalować (zastąpić) automatycznie w czasie wykonywania. Proces instalacji jest przerywany i może być kontynuowany dopiero po pomyślnym zakończeniu kroków ręcznych.
Podkatalog \upgrade-manual jest tworzony w katalogu importu \semiramis\refreshes\import. Zawartość katalogu musi zostać ręcznie przeniesiona do katalogu docelowego, a następnie katalog musi zostać usunięty. Niezbędne instrukcje są automatycznie określane i wyświetlane w narzędziu Toolshell.
Jeśli serwer aplikacji systemu ERP (SAS) zostanie uruchomiony w systemie Windows za pomocą pliku wsadowego, okno, w którym działał SAS, może zostać automatycznie zamknięte. W rezultacie wymagane informacje nie są wyświetlane. W takim przypadku partię startową należy uruchomić w następujący sposób:
- Uruchomić Wiersz polecenia (Start -> Uruchom -> cmd).
- Przejść do folderu, w którym zapisana jest partia startowa.
- Uruchomić partię startową w katalogu.
W systemie UNIX wykonaj następujące czynności:
- Uruchomić Shell.
- Przejść do katalogu, w którym znajdują się używane skrypty startowe.
- Uruchomić skrypt, który jest używany do wykonania SAS w trybie aktualizacji.
SAS sprawdza bieżący stan instalacji podczas uruchamiania, określa wymagane kroki ręczne i wyświetla polecenia do wykonania, jak przedstawiono w poniższym przykładzie.
Po skopiowaniu usunać katalog
R:\QAS\QAS400MS\semiramis\upgrade-manual jest wymagane.
Wykonać następujące polecenia:
xcopy R:\QAS\QAS400MS\semiramis\upgrade-manual R:\QAS\QAS400MS\semiramis\ /v/s/y/h/r/q
rmdir R:\QAS\QAS400MS\semiramis\upgrade-manual /S/Q
- Wykonać polecenie kopiowania (xcopy) na komputerze wymienionym w sekcji Wykonaj następujące polecenia.
- Sprawdzić, czy proces kopiowania został przeprowadzony prawidłowo
- Wykonać polecenie usunięcia (delete) katalogu (rmdir) na komputerze zgodnie z listą w sekcji Wykonaj następujące polecenia
- Sprawdzić, czy katalog został poprawnie usunięty.
- Uruchomić ponownie proces instalacji (zgodnie z wybraną metodą instalacji).
- Kontynuować przerwaną instalację
- Proces instalacji można kontynuować w jeden z poniższych sposobów:
- zwolnić proces instalacji w aplikacji Panel System systemu źródłowego.
- uruchomić ponownie serwer aplikacji używany do instalacji w trybie automatycznej aktualizacji. W tym celu należy dodać następujące parametry (które mogą być używane tylko podczas instalacji): – autoUpgrade (svm -autoUpgrade -remaining parameters…).
Monitorowanie procesu instalacji
Aplikacja Panel System
Proces instalacji w systemie docelowym można monitorować w aplikacji Panel System systemu źródłowego:
- Uruchomić aplikację Panel System
- W polu Typ wybrać opcje System
- W polu Nazwa wybrać system docelowy w polu
Na zakładce Operacje instalacji można śledzić bieżący proces instalacji lub sprawdzić poprzednie instalacje.
Jeśli proces instalacji został przerwany (np. z powodu ręcznych kroków instalacji), można go ponownie uruchomić, wybierając przycisk [Zwolnij proces instalacji] (obok pola Status instalacji) lub wybrać na klawiaturze kombinacje klawiszy: Ctrl+Shift+R.
Dzienniki instalacji
Dla każdej instalacji w katalogu (\semiramis\refreshes\import\AI-20030801155701) tworzony jest podkatalog (np. \semiramis\refreshes\import\AI-20030801155701), w którym zapisywane są dzienniki, w których rejestrowane są wszystkie kroki instalacji. Pliki dziennika można wyświetlić na zakładce Operacje instalacji.
Przetwarzanie końcowe instalacji
Sprawdzanie instalacji
- Uruchomić aplikację Panel Aktualizacja oprogramowania, widok Zaimportowane aktualizacje oprogramowania.
- Wybrać przycisk [Aktualizuj] na standardowym pasku narzędzi.
- Jeśli instalacja przebiegła pomyślnie, wszystkie aktualizacje oprogramowania muszą mieć status Zainstalowany.
Sprawdzanie paczki plików
Wymiana plików, które są dostarczane z paczką plików, odbywa się poza Comarch ERP Enterpise. Po ponownym uruchomieniu serwera aplikacji, który wykonał aktualizację, pliki są kopiowane do folderów docelowych. W przypadku braku możliwości wymiany plików wyświetlany jest komunikat o błędzie i proces kopiowania jest anulowany. W zależności od systemu operacyjnego możliwa jest wymiana plików, ale nie można poprawnie ustawić daty pliku. Daty pliku nie można ustawić, jeśli plik jest zablokowany przez inne programy, takie jak Eclipse. Jeśli nie można ustawić daty pliku, wyświetlane jest ostrzeżenie, ale proces kopiowania jest kontynuowany.
Jeśli kopiowanie nie mogło zostać pomyślnie wykonane (np. wymiana nie mogła nastąpić, ponieważ aplikacja nadal korzystała z pliku), można użyć narzędzia Toolshell, aby sprawdzić, czy instalacja wszystkich paczek plików została wykonana poprawnie:
- Uruchomić serwer aplikacji.
- Uruchomić sprawdzanie zainstalowanych paczek plików: chkfd -all
Informacje o paczkach plików są wyświetlane w konsoli, jak w poniższym przykładzie i rejestrowane w pliku dziennika:
Parsing xml file
Checking file delivery com.cisag.sys.delivery.SystemEngine
Checking file checksums
Parsing xml file
Checking file delivery com.cisag.sys.delivery.Library-vwe-accounting
Checking file checksums
Parsing xml file
Checking file delivery com.cisag.sys.delivery.Library-log4j-core
Checking file checksums
Parsing xml file
Checking file delivery com.cisag.sys.delivery.Library-US-export-policy
Checking file checksums
Parsing xml file
Checking file delivery com.cisag.sys.delivery.Library-jacorb-properties
Checking file checksums
……
File of active file deliveries are ok.
W powyższym przykładzie wszystkie zainstalowane paczki plików są poprawnie aktywowane. Jest to udokumentowane komunikatem File of active file deliveries are ok..
Parsing xml file Checking file delivery com.cisag.sys.delivery.Library-vwe-base Checking file checksums ERROR: size of file lib/vwe-base.jar doesn’t match. ERROR: file check for file delivery com.cisag.sys.delivery.Library-vwe-base failed. Errors occured ============== Error = size of file lib/vwe-base.jar doesn’t match. Action = active file deliveries check Subaction = file checksum check Error = file check for file delivery com.cisag.sys.delivery.Library-vwe-base failed. Action = active file deliveries check Subaction = Checking file delivery com.cisag.sys.delivery.Library-vwe-base Error = Files of active file deliveries are incorrect. Action = check of active file deliveries Subaction = parse xml file
W powyższym przykładzie plik vwe-base.jar w katalogu \semiramis\lib nie został zaktualizowany.
Różni się to od dostarczonego pliku, który znajduje się w katalogu
semiramis\file-deliveries\com\cisag\sys\delivery\Library-vwe-base_0X1 (gdzie _0X1 oznacza wersję 1 pliku) podczas procesu instalacji.
W takim przypadku proces kopiowania można przeprowadzić ponownie ręcznie:
- Skopiować plik vwe-base.jar z katalogu semiramis\file-deliveries\com\cisag\sys\delivery\Library-vwe-base_0X1 do katalogu \semiramis\lib.
- Sprawdzić ponownie paczki plików i upewnić się, że wszystkie zostały poprawnie zainstalowane: chkfd -all
Obsługa błędów
W tym rozdziale opisano błędy i ostrzeżenia, które mogą wystąpić podczas wywoływania narzędzi imprfr i upgaps. Oprócz wyjaśnienia przyczyny błędu opisano również możliwe sposoby jego usunięcia. Jeśli wystąpią błędy, które nie zostały wymienione w poniższych tabelach, należy skontaktować się z Asystą Techniczną.
Błędy i ostrzeżenia w narzędziu imprfr
Komunikaty o błędach
| Przyczyna | Rozwiązanie |
| code refresh cannot import into origin system | |
| Podejmowana jest próba zaimportowania aktualizacji oprogramowania do systemu, w którym została utworzona. | Import nie jest możliwy. |
| <nazwa aktualizacji oprogramowania> does not match import restrictions: | |
| Aktualizacja oprogramowania nie jest zgodna z ograniczeniami importu w aplikacji Panel System. | Należy sprawdzić ograniczenia importu w aplikacji Panel System. |
| code refresh <*.cr> can not be imported, a critical refresh is already imported. You must install (upgaps) or remove that refresh before | |
| Zaimportowano krytyczną aktualizację oprogramowania. Musi ona zostać zainstalowana indywidualnie. | Należy zainstalować krytyczną aktualizację oprogramowania lub ją usunać (imprfr -undo -file: …). |
| code refresh <*.cr/*sr> can not be imported, wrong code class | |
| Nazwa pliku aktualizacji oprogramowania nie zawiera określonej klasy kodu (-app, -sys). | Należy sprawdzić pliki aktualizacji oprogramowania, czy zawierają klasę kodu w nazwie pliku (-sys. -app). |
| could not read file deliveries | |
| Nie można odczytać paczki plików zawartego w aktualizacji oprogramowania. | Nie można odczytać paczki plików zawartego w aktualizacji oprogramowania. |
| deserialization error | |
| Błąd podczas deserializacji aktualizacji oprogramowania. | Błąd podczas deserializacji aktualizacji oprogramowania. |
| file not found | |
| Aktualizacja oprogramowania nie została znaleziona w systemie plików. | Aktualizacja oprogramowania nie została znaleziona w systemie plików. |
| import directory not exists | |
| Katalog importu nie istnieje. | Katalog importu nie istnieje. |
| import directory not exists or filename is invalid | |
| Katalog importu nie istnieje lub nazwy plików w katalogu importu są nieprawidłowe. | Katalog importu nie istnieje lub nazwy plików w katalogu importu są nieprawidłowe. |
| Invalid code class: <Codeklasse> | |
| Określono nieprawidłową klasę kodu. | Określono nieprawidłową klasę kodu. |
| invalid content version | |
| Nie można odczytać aktualizacji oprogramowania, ponieważ nie można odczytać wersji pliku za pomocą tego silnika systemu. | Nie można odczytać aktualizacji oprogramowania, ponieważ nie można odczytać wersji pliku za pomocą tego silnika systemu. |
| invalid data | |
| Dane aktualizacji oprogramowania są nieprawidłowe. | Dane aktualizacji oprogramowania są nieprawidłowe. |
| invalid header | |
| Nagłówek aktualizacji oprogramowania jest nieprawidłowy. | Nagłówek aktualizacji oprogramowania jest nieprawidłowy. |
| invalid file server directory – check configuration | |
| Nie określono katalogu serwera plików. | Nie określono katalogu serwera plików. |
| invalid release | |
| Wersja aktualizacji oprogramowania nie jest zgodna z wersją systemu docelowego. | Wersja aktualizacji oprogramowania nie jest zgodna z wersją systemu docelowego. |
| Import restriction is not defined | |
| Ograniczenie importu nie zostało zdefiniowane. | Ograniczenie importu nie zostało zdefiniowane. |
| import or upgrade is already in process | |
| Nie można przeprowadzić importu, ponieważ trwa już import lub instalacja. | Nie można przeprowadzić importu, ponieważ trwa już import lub instalacja. |
| IO error | |
| Błąd odczytu aktualizacji oprogramowania w systemie plików. | Błąd odczytu aktualizacji oprogramowania w systemie plików. |
| Object with different guid already exists: <nazwa obiektu deweloperskiego> | |
| Obiekt deweloperski już istnieje z innym identyfikatorem GUID jako kluczem. | Obiekt deweloperski już istnieje z innym identyfikatorem GUID jako kluczem. |
| Only one import restrictions must be defined | |
| Zdefiniowano więcej niż jedno ograniczenie importu. | Zdefiniowano więcej niż jedno ograniczenie importu. |
| write access denied to file server directory | |
| Brak dostępu do zapisu w katalogu serwera plików. | Brak dostępu do zapisu w katalogu serwera plików. |
Ostrzeżenia
| Przyczyna | Rozwiązanie |
| code refresh is already imported | |
| Aktualizacja oprogramowania została już zaimportowana. | – |
Błędy i ostrzeżenia w narzędziu upgaps
Komunikaty o błędach
| Przyczyna | Rozwiązanie |
| Any database is unconnected – check configuration | |
| Zarejestrowana baza danych nie jest połączona z serwerem aplikacji. Zmiany schematu nie są wykonywane w tej bazie danych. | Należy sprawdzić w aplikacji Panel System, która baza danych nie jest przypisana do serwera aplikacji. |
| Cannot delete file | |
| Błąd usuwania plików obiektów z katalogu semiramis. | Należy sprawdzić uprawnienia do zapisu serwera aplikacji w katalogu semiramis. |
| Cannot delete file(s) | |
| Błąd usuwania klas Java z katalogu semiramis. | Należy sprawdzić uprawnienia zapisu serwera aplikacji w katalogu semiramis. |
| Cannot delete online help file | |
| Błąd usuwania plików ikon z katalogu semiramis. | Należy sprawdzić uprawnienia zapisu serwera aplikacji w katalogu semiramis. |
| Cannot prepare: undo required for this operation | |
| Opcja -prepare nie może zostać wykonana. | Instalacja nie została jeszcze zakończona. Należy wykonać upgaps -undo …. . Jeśli funkcja undo nie może być już wywołana, należy wywołać upgaps -upgrade … . aby zakończyć instalację. |
| Cannot replace file | |
| Błąd kopiowania plików obiektów do katalogu semiramis. | Należy sprawdzić uprawnienia do zapisu serwera aplikacji w katalogu semiramis. |
| Cannot replace file(s) | |
| Błąd kopiowania klas Java do katalogu semiramis. | Należy sprawdzić uprawnienia zapisu serwera aplikacji w katalogu semiramis. |
| Cannot replace icon file | |
| Błąd kopiowania plików ikon do katalogu semiramis. | Należy sprawdzić uprawnienia zapisu serwera aplikacji w katalogu semiramis. |
| Cannot replace online help file | |
| Błąd kopiowania plików obiektów pomocy do katalogu semiramis. | Należy sprawdzić uprawnienia zapisu serwera aplikacji w katalogu semiramis. |
| Cannot undo: activate failed | |
| Nie można wywołać opcji -undo. | Proces aktywacji nie powiódł się podczas instalacji. Opcja -undo nie jest już możliwa do wywołania. W tym przypadku ponownie należy wykonać opcję imprfr -upgrade …., aby zakończyć instalację. Jeśli błąd wystąpi ponownie, skontaktuj się z centrum pomocy technicznej. |
| Cannot undo: database content already modified! | |
| Nie można wywołać opcji -undo. | Schematy bazy danych zostały zaktualizowane. Nie można już wywołać opcji -undo. Rozpoczęta instalacja musi zostać zakończona. Należy ponownie wywołać opcję imprfr -upgrade …, aby zakończyć instalację. |
| Cannot undo: database schema already modified! | |
| Nie można wywołać opcji -undo. | Schematy bazy danych zostały zaktualizowane. Nie można wywołać opcji -undo. Rozpoczęta instalacja musi zostać zakończona w każdym przypadku. Należy ponownie wywołać opcję imprfr -upgrade …, aby zakończyć instalację. |
| Cannot upgrade: prepare failed | |
| Nie można wywołać opcji -upgrade. | Należy wywołać upgaps -prepare …. |
| Cannot upgrade: undo failed | |
| Nie można wywołać opcji -upgrade. | Nie można poprawnie wykonać opcji -undo. należy skontaktować się z Asystą Techniczną. |
| Coderefresh: <nazwa aktualizacji oprogramowania> is not installed completely, please install coderefresh again. | |
| Aktualizacja oprogramowania została zaimportowana niekompletnie lub proces importowania został anulowany. | Należy zaimportować ponownie aktualizację oprogramowania (imprfr …). |
| Conflict in level 7 system: <Obiekt deweloperski> | |
| Wystąpił konflikt w systemie testowym lub produkcyjnym. | Należy skontaktować się z centrum pomocy technicznej. |
| Export code refreshes could not be created | |
| Eksport aktualizacji oprogramowania nie powiódł się. | Należy pownie wykonać instalację (upgaps -upgrade …). Jeśli błąd wystąpi ponownie, należy skontaktować się z centrum pomocy technicznej. |
| Identity list contains inconsistent data | |
| Podczas sprawdzania listy identyfikacji wystąpiły błędy. | Skontaktuj się z centrum pomocy technicznej. |
| Import or upgrade is already in process | |
| Obecnie trwa instalacja lub import. | Instalację należy przeprowadzić w późniejszym czasie. |
| Invalid code class: <Code-Klasse> | |
| Określono nieprawidłową klasę kodu. | Jako klasę kodu można określić tylko -APP lub -SYS. |
| Invalid file server directory – check configuration | |
| Nie określono katalogu serwera plików. | W aplikacji Panel System należy, czy określono katalog serwera plików serwera aplikacji. |
| Object is locked: <nazwa obiektu deweloperskiego> | |
| Obiekt deweloperski jest zablokowany w zadaniu deweloperskim. | Usuń dany obiekt deweloperski z zadania deweloperskiego lub aktywuj go. |
| Referenced object not exists, <nazwa obiektu deweloperskiego> | |
| Obiekt deweloperski nie istnieje jeszcze w tym systemie. | Należy odszukać aktualizację oprogramowania, w której znajduje się obiekt deweloperski i gp zaimportować (import). |
| Refresh <nazwa aktualizacji oprogramowania> depends on unavailable refresh <nazwa aktualizacji oprogramowania> | |
| Wymagana jest zależna aktualizacja oprogramowania (zależność zdefiniowana przez użytkownika). | Należy zaimportować wymaganą aktualizację oprogramowania (imprfr). |
| Restore database schema failed | |
| Wystąpił błąd podczas generowania tabel bazy danych. | Należy skontaktować się z centrum pomocy technicznej. |
| The versioning level of source systems are different | |
| Wszystkie aktualizacje oprogramowania muszą pochodzić z tego samego systemu. | Należy sprawdzić zaimportowane aktualizacje oprogramowania i usunać je (imprfr -undo …). |
| Upgrade info already exists | |
| Informacje w stanie Zapisane podczas instalacji nadal istnieją. Oznacza to, że proces instalacji nie został jeszcze zakończony lub informacje o stanie nie zostały usunięte za pomocą opcji -undo. | Należy kontynuować proces instalacji (upgaps -upgrade …) lub zresetować instalację (up-gaps -undo ...). |
| Write access denied to file server directory | |
| Brak uprawnień do zapisu w katalogu serwera plików. | Należy sprawdzić, czy serwer aplikacji ma dostęp do zapisu w katalogu serwera plików. |
Ostrzeżenia
| Przyczyna | Rozwiązanie |
| conflict:<nazwa obiektu deweloperskiego> | |
| Zaimportowana wersja obiektu deweloperskiego wywołuje konflikt. | Obiekt deweloperski jest przypisany do zadania konfliktu, w którym może być edytowany. |
| perform oql-statement failed | |
| Nie można było wykonać instrukcji OQL aktualizacji oprogramowania. | Przyczyny:
|
| Refresh <nazwa aktualizacji oprogramowania> depends on unavailable refresh <nazwa aktualizacji oprogramowania> | |
| Wymagana jest zależna aktualizacja oprogramowania (zależność określona przez system). | Należy zaimportować wymaganą aktualizację oprogramowania (imprfr). |
| skip:<nazwa obiektu deweloperskiego>, active version is newer as the imported version | |
| Zaimportowana wersja obiektu nazwa obiektu deweloperskiego jest niższa niż wersja aktywna. | Ta wersja obiektu deweloperskiego nie jest brana pod uwagę podczas instalacji. |
| skip:<nazwa obiektu deweloperskiego>, imported version is already activated | |
| Wersja obiektu deweloperskiego została już aktywowana w systemie. | Ten obiekt deweloperski nie jest brany pod uwagę podczas instalacji. |
| skip:<nazwa obiektu deweloperskiego>, object is deleted | |
| Obiekt deweloperski został już usunięty. | Ten obiekt deweloperski nie jest brany pod uwagę podczas instalacji. |
| the versioning level of source system is lower or equals as the level of this system (level: <poziom wersjonowania systemu źródłowego>) | |
| Przeniesienie z niższej wersji systemu lub systemu korekty na system o tym samym poziomie | – |
