Konfigurowanie usług zdalnych na serwerze Apache Tomcat

Poniższe kroki umożliwiają skonfigurowanie użytkowników i opcji języka Java™ na potrzeby usług zdalnych na serwerze Apache Tomcat.

Zanim rozpoczniesz

Przed przystąpieniem do konfigurowania użytkowników i opcji języka Java należy zainstalować serwer Apache Tomcat, produkt Rational Publishing Engine i aplikację usług Web Service oraz wdrożyć te usługi.

Konfigurowanie użytkowników i ich ról

O tym zadaniu

Tabela 1. Role użytkownika usług zdalnych
Rola Możliwości
Użytkownik generujący dokumenty (rpe_docgen_user)
  • Może generować dokumenty zdalnie lub lokalnie z poziomu aplikacji klienckich.
  • Może wyświetlać pliki wyjściowe i dzienniki dotyczące swoich zadań generowania dokumentów.
Administrator generowania dokumentów (rpe_docgen_admin)
  • Może generować dokumenty zdalnie lub lokalnie z poziomu aplikacji klienckich.
  • Jeśli ta rola jest używana wspólnie z rolą rpe_monitor_admin, wówczas może wyświetlać pliki wyjściowe i dzienniki dotyczące zadań generowania dokumentów zainicjowanych przez dowolnego użytkownika.
Użytkownik komponentu Zarządzanie centralne (rpe_library_user)
  • Może wyświetlać zasoby publiczne w aplikacji Document Studio.
  • Może używać zasobów publicznych do projektowania szablonów.
Kontrybutor komponentu Zarządzanie centralne (rpe_library_contributor)
  • Może wyświetlać zasoby w aplikacji Document Studio.
  • Może używać zasobów do projektowania szablonów.
  • Może wprowadzać zasoby w aplikacji Document Studio.
  • Może modyfikować swoje istniejące zasoby w aplikacji Document Studio.
Administrator komponentu Zarządzanie centralne (rpe_library_admin)
  • Może wyświetlać zasoby utworzone przez dowolnego użytkownika w aplikacji Document Studio.
  • Może używać do projektowania szablonów zasobów utworzonych przez dowolnego użytkownika.
  • Może wprowadzać zasoby w aplikacji Document Studio.
  • Może modyfikować istniejące zasoby utworzone przez dowolnego użytkownika w aplikacji Document Studio.
  • Może tworzyć zasoby w interfejsie użytkownika administracyjnego komponentu Zarządzanie centralne.
  • Może modyfikować istniejące zasoby utworzone przez dowolnego użytkownika z poziomu interfejsu użytkownika administracyjnego komponentu Zarządzanie centralne.
  • Może usuwać zasoby utworzone przez dowolnego użytkownika z poziomu interfejsu użytkownika administracyjnego komponentu Zarządzanie centralne.
Użytkownik komponentu Monitorowanie i sterowanie (rpe_monitor_user)
  • Może zmieniać stan swoich zadań generowania dokumentów.
  • Umożliwia monitorowanie zadań generowania dokumentów tego użytkownika przez użytkowników z rolą rpe_monitor_admin.
Administrator komponentu Monitorowanie i sterowanie (rpe_monitor_admin)
  • Jeśli ta rola jest używana wspólnie z rolą rpe_docgen_admin, wówczas może wyświetlać pliki wyjściowe i dzienniki dotyczące zadań generowania dokumentów zainicjowanych przez dowolnego użytkownika.
  • Może zmieniać status zadań generowania dokumentów zainicjowanych przez dowolnego użytkownika.

