Konfigurace běhových a formátovaných příznaků pro klientské aplikace

Chcete-li pro své aplikace zadat určité parametry, můžete do konfiguračních souborů spouštěcího programu a produktu Document Studio přidat vlastnosti nazývané příznaky.

Než začnete

Prostudujte si seznam běhových a formátovaných příznaků dostupných k použití pro klientské aplikace a poté jeden z nich vyberte k dokončení této úlohy.
Tabulka 1. Běhové a formátované příznaky
Příznak Hodnota Typ Popis
-Dcom.ibm.rational.rpe.config.oslcServiceProviders Úplná cesta k souboru, cesta UNC nebo umístění HTTP
Příklad:

-Dcom.ibm.rational.rpe.config.oslcServiceProviders=
C:\rpe\oslcServiceProviders.xml

Příznak produktu Rational Publishing Engine Chcete-li nakonfigurovat metodu ověření OAuth-OSLC authentication pro zdroje dat produktu Rational DOORS Web Access. Musíte zadat platné hodnoty vlastností base_url, consumer_key a secret v souboru oslcServiceProviders.xml uvedeném pro tento příznak. Chcete-li získat další informace, viz Vytvoření souboru oslcServiceProviders.xmlpro ověření OAuth-OSLC a odkaz na ukázku v instalačním adresáři Rational Publishing Engine: %RPE_HOME%/config/oslcServiceProviders-sample.xml
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd Řetězec.

Příklad: -Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd=password

Příznak produktu Rational Publishing Engine Heslo požadované pro provedení ověření OAuth-OSLC pomocí příznaku -Dcom.ibm.rational.rpe.config.oslcServiceProviders.
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr Řetězec.

Příklad: -Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr=user

Příznak produktu Rational Publishing Engine Jméno uživatele požadované pro provedení ověření OAuth-OSLC pomocí příznaku -Dcom.ibm.rational.rpe.config.oslcServiceProviders.
-Dcom.ibm.rational.rpe.disablecommands true, false

Příklad: -Dcom.ibm.rational.rpe.disablecommands=true

Příznak produktu Rational Publishing Engine Zabezpečení zvýšíte tím, že nastavíte tento příznak a zabráníte aplikaci Remote Services ve spouštění příkazů před a příkazů po.
-Dcom.ibm.rational.rpe.mc.maxerrorcount Číslo

Příklad: -Dcom.ibm.rational.rpe.mc.maxerrorcount=

Příznak produktu Rational Publishing Engine Počet případů, kdy se klient pokusí připojit ke komponentě Monitorování a řízení za účelem vypsání úlohy generování dokumentu. Výchozí počet případů jsou 3. Obecně platí, že pokud server nelze kontaktovat po 6 po sobě jdoucích pokusech, je server pravděpodobně vypnutý a administrátor ho musí restartovat.
-Dcom.ibm.rational.rpe.console.limit Počet znaků

Příklad: -Dcom.ibm.rational.rpe.console.limit=90000

Příznak produktu Rational Publishing Engine Můžete určit rozsah informace z protokolů uchovávaných v pohledu Konzola. Standardně je maximální velikost nastavena na 100 000 znaků.
-Dcom.ibm.rational.rpe.doors.data Argument dat ke schválení na příkazovém řádku produktu Rational DOORS

Příklad: -Dcom.ibm.rational.rpe.doors.data=36677@localhost

Příznak produktu Rational Publishing Engine Tento příznak můžete zahrnout k identifikaci vaší databáze produktu Rational DOORS, takže ji nemusí identifikovat produkt Rational Publishing Engine. Nastavení této hodnoty zlepšuje výkon, když je váš produkt Rational DOORS stabilní, nebo když je vaše generování dokumentu nastaveno na počítači, na kterém není povoleno spuštění příkazu reg.exe. Když je tento příznak nakonfigurován, přepíše hodnotu uvedenou pro vlastnost doors_param ve specifikaci dokumentu. Tento příznak můžete uvést jako systémovou proměnnou nebo jako proměnnou prostředí JRE (Java™ Runtime). Proměnné prostředí JRE (Java Runtime) mají přednost před systémovými proměnnými.

