launchClient aracı

WebSphere® Application Serveriçin launchClient aracı için Java™ Platform, Enterprise Edition (Java EE) komut satırı sözdizimini kullanabilirsiniz.

Önemli: Belirli bir profilden komut çalıştıran tüm kullanıcıların, aynı profili kullanan diğer kullanıcılar tarafından oluşturulan dosyaları değiştirme yetkisi olmalıdır. Tersi durumda, günlük kütüklerinde bir izin reddedildi hatası görebilirsiniz. Bu sorunu önlemek için aşağıdaki ilkelerden birini göz önünde bulundurun:
  • [AIX Solaris HP-UX Linux Windows]Ayrı kullanıcı yetkileri için belirli profilleri kullanın
  • Verili bir tanıtımda çalıştırılan tüm komutlar için her zaman aynı kullanıcıyı kullan
  • Belirli bir tanıtıma ait tüm kullanıcıların aynı gruba ait olduğundan emin olun. Ayrıca, bir grup kullanıcısının, aynı profildeki diğer üyeler tarafından oluşturulan dosyalara okuma ve yazma yetkisi olduğundan emin olun.

Aşağıdaki örnek, launchClient aracı için komut satırı başlatma sözdizimini göstermektedir:

launchClient [-profileName pName | -JVMOptions options | -help | -?] userapp [-CCname=value] [app args]
Nerede
  • userapp , uygulama istemcisini içeren EAR dosyasının yolu ve adıdır.
  • -CCname = değer , istemci taşıyıcısı ad-değer çifti parametresidir. Desteklenen ad-değer çifti bağımsız değişkenleri için istemci taşıyıcısı parametreleri bölümüne bakın.
  • app args , uygulama istemcisine geçen bağımsız değişkenlerdir.
  • -profileName , çok profilli bir kurulumda Application Server işleminin profilini tanımlar. -profileName seçeneği, tek bir profil ortamında ya da bir Uygulama İstemcileri kuruluşunda çalıştırmak için gerekli değildir.

    [AIX Solaris HP-UX Linux Windows]Varsayılan değer default_profile' dir.

  • -JVMOptions , -cp ya da -classpathdışında, geçerli bir Java standardı ya da standart dışı seçenek dizgisidir. Dizenin çevresine tırnak işareti ekleyin.
  • -help,-? , kullanım bilgilerini yazdırır.

İlk değiştirge -help, -? olmalı ya da hiçbir parametre içermemelidir. -profileName pName ve -JVMOptions seçenekleri isteğe bağlı parametrellerdir. Kullanılırsa, bunlar < userapp> değiştirginden önce görünmelidir. Diğer tüm parametreler isteğe bağlıdır ve userapp değiştirginden sonra herhangi bir sırada görüntülenebilir. Java EE Uygulama istemcisi çalıştırma zamanı, bir -CC önekiyle başlamayan ve bu parametreleri uygulama istemcisine geçirmeyen isteğe bağlı parametreleri yoksayar.

İstemci taşıyıcısı parametreleri

Desteklenen bağımsız değişkenler şunlardır:

-CCadminConnectorHost
Konfigürasyon bilgilerinin alınacağı sunucunun anasistem adını belirler.

[AIX Solaris HP-UX Linux Windows]The default is the value of the -CCBootstrapHost parameter or the value, yerel anasistem, if the -CCBootstrapHost parameter is not specified.

-CCadminConnectorPort
Denetimle görevli istemci işlevine ilişkin kapı numarasını gösterir. Varsayılan değer, SOAP bağlantıları için 8880 ve Remote Method Invocation (RMI) bağlantıları için 2809 ' dır.
-CCadminConnectorType
Denetim istemcisinin sunucuya nasıl bağlanacağını belirtir. RMI bağlantı tipini kullanmak için RMI belirleyin ya da SOAP bağlantı tipini kullanmak için SOAP seçeneğini belirtin. Varsayılan değer SOAP' dir.
-CCadminConnectorUser
Yönetim istemcileri, bir sunucu kimlik doğrulaması gerektirdiğinde bu kullanıcı adını kullanır. Bağlantı tipi SOAP ise ve sunucuda güvenlik etkinleştirilmişse, bu parametre gereklidir.
-CCadminConnectorPassword
-CCadminConnectorUser parametresinin belirttiği kullanıcı adına ilişkin parola.
-CCaltDD
Diğer bir konuşlandırma tanımlayıcısı dosyasının adı. Bu değiştirge, kullanılacak konuşlandırma tanımlayıcısını belirtmek için -CCjar değiştirgesinde kullanılır. Bir istemci JAR dosyası birden çok konuşlandırma tanımlayıcısı ile yapılandırıldığında bu bağımsız değişkeni kullanın. İstemci JAR dosyası standart konuşlandırma tanımlayıcısını kullanmak için değeri null olarak ayarlayın.
-CCBootstrapHost
İlk olarak bağlanmak istediğiniz anasistem sunucusunun adı. Biçim şöyledir: your_server_of_choice.com
-CCBootstrapPort
Sunucu kapı numarası. Bu bağımsız değişkeni belirtmezseniz, WebSphere Application Server varsayılan değeri kullanılır.
-CCclassLoaderMode
Sınıf yükleyici kipini belirtir. PARENT_SON belirtilirse, sınıf yüklerken sınıf yükleyicisi üst sınıf yolundan önce sınıf yükler yerel sınıf yolundan yükler. Aşağıdakiler için yüklenen sınıflar etkilenir:
  • Java EE uygulama istemcisi için tanımlanan sınıflar
  • Java EE uygulamasında tanımlı kaynaklar
  • Java EE istemcisi JAR dosyasının bildirgesinde (manifest) belirtilen sınıflar
  • -CCclasspath seçeneği kullanılarak belirtilen sınıflar
