Aktualizowanie działającego centrum informacyjnego przy użyciu wiersza komend

Oprócz komend start i shutdown obsługiwanych przez centrum informacyjne oraz opisanych w sekcji Instalowanie systemu pomocy jako centrum informacyjnego, centrum informacyjne obsługuje zestaw komend służących do wywoływania operacji menedżera aktualizacji w ramach działającej platformy Eclipse. Możliwe jest instalowanie, aktualizowanie, włączanie i wyłączanie składników, wyświetlanie listy zainstalowanych składników lub składników dostępnych na serwerze aktualizacji, a także dodawanie serwisu rozszerzenia do działającego centrum informacyjnego. W praktyce oznacza to możliwość modyfikowania zestawu działających modułów dodatkowych dokumentacji bez potrzeby zatrzymywania lub restartowania centrum informacyjnego.

Należy uruchomić centrum informacyjne w sposób opisany w sekcji Instalowanie systemu pomocy jako centrum informacyjnego. Jeśli jest używany minimalny zestaw modułów dodatkowych, przed uruchomieniem centrum informacyjnego (przy użyciu komendy start) należy dodać moduł org.eclipse.update.core do listy modułów dodatkowych.
Następnie należy użyć poniższych komend aktualizacji centrum informacyjnego. Nawiasy kwadratowe [ ] oznaczają argumenty opcjonalne, a argumenty wyróżnione kursywą musi podać użytkownik.
Po przeprowadzeniu aktualizacji można zastosować zmiany, używając komendy apply w ostatnim kroku procedury. Jej działanie polega na uwzględnieniu zmian w ramach bieżącej sesji. Jeśli nie użyto komendy apply, zmiany zostaną zastosowane dopiero po następnym uruchomieniu centrum informacyjnego.

Instalowanie składnika z serwisu zdalnego:
java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter
    -command install
    -featureId identyfikator_składnika
    -version wersja
    -from adres_URL_serwisu_zdalnego
    [-to katalog_serwisu_docelowego]

Przykład: java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter -command install -from http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/optionalSite/ -featureId com.example.root -version 1.0.0


Aktualizowanie istniejącego składnika lub wszystkich składników:
java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter
    -command update
    [-featureId identyfikator_składnika]
    [-version wersja]

Włączanie (konfigurowanie) określonego składnika:
java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter
    -command enable
    -featureId identyfikator_składnika
    -version wersja
    [-to katalog_serwisu_docelowego]

Wyłączanie (dekonfigurowanie) określonego składnika:
java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter
    -command disable
    -featureId identyfikator_składnika
    -version wersja
    [-to katalog_serwisu_docelowego]

Deinstalowanie określonego składnika:
java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter
    -command uninstall
    -featureId identyfikator_składnika
    -version wersja
    [-to katalog_serwisu_docelowego]

W przypadku wszystkich powyższych komend w miejscach, w których użyto opcji -to katalog_serwisu_docelowego, zostanie użyty odpowiedni skonfigurowany serwis docelowy z podanego katalogu. W razie pominięcia tej opcji zostanie użyty domyślny lokalny serwis produktu.

Aby bez przeprowadzania operacji sprawdzić, czy może ona zakończyć się pomyślnie w przypadku zastosowania powyższych komend (tzn. spełnia odpowiednie wymogi), do listy argumentów należy dodać pozycję -verifyOnly=true.

Wyszukiwanie w serwisie zdalnym i wyświetlanie listy dostępnych składników do zainstalowania:
java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter
    -command search
    -from adres_URL_serwisu_zdalnego

Wyświetlanie listy zainstalowanych składników:
java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter
    -command listFeatures
    -from katalog_serwisu_lokalnego

Składniki są wyświetlane w następujący sposób:
Site: adres URL serwisu
  Feature: identyfikator wersji enabled (lub disabled)


Dodawanie do serwisu lokalnego kolejnych składników:
java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter
    -command addSite
    -from katalog_serwisu_lokalnego

Usuwanie serwisu lokalnego:
java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter
    -command removeSite
    -to katalog_serwisu_lokalnego

Stosowanie zmian:
java -cp plugins/org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Infocenter
    -command apply