Nastavení aplikačního serveru WebSphere Application Server

Toto téma popisuje, jak nastavit server Jazz Team Server pro práci s aplikačním serverem WebSphere Application Server. Toto nastavení předpokládá, že instalujete server Jazz Team Server na stejný počítač jako aplikační server Websphere Application Server.

Než začnete tímto postupem, měly by být splněny níže uvedené podmínky:

Aplikační server WebSphere Application Server je již nainstalován.
Je vytvořena databáze a soubor teamserver.properties je aktualizován podle nastavení databáze.
Informace o nastavení zabezpečení najdete v dokumentaci k WebSphere; vyplňte vlastnost nerozlišování malých a velkých písmen.
Poznámka: Websphere i mnohé adresáře LDAP umožňují přihlašovat se bez rozlišování malých a velkých písmen, nicméně server Jazz Team Server ukládá záznamy uživatelů s jejich ID přesně tak, jak byly importovány. Když se přihlásíte k serveru Jazz Team Server, načte se záznam uživatele ze seznamu uživatelů a velikost písmen musí přesně odpovídat.
Volba zabezpečení Java 2 by měla být vypnuta. Pokud je tato volba na serveru WebSphere Application Server zapnuta, soubor .war serveru Jazz Team Server se nespustí.
Server Jazz Team Server obsahuje soubory nezbytné ke spuštění kompletního serveru založeného na serveru Apache Tomcat. K instalaci WebSphere potřebujete pouze některé ze souborů serveru Jazz Team Server a ty byste měli umístit do adresáře na vašem počítači se serverem WebSphere. V dalším pokynech se na tento adresář odkazuje jako na instalační adresář Jazz Team Server, nebo krátce jen instalační_adresář_Jazz. V tomto adresáři použijte:
- Soubor instalační_adresář_Jazz/server/teamserver.properties.
- Soubor instalační_adresář_Jazz/server/log4j.properties. Používáte-li Websphere Application Server, můžete v tomto souboru změnit cestu k souboru jazz.log, kam se ukládají pouze zprávy ze serveru Jazz Team Server. Výchozí cesta je tomcat/logs/jazz.log.
- Soubor instalační_adresář_Jazz/server/tomcat/webapps/jazz.war.
- Adresář instalační_adresář_Jazz/server/provision_profiles.
- Adresář instalační_adresář_Jazz/server/update-site.
- Výchozí databázi úložiště v adresáři instalační_adresář_Jazz/repositoryDB.
- Nástroje aplikace Repository Tools v adresáři instalační_adresář_Jazz/repotools.

Tip: Při použití správce instalace IBM Installation Manager mohou být soubory serveru Jazz Team Server nainstalovány do adresáře webové aplikace. Při instalaci byste neměli instalovat aplikační server Apache Tomcat, který je součástí instalačních souborů; správce instalace se tak zeptá na adresář webové aplikace a nainstaluje pouze soubory potřebné pro WebSphere. Výchozím adresářem je C:\Program Files\IBM\JazzTeamServer na systému Windows, resp. /opt/IBM/JazzTeamServer na systému Linux. Instalační adresář se v tomto postupu označuje jako instalační_adresář_Jazz. Používáte-li správce instalace IBM Installation Manager k instalaci souborů do adresáře webových aplikací serveru WebSphere Application Server, nemusíte soubory přesunovat ručně jak je popsáno výše.

Poznámka: Tento dokument neobsahuje informace ke konfiguraci ověřování WebSphere či SSL, neboť se jedná o složitější témata. Podrobné informace o různých volbách ověřování a šifrování pro WebSphere najdete v Informačním centru WebSphere. Další informace viz Informační centrum WebSphere, kde hledejte téma Zabezpečení aplikací a jejich prostředí. Webové uživatelské rozhraní Jazz vyžaduje konfiguraci ověřování, aby bylo možné provádět autorizaci a přizpůsobovat aplikaci.

Upravte soubory profile.ini a license-profile.ini:
Upravte jednotlivé profily v adresáři instalační_adresář_Jazz/server/provision_profiles/ a nastavte absolutní cestu u vlastnosti s adresou URL.
Například
- Změňte tento řádek:
```
url=file:./update-site.
```
- Např. takto:
```
url=file:/opt/IBM/JazzTeamServer/server/update-site.
```
Poznámka: Adresář instalační_adresář_Jazz/server/provision_profiles/ musí obsahovat pouze příslušné soubory .ini a nesmí zde být žádné záložní soubory. Některé editory automaticky ukládají záložní soubory - ty je nutné odebrat.

Přezkoumejte a aktualizujte umístění databáze v souboru teamserver.properties

com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin

Ověřte nebo aktualizujte úroveň aplikačního serveru WebSphere Application Server.
Jazz Team Server vyžaduje WebSphere Application Server verze 6.1 se sadou IBM Java SDK 1.5, včetně kumulativní opravy SR5 nebo novější. Aktualizace IBM Java SDK 1.5 SR6 je k dispozici na adrese http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. Při použití WebSphere verze 6.1 a GA IBM Java SDK začne Jazz po určitém počtu operací vykazovat "chyby proxy".
Aktualizujte argumenty JVM.
Server Jazz Team Server vyžaduje specifická nastavení virtuálního počítače Java, na kterém je spuštěn.

