Konfiguracja pliku XML instalatora

Konfiguracja pliku XML instalatora to przygotowanie zestawu ustawień automatyzujących wdrożenie pakietu biurowego.

Rola pliku XML w instalacji pakietu biurowego

Konfiguracja pliku XML instalatora polega na zapisaniu w jednym dokumencie ustawień, według których narzędzie wdrożeniowe pobiera, instaluje albo aktualizuje pakiet biurowy. W przypadku pakietu Microsoft 365 Apps oraz pakietów instalowanych za pomocą Office Deployment Tool plik XML określa między innymi używany kanał aktualizacji, architekturę aplikacji, języki oraz zakres instalowanych programów. Dzięki temu przebieg instalacji nie zależy wyłącznie od ręcznego wyboru opcji w kreatorze.

Plik XML jest dokumentem tekstowym, dlatego może zostać przygotowany w zwykłym edytorze, ale jego składnia musi odpowiadać schematowi obsługiwanemu przez konkretne narzędzie instalacyjne. Znaczenie mają nazwy elementów, atrybutów, wielkość liter oraz wzajemne położenie znaczników. Błąd składni może zatrzymać instalację jeszcze przed pobraniem plików, natomiast niepoprawna wartość ustawienia może spowodować instalację innej architektury, języka lub zestawu aplikacji niż planowano.

Elementy sterujące pobieraniem i instalowaniem

W konfiguracji Office Deployment Tool centralną rolę pełni element Configuration. Wewnątrz niego umieszcza się element Add, który wskazuje produkt przeznaczony do dodania. Atrybut OfficeClientEdition przyjmuje wartość 32 albo 64 i określa architekturę instalowanego pakietu. W elemencie Product podaje się identyfikator produktu, a element Language definiuje język instalacji, na przykład pl-pl. Identyfikator produktu i dostępne języki muszą odpowiadać wydaniu, licencji oraz mechanizmowi wdrożenia.

Konfiguracja może obejmować także element Updates, który steruje aktualizacjami pakietu, oraz element Display, używany do ustawienia sposobu prezentowania instalatora. Przy wdrożeniu bezobsługowym często wyłącza się interfejs użytkownika atrybutem Level="None" i kontrolę anulowania przez AcceptEULA lub inne ustawienia wspierane przez daną wersję narzędzia. Nie należy jednak kopiować przypadkowych przykładów z innego wydania Office Deployment Tool, ponieważ obsługiwane identyfikatory produktów i opcje mogą zależeć od rodzaju instalacji.

Element RemoveMSI może służyć do usunięcia wcześniejszych instalacji opartych na technologii Windows Installer, zanim zostanie wdrożona wersja Click-to-Run. To ustawienie wymaga sprawdzenia zgodności z istniejącym środowiskiem, ponieważ usunięcie starszego pakietu wpływa na dostępność programów, skojarzenia plików i dodatki. Sam plik XML nie zawiera zwykle całego instalatora; przekazuje instrukcje narzędziu, które pobiera właściwe składniki z określonego źródła.

Walidacja zgodności przed uruchomieniem instalatora

Przed zastosowaniem konfiguracji trzeba sprawdzić, czy dokument jest poprawnym XML-em oraz czy zawiera wszystkie wymagane elementy. Każdy znacznik otwierający musi mieć odpowiadający mu znacznik zamykający, wartości atrybutów powinny być ujęte w cudzysłowy, a dokument nie może zawierać przypadkowych znaków spoza deklarowanego kodowania. Poprawność formalna nie gwarantuje jednak poprawności wdrożenia. Narzędzie może zaakceptować dokument, ale odrzucić nieistniejący identyfikator produktu, kanał aktualizacji lub kombinację języków.

Istotne jest również rozróżnienie operacji pobierania i instalowania. Office Deployment Tool używa pliku XML zarówno do pobrania plików instalacyjnych, jak i do przeprowadzenia instalacji, lecz te działania są uruchamiane odrębnymi poleceniami programu. Przykładowo polecenie z parametrem /download pobiera składniki wskazane w konfiguracji, a polecenie z parametrem /configure wykorzystuje dokument do instalacji lub modyfikacji pakietu. Polecenie należy uruchamiać z katalogu zawierającego narzędzie albo podać prawidłową ścieżkę do pliku XML.

Przy diagnozowaniu problemu warto zapisać dokładny komunikat instalatora, użyty plik XML, wersję narzędzia oraz architekturę systemu. Należy też sprawdzić dostępność miejsca na dysku, uprawnienia do katalogu źródłowego i możliwość pobrania plików przez system. Jeżeli instalacja zatrzymuje się po zmianie konfiguracji, pomocne jest porównanie działającego i zmodyfikowanego dokumentu element po elemencie. Szczególną uwagę trzeba zwrócić na literówki w identyfikatorach, nieprawidłowe kody językowe oraz jednoczesne wskazanie niezgodnych sposobów instalacji.

Konfiguracja XML w praktyce serwisowej

Nieprawidłowy plik XML może powodować pozornie różne objawy: brak instalacji, częściowe pobranie pakietu, uruchamianie niewłaściwego języka, instalację aplikacji, które miały zostać pominięte, albo powracające komunikaty o konieczności naprawy pakietu. Ocena problemu wymaga wtedy rozdzielenia błędu konfiguracji od problemu systemowego. Sama zmiana pliku bez sprawdzenia logów, ścieżek i wcześniejszej instalacji może utrudnić ustalenie przyczyny.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów i komputerów PC, w tym problemami z instalacją oraz konfiguracją popularnego oprogramowania biurowego. W praktyce można sprawdzić strukturę pliku XML, zgodność ustawień z wybranym pakietem, pozostałości wcześniejszej instalacji i komunikaty systemowe, a następnie uporządkować konfigurację bez dopisywania ustawień, których dane wydanie instalatora nie obsługuje.

Przed rozpoczęciem zmian warto zachować kopię używanego pliku XML i zanotować aktualny stan aplikacji. Ma to znaczenie zwłaszcza wtedy, gdy na komputerze znajdują się dodatki, kilka języków albo wcześniejsza wersja pakietu. Prawidłowo przygotowana konfiguracja powinna jednoznacznie wskazywać oczekiwany produkt, architekturę, język i sposób działania instalatora. Im mniej niepotrzebnych opcji znajduje się w dokumencie, tym łatwiej zweryfikować jego działanie oraz odtworzyć instalację po awarii systemu.