> For the complete documentation index, see [llms.txt](https://helpcenter.xopero.com/xopero-one-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.xopero.com/xopero-one-en/pl/historia-zmian/2026/xopero-one-2.5.0.md).
# Xopero ONE 2.5.0
Wydanie 2.5.0, wprowadzające obsługę szyfrowania w narzędziu XSRD Standalone Agent, ulepszony proces przywracania repozytoriów oraz zaktualizowany silnik backupu Microsoft 365.
POPRZEDNIE WYDANIA
### 🆕 NOWE FUNKCJE
#### Przywracanie maszyn wirtualnych VMware z zachowaniem oryginalnego ID
Wprowadzono możliwość zachowania oryginalnych identyfikatorów **VMware** (`InstanceUUID`) podczas procedury przywracania. Przy pełnym odzyskiwaniu maszyny wirtualnej lub w trybie instant restore użytkownik może zdecydować o zachowaniu jej dotychczasowego identyfikatora. Domyślnie przywracane maszyny otrzymują nowe ID, jednak włączenie odpowiedniego przełącznika w ustawieniach przywracania pozwala zachować identyfikator pierwotny.
#### Obsługa szyfrowania dla Xopero Sphere Recovery Drive
Dodano obsługę szyfrowania nośnika odzyskiwania w narzędziu **XSRD Standalone Agent**. Użytkownicy mogą teraz zabezpieczać dane zapisywane na dysku odzyskiwania przy użyciu zdefiniowanej przez siebie frazy szyfrującej i wybranej długości klucza. To rozwiązanie chroni dane backupu przed nieautoryzowanym dostępem w razie utraty fizycznego nośnika, bez wpływu na ciągłość kopii przyrostowych i wydajność deduplikacji.
***
### 🔨 ULEPSZENIA
#### Optymalizacja inicjalizacji zadań replikacji oraz zużycia pamięci
Zwiększono wydajność inicjalizacji zadań replikacji oraz efektywność wykorzystania zasobów. Inicjalizacja zadań przebiega znacznie szybciej w sytuacjach, gdy magazyn docelowy posiada już istniejące dane, redukując szczytowe obciążenie CPU i RAM. W przypadku scenariuszy replikacji cyklicznej optymalizacja ta przyspiesza wykonywanie zadań nawet 66-krotnie (np. skracając czas inicjalizacji z 12 godzin do 11 minut), utrzymując stabilne obciążenie infrastruktury bez wpływu na możliwości odzyskiwania danych ze zreplikowanego magazynu.
#### Migracja silnika backupu Microsoft 365 na API Microsoft Graph
Przeniesiono silnik kopii zapasowych i przywracania **Microsoft 365** na interfejs API **Microsoft Graph**. **Xopero ONE** wykorzystuje teraz interfejs **Graph** API zamiast dotychczasowej usługi **Exchange Web Services** (**EWS**) do przetwarzania wiadomości e-mail, kontaktów i kalendarzy **Microsoft 365**. Zmiana ta gwarantuje stabilność i zgodność technologiczną przed planowanym wycofaniem **EWS** przez **Microsoft** w październiku 2026 r., zapewniając wyższą wydajność tworzenia i przywracania kopii zapasowych. Aktualizacja zachowuje pełną kompatybilność wsteczną z istniejącymi backupami **EWS** oraz podnosi dokładność odzyskiwania na poziomie elementów (zachowując właściwości wiadomości, kategorie i integralność załączników). Zoptymalizowana paginacja i wykrywanie duplikatów dodatkowo eliminują problemy ze stabilnością odzyskiwania dla wszystkich typów backupu.
#### Egzekwowanie limitów równoległych zadań backupu
Zaktualizowano logikę panelu zarządzania pod kątem spójnego przestrzegania limitów współbieżności w usłudze **Xopero ONE Management Service** (**XMS**). Konsola ściśle respektuje teraz maksymalną liczbę równoległych zadań backupu niezależnie od typu planu. Zmiana ta usuwa dawne, sztywne ograniczenia kodowe oraz parametry środowiskowe, gwarantując właściwe stosowanie domyślnych limitów (5 zadań dla środowisk chmurowych, 20 dla lokalnych) oraz pełne uwzględnienie wartości zdefiniowanych w zmiennej `XOPERO_MAX_CONCURRENT_BACKUP_TASKS`.
#### Kontekstowe ostrzeżenie o szyfrowaniu AES-256 w ustawieniach planu backupu
Zaktualizowano sposób wyświetlania ostrzeżenia dotyczącego szyfrowania AES-256 w konfiguracji planów kopii zapasowych. System **Xopero ONE** wyświetla teraz ostrzeżenie o szyfrowaniu AES-256 warunkowo — wyłącznie dla planów backupu obrazu dysku oraz maszyn wirtualnych **VMware**, w przypadku których mają zastosowanie ograniczenia funkcjonalne związane z obsługą iSCSI i instant restore. Dla pozostałych typów zasobów (takich jak pliki, **Microsoft 365** czy bazy danych) ostrzeżenie jest ukryte, aby wyeliminować niepotrzebne wprowadzanie użytkowników w błąd, w odniesieniu do opcji niedostępnych dla danego typu zasobów.
#### Rozszerzone logowanie skryptów akcji użytkownika
Ulepszono rejestrowanie zdarzeń z wykonywania niestandardowych skryptów akcji w zadaniach backupu i replikacji. System **Xopero ONE** rejestruje teraz przebieg oraz dane wyjściowe skryptów uruchamianych przez agenty (workery) na platformach **Windows** oraz **Linux**. Logi wykonywania zawierają informacje o uruchomieniu, statusie końcowym i komunikatach konsoli, gwarantując pełną przejrzystość działań typu pre- i post-task, przy automatycznym maskowaniu haseł i innych danych wrażliwych.
#### Optymalizacja wydajności i niezawodności odzyskiwania danych Jira oraz Confluence
Ulepszono proces przeglądania kopii zapasowych środowisk **Jira** i **Confluence**. **Xopero ONE** wykorzystuje teraz buforowanie metadanych (metadata caching mechanism) w celu przyspieszenia przeglądania i podniesienia stabilności podczas przygotowywania backupu do przywrócenia. Zmiana eliminuje błędy przekroczenia limitu czasu (timeout) w dużych strukturach organizacyjnych, wprowadza bieżący podgląd postępu ładowania danych i zapewnia dokładne raportowanie stanu synchronizacji bez względu na czas przechowywania kopii.
#### Mapowanie organizacji i weryfikacja przywracania repozytoriów
Zoptymalizowano proces przywracania repozytoriów dzięki rozbudowanym opcjom wyboru miejsca docelowego i walidacji w ustawieniach przywracania w usłudze zarządzania **Xopero ONE**. Aktualizacja oddziela zmianę nazwy repozytorium od wyboru ścieżki docelowej, wymusza ścisłe zasady nazewnictwa organizacji i repozytoriów oraz dodaje jasne komunikaty w aplikacji opisujące procedury zastępcze (fallback) dla platform **GitHub**, **GitLab** i **Azure DevOps**.
***
### 🐛 POPRAWKI BŁĘDÓW
#### Błąd uruchamiania agenta backupu dla systemu macOS z procesorem Intel
Rozwiązano problem powodujący, że agent backupu dla systemu **macOS** na architekturze **Intel** nie uruchamiał się ani nie rejestrował po zainstalowaniu. Obecnie po zakończeniu instalacji agent uruchamia się poprawnie i pomyślnie łączy z usługą **Xopero ONE Management Service** (**XMS**). Wcześniej proces inicjalizacji na komputerach **macOS** z procesorami **Intel** wywoływał błąd bez rejestrowania dzienników diagnostycznych.
#### Błąd zdalnej aktualizacji agenta backupu w systemie Linux
Rozwiązano problem powodujący błędy zdalnej aktualizacji agentów backupu **Xopero ONE** dla systemu **Linux** wynikające z braku obsługi zależności bibliotek. Obecnie agent kończy proces aktualizacji pomyślnie, utrzymując status online na każdym jego etapie. Wcześniej ponowne uruchomienie usługi agenta po aktualizacji mogło wywołać błąd zależności bibliotek i skutkować przejściem hosta w tryb offline. Zoptymalizowana obsługa zależności podczas restartu usługi gwarantuje stabilną ścieżkę aktualizacji dla środowisk **Linux**.
#### Problem z backupem SharePoint wywołany limitami widoku listy
Naprawiono błąd powodujący niepowodzenie zadań backupu **SharePoint** w przypadku osiągnięcia limitu progowego widoku listy. Moduł backupu **SharePoint** w bezpieczny sposób reaguje teraz na przekroczenie limitów widoku podczas realizacji zadania. Zamiast kończyć całe zadanie nieobsłużonym wyjątkiem, silnik rejestruje kod błędu `DV0395` z podaniem konkretnej witryny i listy, umożliwiając nieprzerwany backup pozostałych zasobów.
#### Filtrowanie wpisów sub-logów na liście zdarzeń
Widok listy zdarzeń dokładnie wyświetla teraz wpisy dziennika dla zadań odzyskiwania i pozostałych sub-logów. W przypadku, gdy skonfigurowany filtr wskazuje wyłącznie sub-logi, system automatycznie uruchamia dedykowany tryb zapytań pobierający dane niezależnie od głównych logów pakietów zadań. Zapewnia to dokładne wyniki wyszukiwania przy zachowaniu optymalnej wydajności bazy danych podczas generowania standardowych zdarzeń.
#### Błąd czyszczenia magazynu deduplikacji
Naprawiono problem, w wyniku którego czyszczenie magazynu kończyło się niepowodzeniem podczas próby usunięcia plików deduplikacji zablokowanych przez pamięć podręczną systemu. Zadanie usuwania zablokowanych wcześniej plików przebiega teraz bez zakłóceń. Poprawka eliminuje błąd wejścia/wyjścia (I/O) pozostawiający osierocone pliki .tr4 w magazynie docelowym, co gwarantuje pełne czyszczenie niepotrzebnych danych backupu i precyzyjne zwolnienie przestrzeni dyskowej.
#### Problem z backupem elementów SharePoint z pustym polem Author
Naprawiono błąd powodujący niepowodzenie kopii zapasowych **SharePoint** przy napotkaniu wartości null w polu **Author**. Moduł backupu w sposób kontrolowany przetwarza teraz witryny i elementy pozbawione przypisanego autora. Wcześniej brak wartości w tym polu wywoływał błąd `NullReferenceException` i przerywał realizację planu. Zoptymalizowany silnik zachowuje wartości null bez wywoływania wyjątku, co gwarantuje stabilną ochronę wszystkich zasobów **SharePoint**.
#### Nieprawidłowe wartości wskaźników SLA ochrony danych w panelu zarządzania
Rozwiązano problem powodujący błędne wyświetlanie wskaźników procentowych SLA po zmianie typu backupu **Jiry**. Podsumowanie SLA w panelu zarządzania wyświetla teraz dokładne metryki ochrony danych, gwarantując administratorom rzetelny wgląd w ogólny poziom pokrycia ochroną. Wcześniej zmiana konfiguracji planu backupu **Jira** na tryb granularny wywoływała renderowanie niepoprawnych wartości zgodności z SLA w widoku podsumowania.
#### Czyszczenie tymczasowych plików bazy danych podczas przywracania wiadomości e-mail z kopii zapasowej Microsoft 365
Tymczasowe pliki bazy danych są teraz automatycznie usuwane z katalogu docelowego podczas operacji przywracania wiadomości e-mail z kopii zapasowej **Microsoft 365** do środowisk lokalnych (on-premises). Zmiana ta eliminuje zbędne kontenery konwersyjne wywołujące dotąd blokady dostępu do plików oraz zapobiega pozostawianiu niepotrzebnych struktur w ścieżce docelowej.
#### Problem z odświeżaniem danych z powodu niedostępności magazynu S3
Naprawiono problem, w wyniku którego zadania odświeżania informacji o magazynie kończyły się niepowodzeniem, gdy docelowy magazyn S3 znajdował się w trybie offline. Obecnie system automatycznie pomija odświeżanie, jeśli po zakończeniu replikacji magazyn kompatybilny z S3 jest niedostępny. W przypadku celowego wyłączania magazynu (np. skryptami zarządzania energią `iDRACPowerDown`) zmiana ta zapobiega generowaniu fałszywych alarmów o niepowodzeniu przy zachowaniu dokładnych raportów z realizacji zadań.
#### Stabilność wykonywania skryptów pre- i post-backup w systemie Linux
Naprawiono błąd powodujący niepowodzenie skryptów pre- i post-backup na agentach **Linux** w wyniku konfliktów z bibliotekami systemowymi. Skrypty uruchamiane przez agenta backupu wykonują się teraz bezzakłóceniowo przy wywoływaniu zewnętrznych aplikacji korzystających z bibliotek systemowych. Wcześniej dziedziczenie zmiennych środowiskowych agenta zakłócało działanie zewnętrznych procesów, prowadząc do nieoczekiwanych awarii skryptów użytkownika.
#### Czytelne komunikaty błędów dla planów backupu SharePoint
W panelu zarządzania wprowadzono opisowe komunikaty błędów zastępujące nieprzetworzone kody w przypadkach, gdy plan ochrony **SharePoint** nie może zostać zastosowany przez brak wystarczających uprawnień lub przypisania witryn. Zmiana ta pozwala administratorom na błyskawiczne diagnozowanie i usuwanie problemów konfiguracyjnych wewnątrz konsoli, bez konieczności sięgania do zewnętrznej dokumentacji diagnostycznej.
#### Odporność procesów przywracania na przejściowe błędy protokołu SMB
Rozwiązano problem powodujący przerywanie zadań backupu i przywracania w przypadku wystąpienia przejściowych błędów SMB. Operacje realizowane na magazynach SMB reagują teraz na błąd `STATUS_INVALID_SMB` poprzez automatyczne ponawianie próby połączenia. Zmiana ta zapobiega natychmiastowym błędom zadań przy krótkotrwałych zakłóceniach sieci lub chwilowej niedostępności serwera, gwarantując ciągłość ochrony danych i stabilność procesów odzyskiwania.
#### Stabilność backupu załączników Jira dla dużych organizacji
Naprawiono problem powodujący błąd `OutOfMemoryException` podczas tworzenia kopii zapasowych załączników **Jira** w dużych środowiskach. Zadania backupu w dużych organizacjach (o rozmiarze danych powyżej 500 GB) wykonują się teraz stabilnie i nie prowadzą do wyczerpania pamięci. Zoptymalizowany przydział pamięci podczas przetwarzania załączników zapewnia kompletny i niezawodny backup wszystkich zasobów przestrzeni **Jira**.
#### Obsługa błędów synchronizacji niestandardowych właściwości GitHub
Naprawiono błąd powodujący przerywanie synchronizacji niestandardowych właściwości **GitHub** dla wszystkich organizacji z powodu przejściowych błędów w pojedynczej organizacji. Niepowodzenie pobierania schematu dla danej organizacji (np. błąd HTTP 404) nie blokuje już przetwarzania pozostałych podmiotów — system zachowuje dotychczasowy schemat dla zmienionej organizacji i kontynuuje aktualizację reszty środowiska. W przypadku trwałego błędu autoryzacji (HTTP 401) lub zawieszenia konta proces jest bezpiecznie przerywany, a organizacja oznaczana jako wymagająca naprawy.
#### Backup zarchiwizowanych przestrzeni Confluence
Rozwiązano problem, w wyniku którego tworzenie kopii zapasowych zarchiwizowanych przestrzeni **Confluence** wywoływało błędy podczas przetwarzania schematów (blueprints) i szablonów. Proces backupu poprawnie uwzględnia teraz szablony oraz schematy przestrzeni w zadaniach pełnych i przyrostowych kopii zapasowych. Zmiana ta gwarantuje kompletną i automatyczną ochronę zarchiwizowanych danych w środowisku **Confluence**, eliminując potrzebę ręcznych obejść (np. tymczasowej aktywacji przestrzeni).