Nejdříve musí vědět, kde najít konfigurační soubory pro server a log4j, což je rámec protokolování používaný serverem. To se provede nastavením vlastností systému com.ibm.team.server.configURL a log4j.configuration. U těchto vlastností se používá adresa URL namísto jednoduché cesty, a tak by hodnota měla být zadána jako file://-style URL.

Druhá vlastnost, nezbytná pro Jazz JVM, slouží k nastavení vyšší alokace paměti oproti výchozí, za pomoci volby -Xmx. Toto nastavení by mělo být založeno na velikosti týmu podporovaného serverem a kapacity paměti serveru, na kterém je spuštěn Jazz Team Server. Typický středně velký tým může použít hodnotu -Xmx1000M, což je paměť haldy 1000 MB pro procesy serveru Jazz Team Server.

Pokud se připojujete k databázi Oracle, musíte přidat vlastnost s názvem "ORACLE_JDBC". Nastavte vlastnost na absolutní cestu (nikoli URL) k souboru s ovladači JDBC Oracle.

Existuje několik dalších vlastností systému, které je třeba nastavit k úpravě chování serveru - viz níže. Zde jsou specifika nastavení těchto vlastností JVM v administrativní konzole WebSphere Administrative Console; nahraďte instalační_adresář_Jazz vaším instalačním adresářem serveru Jazz Team Server:
1. Klepněte na volbu Servery > Aplikační servery.
2. Klepněte na volbu server1.
3. Klepněte na volbu Java a Správa procesů > Definice procesu.
4. Klepněte na volbu Java Virtual Machine.
5. Přidejte hodnotu 100 pod Počáteční halda.
6. Přidejte hodnotu 1000 pod Maximální velikost haldy.
7. Klepněte na volbu Použít.
8. Klepněte na volbu Protokolování a trasování. Klepněte na volbu Změnit úrovně podrobností protokolu. Produkt Jazz Team Server použije stroj vytváření sestav BIRT. Chcete-li zabránit zápisu informačních položek BIRT do souboru protokolu WebSphere, nastavte úroveň protokolování na severe pro balíky org.eclipse.birt.*. Klepněte na volbu Použít.
9. Klepněte na volbu Přizpůsobené vlastnosti
10. Přidejte tyto vlastnosti: Klepněte na volbu Nový; zadejte Název a Hodnotu; poté klepněte na tlačítko OK.
  - Název: com.ibm.team.repository.provision.profile Hodnota: file:///instalační_adresář_Jazz/server/provision_profiles (jako adresa URL souboru).
    Poznámka: Vlastnost com.ibm.team.repository.provision.profile musí ukazovat na adresář obsahující provision_profiles.
  - Název: com.ibm.team.server.configURL Hodnota: file:///instalační_adresář_Jazz/server/teamserver.properties (jako adresa URL souboru).
  - Název: log4j.configuration Hodnota: file:///instalační_adresář_Jazz/server/log4j.properties (jako adresa URL serveru).
  - Název: java.awt.headless Hodnota: true.
  - Název: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Hodnota: true.
11. Klepnutím na tlačítko Uložit se nastavení uloží přímo do hlavní konfigurace.
Restartujte Websphere, aby se nainstalovala aplikace Jazz.
V následujících příkladech pro příkazový řádek instalační_adresář_WAS představuje umístění aplikačního serveru WebSphere Application Server na vašem serveru.
- Na systému Windows je výchozí hodnota instalačního adresáře WebSphere:
```
C:\Program Files\IBM\WebSphere\AppServer
```
  Na systému Windows můžete server restartovat pomocí těchto příkazů:
```
cd instalační_adresář_WAS\bin 
stopServer.bat server1 [u zabezpečeného serveru použijte navíc: -username {uživatel_LDAP} -password {heslo_LDAP}] 
startServer.bat server1
```
- Na systému Linux je výchozí hodnota instalačního adresáře WebSphere:
```
/opt/IBM/WebSphere/AppServer
```
  Na systému Linux můžete server restartovat pomocí těchto příkazů:
```
cd instalační_adresář_WAS/bin 
./stopServer.sh server1 [u zabezpečeného serveru použijte navíc: -username {uživatel_LDAP} -password {heslo_LDAP}] 
./startServer.sh server1
```
1. Otevřete administrativní konzolu vašeho aplikačního serveru WebSphere Application Server.
2. Klepněte na volbu Aplikace > Instalovat novou aplikaci.
3. Pod Cesta k nové aplikaci klepněte na volbu Lokální systém souborů.
4. Pod Úplná cesta zadejte:
```
instalační_adresář_Jazz/server/jazz.war
```
5. Nastavte Kontextový kořenový adresář na /jazz.
6. Klepněte na tlačítko Další a pokračujte zbývajícími kroky průvodce Instalovat novou aplikaci.
7. Klepněte na tlačítko Dokončit.
8. Klepnutím na tlačítko Uložit se nastavení uloží přímo do hlavní konfigurace.
9. Klepněte na volbu Aplikace > Podnikové aplikace.
10. Vyberte rámeček vedle jazz_war; klepněte na volbu Spustit.
  Měla by se zobrazit zelená šipka na znamení toho, že aplikace byla úspěšně spuštěna.

Po spuštění serveru pokračujte tématem Spuštění průvodce nastavením.