Při konfiguraci tohoto příznaku musíte nastavit vlastnost new_instance na hodnotu true.

-Dcom.ibm.rational.rpe.doors.flags Volby příkazového řádku produktu Rational DOORS

Příklad: -Dcom.ibm.rational.rpe.doors.flags="-addins file path"

Příznak produktu Rational Publishing Engine Můžete uvést volby příkazového řádku pro produkt Rational DOORS. Tento příznak můžete uvést jako systémovou proměnnou nebo jako proměnnou prostředí JRE (Java Runtime). Proměnné prostředí JRE (Java Runtime) mají přednost před systémovými proměnnými.
-Dcom.ibm.rational.rpe.doors.home Cesta ke spustitelnému souboru produktu Rational DOORS
Příklad:

-Dcom.ibm.rational.rpe.doors.home=
C:\Program Files (x86)\IBM\Rational\DOORS\9.5\bin\doors.exe

Příznak produktu Rational Publishing Engine Tento příznak můžete zahrnout k identifikaci vaší verze produktu Rational DOORS, takže ji nemusí identifikovat produkt Rational Publishing Engine. Nastavení této hodnoty zlepšuje výkonu, když je váš produkt Rational DOORS stabilní, nebo když je vaše generování dokumentu nastaveno na virtuálním počítači při spuštění nepovoleného příkazu reg.exe. Když je tento příznak nakonfigurován, přepíše hodnotu uvedenou pro vlastnost doors_home ve specifikaci dokumentu. Tento příznak můžete uvést jako systémovou proměnnou nebo jako proměnnou prostředí JRE (Java Runtime). Proměnné prostředí JRE (Java Runtime) mají přednost před systémovými proměnnými.

Při konfiguraci tohoto příznaku musíte nastavit vlastnost new_instance na hodnotu true.

-Dcom.ibm.rational.rpe.dxl.enable.memory.management true, false

Příklad: -Dcom.ibm.rational.rpe.dxl.enable.memory.management=true

Příznak produktu Rational Publishing Engine

Když je modul Rational DOORS připojen k jiným modulům, musí produkt Rational Publishing Engine během generování dokumentu otevřít tyto připojené moduly na pozadí. Moduly jsou také otevřeny na pozadí při použití kódu DXL rozvržení, dokud není kód DXL dokončen.

V obou případech se paměť klienta Rational DOORS používá k otevření a zavření modulů na pozadí. Můžete konfigurovat klíč registru tak, aby se při dosažení limitu paměti uzavřely procesy na pozadí, jakmile dokončí čtení aktuálního objektu, a otevřely objekt znovu jen v případě potřeby.

Když je příznak -Dcom.ibm.rational.rpe.dxl.enable.memory.management nastaven na hodnotu true, mohou uživatelé nastavit klíč registru a definovat toto omezení paměti, jinak se použije výchozí omezení paměti 2 GB nastavené v kódu DXL. Další informace o klíči registru viz téma Odstraňování problémů generování dokumentů produktu Rational DOORS.

Výchozí hodnota je false a klíče registru nemá vliv na proces generování dokumentu.

-Dcom.ibm.rational.rpe.nonunicodefonts Název písma nebo písem jiných než Unicode oddělených středníky.

Příklad: -Dcom.ibm.rational.rpe.nonunicodefonts=Akshar

Příznak produktu Rational Publishing Engine Můžete určit písma pro použití v produktu Rational Publishing Engine, která nejsou písmy Unicode. Jiná než Unicode písma, která určíte, musí být nainstalována na stejném počítači, na kterém jsou spuštěny klientské aplikace.

Jiná písma než Unicode se nemusí vždy generovat správně ve výstupu produktu Microsoft Word. Nastavte písmo na hodnotu Arial Unicode MS nebo libovolné jiné písmo, které dokáže vykreslit tento znak a generuje výstup správně.