PARENT_SON belirtilmediyse, varsayılan kip, PARENT_FIRST, sınıfı yerel sınıf yolundan yüklemeye çalışmadan önce sınıf yükleyicisinin sınıf yükleyicisini üst sınıf yükleyicisine devredemesine neden olur.
-CCclasspath
Sınıf yolu değeri. Bir uygulama başlattığınızda, sistem sınıfı yolu kullanılır. EAR dosyasında olmayan sınıflara ya da sistem sınıfı yollarına erişmek istiyorsanız, burada uygun sınıf yolunu belirtin. Birden çok yol birleştirilebilir.
-CCD
Use this option to have the WebSphere Application Server set the specified system property during initialization. Şu karakterden sonra equals (=) karakterini kullanmayın-CCD. Örneğin:-CCDcom.ibm.test.property=testvalue. Birden çok değer belirtebilirsiniz.-CCDDeğiştirge. Bu parametrenin genel biçimi:-CCD<property key>=<property value>. Örneğin, -CCDI18NService.enable=true.
-CCdumpJavaNameSpace
Başlatılan uygulamaya ilişkin java: ad alanı dökümünün oluşturulmasını denetler; bu, hata ayıklama amacıyla kullanılabilir. true değeri, kısa biçimde bir döküm oluşturur ve her bağ tanımı için ad ve nesne tipini içerir. Uzun değeri, dökümü uzun biçimde oluşturur ve her bağ tanımı için, yerel nesnenin yerel nesne tipi ve dizgi gösterimi gibi, her bağ tanımı için ek bilgi içerir. Varsayılan değer false' tır ve döküm oluşturmaz.
-CCexitVM
WebSphere Application Server ' in çağrısını aramak için bu seçeneği kullanınSystem.exit()İstemci uygulaması tamamlandıktan sonra yöntem. Varsayılan değerfalse.
-CCinitonly
İstemci uygulamasını başlatmadan ActiveX uygulama istemcilerine ilişkin uygulama istemci çalıştırma zamanını kullanıma hazırlamak için bu seçeneği kullanın. Varsayılan değerfalse.
-CCjar
Başlatmak istediğiniz uygulama için EAR dosyası içinde bulunan istemci Java Archive (JAR) dosyasının adı. EAR dosyasında birden çok istemci JAR dosyası varsa bu bağımsız değişkeni kullanın.
-CCpropfile
launchClient özelliklerini içeren bir özellikler dosyasının adını belirtir. Özellikleri olmayan özellikleri belirtin-CCsecurityManager, securityMgrClass ve securityMgrPolicy özellikleri dışında, dosyanın öneki. Aşağıdaki örneğe bakın:verbose=true.
-CCproviderURL
İlk bağlam üreticinin ilk bağlamı elde etmek için kullanabileceği önyükleme sunucusu bilgileri sağlar. WebSphere Application Server başlangıç bağlamı üreticisi bir Common Object Request Broker Architecture (CORBA) nesnesi URL adresini ya da bir IIOP (Internet Inter-ORB Protokolü) protokolünü kullanabilir. URL adresi. CORBA nesnesi URL adresleri, IIOP URL adreslerinden daha esnekdir ve kullanılması önerilen URL biçimidir. Bu değer, birden çok önyükleme sunucusu adresi içerebilir. Bu özellik, bir sunucu kümesinden ilk bağlamı elde etme girişimi sırasında kullanılabilir. Önyükleme sunucusu adreslerini, kümedeki tüm sunucular için URL ' de belirleyebilirsiniz. Sunuculardan en az biri çalışıyorsa işlem başarılı olur ve tek bir hata noktasını ortadan kaldırır. Adres listesi belirli bir sırada işlenmez. Adlandırma işlemleri için bu değer,-CCBootstrapHostve-CCBootstrapPortDeğiştirge. Birden çok sistemi belirten bir CORBA nesne URL 'si aşağıdaki örnekte gösterilmektedir:
-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
Bu değer şu değerle eşlenir:java.naming.provider.urlSistem özelliği.
-CCsecurityManager
WebSphere Application Server ' ı bir güvenlik yöneticisiyle etkinleştirir ve çalıştırır. Varsayılan değerdisable.
-CCsecurityMgrClass
Bir güvenlik yöneticisini uygulayan bir sınıfın tam olarak nitelenmiş adını belirtir. Bu bağımsız değişkeni yalnızca şu durumlarda kullanın:-CCsecurityManagerdeğiştirge şu şekilde ayarlandı:enable. Varsayılan değerjava.lang.SecurityManager.
-CCsecurityMgrPolicy
Bir güvenlik yöneticisi ilke dosyasının adını belirtir. Only use this argument if the -CCsecurityManager parameter is set to enable. Bu değiştirgeyi etkinleştirdiğinizde,java.security.policysistem özelliği ayarlıdır. Varsayılan değer: uyg_sunucusu_kökdzn/properties/client.policy.
-CCsoapConnectorPort
Basit Nesne Erişimi İletişim Kuralı (SOAP) bağlayıcısı kapısı. Bu bağımsız değişkeni belirtmezseniz, WebSphere Application Server varsayılan değeri kullanılır.
-CCtrace
Hata ayıklama izleme bilgilerini almak için bu seçeneği kullanın. Bir sorunu IBM® müşteri desteğine bildirirken bu bilgilere gereksinim duyabilirsiniz. Varsayılan değerfalse. Ek bilgi için, Enabling trace başlıklı konuyu okuyun.
-CCtracefile
İzleme bilgilerinin yazıldığı kütüğün adını belirtir. Varsayılan değer, çıktıyı konsola yazmadır.
-CCtraceMode
İzleme için kullanılacak izleme biçimini belirler. Geçerli değer ( basic) belirtilmemişse, varsayılan değer gelişmiş olur. Temel izleme biçimi, izleme biçiminin daha küçük bir biçimidir.