Procedura

  1. Otwórz program Apache Tomcat Manager w przeglądarce: http://serwer:port/manager/html. Przykład: http://localhost:8080/manager/html.
  2. Zatrzymaj wdrożone aplikację usług Web Service . W sekcji Applications (Aplikacje) znajdź wiersz rpews.war application (aplikacja rpews.war) i kliknij opcję Stop (Zatrzymaj).
  3. Utwórz użytkowników i role dla serwera Apache Tomcat na potrzeby komponentu Monitorowanie i sterowanie.
    1. Otwórz plik tomcat-users.xml, który domyślnie znajduje się w następującym położeniu: $CATALINA_HOME\conf\tomcat-users.xml.
    2. Dodaj role użytkownika, kontrybutora i administratora dla używanych usług.
      Wskazówka:
      • Aby zapoznać się z opisami poszczególnych ról, należy przejrzeć tabelę w powyższej sekcji O tym zadaniu.
      • Aby uzyskać wyższy poziom zabezpieczeń, należy utworzyć więcej niż jednego użytkownika będącego klientem i nadać tylko jednemu z nich rolę rpe_docgen_user. Dokumenty generowane przez użytkowników mogą zawierać poufne dane. Tworząc dwa typy użytkowników, można upewnić się, że tylko użytkownicy o uprawnieniach do wyświetlania wynikowych danych wyjściowych będą mogli je wyświetlać.
      <role rolename="administrator_usługi_generowania_dokumentów_produktu_rpe" />
      <role rolename="użytkownik_usługi_generowania_dokumentów_produktu_rpe" /> 
      <role rolename="rpe_library_user"/>
      <role rolename="kontrybutor_biblioteki_produktu_rpe"/>
      <role rolename="administrator_biblioteki_produktu_rpe"/>
      <role rolename="użytkownik_monitora_rpe"/>
      <role rolename="administrator_monitora_rpe"/>
    3. Dodaj co najmniej jednego administratora i przypisz mu zarówno role administratora, jak i użytkownika dla używanych usług. Przykład:
      <user username="administrator_produktu_rpe"
      password="hasło" roles="rpe_docgen_admin,rpe_library_admin,rpe_monitor_admin"/>
    4. Dodaj co najmniej jednego użytkownika będącego klientem. Przypisz użytkownikowi będącemu klientem role użytkownika dla używanych usług. Przykład:
      <user username="klient_rpe" password="hasło" roles="rpe_docgen_user,rpe_library_user,rpe_monitor_user"/>
      <user username="kontrybutor_produktu_rpe"
      password="hasło"
      roles="rpe_docgen_user,rpe_library_contributor,rpe_monitor_user"/>
    5. Opcjonalne: Dodaj dodatkowych użytkowników będących klientami i kontrybutorami. Przykład:
      <user username="użytkownik_1"
      password="hasło"
      roles="rpe_docgen_user,rpe_library_contributor,rpe_monitor_user"/>
  4. Należy uruchomić aplikację usług Web Service . W sekcji Applications (Aplikacje) programu Apache Tomcat Manager znajdź wiersz rpews.war application (aplikacja rpews.war) i kliknij opcję Start (Uruchom).

Opcjonalne: konfigurowanie komponentu Monitorowanie i sterowanie na innym serwerze niż zdalne generowanie dokumentów

Usługa generowania dokumentów automatycznie korzysta z wdrożonego wraz z nią komponentu Monitorowanie i sterowanie. Aby użyć domyślnego komponentu Monitorowanie i sterowanie nie jest wymagana dodatkowa konfiguracja i można przejść do następnego kroku. Aby użyć innego komponentu Monitorowanie i sterowanie na innym serwerze lub innym porcie niż generowanie dokumentów, należy skonfigurować następujące opcje języka Java w celu skonfigurowania referencji logowania.

Procedura

  1. Zatrzymaj wdrożone aplikację usług Web Service . W sekcji Applications (Aplikacje) znajdź wiersz rpews.war application (aplikacja rpews.war) i kliknij opcję Stop (Zatrzymaj).
  2. Ustaw opcje języka Java:
    1. W plikach aplikacji serwera Apache Tomcat kliknij prawym przyciskiem myszy plik startup używany do uruchamiania serwera.
    2. Kliknij opcję Właściwości.
    3. Wybierz kartę Java.
    4. W polu opcji języka Java wprowadź następujące opcje:
      -Dcom.ibm.rational.rpe.mc.url=http://serwer:port/rpews/monitor
      -Dcom.ibm.rational.rpe.mc.user=klient_produktu_rpe
      -Dcom.ibm.rational.rpe.mc.password=hasło
    5. Kliknij przycisk OK.
  3. Należy uruchomić aplikację usług Web Service . W sekcji Applications (Aplikacje) programu Apache Tomcat Manager znajdź wiersz rpews.war application (aplikacja rpews.war) i kliknij opcję Start (Uruchom).

Wyniki

Po zakończeniu wdrażania Konsola administracyjna komponentu Monitorowanie i sterowanie będzie dostępna pod następującym adresem: http://serwer:port/rpews/ui/monitor.html. Więcej informacji na temat korzystania z Konsoli administracyjnej zawiera sekcja Zarządzanie zadaniami generowania dokumentów w komponencie Monitorowanie i sterowanie.

Co dalej

Na komputerach użytkowników końcowych należy określić adres URL komponentu Monitorowanie i sterowanie dla serwera zdalnego. Patrz: Ustawianie preferencji usług zdalnych.


Opinia