-Dcom.ibm.rational.rpe.output.default Dočasný adresář

Příklad: -Dcom.ibm.rational.rpe.output.default=C:\RPE\output

Příznak produktu Rational Publishing Engine Můžete změnit dočasný adresář na jiné umístění než výchozí, které je %TEMP%\rpe\output. Tento příznak můžete uvést jako systémovou proměnnou nebo jako proměnnou prostředí JRE (Java Runtime). Proměnné prostředí JRE (Java Runtime) mají přednost před systémovými proměnnými.
-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory Adresář nebo několik adresářů oddělených středníky.
Příklad:

-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory=
C:\Windows\Fonts;d:\fontlib

Příznak produktu Rational Publishing Engine Pokud má systém v nestandardním adresáři nainstalována další písma, můžete určit tyto podadresáře písem.
-Dcom.ibm.rational.rpe.rpews.scheduler.pwd Heslo uživatele pro ověření s plánovačem sestav.

Příklad: -Dcom.ibm.rational.rpe.rpews.scheduler.pwd=password

Příznak produktu Rational Publishing Engine Chcete-li provést ověření s komponentou plánovače sestav aplikace Remote Services, nakonfigurujte tento příznak s heslem.
-Dcom.ibm.rational.rpe.rpews.scheduler.url Adresa URL do plánovače sestav.
Příklad:

-Dcom.ibm.rational.rpe.rpews.scheduler.url=
http://server:port/rpews/scheduler

Příznak produktu Rational Publishing Engine Chcete-li provést ověření s komponentou plánovače sestav aplikace Remote Services, nakonfigurujte tento příznak s adresou URL.
-Dcom.ibm.rational.rpe.rpews.scheduler.usr Jméno uživatele pro ověření s plánovačem sestav.

Příklad: -Dcom.ibm.rational.rpe.rpews.scheduler.usr=user

Příznak produktu Rational Publishing Engine Chcete-li provést ověření s komponentou plánovače sestav aplikace Remote Services, nakonfigurujte tento příznak se jménem uživatele.
-Dcom.ibm.rational.rpe.wstimeout Čas v milisekundách

Příklad: -Dcom.ibm.rational.rpe.wstimeout=35000

Příznak produktu Rational Publishing Engine Při vytváření složitých specifikací dokumentu nakonfigurovaných pro použití generátoru vzdáleného publikování dojde k vypršení časového limitu aplikace Launcher. Pokud zjistíte, že dochází k příliš brzkému vypršení časového limitu klienta, zvyšte hodnotu časového limitu. Výchozí hodnota časového limitu je 30000 milisekund.
-Dcom.ibm.rational.rpews.pwd Heslo uživatele pro ověření s aplikací Remote Services.

Příklad: -Dcom.ibm.rational.rpews.pwd=password

Příznak produktu Rational Publishing Engine Chcete-li provést ověření s aplikací Remote Services, nakonfigurujte tento příznak s heslem.
-Dcom.ibm.rational.rpews.url Adresa URL
Příklad:

-Dcom.ibm.rational.rpews.url=
http://server:port/rpews/

Příznak produktu Rational Publishing Engine Adresa URL pro připojení k aplikaci Remote Services. Tato adresa URL nemusí být upravitelná v případě, že administrátor nepovoluje uživatelům měnit umístění.
-Dcom.ibm.rational.rpews.usr Jméno uživatele pro ověření s aplikací Remote Services.

Příklad: -Dcom.ibm.rational.rpews.usr=user

Příznak produktu Rational Publishing Engine Chcete-li provést ověření s aplikací Remote Services, nakonfigurujte tento příznak se jménem uživatele.
-Dosgi.configuration.area Cesta k souboru
Příklad:

-Dosgi.configuration.area=@user.home/Application
Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