[AIX Solaris HP-UX Linux Windows]Temel ve ileri düzey izleme biçimleriyle ilgili daha fazla bilgi için izleme çıkışı yorumlama başlıklı konuya bakın.

-CCverbose
Bu seçenek, ek bilgi iletilerini görüntüler. Varsayılan değer false değeridir.

Güvenliği etkinleştiren bir EJB istemcisi uygulaması kullanıyorsanız, profile_root/properties dizininde bulunan sas.client.props dosyasını düzenleyin. Dosya içinde, com.ibm.CORBA.loginSource değerini noneolarak değiştirin.

sas.client.props yardımcı programıyla ilgili daha fazla bilgi için, özellikler (properties) dosyalarındaki ve PropFilePasswordEncoder komut başvurusu konularındaki parolaların el ile kodlanması başlıklı konuya bakın.

Güvenlik ile RMI bağlantısı. EJB ve denetim istemcisi uygulaması ile kullanılır.
Jacl 'i kullanarak:
[AIX Solaris HP-UX Linux Windows]
wsadmin -conntype RMI -port  rmiportnumber -user userid 
-password password

Jython kullanılması:

[AIX Solaris HP-UX Linux Windows]
wsadmin -lang jython -conntype RMI -port  rmiportnumber -user userid 
-password password

rmiportnumber for your connection displays in the administrative console as BOOTSTRAP_ADDRESS.

Dikkat: AIX®, HP-UX, Linux®, IBM i, Solaris ve z/OS® işletim sistemlerinde, parola bilgileri, tüm çalışan işlemleri görüntülemek için diğer kullanıcılar tarafından çağrılabilen ps komutu gibi, parola bilgileri sistem durumu programına görünür hale gelmesiyle güvenlik açılmasına neden olabilir. Güvenlik açığı sizi ilgilendiriyorsa, bu seçeneği kullanmayın. Bunun yerine, SOAP bağlayıcısı için soap.client.props dosyasında ya da RMI bağlayıcısı için sas.client.props dosyasına ilişkin kullanıcı ve parola bilgilerini belirtin. soap.client.props ve sas.client.props dosyaları, WebSphere Application Server profilinizin özellikler dizininde yer alır.

Yönetici kimlik doğrulaması için Kerberos (KRB5) etkinleştirilmişse, kimlik doğrulama hedefi BasicAuth ve KRB5' i destekler. KRB5' u kullanmak için, bağlayıcı tipine göre sas.client.props, soap.client.propsve ipc.client.props dosyalarını güncelleyin.

Dikkat: Kerberos kimlik doğrulaması kullanılırken, kullanıcı parolası aktarım kanalından geçmiyor. İstemciyi tanımlamak için tek yönlü bir parola hash değeri kullanılır.

Aşağıdaki örneklerde doğru sözdizimi gösterilmektedir.

[ Windows]
launchClient c:\earfiles\myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
[AIX HP-UX Solaris]
./launchClient.sh /usr/earfiles/myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2