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. Další informace viz téma Vytvoření souboru oslcServiceProviders.xml pro 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

Výchozí hodnota: 3

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í dokumentů. Obecně platí, že pokud server nelze kontaktovat po šesti po sobě jdoucích pokusech, je server pravděpodobně vypnutý a administrátor jej musí restartovat.
-Dcom.ibm.rational.rpe.console.limit Počet znaků

Výchozí hodnota: 100000 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.
-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í dokumentů 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í dokumentů 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

Výchozí hodnota: 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í dokumentů otevřít tyto propojené 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í dokumentů.

-Dcom.ibm.rational.rpe.enable.surrogate.char.processing true, false

Výchozí hodnota: false

Příklad: -Dcom.ibm.rational.rpe.enable.surrogate.char.processing=true

Příznak produktu Rational Publishing Engine Ve výstupu Microsoft Word a PDF se náhrady Unicode, kterými jsou často znaky z asijských jazyků, odeberou. Můžete povolit -Dcom.ibm.rational.rpe.enable.surrogate.char.processing pro správné zpracování těchto znaků během generování dokumentu, aby byly zahrnuty do výstupu podle očekávání.
-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ář

Výchozí hodnota: TEMP\rpe\output

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

Příznak produktu Rational Publishing Engine Dočasný adresář můžete změnit na odlišné umístění než výchozí. 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č 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č 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č sestav aplikace Remote Services, nakonfigurujte tento příznak se jménem uživatele.
-Dcom.ibm.rational.rpe.wstimeout Čas v milisekundách

Výchozí hodnota: 30000 milisekund

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.
-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í dokumentů, 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í dokumentů, 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í dokumentů. 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í dokumentů. 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 je: 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 je: 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