Standardní příznak prostředí Java Chcete-li změnit výchozí umístění výstupu vašich generování dokumentu, můžete změnit cestu k souboru pro tento parametr. Uveďte stejnou hodnotu pro parametry -Dosgi.instance.area a -Dosgi.configuration.area.
-Dosgi.instance.area Cesta k souboru
Příklad:

-Dosgi.instance.area=@user.home/Application
Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

Standardní příznak prostředí Java Chcete-li změnit výchozí umístění výstupu vašich generování dokumentu, můžete změnit cestu k souboru pro tento parametr. Uveďte stejnou hodnotu pro parametry -Dosgi.configuration.area a -Dosgi.instance.area.
-Duser.country Kód země
Například brazilská portugalština:

-Duser.country=BR
-Duser.language=pt

Standardní příznak prostředí Java Nastavte tento příznak do zkratky pro zemi, která odpovídá vašemu kódu jazyka k nastavení národního prostředí pro vaše generování dokumentu. Nezbytné je pouze zahrnout -Duser.country, když jsou překlady dostupné pro specifický odkazovaný jazyk při kombinaci s -Duser.language.
-Duser.language Kód jazyka

Příklad pro japonštinu: -Duser.language=ja

Standardní příznak prostředí Java Nastavte tento příznak do zkratky pro jazyk k nastavení národního prostředí pro vaše generování dokumentu. Další příklady kódů jazyků viz Odkaz na kód jazyka HTML.
-Duser.timezone GMT+odchylka

Příklad: -Duser.timezone=GMT+02:00

Standardní příznak prostředí Java Produkt Rational Publishing Engine převádí datum a čas na časové pásmo počítače, kde je nainstalovaný produkt Rational Publishing Engine, nikoli na časové pásmo serveru, kde je dokument vzdáleně generován. Chcete-li toto nastavení změnit na datum a čas serveru, zadejte GMT a počet hodin, o kolik je místo, kde se server nachází, vzdáleno od středního greenwichského času.
–Xmx<value>m Nastavení haldy prostředí Java

Příklad: –Xmx512m

Příznak prostředí IBM JRE (IBM® Java Runtime Environment) Snižte hodnotu pro tento parametr v konfiguračních souborech produktu, abyste umožnili spuštění produktu Rational Publishing Engine na virtuálních počítačích.

Zvyšte hodnotu, abyste zlepšili výkon, když generujete velké dokumenty v jiných prostředích, ne na virtuálních počítačích.

–Xmx je standardním parametrem prostředí Java jedinečným pro produkt Rational Publishing Engine.

TELELOGIC_LICENSE_FILE Hodnota licenčního serveru uvedená v systémové proměnné TELELOGIC_LICENSE_FILE ve formě port@název_hostitele_licenčního_serveru_nebo_adresa_IP.

Příklad: 19353@LicenseServer2

Příznak produktu Rational Publishing Engine Systémová proměnná obsahující adresu licenčního serveru.

Informace o této úloze

Běhové a formátované příznaky můžete nakonfigurovat pro jednu nebo obě klientské aplikace:

Document Studio

Postup

  1. Otevřete konfigurační soubor aplikace Document Studio v textovém editoru. Výchozí umístění konfiguračního souboru: %RPE_HOME%\studio\rpe-studio.ini
  2. Na konec souboru přidejte příznak a hodnotu. Více hodnot lze oddělit středníkem. Příklad:
    -Dcom.ibm.rational.rpe.pdf.truetypefontdirectory=C:\Windows\Fonts;d:\fontlib
  3. Uložte změny.

Launcher

Postup

  1. Otevřete konfigurační soubor spouštěcí aplikace v textovém editoru. Výchozí umístění konfiguračního souboru: %RPE_HOME%\launcher\rpe-launcher.ini
  2. Na konec souboru přidejte příznak a hodnotu. Více hodnot lze oddělit středníkem. Příklad:
    -Dcom.ibm.rational.rpe.pdf.truetypefontdirectory=C:\Windows\Fonts;d:\fontlib
  3. Uložte změny.

Zpětná vazba