JVM(Java Virtual Machine) 사용자 정의 특성
관리 콘솔을 사용하여 JVM(Java™ Virtual Machine) 사용자 정의 특성의 값을 변경할 수 있습니다.
사용자 정의 특성을 설정하려면 관리 콘솔에 연결하여 해당 JVM(Java Virtual Machine) 사용자 정의 특성 페이지를 탐색하십시오.
애플리케이션 서버 | 배치 관리자 | 노드 에이전트 |
---|---|---|
|
|
|
사용자 정의 특성이 이미 정의된 사용자 정의 특성 목록에 없으면, 새 특성 이름을 작성하고 이름 필드에 특성 이름을, 값 필드에 올바른 값을 입력하십시오. 서버를 다시 시작하여 변경사항을 완료하십시오.
- allowDeployerRoleGenPluginCfg
- com.ibm.cacheLocalHost
- com.ibm.apc.nodeMMTimeout
- com.ibm.config.allow.set.session.timeout
- com.ibm.config.eclipse.wtp.enablejemtrim
- com.ibm.config.eclipse.wtp.enablexmltrim
- com.ibm.config.eclipse.wtp.jem=finer
- com.ibm.config.eclipse.wtp.xmltrim=finer
- com.ibm.disableCommonsElCache
com.ibm.eclipse.wtp.allowRootedEntries
- com.ibm.ejs.ras.disablerasnotifications
- com.ibm.ejs.ras.writeSystemStreamsDirectlyToFile
- com.ibm.ejs.sm.server.quiesceInactiveRequestTime
- com.ibm.ejs.sm.server.quiesceTimeout
- com.ibm.ffdc.log
- com.ibm.websphere.application.updateapponcluster.waitforappsave
com.ibm.websphere.bean.delete.sleep.time
- com.ibm.websphere.deletejspclasses
- com.ibm.websphere.deletejspclasses.delete
- com.ibm.websphere.deletejspclasses.update
- com.ibm.websphere.ejb.UseEJB61FEPScanPolicy
- com.ibm.websphere.ejbcontainer.expandCMPCFJNDIName
- com.ibm.websphere.ejbcontainer.includeRootExceptionOnRollback
- com.ibm.websphere.jaxrpc.stub.typemapping.per.thread
- com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine
- com.ibm.websphere.logging.useJULThreadID
- com.ibm.websphere.management.application.client.EnvEntry_processBindings
- com.ibm.websphere.management.application.fullupdate
- com.ibm.websphere.management.application.fullupdate.application_name
- com.ibm.websphere.management.application.keepExistingSharedLibraries
- com.ibm.websphere.management.application.persistWebContext
- com.ibm.websphere.management.application.sync.recycleappasv5
- com.ibm.websphere.management.application.updateClusterTask.serverStopWaitTimeout
- com.ibm.websphere.management.application.updatesync.appExpansionTimeout
- com.ibm.websphere.management.configservice.getServerLogRootFromTemplate
- com.ibm.websphere.management.configservice.sessionIdUniqueness
- com.ibm.websphere.management.configservice.validatePropNames
com.ibm.websphere.management.jmx.random
- com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool
- com.ibm.websphere.management.nodesync.skipWebServerTarget
- com.ibm.websphere.management.processEmbeddedConfigGlobal
com.ibm.websphere.management.registerServerIORWithLSD
- com.ibm.websphere.management.soapSocketConnectionTimeout
- com.ibm.websphere.management.useUpdatedPropertyFiles
- com.ibm.websphere.metadata.ignoreDuplicateRefBindingsInWebModules
- com.ibm.websphere.network.useMultiHome
- com.ibm.websphere.perf.tuning.disableRPARepositoryCache
- com.ibm.websphere.resource.xmlConfigMaxLineLength
- com.ibm.websphere.sib.webservices.useTypeSoapArray
- com.ibm.websphere.webservices.attachment.tempfile.expiration
- com.ibm.websphere.webservices.attachements.maxMemCacheSize
- com.ibm.websphere.webservices.DisableIBMJAXWSEngine
- com.ibm.websphere.webservices.http.OneWayConnectionRecycleTime
- com.ibm.websphere.webservices.http.waitingThreadsThreshold
- com.ibm.websphere.webservices.jaxrpc.client.publishwsdl
- com.ibm.websphere.management.connector.http.header.includeProductVersion
- com.ibm.websphere.webservices.jaxws.setLinkValuePrecedence
- com.ibm.websphere.webservices.soap.enable.legacy.get.behavior
- com.ibm.websphere.webservices.tempAttachDir
- com.ibm.websphere.webservices.transport.jms.messageType
- com.ibm.websphere.webservices.transport.OPTIMIZE_HTTP_HEADERS
- com.ibm.websphere.webservices.transport.ssl.loadFromPolicyBinding
- com.ibm.websphere.webservices.UseWSFEP61ScanPolicy
- com.ibm.websphere.webservices.WSDL_Generation_Extra_ClassPath
- com.ibm.websphere.websvcs.EJBPostInvokeCallOnException
- com.ibm.websphere.workspace.decodeclustervariable
- com.ibm.websphere.wsrm.MaxSequenceBacklog
- com.ibm.websphere.wsrm.MessageContextCacheSize
- com.ibm.websphere.wsrm.pollingInterval
- com.ibm.websphere.wsrm.retransmissionInterval
com.ibm.websphere.zos.userdir.useRacfSettings
- com.ibm.ws.amm.require.produces.annotation.for.cdi
- com.ibm.ws.amm.scan.context.filter.archives
- com.ibm.ws.amm.scan.context.filter.disable.unifyTrue
- com.ibm.ws.amm.scan.context.filter.packages.
- com.ibm.ws.application.enhancedScanning
- com.ibm.ws.cache.CacheConfig.alwaysSetSurrogateControlHdr
- com.ibm.ws.cache.CacheConfig.cascadeCachespecProperties
- com.ibm.ws.cache.CacheConfig.filteredStatusCodes
- com.ibm.ws.cache.CacheConfig.use61EntrySetBehavior
- com.ibm.ws.cache.CacheConfig.useServerClassLoader
- com.ibm.ws.CacheConfig.alwaysTriggerCommandInvalidations
- com.ibm.ws.cdi.immediate.ejb.start
- com.ibm.ws.classloader.allowDisposedClassLoad
- com.ibm.ws.classloader.encodeResourceURLs
- com.ibm.ws.classloader.strict
- com.ibm.ws.classloader.zipFileCacheSize
- com.ibm.ws.cscope.HighlyAvailableIORsEnabled
- com.ibm.ws.el.reuseEvaluationContext
- com.ibm.ws.http.ConnectionIOTimeout
com.ibm.ws.iiop.channel.disableOnewayLocateRequiredMessage
- com.ibm.ws.jsf.allow.interpolator.per.app
- com.ibm.ws.jsf.call.publishevent.with.sourceclass
- com.ibm.ws.jsp.enhance_el_support
- com.ibm.ws.management.application.task.AppTypeDeploymentTask.isLongRunningApp
com.ibm.ws.management.connector.soap.waitBeforeCloseTime
- com.ibm.ws.management.event.max_polling_interval
- com.ibm.ws.management.event.pull_notification_timeout
- com.ibm.ws.management.repository.tempFileKeepTimeMinutes
- com.ibm.ws.management.repository.tempFileSweepIntervalMinutes
- com.ibm.ws.management.suppressPortScan
- com.ibm.ws.management.taskcommandtimeoutsec
- com.ibm.ws.odr.plugincfg.config.ASDisableNagle
- com.ibm.ws.odr.plugincfg.config.AcceptAllContent
- com.ibm.ws.odr.plugincfg.config.AppServerPortPreference
- com.ibm.ws.odr.plugincfg.config.ChunkedResponse
- com.ibm.ws.odr.plugincfg.config.IISDisableNagle
- com.ibm.ws.odr.plugincfg.config.IISPluginPriority
- com.ibm.ws.odr.plugincfg.config.IgnoreDNSFailures
- com.ibm.ws.odr.plugincfg.config.RefreshInterval
- com.ibm.ws.odr.plugincfg.config.ResponseChunkSize
- com.ibm.ws.odr.plugincfg.config.VHostMatchingCompat
- com.ibm.ws.odr.plugincfg.config.TrustedProxyEnable
- com.ibm.ws.odr.plugincfg.log.Name
- com.ibm.ws.odr.plugincfg.log.LogLevel
- com.ibm.ws.odr.plugincfg.cluster.CloneSeparatorChange
- com.ibm.ws.odr.plugincfg.cluster.LoadBalance
- com.ibm.ws.odr.plugincfg.cluster.PostSizeLimit
- com.ibm.ws.odr.plugincfg.cluster.RemoveSpecialHeaders
- com.ibm.ws.odr.plugincfg.cluster.RetryInterval
- com.ibm.ws.odr.plugincfg.odrIncludeStopped
- com.ibm.ws.odr.plugincfg.server.ConnectTimeout
- com.ibm.ws.odr.plugincfg.server.ExtendedHandShake
- com.ibm.ws.odr.plugincfg.server.MaxConnections
- com.ibm.ws.odr.plugincfg.cluster.WaitForContinue
- com.ibm.ws.odr.plugincfg.property.ESIEnable
- com.ibm.ws.odr.plugincfg.property.ESIMaxCacheSize
- com.ibm.ws.odr.plugincfg.property.ESIInvalidationMonitor
- com.ibm.ws.odr.plugincfg.property.https.keyring
- com.ibm.ws.odr.plugincfg.property.https.stashfile
- com.ibm.ws.odr.plugincfg.property.PluginInstallRoot
- com.ibm.ws.pm.checkingDBconnection
- com.ibm.ws.policyset.exportEncodedPasswords
- com.ibm.ws.recoverylog.disableNonHARegistration
- com.ibm.ws.recoverylog.spi.NoMemoryMappedFiles
- com.ibm.ws.runtime.component.ResourceMgr.postBindNotify
- com.ibm.ws.runtime.dumpShutdown
com.ibm.ws.runtime.logThreadPoolGrowth
- com.ibm.ws.scripting.apptimeout
- com.ibm.ws.sib.webservices.useSOAPJMSTextMessages
- com.ibm.ws.soap.handleRST
- com.ibm.ws.use602RequiredAttrCompatibility
- com.ibm.ws.webcontainer.allowDefaultErrorPage
- com.ibm.ws.webservices.allowNoSOAPActionHeader
- com.ibm.ws.webservices.allowStatusCode202OneWay
- com.ibm.ws.webservices.appendRootCauseToWSF
com.ibm.ws.webservices.cacheEngineList
- com.ibm.ws.webservices.contentTransferEncoding
- com.ibm.ws.webservices.disableSOAPElementLazyParse
- com.ibm.ws.webservices.engine.transport.jms.propagateOneWaySystemExceptions
- com.ibm.ws.webservices.forceLegacyDispatchFromSOAPConnection
- com.ibm.ws.webservices.HttpRedirectWithProxy
- com.ibm.ws.webservices.ignoreUnknownElements
- com.ibm.ws.webservices.jaxrpc.parse.tolerate.invalid.namespace
- com.ibm.ws.webservices.resolveXMLSchemaDTD
- com.ibm.ws.webservices.searchForAppServer
- com.ibm.ws.webservices.serialize.2DimArray.asArrays
- com.ibm.ws.webservices.serializeDetailElementUsingDefaultNamespace
- com.ibm.ws.webservices.suppressHTTPRequestPortSuffix
- com.ibm.ws.websvcs.attachments.sizethreshold
- com.ibm.ws.websvcs.getJAXBContext.cacheClassList
- com.ibm.ws.websvcs.getJAXBContext.cacheClassList.persist
- com.ibm.ws.websvcs.logOperationExceptionAsDebug
- com.ibm.ws.websvcs.relaxClientPolsetMatching
- com.ibm.ws.websvcs.relaxClientPolsetMatching
- com.ibm.ws.websvcs.suppressHTTPRequestPortSuffix
- com.ibm.ws.websvcs.transport.enableProxyTunnel
- com.ibm.ws.websvcs.transport.jms.enableBasicAuthOnResponse
- com.ibm.ws.websvcs.unifyServiceMessage
- com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri
- com.ibm.ws.ws.wsba.protocolmessages.twoway
com.ibm.ws390.SystemOutErrCodepage
- com.ibm.wsspi.amm.merge.ignoreValidationExceptions
- com.ibm.wsspi.wssecurity.dsig.enableEnvelopedSignatureProperty
- com.ibm.xml.xlxp.jaxb.opti.level
- com.ibm.xml.xlxp2.api.util.encoding.DataSourceFactory.bufferLength
- com.ibm.xml.xlxp2.api.util.Pool.STRONG_REFERENCE_POOL_MAXIMUM_SIZE
- config_consistency_check
- deactivateWildCardURIMapping
- DISABLE_LOCAL_COMM_WHEN_SSL_REQUIRED
- disableWSAddressCaching
- DRS_BATCH_INTERVAL_SIZE
- DRS_THREADPOOL_ISGROWABLE
- DRS_THREADPOOL_MINSIZE
- DRS_THREADPOOL_MAXSIZE
- dynacache.jms.cacheInstance
- dynacache.jms.connRetryInterval
- dynacache.jms.invProcessingDelay
- dynacache.jms.numStoredInvalidations
invocationCacheSize
java.net.preferIPv4Stack
java.net.preferIPv6Addresses
- java.util.logging.configureByLoggingPropertiesFile
- jaxws.asyncClient.maxThreadPoolSize
- jaxws.handler.reducecaching
- jaxws.ignore.extraWSDLOps
- jaxws.ignoreMetadataComplete
- jaxws.JAXBContext.permStoreCostThresholdMsec
- jaxws.JAXBContext.permStoreMaxSize
- jaxws.JAXBContext.permStoreStaleThresholdHours
- jaxws.payload.highFidelity
- jaxws.provider.interpretNullAsOneway
- jaxws.runtime.inheritedImplMethodsAccessible
- jaxws.runtime.restrictStaticWebmethod
- jaxws.share.dynamic.ports.enable
- jaxws.soapfault.local.exceptions.disable
- jaxws.useSafeIPC
- jdk.corba.allowOutputStreamSubclass
- ODCClearMessageAge
- ODCInit.disabled
- org.apache.aries.blueprint.header.mandatory
- org.apache.axiom.attachments.tempfile.expiration
- org.apache.el.parser.SKIP_IDENTIFIER_CHECK
- org.eclipse.jst.j2ee.commonarchivecore.disableZip
- org.eclipse.jst.j2ee.commonarchivecore.ignore.ejb.in.war
- org.eclipse.jst.j2ee.commonarchivecore.FILTERBINARIES
- org.eclipse.jst.j2ee.commonarchivecore.ignore.jee6.annotation
- org.eclipse.jst.j2ee.commonarchivecore.ignore.jee7.annotation
- org.eclipse.jst.j2ee.commonarchivecore.ignore.web.fragment
- org.eclipse.jst.j2ee.commonarchivecore.openAllArchivesTrue
- org.eclipse.jst.j2ee.commonarchivecore.PM62467.Disabled
- overrideAutoProp
- plugin.syncdisabled
- threadpool.maxsize
was.xcfmonitor.enabled
- webservices.unify.faults
wink.client.readTimeout
wink.client.connectTimeout
allowDeployerRoleGenPluginCfg
배치자 역할을 하는 사용자가 plugin-cfg.xml 파일을 생성 및 구성할 수 있게 하려면 이 사용자 정의 특성을 true로 설정하십시오. 이 사용자 정의 특성을 설정해서 저장한 후 애플리케이션 서버를 다시 시작하십시오.
- 생성 및 구성 프로세스가 실패합니다.
- 오류 메시지가 발생됩니다.
이 기능을 사용하지 않으려면 사용자 정의 특성을 삭제하거나 값을 false로 설정하십시오.
#-------------------------------------------------------------------------
# setAllowDeployer.jacl - Jacl script for setting a the allowDeployerRoleGenPluginCfg
property
# of the web server plug-in for WebSphere Application Server
#-------------------------------------------------------------------------
# This Jacl file modifies the server.xml file for an application
server. This script is designed
# to be invoked while the AppServer is running.
#
# Here is an example of how to invoke the script:
# wsadmin -f setAllowDeployer.jacl <nodeName> <serverName> <enableValue>
#------------------------------------------------------------------------
proc printUsageAndExit {} {
puts ""
puts "Usage: wsadmin -f setAllowDeployer.jacl <nodeName> <serverName> <boolEnable>"
puts "Note: enableValue argument is of type boolean; valid values
are true and false."
exit
}
if { [llength $argv] >= 3 } {
set nodename [lindex $argv 0]
set servername [lindex $argv 1]
set enablevalue [lindex $argv 2]
} else {
printUsageAndExit
}
set cellname [$AdminControl getCell]
set propname "allowDeployerRoleGenPluginCfg"
set propdesc "Allow conditional deployer role for plug-in generation
and propagation"
set required "false"
set jvm [$AdminConfig getid
/Cell:${cellname}/Node:${nodename}/Server:${servername}/JavaProcessDef:/JavaVirtualMachine:/]
$AdminConfig modify $jvm [subst {{systemProperties {{{name {$propname}}
{value {$enablevalue}}
{description {$propdesc}} {required {$required}}}}}}]
$AdminConfig save
exit 0
wsadmin -f setAllowDeployer.jacl node_name server_name true
com.ibm.cacheLocalHost
IBM SDK for Java에서 JVM 주기 동안 java/net/InetAddress.getLocalHost에서 리턴된 IP 주소를 캐시하도록 지시하려면 이 특성을 true로 설정하십시오. 이는 프로세스 실행 중에 프로세스의 로컬 호스트 주소가 변경되지 않는 경우 모든 프로세스에 권장하는 성능 개선사항입니다.
com.ibm.apc.nodeMMTimeout
노드를 유지보수 모드에 설정하고 APC를 자동으로 설정하는 경우, 기본적으로 배치 관리자에 의해 유지보수 모드 조작이 20분 후에 제한시간을 초과합니다. 배치 관리자에서 일반 JVM 인수 -DnodeMMTimeout을 설정하고 배치 관리자를 다시 시작하여 이를 변경할 수 있습니다. 예를 들어, -DnodeMMTimeout을 60으로 설정하면 유지보수 모드 조작이 60분 후에 제한시간을 초과합니다. 이와 관련하여 apcConcurrentStartSize는 유지보수 모드 조작을 다루기 위해 APC에서 사용하는 시간을 줄이는데 도움이 될 수 있고, 동적 클러스터에서 min != max와 같은 기타 사항을 고려하면 APC가 변경시켜야 하는 경우를 줄일 수 있습니다.
com.ibm.config.allow.set.session.timeout
web.xml 요소 session-timeout에 적용된 것처럼 PI20040의 동작을 되돌리도록 이 사용자 설치 특성을 설정하십시오.
PI20040에서 제공하는 업데이트된 동작을 얻으려면 이 사용자 정의 특성을 설정되지 않은 상태로 두십시오.
기본 동작은 PI20040의 업데이트된 동작을 얻는 것입니다. 업데이트된 동작은 서블릿 스펙에 따른 올바른 동작이며 session-timeout 값을 작성할 때의 새 기본 동작입니다. 이 사용자 정의 특성은 이전 동작을 다시 사용할 수 있도록 하기 위해 제공됩니다.
com.ibm.config.eclipse.wtp.enablejemtrim
애플리케이션의 메타데이터 XML 구문 분석이 발생한 후 매개체 DOM 노드를 제거할 수 있게 하려면 이 사용자 정의 특성을 사용하십시오.
기본값은 false입니다.
com.ibm.config.eclipse.wtp.enablexmltrim
JavaClass 인스턴스를 공유하고 확장된 JavaClass 및 JavaMethod 오브젝트를 사용한 후 간단한 프록시로 변환할 수 있게 하려면 이 사용자 정의 특성을 사용하십시오.
기본값은 false입니다.
com.ibm.config.eclipse.wtp.jem=finer
com.ibm.config.eclipse.wtp.enablejemtrim 사용자 정의 특성이 true로 설정되는 경우 사용으로 설정되는 코드 영역에서 추적을 생성하려면 이 사용자 정의 특성을 사용하십시오.
com.ibm.config.eclipse.wtp.xmltrim=finer
com.ibm.config.eclipse.wtp.enablexmltrim 사용자 정의 특성이 true으로 설정될 때 사용으로 설정되는 코드 영역으로부터 추적을 생성하려면 이 사용자 정의 특성을 사용하십시오.
com.ibm.disableCommonsElCache
표현식 평가기에서 해시 맵을 보유하고 있어서 메모리 부족 상황을 경험하는 경우 commons-el 표현식 캐시를 사용 안함으로 설정하려면 com.ibm.wsspi.jsp.disableElCache 웹 컨테이너 사용자 정의 특성을 true로 설정하십시오.
기본값은 false입니다.
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
com.ibm.eclipse.wtp.allowRootedEntries
이전 서비스 릴리스에서는 엔터프라이즈 아카이브(EAR) 파일의 루트 디렉토리에 있는 특성 파일을 제대로 읽을 수 없었습니다. 따라서 이 서비스 릴리스 이상에서는, META-INF 및 MANIFEST.MF 파일의 클래스 경로가 상대 URI로 간주되도록 작동이 변경됩니다. 원래 동작으로 되돌리려면, com.ibm.eclipse.wtp.allowRootedEntries를 true로 설정하십시오.
com.ibm.ejs.ras.disablerasnotifications
이 특성을 사용하여 RAS 서비스를 사용하거나 사용하지 않을 수 있습니다. 이 특성을 true로 설정하면 RAS 서비스가 사용되지 않습니다. 이 특성의 기본값은 false입니다.
com.ibm.ejs.ras.writeSystemStreamsDirectlyToFile
WebSphere® Application Server의 형식없이 JSR-47 사용자 정의 로깅을 SystemOut 스트림에 쓰도록 지원하려면 이 사용자 정의 특성을 사용하십시오. WebSphere Application Server의 형식에는 시간소인, 스레드 ID 등의 정보가 포함됩니다. 애플리케이션은 이 정보를 SystemOut 스트림에 표시하고 싶지 않거나 이 정보를 다른 형식으로 표시하고 싶을 수 있습니다. WebSphere Application Server의 형식을 사용하지 않으려면 이 사용자 정의 특성을 true로 설정하십시오.
com.ibm.ejs.sm.server.quiesceInactiveRequestTime
An error occurred while stopping Server1. Check the error logs for more information.
기본값은 5000(5초)입니다.
이 사용자 정의 특성을 사용하기로 결정한 경우, 애플리케이션 서버, 노드 에이전트 또는 배치 관리자에 대한 JVM 사용자 정의 특성으로 지정할 수 있습니다. 이 특성은 일반적으로 애플리케이션 서버의 JVM 사용자 정의 특성으로 설정됩니다.
com.ibm.ejs.sm.server.quiesceTimeout
이 사용자 정의 특성을 사용하기로 결정한 경우, 애플리케이션 서버, 노드 에이전트 또는 배치 관리자에 대한 JVM 사용자 정의 특성으로 지정할 수 있습니다. 이 특성은 일반적으로 애플리케이션 서버의 JVM 사용자 정의 특성으로 설정됩니다.
com.ibm.ffdc.log
제품 런타임 처리 중 장애가 발생할 때 FFDC(First Failure Data Capture) 데이터를 저장할 위치를 지정하려면 이 사용자 정의 특성을 사용하십시오. FFDC 기능은 장애를 일으키는 이벤트 및 오류에 대한 정보를 즉시 수집합니다. 그런 다음, 캡처된 데이터를 사용하여 문제점을 분석할 수 있습니다. 정보가 수집되어 로그 파일에 저장된 후 FFDC는 영향을 받는 엔진에 제어를 리턴합니다.
이름: com.ibm.ffdc.log
값: C:\my_FFDC_CP\
이름: com.ibm.ffdc.log
값: C:\my_FFDC_CP_log
com.ibm.websphere.application.updateapponcluster.waitforappsave
배치 관리자가 업데이트된 애플리케이션을 시작하기 전에 저장 조작의 확장 태스크가 완료될 때까지 대기하는 시간(초)을 지정하려면 이 사용자 정의 특성을 사용하십시오.
일반적으로 롤아웃 업데이트 프로세스를 사용하여 수행하는 애플리케이션 업데이트의 저장 조작 도중에는 저장 조작의 확장 태스크가 별도의 스레드에서 백그라운드 조작으로 실행됩니다. 업데이트 롤아웃 프로세스의 동기화 부분 이전에 저장 조작의 기본 스레드가 완료되면 업데이트된 애플리케이션이 제대로 시작되지 않습니다.
이 사용자 정의 특성을 배치 관리자 설정에 추가하는 경우, 저장 조작의 확장 태스크가 지정된 시간내에 완료되지 않으면 롤아웃 업데이트 프로세스는 애플리케이션 업데이트 프로세스를 중지하여 롤아웃 업데이트 프로세스의 동기화 부분 도중 애플리케이션이 손상되지 않도록 합니다.
기본값은 180입니다.
![[z/OS]](../images/ngzos.gif)
com.ibm.websphere.bean.delete.sleep.time
이 특성을 사용하여 제한시간 종료된 Bean을 확인하는 정리(sweeps) 사이의 시간을 지정합니다. 값은 초 단위로 입력됩니다. 예를 들어 값 120은 2분이 됩니다. 이 특성은 엔터프라이즈 Bean 컨테이너에 아직 가시적인 제한시간 초과된 Bean을 확인하는 하위(servant) 프로세스의 간격도 제어합니다.
기본값은 4200(70분)입니다. 최소값은 60(1분)입니다. 이 값은 관리 콘솔을 통해 변경될 수 있습니다. 이 특성을 적용하려면 제어 및 하위(servant) JVM 사용자 정의 특성 모두에 값을 지정해야 합니다.
com.ibm.websphere.deletejspclasses
해당 애플리케이션을 삭제 또는 업데이트한 후 모든 애플리케이션에 대한 JSP(JavaServer Pages) 클래스를 삭제하도록 표시하려면 이 특성을 사용하십시오.기본값은 false입니다.
애플리케이션 서버가 연합 셀에서 실행되는 경우에는 노드 에이전트에서 이 특성을 설정하십시오.
com.ibm.websphere.deletejspclasses.delete
업데이트 이후가 아니라 해당 애플리케이션을 삭제한 후 모든 애플리케이션에 대한 JSP(JavaServer Pages) 클래스를 삭제하도록 표시하려면 이 특성을 사용하십시오. 기본값은 false입니다.
애플리케이션 서버가 연합 셀에서 실행되는 경우에는 노드 에이전트에서 이 특성을 설정하십시오.
com.ibm.websphere.deletejspclasses.update
삭제 이후가 아니라 해당 애플리케이션을 업데이트한 후 모든 애플리케이션에 대한 JSP(JavaServer Pages) 클래스를 삭제하도록 표시하려면 이 특성을 사용하십시오. 기본값은 false입니다.
애플리케이션 서버가 연합 셀에서 실행되는 경우에는 노드 에이전트에서 이 특성을 설정하십시오.
com.ibm.websphere.ejb.UseEJB61FEPScanPolicy
애플리케이션 설치 프로세스 또는 서버 시작 도중 제품이 Java EE 5 사전 모듈에서 추가 메타데이터를 스캔하는지 여부를 제어하려면 이 특성을 사용하십시오. 기본적으로 이 레거시 EJB 모듈은 스캔되지 않습니다.
기본값은 false입니다.
기본값을 변경할 필요가 있는 각 서버 및 관리 서버에 대해 이 특성을 true로 설정해야 합니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.ejbcontainer.expandCMPCFJNDIName
EJB 컨테이너에서는 사용자의 JNDI 이름에 사용자 정의 Application Server 변수가 포함되는 경우 CMP 연결 팩토리 JNDI 이름을 확장할 수 있어야 합니다. com.ibm.websphere.ejbcontainer.expandCMPCFJNDIName 사용자 정의 특성을 사용하면 CMP 연결 팩토리 JNDI 이름을 확장할 수 있습니다.
값이 true(기본값)이면 EJB 컨테이너는 CMP 연결 팩토리 JNDI 이름에 변수가 있을 때 이를 확장합니다. 값을 false로 설정하면 EJB 컨테이너가 변수를 확장하지 않습니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.ejbcontainer.includeRootExceptionOnRollback
- 로컬 호출자가 트랜잭션을 실행한 경우 트랜잭션 롤백의 근본 원인이 TransactionRolledbackLocalException에 포함되도록 합니다.
- 원격 호출자가 트랜잭션을 실행한 경우에도 커미트 메소드에서 발생한 트랜잭션 롤백의 근본 원인이 TransactionRolledbackLocalException에 포함되도록 합니다.
- 로컬 클라이언트에 대한 TransactionRolledbackLocalException 또는 원격 클라이언트에 대한 TransactionRolledbackLocalException 대신 경험적 예외를 리턴합니다.
- 호출 트랜잭션의 컨텍스트에서 메소드가 실행 중인 경우에도 원격 EJB 메소드로부터 RemoteExcpetion이 리턴되도록 합니다. 예를 들어 EJB1, 메소드 m1이 트랜잭션을 시작하고 EJB2, 메소드 m2를 호출하며 m2가 처리되지 않은 예외를 유발함을 고려하십시오. 이 경우 EJB 스펙은 m1이 TransactionRolledbackException을 받도록 지시합니다. 이 기능이 EJB 스펙 요구사항과 반대인 경우라도 중첩 예외를 포함하는 RemoteException이 TransactionRolledbackException 대신 리턴되도록 하려면 이 특성을 true로 설정하십시오.
이 기능을 사용으로 설정하려면 이 특성을 true로 설정하십시오. 이 기능을 사용 안함으로 설정하려면 이 특성을 false로 설정하십시오.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.jaxrpc.stub.typemapping.per.thread
이 특성을 사용하여 JAX-RPC 런타임에서 스레드 특정 유형의 맵핑 오브젝트를 사용해야 하는지 여부를 표시합니다.
JAX-RPC 런타임은 모든 JAX-RPC 클라이언트에 대해 단일 TypeMappingRegistry 오브젝트를 사용합니다. 이는 의도적인 설계로 사용자가 JAX-RPC 스텁을 작성하여 다중 스레드에서 사용할 수 있게 해줍니다. 그러나 맵핑이 서로 다른 여러 JAX-RPC 웹 서비스가 동시에 호출되면 싱글톤 TypeMappingRegistry는 오염됩니다. 이 상황이 일반적인 경우는 아니지만 시스템에서 발생하면, com.ibm.websphere.jaxrpc.stub.typemapping.per.thread 사용자 정의 특성을 true로 설정하여 스레드 고유의 유형 맵핑 오브젝트를 사용할 수 있음을 JAX-RPC 런타임에 표시하십시오. 이 개별 맵핑 오브젝트를 사용하면 오염 문제를 방지하고 다양한 웹 서비스 호출이 성공합니다.
기본값은 false입니다.
com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine
com.ibm.websphere.logging.useJULThreadID
WebSphere Application Server 로그 파일에서 사용된 스레드 ID 유형을 제어하려면 이 특성을 사용하십시오.
이 특성을 true로 설정하면 LogRecord 인스턴스가 스레드 ID를 검색하는 데 사용됩니다. 이 특성을 false로 설정하면 스레드 인스턴스를 사용하여 스레드 ID를 검색합니다.
기본값은 false입니다.

com.ibm.websphere.management.application.client.EnvEntry_processBindings
이 특성을 사용하여 애플리케이션 배치 중에 환경 항목 값이 처리되는 방식을 지정합니다.
이 특성 값이 false인 경우 배치 디스크립터에서 환경 항목 값을 읽거나 기록합니다. XML 바인딩에서 지정되는 환경 항목 값은 무시됩니다.
이 특성이 지정되지 않거나 true 값이 있으면, XML 바인딩에서 지정되는 환경 항목 값에는 배치 디스크립터에서 지정된 값보다 높은 우선순위가 지정됩니다. 어노테이션의 환경 항목은 처리됩니다. 기본값은 true입니다.
com.ibm.websphere.management.application.client.EnvEntry_processBindings이 사용으로 설정된 상태로 애플리케이션이 배치된 후 내보내져 버전 8.0 이전 환경에서 배치되는 경우, XML 바인딩에 있는 환경 항목 값은 배치 및 런타임 환경 모두에서 인식되지 않습니다.
com.ibm.websphere.management.application.client.EnvEntry_processBindings가 사용 가능한 상태로 애플리케이션이 배치되고 내보내져 버전 8.0 이후 환경에 배치되는 경우, XML 바인딩의 환경 항목 값은 배치 환경에서는 인식하지 못하지만 런타임 환경에서는 인식합니다.
com.ibm.websphere.management.application.fullupdate
애플리케이션이 업데이트될 때 2진 디렉토리를 지우고 업데이트된 EAR 파일의 컨텐츠를 완전히 추출하도록 지정하려면 이 특성을 사용하십시오.
이 특성을 지정하지 않으면 업데이트된 EAR 파일 내의 변경된 각 파일이 노드에서 개별적으로 업데이트되고 동기화됩니다. 많은 파일이 변경되면 이 프로세스는 대형 애플리케이션의 경우 오랜 시간이 소요될 수 있습니다.
- true로 설정하면 애플리케이션이 업데이트될 때 2진 디렉토리를 지우고 업데이트된 EAR 파일의 컨텐츠가 완전히 추출되도록 지정합니다.
- false로 설정하면 애플리케이션이 업데이트될 때 이 EAR 파일 내의 변경된 파일만 노드에서 업데이트된 후 동기화되도록 지정합니다.
- 애플리케이션 모두 대신 특정 애플리케이션에 대해 전체 대체를 수행하려는 경우 com.ibm.websphere.management.application.fullupdateapplication_name 특성을 사용하십시오.
- 배치 관리자 JVM에 이 특성을 정의해야 합니다.
com.ibm.websphere.management.application.fullupdate.application_name
지정된 애플리케이션이 업데이트될 때 이 애플리케이션의 2진 디렉토리를 지우고 업데이트된 EAR 파일의 컨텐츠를 완전히 추출하도록 지정하려면 이 특성을 사용하십시오.
이 특성을 지정하지 않으면 지정된 애플리케이션의 업데이트된 EAR 파일 내 변경된 각 파일이 노드에서 개별적으로 업데이트되고 동기화됩니다. 많은 파일이 변경되면 이 프로세스는 대형 애플리케이션의 경우 오랜 시간이 소요될 수 있습니다.
- true로 설정하면 지정된 애플리케이션이 업데이트될 때 2진 디렉토리를 지우고 업데이트된 EAR 파일의 컨텐츠가 완전히 추출되도록 지정합니다.
- false로 설정하면 지정된 애플리케이션이 업데이트될 때 변경된 파일만 노드에서 업데이트된 후 동기화되도록 지정합니다.
- 2진 디렉토리가 지워지고 애플리케이션을 업데이트할 때마다 업데이트된 EAR 파일의 컨텐츠를 완전히 추출하려는 경우 com.ibm.websphere.management.application.fullupdate 특성을 사용하십시오.
- 배치 관리자 JVM에 이 특성을 정의해야 합니다.
com.ibm.websphere.management.application.persistWebContext
이 특성을 사용하여 웹 모듈의 컨텍스트 루트 및 가상 호스트 정보가 deployment.xml 파일에서 지속되는지 여부를 지정합니다. 이 특성을 지정하지 않은 경우 애플리케이션 배치는 어노테이션 처리에 의존하여 컨텍스트 루트 및 가상 호스트 정보를 읽습니다. 이는 애플리케이션 배치 성능에 영향을 미칩니다.
이 특성을 true로 설정한 경우 웹 모듈의 컨텍스트 루트 및 가상 호스트 정보가 deployment.xml 파일에서 지속되며, 지속된 데이터를 애플리케이션 배치 유효성 검증에 사용하여 애플리케이션 배치 성능을 개선합니다.
기본값은 false입니다. 이는 웹 모듈의 컨텍스트 루트 및 가상 호스트 정보가 deployment.xml 파일에 지속되지 않음을 의미합니다.
com.ibm.websphere.management.application.sync.recycleappasv5
애플리케이션 다시 시작 동작이 제품의 버전 6.x 이전 버전에서의 동작과 동일하게 작동하도록 지정하려면 이 특성을 사용하십시오.
버전 6.x 이상에서는, 애플리케이션 업데이트 또는 편집 조작이 발생한 후 수정된 파일에 따라 애플리케이션이나 모듈이 자동으로 다시 시작됩니다. 이 다시 시작 프로세스는 모든 애플리케이션 구성 파일 변경 및 모든 비정적 파일 변경에 대해 발생합니다.
그러나 제품의 버전 6.x 이전 버전에서는 EAR(Enterprise Archive) 파일 자체가 업데이트되거나 2진 URL 속성이 변경되는 경우에만 애플리케이션이 다시 시작됩니다. 애플리케이션 구성 파일이 변경되는 경우에는 애플리케이션이 다시 시작되지 않습니다.
- true로 설정하면 애플리케이션 다시 시작 동작이 제품의 버전 6.x 이전 버전에서의 동작과 동일하게 작동하도록 지정됩니다.
- false로 설정하면 애플리케이션 다시 시작 동작이 버전 6.x 이상의 동작 스키마에 따라 작동하도록 지정됩니다.
기본값은 false입니다.
com.ibm.websphere.management.application.updateClusterTask.serverStopWaitTimeout
$AdminTask updateAppOnCluster 태스크에서 서버가 완전히 중지될 때까지 배치 관리자가 대기하는 시간(초)을 지정하려면 이 특성을 사용하십시오. 기본적으로 배치 관리자는 60초 동안 기다립니다. 이 특성에 지정하는 시간은 클러스터에서 서버가 중지되는 데 걸리는 가장 오랜 시간보다 길어야 합니다.
이 특성은 버전 7.0.0.1 이상을 사용 중인 경우에만 지정할 수 있습니다.
com.ibm.websphere.management.application.updatesync.appExpansionTimeout
애플리케이션 업데이트 후 애플리케이션 서버가 시작될 때까지 배치 관리자가 대기하는 시간을 지정하려면 이 특성을 사용하십시오. 업데이트 프로세스가 완료된 후 이 대기 시간에 애플리케이션의 2진이 디렉토리로 확장될 수 있습니다. 이 특성에 지정하는 시간은 노드에 상주하는 애플리케이션이 2진을 완전히 확장하는 데 걸리는 최대 시간이어야 합니다.
기본적으로 하나 이상의 애플리케이션이 업데이트된 후 각 애플리케이션 확장이 발생하려면 업데이트 롤아웃 기능이 60초를 대기합니다. 롤아웃 기능을 사용하여 다중 애플리케이션을 동시에 업데이트할 수 있기 때문에 이 특성의 기본값은 n x 60초이며, 여기서 n은 업데이트 중인 애플리케이션의 수입니다.
보다 큰 애플리케이션에는 기본 대기 시간이 충분하지 않을 수 있습니다. 애플리케이션을 업데이트한 후 서버를 시작할 때 이러한 애플리케이션 중 하나 이상이 시작되지 않으면, 서버를 시작하기 전에 롤아웃 업데이트 기능이 대기해야 하는 시간을 좀 더 길게 지정해야 합니다.
com.ibm.websphere.management.configservice.getServerLogRootFromTemplate
서버 템플리트에 정의된 SERVER_ROOT 변수에 대해 값이 지정되었는지 또는 애플리케이션 서버 또는 클러스터 멤버를 작성할 때 {LOG_ROOT}/serverName 값을 사용해야 하는지를 지정하려면 이 특성을 사용하십시오.
애플리케이션 서버나 클러스터 멤버를 작성할 때 기존 서버 템플리트에 정의된 SERVER_ROOT 변수 값 대신 항상 {LOG_ROOT}/serverName 값이 사용됩니다. 애플리케이션 서버 또는 클러스터 멤버를 작성하는 경우, 서버 템플리트에 정의된 SERVER_ROOT 변수 값을 사용하려면 이 특성을 true로 설정하십시오.
이 사용자 정의 특성을 사용할 경우 배치 관리자에 대해 이 특성이 설정되어야 합니다.
연결된 모드에서 wsadmin을 사용할 경우 배치 관리자 레벨에서 이 특성을 설정하려면 AdminTask.setJVMSystemProperties 명령을 사용하십시오.
wsadmin -conntype none -javaoption
"-Dcom.ibm.websphere.management.configservice.getServerLogRootFromTemplate=true"
com.ibm.websphere.management.configservice.sessionIdUniqueness
이 특성을 사용하면 중복되는 구성 세션 또는 작업공간 ID 생성을 피할 수 있습니다. 다른 프로세스에서 같은 밀리초 내에 무작위로 생성된 구성 세션 또는 작업공간 ID를 작성하는 경우, ID가 같을 수 있습니다.
구성 세션 또는 작업공간 ID 생성이 중복되지 않도록 하려면, 이 특성을 애플리케이션 서버 설정에 추가하고 true로 설정하십시오.
AdminTask.setJVMSystemProperties wsadmin 명령 또는 관리 콘솔을 사용하여 이 사용자 정의 특성을 지정할 수 있습니다.
애플리케이션 서버가 연합 셀의 일부인 경우, 변경사항을 저장한 후 노드를 동기화하고, 각 서버를 다시 시작하여 해당 구성 변경사항을 적용해야 합니다.
이 사용자 정의 특성을 사용하기 위해, 배치 관리자 또는 애플리케이션 서버 JVM 사용자 정의 특성으로 지정할 수 있습니다.
com.ibm.websphere.management.configservice.validatePropNames
이 특성을 사용하여 사용자 정의 특성 이름과 wsadmin 명령의 Property 및 J2EEResourceProperty 구성 오브젝트의 이름 값에 대한 문자 제한을 시행할지 여부를 지정합니다.
- 배치 관리자 서버의 JVM(Java Virtual Machine)에서 com.ibm.websphere.management.configservice.validatePropNames Java 시스템 특성을 false로 설정하십시오.
- wsadmin 도구를 로컬 모드에서 사용할 때
-javaoption 매개변수를 사용하여 com.ibm.websphere.management.configservice.validatePropNames
특성을 설정하십시오.
wsadmin -conntype none -javaoption "-Dcom.ibm.websphere.management.configservice.validatePropNames=false"
![[z/OS]](../images/ngzos.gif)
com.ibm.websphere.management.jmx.random
요청을 핫 하위(servant)에 자동으로 지정하지 않고 JMX(Java Management Extensions) 커넥터 요청을 처리할 하위 풀에서 제어기가 초기 하위를 임의로 선택할 수 있게 하려면 이 특성을 사용하십시오.
기본적으로 다중 하위(servant)가 사용 가능하고 애플리케이션 서버가 JMX 연결 요청을 수신하면, 애플리케이션 서버가 첫 번째 하위(핫 하위라고도 함)에 요청을 지정합니다. 이 계획은 페이지 아웃된 하위에 요청이 지정되는 위험을 최소화합니다. 그러나 첫 번째 하위의 워크로드가 가중한 경우에는 이에 따라 해당 하위에 대한 요청이 실패합니다. 그러므로 랜덤 알고리즘을 사용할 경우의 장점은 지정된 서번트가 아직 다른 많은 요청을 처리하지 않는다는 것입니다. 그러나 단점은 선택된 하위가 페이지 아웃되었을 수도 있으며 요청을 처리하기 전에 다시 페이지 인되어야 합니다.
- true는 제어기가 JMX 커넥터 요청을 처리할 하위 풀에서 초기 하위를 임의로 선택하도록 지정합니다.
- false는 제어기가 모든 JMX 커넥터 요청을 핫 하위(servant)에 지정하도록 합니다.
이 사용자 정의 특성을 사용하려면, 제어기에 대한 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool
새로 작성된 스레드 풀에 포함할 수 있는 스레드 수를 제어하려면 이 특성을 사용하십시오. 전용 스레드가 각 애플리케이션 서버 JVM(Java Virtual Machine)을 시작하도록 작성되었습니다. 이 스레드 풀의 전용 스레드가 있는 JVM은 노드 에이전트가 시작될 때마다 동시에 시작되는 JVM입니다.
0 - 5의 정수를 이 특성 값으로 지정할 수 있습니다. 지정한 값이 0보다 큰 경우, 해당 값을 새로 작성된 스레드 풀에 포함할 수 있는 최대 스레드 수로 사용하여 스레드 풀이 작성됩니다. 다음 표에는 이 사용자 정의 특성에 지원되는 값과 영향이 나열됩니다.
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool | 영향 |
---|---|
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool 특성을 0으로 설정하거나 지정하지 않음 | 노드 에이전트가 다섯 개의 JVM을 병렬로 시작합니다. |
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool 특성을 1로 설정함 | 노드 에이전트가 JVM을 계속해서 시작합니다. |
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool 특성을 2와 5 사이의 정수 값으로 설정함 | 노드 에이전트가 지정된 값과 동일한 수의 JVM을 병렬로 시작합니다. |
예를 들어, 노드 에이전트에 running 상태로 설정된 10개의 JVM(즉, 노드 에이전트가 시작할 때마다 시작됨)이 있다고 가정하십시오. 이 특성에 3을 지정하면, 노드 에이전트를 중지하고 시작할 때마다 10개의 JVM 중 세 개만 동시에 시작합니다.
- 관리 콘솔을 사용하고 노드 에이전트의 새 JVM 사용자 정의 특성 이름으로 com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool을 지정하는 경우, 이 새 사용자 정의 특성의 값 필드에 값을 지정해야 합니다. 값을 지정하지 않으면, 오류 메시지가 표시됩니다.
- 명령행에서 공백 값을 특성으로 전달하는 경우, 공백 값은 잘못된 값으로 간주되며 노드 에이전트의 기본 동작이 복원됩니다.
이 특성은 기본적으로 지정되지 않습니다. 이 사용자 정의 특성을 사용하려면, 노드 에이전트 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.management.nodesync.skipWebServerTarget
애플리케이션이 웹 서버만을 대상으로 하는 대상 노드로 애플리케이션 2진이 분배되는지 여부를 제어하려면 이 특성을 사용하십시오.
기본적으로 사용자 정의 특성 값은 false로 설정되어, 애플리케이션 서버가 애플리케이션 2진을 대상 노드로 분배합니다. 이 사용자 정의 특성을 true로 설정하면 애플리케이션 서버가 웹 서버 대상만 포함된 대상 노드로 애플리케이션 2진을 분배하지 않습니다.
wsadmin>$AdminApp isAppReady SuperApp
ADMA5071I: Distribution status check started for application SuperApp.
WebSphere:cell=IBMCell10,node=IBMNode30,distribution=true,expansion=skipped
ADMA5011I: The cleanup of the temp directory for application SuperApp is complete.
ADMA5072I: Distribution status check completed for application SuperApp.
true
- profile_root/bin 디렉토리에서 wsadmin 스크립트 도구를 시작하십시오. 이 디렉토리 내에서 .wsadmin.bat 또는 wsadmin.sh 명령을 시작해야 합니다.
- 다음 중 한 명령을 실행하십시오.
- Jacl 사용
- $AdminTask setJVMSystemProperties {-serverName server_name -nodeName node_name -propertyName com.ibm.websphere.management.nodesync.skipWebServerTarget -propertyValue true}
- Jython 문자열 사용
- AdminTask.setJVMSystemProperties('[-serverName server_name -nodeName node_name -propertyName com.ibm.websphere.management.nodesync.skipWebServerTarget -propertyValue true]')
- Jython 목록 사용
- AdminTask.setJVMSystemProperties (['-serverName', 'server_name', '-nodeName', 'node_name' '-propertyName', 'com.ibm.websphere.management.nodesync.skipWebServerTarget', '-propertyValue', 'true'])
여기서 server_name 및 node_name 변수는 환경에 고유합니다.
- 배치 관리자를 다시 시작하십시오.
com.ibm.websphere.management.processEmbeddedConfigGlobal
배치 중 확장 엔터프라이즈 아카이브(EAR) 파일의 임베디드 구성 처리를 글로벌하게 사용하거나 사용하지 않으려면 이 특성을 사용하십시오. 확장 EAR 파일은 설치된 애플리케이션을 내보낼 때 생성됩니다.
이 사용자 정의 특성은 Process embedded configuration(-processEmbededConfig) 옵션의 기본 설정을 글로벌하게 대체합니다. 기본적으로 프로세스 임베디드 구성은 확장 EAR 파일의 경우 true(선택)로, 기타 모든 EAR 파일에 대해서는 false(선택 취소)로 설정됩니다. 프로세스 임베디드 구성 설정은 확장 EAR 파일 배치 중 제품이 확장 EAR 파일을 확장하는 디렉토리를 판별합니다. 현재 셀 이외의 셀에서 애플리케이션을 내보냈으며 애플리케이션을 처음으로 설치할 때 애플리케이션을 설치할 디렉토리에 $(CELL) 변수를 지정하지 않은 경우, 확장 EAR 파일 배치 중 프로세스 임베디드 구성을 false로 설정하면 확장 EAR 파일이 app_server_root/profiles/installedApps/current_cell_name 디렉토리에 추출됩니다. 그렇지 않은 경우 프로세스 임베디드 구성이 true로 설정되면 확장 EAR 파일이 app_server_root/profiles/installedApps/original_cell_name 디렉토리에 펼쳐지며, 여기서 original_cell_name은 애플리케이션이 처음에 설치된 셀입니다. 애플리케이션을 처음으로 설치할 때 애플리케이션을 설치할 디렉토리에 $(CELL) 변수를 지정한 경우에는 설치 중 확장 EAR 파일이 app_server_root/profiles/installedApps/current_cell_name 디렉토리에 확장됩니다.
이 processEmbeddedConfigGlobal 사용자 정의 특성이 false로 설정되면 제품이 배치 중 확장 EAR 파일을 포함하여 애플리케이션의 임베디드 구성을 처리하지 않습니다. processEmbeddedConfigGlobal을 false로 설정하고 나면 제품이 확장 EAR 파일의 임베디드 구성을 처리하지 않습니다. 그러나 개별 확장 EAR 파일을 배치할 때 프로세스 임베디드 구성을 명시적으로 true로 설정해서 이 false 설정을 대체할 수 있습니다.
이 processEmbeddedConfigGlobal 사용자 정의 특성이 true로 설정되면 제품은 확장 EAR 파일의 임베디드 구성을 처리합니다.
임베디드 구성이 없는 애플리케이션은 processEmbeddedConfigGlobal 사용자 정의 특성이 true 또는 false로 설정되는지 여부와 무관하게, 제품이 일반적인 경우처럼 배치됩니다. 이 설정은 배치에 영향을 주지 않습니다.
![[z/OS]](../images/ngzos.gif)
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
com.ibm.websphere.management.registerServerIORWithLSD
이 특성을 사용하여 연합된 서버가 위치 서비스 디먼에 등록되는지 여부를 제어합니다. 일반적으로 연합 서버에서는 노드 에이전트가 실행되고 있어야 합니다. 서버가 LSD에 등록하지 않고 활성 노드 에이전트에 대한 종속성을 제거하도록 하려면 com.ibm.websphere.management.registerServerIORWithLSD JVM 사용자 정의 특성을 false로 설정하고 ORB_LISTENER_ADDRESS를 0보다 큰 값으로 설정해서 ORB가 고정 포트에서 청취하도록 해야 합니다. ORB_LISTENER_ADDRESS 특성이 0(제로)으로 설정되어 있거나 지정되지 않은 경우 이 특성의 설정은 무시되고 연합 서버가 LSD에 등록됩니다.
노드 에이전트가 실행되고 있지 않은 경우에도 서버를 실행하려면 이 특성을 false로 설정하십시오. 이 특성을 true로 설정하면 연합 서버는 LSD에 등록됩니다. 기본값은 true입니다.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
이 사용자 정의 특성의 값을 변경한 후 이 변경사항이 노드의 server.xml 파일에 반영되기 전에 전체 동기화를 수행해야 합니다. 서버에 대한 노드 에이전트를 시작할 수 없는 경우, server.xml 파일을 수동으로 편집하여 이 사용자 정의 특성의 값을 true에서 false로 변경해야 합니다.
com.ibm.websphere.management.registerServerIORWithLSD 특성을 false로 설정하면, 서버가 ORB_LISTENER_ADDRESS 포트를 동적으로 지정할 때 노드 에이전트에 알리지 않습니다. 또한 노드 에이전트가 서버로 해석할 수 있는 간접 IOR(Interoperable Object References)이 없습니다. 모든 IOR은 직접적이 됩니다. 즉, 노드 에이전트는 정적 ORB_LISTENER_ADDRESS가 서버에 지정된 경우에만 해당 서버에 연결할 수 있습니다.
com.ibm.websphere.management.registerServerIORWithLSD 특성을 설정해도 WLM의 요청 라우팅이나 동적 또는 정적 포트 사용에는 영향이 미치지 않습니다. 그러나 HAManager의 노드 에이전트에서 제공하는 잠재적 장애 조치(failover) 레벨은 유실됩니다.
WLM 처리는 요청의 가중 분산으로 보유됩니다.
com.ibm.websphere.management.soapSocketConnectionTimeout
JMX SOAP 커넥터 소켓이 열린 채로 남아 있는 시간(초)을 지정하려면 이 특성을 사용하십시오. 이 특성에 값을 지정하지 않으면 JMX SOAP 커넥터 소켓 연결은 무한히 열려 있습니다.
com.ibm.websphere.management.useUpdatedPropertyFiles
업데이트된 특성 파일 템플리트를 사용하여 새 메일 세션을 작성하려면 이 특성을 사용하십시오.
업데이트된 특성 파일 구성 템플리트를 사용하여 새 메일 세션을 작성하려면 이 특성을 true로 설정하십시오. 원래 특성 파일 구성 템플리트 대신 업데이트된 특성 파일 구성 템플리트가 사용됩니다.

시스템 특성을 설정한 후에는 변경사항을 저장하십시오. 애플리케이션 서버가 연합 셀의 일부인 경우, 노드를 동기화하여 변경사항을 전파하십시오. 변경사항을 적용하려면 각 서버를 다시 시작하십시오.
이 특성은 기본적으로 사용 가능합니다.
com.ibm.websphere.metadata.ignoreDuplicateRefBindingsInWebModules
J2EE(Java 2 Platform, Enterprise Edition) 버전 1.3 애플리케이션에서 웹 모듈에 대한 DTD 파일의 중복 참조 바인딩 인스턴스를 JVM이 무시하는지 여부를 제어하려면 이 특성을 사용하십시오. 일반적으로 MetaDataException은 J2EE(Java 2 Platform, Enterprise Edition) 버전 1.3 애플리케이션에서 웹 모듈에 대한 DTD 파일에 중복 참조가 있을 때 발생합니다.
웹 모듈에 대한 DTD 파일 표준에서는 참조 바인딩에 고유한 이름 필드가 있어야 함이 명시되어 있습니다. 따라서 중복 참조 바인딩이 있는 웹 모듈이 포함된 애플리케이션은 기술적으로 준수되지 않는 애플리케이션입니다.
웹 모듈에 대한 DTD 파일 표준에서 사용자가 중복된 참조 바인딩을 정의하지 못하도록 금지하더라도 7.0 이전 제품 버전에서 JVM은 중복된 참조 바인딩을 허용합니다. J2EE(Java 2 Platform, Enterprise Edition) 버전 1.3 애플리케이션에서 중복 참조 바인딩이 포함된 웹 모듈에 대한 DTD 파일이 있는 경우, 중복 참조를 제거하거나 이 특성을 JVM 구성 설정에 추가하고 특성을 true로 설정할 수 있습니다.
com.ibm.websphere.network.useMultiHome
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
- true는 제품이 호스트의 모든 IP 주소에서 Discovery 및 SOAP 메시지를 청취하도록 지정합니다.
- false는 구성된 호스트 이름에서만 제품이 Discovery 및 SOAP 메시지를 청취하도록 지정합니다. 이 특성을 false로 설정하면, 특정 IP 주소로 해석되는 호스트 이름이 제품에서 구성되어야 합니다.
- null은 제품이 기본 IP 주소에서만 청취하도록 지정합니다.
![[z/OS]](../images/ngzos.gif)
- 특정 IP 주소로 해석되는 호스트 이름이 제품에 구성되어 있어야 합니다.
- 배치 관리자, 모든 애플리케이션 서버 및 노드 에이전트의 엔드포인트 특성이 이 호스트 이름으로 설정되어 있는지 확인해야 합니다. 배치 관리자의 경우, 설정되어야 하는 엔드포인트는 CELL_DISCOVERY_ADDRESS 및 SOAP_CONNECTOR_ADDRESS입니다. 노드 에이전트 및 애플리케이션 서버의 경우, SOAP_CONNECTOR_ADDRESS 엔드포인트만 설정되어야 합니다.
서버에 접속할 수 없으면 올바른지 확인하기 위해 com.ibm.websphere.network.useMultihome 설정을 확인하십시오. 관리 콘솔을 통해 이 값을 변경할 수 있습니다. 서버, 배치 관리자 및 노드 에이전트에 대한 값을 설정하여 기본값을 수정하십시오. 변경을 적용하기 전에 서버를 다시 시작해야 합니다.
com.ibm.websphere.perf.tuning.disableRPARepositoryCache
RPA가 사용 불가능한 경우 서버 구성 세부사항이 캐싱되지 않도록 하려면 이 특성을 사용하십시오.
RPA는 서버의 구성 세부사항을 저장하는 저장소 캐시를 사용합니다. RPA 및 PMI가 사용 불가능한 경우에도 이 캐시는 초기화되고 구성 세부사항은 저장됩니다. 저장소 캐시는 3000개 이상의 데이터 소스가 있는 설치와 같이 초대형 설치에 대해서는 커질 수 있습니다. 이 저장소 캐시의 크기 때문에 성능 문제가 발생하는 경우 RPA는 사용 불가능하게 되며 이 특성을 JVM 구성 설정에 추가하고 true로 설정하십시오. RPA가 사용 가능한 경우 또는 이 저장소 캐시의 크기 때문에 성능 문제가 발생하지 않는 경우 이 사용자 정의 특성을 사용하면 안됩니다.
이 특성의 기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.resource.xmlConfigMaxLineLength
XML 구성 문서에 대해 선호하는 최대 행 길이를 지정하려면 이 특성을 사용하십시오.
server.xml 파일의 시작 행은 종종 2048자를 초과합니다. z/OS 등 일부 운영 체제의 일반 텍스트 편집 도구는 2048자를 넘는 행을 처리할 수 없습니다. 그러므로 2048자를 넘는 행이 포함된 파일을 편집하고 저장하는 경우 해당 행이 잘립니다. 행이 잘리면 구성 파일을 사용할 수 없게 되고 서버 시작에 실패합니다.
이 특성 값을 지정하면 XML 구성 문서를 편집하고 저장할 때 행의 문자 수가 지정된 최대 문자 수에 도달한 후 바로 행 바꾸기가 실행됩니다. 행 바꾸기는 논리적 바꾸기 지점에서 계속 실행되는 데 이는 행의 길이가 지정된 최대값을 여전히 초과하기 때문입니다. 그러므로 이 특성에 대해 지정하는 값은 문서에서 행 수가 2048자를 초과하지 않도록 지정된 최대값을 초과할 수 있는 문자 수를 고려해야 합니다.
이 특성 값을 지정하지 않으면 행 길이에 대한 제한이 없습니다.
이 특성 값의 범위는 80 - 2046(80과 2046 포함)의 정수입니다.
이 특성에 대한 기본값은 없습니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.sib.webservices.useTypeSoapArray
- 생성된 기본 RPC-인코드 웹 서비스 문자열 배열 메시지는 일부 대상 서비스 제공자와 상호 운용되지 않습니다.
- 생성된 문자열 배열 메시지는 상호 운용될 수 있는 동등한 표준 JAX-RPC와 정확하게 동일하지 않습니다.
- 서비스 통합 버스 메시지:
<partname env:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/ xsi:type='ns1:ArrayOf_xsd_string'> <item xsi:type='xsd:anySimpleType'>namevalue</item> </partname>
- JAX-RPC 클라이언트 메시지:
<partname xsi:type="soapenc:Array" soapenc:arrayType="xsd:string[1]"> <item>namevalue</item> </partname>
기본 작동을 수정하고 표준 JAX-RPC와 완전히 호환되는 문자열 배열 메시지를 전송하려면 이 특성을 true로 설정하십시오. 이 특성을 설정하면 서비스 통합 버스에서 전송된 모든 아웃바운드 JMS 웹 서비스 호출의 기본 작동이 수정됩니다.
com.ibm.websphere.webservices.attachment.tempfile.expiration
JAX-WS 또는 Service Component Architecture(SCA) 클라이언트 또는 서비스에서 첨부의 만기 시간(초)을 표시하려면 이 특성을 사용하십시오. 만기 시간보다 긴 기간 동안 첨부에 액세스하지 않은 경우, 웹 서비스 런타임 시 첨부를 삭제할 수 있습니다.
JAX-RPC 프로그래밍 모델을 사용하면 수신되는 웹 서비스 메시지의 첨부에 액세스할 수 있습니다. 첨부에 즉시 액세스하거나 나중에 처리하기 위해 저장할 수 있습니다. 그러므로 웹 서비스 런타임이 첨부를 안전하게 해제시킨 후의 시간 길이가 정확하지 않으므로 첨부와 연관된 메모리는 웹 서비스 상호작용의 지속 기간보다 훨씬 오래 지속될 수 있습니다.
소형 첨부의 경우, 메모리는 최종적으로 Java 가비지 콜렉터에 의해 해제됩니다.
대형 첨부의 경우, JAX-RPC 런타임은 첨부 데이터를 임시 파일에 저장하므로 런타임은 메모리를 사용하지 않고 초대형 첨부를 처리할 수 있습니다. 애플리케이션이 첨부에 액세스하지 않거나 애플리케이션이 첨부와 연관된 데이터 핸들러를 적절하게 닫지 않는 경우, 대형 임시 파일이 삭제되지 않습니다. 이러한 임시 첨부 파일에 만기 시간이 지정되지 않은 경우, 시간이 지남에 따라 해당 파일은 파일 시스템에 누적될 수 있습니다.

이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.webservices.attachements.maxMemCacheSize
JAX-RPC 클라이언트 또는 서비스에서 메모리에 쓸 수 있는 최대 첨부 크기(KB)를 지정하려면 이 특성을 사용하십시오. 예를 들어 웹 서비스에서 20MB 첨부를 전송해야 하는 경우에는 특성을 20480으로 설정하십시오.
이 특성의 값을 결정할 때에는 최대 캐시 크기가 클수록 성능에 미치는 영향이 커져서 잠재적으로 Java 힙에도 영향이 미침에 유의하십시오.
이 특성의 값을 지정하지 않는 경우 캐시 첨부에 사용되는 최대 메모리는 이 특성의 기본값인 32KB입니다.

이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.webservices.DisableIBMJAXWSEngine
서버 레벨의 웹 서비스 어노테이션 스캔을 사용하지 않으려면 이 특성을 사용하십시오. 기본적으로 웹 서비스 어노테이션 스캔은 서버 레벨에서 사용 가능합니다.
애플리케이션 레벨의 어노테이션 스캔을 사용하지 않으려면 EJB 모듈 또는 WAR 파일의 META-INF/MANIFEST.MF에서 DisableIBMJAXWSEngine 특성을 true로 설정하십시오.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.webservices.http.OneWayConnectionRecycleTime
단방향 연결을 재사용하기 전에 웹 서비스 엔진이 대기해야 하는 시간(초)을 지정하려면 이 특성을 사용하십시오. 단방향 연결을 너무 빨리 다시 사용할 경우 SocketTimeoutException 같은 제한시간 문제때문에 클라이언트에서 웹 서비스 조작이 실패할 수 있습니다.
이 특성에 대한 값이 지정된 경우 요청을 전송한 시점부터 시작하여 지정한 시간(초)이 경과할 때까지 단방향 연결이 다시 설정되지 않습니다.
기본적으로 이 특성은 설정되어 있지 않으며 요청이 전송된 후 단방향 연결이 즉시 재설정됩니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.webservices.http.waitingThreadsThreshold
소프트 연결이 해제되기 전에 허용되는 대기 연결 요청의 수를 지정하려면 이 특성을 사용하십시오. 소프트 연결은 연결이 닫힌 후 클라이언트 엔진이 일부 호스트에 대한 연결 오브젝트를 유지보수할 때 발생합니다. 기본적으로 5개의 스레드가 연결을 대기한 후 클라이언트 엔진이 소프트 연결을 해제합니다.
이 사용자 정의 특성의 기본값은 5입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.webservices.jaxrpc.client.publishwsdl
클라이언트 웹 모듈에 대해 WSDL 파일이 공개되는지 여부를 지정합니다. 이 특성이 true로 설정되어 있을 때 애플리케이션에 클라이언트 웹 모듈이 포함되면 이 클라이언트에 대해 WSDL 파일이 공개될 수 있습니다. 클라이언트 애플리케이션에 대해 WSDL 파일을 공개하지 않으려면 이 특성을 false로 설정하십시오.
기본값은 true입니다.
- 클라이언트만 포함된 JAX-RPC 애플리케이션의 경우 WSDL 파일 공개가 불가능합니다.
- JAX-WS 애플리케이션에는 이 특성을 사용할 수 없습니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.management.connector.http.header.includeProductVersion
SOAP 포트 HTTP 응답 헤더에 서버 버전 정보를 포함하려면 이것을 true 값으로 설정하십시오. 기본값은 false입니다.
com.ibm.websphere.webservices.jaxws.setLinkValuePrecedence
JAX-WS 런타임 환경에서 링크 값의 우선순위를 지정하려면 이 특성을 사용하십시오.
이 특성을 true로 설정하면 배치 디스크립터 링크 값은 어노테이션 링크 값보다 우선순위를 갖습니다.
기본값은 false입니다.
com.ibm.websphere.webservices.soap.enable.legacy.get.behavior
com.ibm.websphere.webservices.tempAttachDir
웹 서비스 런타임에 SOAP 메시지의 일부로 전송 또는 수신 중인 32KB보다 큰 첨부의 사본을 캐시하려는 스토리지 디바이스의 위치를 지정하려면 이 특성을 사용하십시오.
성능상의 이유로, 웹 서비스 런타임은 크기가 32KB보다 큰 SOAP 메시지 첨부의 임시 사본을 캐시합니다. 이 특성의 값을 지정하지 않으면 일반적으로 첨부의 캐시된 사본이 운영 체제의 기본 임시 디렉토리로 전송됩니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.webservices.transport.jms.messageType
요청 및 응답 메시지를 전송할 때 SOAP/JMS 컴포넌트에 대한 웹 서비스 엔진에 사용되는 JMS 메시지 유형을 제어하려면 이 특성을 사용하십시오. JMS BytesMessage(javax.jms.BytesMessage) 오브젝트를 지정하려면, 특성을 BYTES로 설정하여 메시지 본문이 2진 데이터임을 표시하십시오. JMS TextMessage(javax.jms.TextMessage) 오브젝트를 지정하려면, 특성을 TEXT로 설정하여 메시지 본문이 문자열 데이터임을 표시하십시오.
이 사용자 정의 특성의 기본값은 BYTES입니다.
SOAP/JMS 메시지 유형에 대해 더 학습하려면 SOAP/JMS 메시지 유형 구성 정보를 참조하십시오.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.webservices.transport.OPTIMIZE_HTTP_HEADERS
버전 8 이전에서는 WebSphere Application Server용 JAX-WS 클라이언트 애플리케이션이 SOAP 메시지의 SAVE_CONNECTION HTTP 헤더를 전송할 수도 있었습니다. 이 추가 헤더로 인해 JAX-WS 웹 서비스를 호스트 중인 애플리케이션 서버에서 적절한 처리가 발생합니다. 그러나 클라이언트용 애플리케이션 서버 및 웹 서비스용 애플리케이션 서버 호스트가 모두 WebSphere Application Server 버전 7.0 수정팩 3 이상을 사용 중인 경우에는 이 SAVE_CONNECTION 헤더 및 추가 처리가 필요하지 않습니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.webservices.transport.ssl.loadFromPolicyBinding
클라이언트가 관리 클라이언트이고 클라이언트와 서버가 서로 다른 애플리케이션 서버에 있을 때 JAX-WS 애플리케이션에 SSL 전송 바인딩 또는 시스템 기본 SSL 설정이 사용되는지 여부를 제어하려면 이 특성을 사용하십시오.
SSL 바인딩을 작성하면 이 특성이 자동으로 바인딩 파일에 추가되어 true로 설정됩니다. 이 설정은 클라이언트가 관리 클라이언트이고 클라이언트와 서버가 서로 다른 애플리케이션 서버에 있을 때 JAX-WS 애플리케이션에 SSL 전송 바인딩을 사용할 수 있도록 합니다. JAX-WS 애플리케이션에 바인딩이 첨부되지 않은 경우에는 이 특성을 false로 설정하십시오.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.webservices.UseWSFEP61ScanPolicy
반 관리 서비스 클라이언트 및 JAXWS 컴포넌트에 대한 WAR 2.4 이전 모듈이 제품에서 스캔되는지 여부를 제어하려면 이 특성을 사용하십시오. 기본적으로 레거시 WAR 모듈은 반 관리 서비스 클라이언트에 대한 스캔일 뿐입니다.
기본값은 false입니다.
기본값을 변경할 필요가 있는 각 서버 및 관리 서버에 대해 이 특성을 true로 설정해야 합니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.webservices.WSDL_Generation_Extra_ClassPath
Caused by: java.lang.NoClassDefFoundError
...
at com.ibm.ws.websvcs.wsdl.WASWSDLGenerator.wsgen(WASWSDLGenerator.java:521)
at com.ibm.ws.websvcs.wsdl.WASWSDLGenerator.generateWsdl(WASWSDLGenerator.java:183)
누락
클래스 파일에 완전한 위치를 제공하려면 이 특성을
사용하십시오. 이 사용자 정의 특성을 사용하여 여러 JAR(Java Archives) 및
디렉토리의 완전한 경로를 제공하고 세미콜론(;)을 사용하여 구분할 수 있습니다.
![[z/OS]](../images/ngzos.gif)
예: D:\sharedlibs;D:\libs\WSBean.jar
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
![[z/OS]](../images/ngzos.gif)
![[z/OS]](../images/ngzos.gif)
- 애플리케이션 서버>[SERVER_NAME]>프로세스 정의>하위>JVM(Java Virtial Machine)>사용자 정의 특성
- 애플리케이션 서버>[SERVER_NAME]>프로세스 정의>제어>JVM(Java Virtial Machine)>사용자 정의 특성
com.ibm.websphere.websvcs.EJBPostInvokeCallOnException
웹 서비스에서 호출된 EJB(Enterprise JavaBeans)에서 예외를 뒤따르는 상태 및 트랜잭션을 정리하려면 이 특성을 사용하십시오.
JAX-WS 웹 서비스를 사용하는 WebSphere Application Server의 설치에서 웹 서비스의 일부로 호출된 EJB에 예외가 발생하면 트랜잭션은 스레드에서 활성으로 유지되고 현재 XA 트랜잭션 플로우와 연관된 트랜잭션은 재개되지 않습니다. 상태와 트랜잭션을 완전하게 정리하려면 이 특성을 true로 설정하십시오.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.websphere.workspace.decodeclustervariable
관리 콘솔에서 정의된 로그 파일 경로에 변수가 발생하는 경우 클러스터 범위에서 정의된 변수를 확장하려면 이 특성을 사용하십시오.
이 특성을 설정하지 않고 클러스터 범위의 변수를 사용하여 로그 파일 경로를 정의한 경우에는 배치 관리자가 요청한 로그 파일을 검색하는 데 실패할 수 있습니다. 그러므로 로그 파일 경로에 클러스터 범위의 변수가 포함된 경우 배치 관리자 JVM 설정에 이 특성을 추가해야 합니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하기로 결정한 경우, 배치 관리자 JVM 사용자 정의 특성으로 지정해야 합니다. 이 특성을 true로 설정한 후, 이 변경을 적용하려면 배치 관리자를 다시 시작해야 합니다.
com.ibm.websphere.wsrm.MaxSequenceBacklog
이 특성을 사용하여 아웃바운드 WS-RM 시퀀스에서 메시지의 최대 수를 구성할 수 있습니다.
정의된 한계에 도달하면 WS-RM은 백로그가 한계 아래로 줄어들 때까지 javax.xml.ws.WebServiceException 예외를 처리하여 새 메시지를 거부합니다. 예외를 수신하는 클라이언트는 요청을 재시도해야 합니다.
설정된 기본값은 없습니다. 값 설정이 정의되지 않은 경우 백로그 한계는 무한합니다.
com.ibm.websphere.wsrm.MessageContextCacheSize
인메모리 캐시의 최대 크기를 양의 정수 값으로 설정하려면 이 특성을 사용하십시오.
설정된 기본값은 없습니다. 캐시의 크기는 무한합니다.
com.ibm.websphere.wsrm.pollingInterval
시퀀스에 대해 MakeConnection 요청이 작성되는 빈도를 지정하려면 이 특성을 사용하십시오.
값은 간격을 밀리초 단위로 지정합니다. 이 특성이 설정되지 않은 경우 기본 동작은 3000밀리초입니다.
com.ibm.websphere.wsrm.retransmissionInterval
메시지를 전송하려는 이전 시도가 실패한 경우 WS-RM이 애플리케이션 메시지를 재전송하는 빈도를 지정하려면 이 특성을 사용하십시오.
값은 간격을 밀리초 단위로 지정합니다. 이 특성이 설정되지 않은 경우 기본 동작은 15000밀리초입니다.
![[z/OS]](../images/ngzos.gif)
com.ibm.websphere.zos.userdir.useRacfSettings
이 특성이 false로 설정되면 user.dir이 WebSphere Application Server 코드에 의해 /profiles/ 디렉토리 앞에 있는 구성 파일 시스템 경로의 일부인 ${USER_INSTALL_ROOT}로 설정됩니다.
이 특성이 true로 설정되면 user.dir이 WebSphere Application Server 코드에 의해 설정되지 않습니다. 대신, USS 설정이 적용될 수 있도록 함으로써 user.dir이 설정됩니다(user.dir == OMVS 세그먼트 홈 디렉토리).
WebSphere Application Server가 이 특성을 설정하지 않으므로 사용자는 하위 JVM 사용자 정의 특성에 user.dir을 원하는 값으로 정의할 수 있습니다. user.dir을 정의하고 나면 Java 코드가 옵션 파일 servant.jvm.options를 통해 이를 설정합니다.
com.ibm.ws.amm.require.produces.annotation.for.cdi
WebSphere Application Server는 @Produces 어노테이션이 CDI Bean에 존재하지 않는 한 다음 어노테이션(@EJB, @WebServiceRef, @PersistenceContext, @PersistenceUnit, @Resource)을 올바르지 않게 무시합니다. @Produces 어노테이션이 있어야 한다는 Java EE 요구사항은 없으므로 이 동작은 잘못된 동작입니다. 기존 애플리케이션이 이 잘못된 동작에 대한 종속성을 가지고 있기 때문에 스펙(잘못된 동작)은 기본으로 남아 있습니다. 이 사용자 정의 특성은 특성을 false로 설정하여 스펙(올바른 동작)을 얻기 위해 제공됩니다.
- 사용자의 애플리케이션은 CDI Bean을 포함함
- CDI Bean은 다음 어노테이션을 포함합니다. @EJB, @WebServiceRef, @PersistenceContext, @PersistenceUnit, @Resource
- CDI Bean은 @Produces 어노테이션을 포함하지 않음
com.ibm.ws.amm.scan.context.filter.archives
어노테이션이 포함되지 않은 유틸리티 JAR 파일이나 아카이브 목록을 제공하려면 이 특성을 사용하십시오. 이 특성에 대해 지정된 아카이브 또는 유틸리티 JAR 파일은 어노테이션을 위해 스캔되지 않습니다.
Java Platform, Enterprise Edition(Java EE) 5 또는 6 애플리케이션이 배치 또는 업데이트된 경우 AMM(Annotations Metadata Manager) 기능에서 모든 어노테이션 메타데이터를 스캔합니다. 이 스캐닝 프로세스는 애플리케이션 배치에 필요한 시간에 부정적인 영향을 줄 수 있습니다. 어노테이션이 없는 유틸리티나 아카이브가 애플리케이션에 포함되어 있으면 이 아카이브와 유틸리티를 이 특성의 값으로 나열할 수 있습니다. 어노테이션이 없는 Java 패키지가 애플리케이션에 포함된 경우에는 이 패키지를 Ignore-Scanning-Packages 특성의 값으로 나열할 수 있습니다.
이러한 특성에 대해 지정된 값에서는 대소문자가 구분되며, 쉼표 뒤에 아카이브 또는 유틸리티 JAR 파일의 이름을 구분할 때 사용되는 공백이 오는 단일 문자열로 표현되어야 합니다. 와일드카드 및 REGEX 표현식은 허용되지 않습니다.
- was_home/properties 디렉토리에 있는 amm.filter.properties 파일
- profile_home/properties 디렉토리에 있는 amm.filter.properties 파일
- 애플리케이션의 Manifest 파일, META-INF/MANIFEST.MF
- 애플리케이션 내 웹 또는 EJB(Enterprise JavaBeans) 모듈의 Manifest
amm.filter.properties 파일에 지정된 값은 이 사용자 정의 특성에 있는 값으로 병합되어 서버 범위의 필터 세트를 형성합니다. 이 병합된 필터 세트는 해당 서버에 배치되는 모든 애플리케이션에 적용됩니다.
애플리케이션의 Manifest 파일에 지정된 값은 서버 범위의 필터 세트와 병합되어 이 애플리케이션 내의 모든 모듈에 적용되는 모듈 범위의 수퍼세트를 형성합니다.
웹 또는 EJB(Enterprise JavaBeans) 모듈의 Manifest 파일에 지정된 값은 모듈 범위의 필터 세트와 병합됩니다. 이 병합된 필터 세트는 해당 모듈에만 적용됩니다.
Ignore-Scanning-Archives : ant.jar, avalon-framework-4.2.0.jar, axis.jar, CICS.jar, xerces.jar
com.ibm.ws.amm.scan.context.filter.disable.unifyTrue
AMM(Annotations Metadata Manager)에 의한 어노테이션 스캐닝에서 특정 JAR 파일을 필터링해야 하지만 ECS(Extensible Class Scanner) 계층에서 스캐닝되게 하려는 경우에만 이 특성을 사용하십시오. 이 특성을 사용하도록 설정하려면 값을 true로 설정하십시오.
기본값은 false입니다.
com.ibm.ws.amm.scan.context.filter.packages.
어노테이션이 포함되지 않은 Java 패키지 목록을 제공하려면 이 특성을 사용하십시오. 이 특성에 지정된 Java 클래스에 대해서는 어노테이션을 스캔하지 않습니다.
Java Platform, Enterprise Edition(Java EE) 5 또는 6 애플리케이션이 배치 또는 업데이트된 경우 AMM(Annotations Metadata Manager) 기능에서 모든 어노테이션 메타데이터를 스캔합니다. 이 스캔 프로세스는 애플리케이션을 배치하는 데 필요한 시간에 부정적인 영향을 줄 수 있습니다. 어노테이션이 없는 Java 패키지가 애플리케이션에 포함된 경우에는 패키지를 이 특성의 값으로 나열할 수 있습니다. 어노테이션이 없는 유틸리티나 아카이브가 애플리케이션에 포함된 경우에는 이 아카이브나 유틸리티를 Ignore-Scanning-Archives 특성의 값으로 나열할 수 있습니다.
이 특성에 대해 지정되는 값은 대소문자가 구분되고, 쉼표 뒤에 Java 패키지의 이름을 구분할 때 사용되는 공백이 오는 단일 문자열로 표현되어야 합니다. 와일드카드 및 REGEX 표현식은 허용되지 않습니다.
- was_home/properties 디렉토리에 있는 amm.filter.properties 파일
- profile_home/properties 디렉토리에 있는 amm.filter.properties 파일
- 애플리케이션의 Manifest 파일, META-INF/MANIFEST.MF
- 애플리케이션 내 웹 또는 EJB(Enterprise JavaBeans) 모듈의 Manifest
amm.filter.properties 파일에 지정된 값은 이 사용자 정의 특성에 있는 값과 병합되어 서버 범위의 필터 세트를 형성합니다. 이 병합된 필터 세트는 해당 서버에 배치되는 모든 애플리케이션에 적용됩니다.
애플리케이션의 Manifest 파일에 지정된 값은 서버 범위의 필터 세트와 병합되어 해당 애플리케이션 내의 모든 모듈에 적용되는 모듈 범위의 수퍼세트를 형성합니다.
웹 또는 EJB(Enterprise JavaBeans) 모듈의 Manifest 파일에서 지정된 값은 모듈 범위의 필터 세트와 병합됩니다. 이 병합된 필터 세트는 해당 모듈에만 적용됩니다.
Ignore-Scanning-Packages : org.apache.avalon, org.apache.batik, org.apache.commons
com.ibm.ws.application.enhancedScanning
- 모듈 파일의 새 캐시
- 모듈 클래스 로드용 새 캐시
- 어노테이션 처리를 위한 대체 코드 경로
com.ibm.ws.cache.CacheConfig.alwaysSetSurrogateControlHdr
동적 캐시 서비스의 대리 제어 헤더를 응답에 항상 설정하도록 강제 실행하려면 이 특성을 사용하십시오. 대리 제어 헤더에는 ESI(Edge Side Include) 처리를 올바르게 생성하고 ESI 캐시의 캐시된 컨텐츠를 무효화해야 하는 메터데이터가 포함되어 있습니다.
기본값은 false이며 대리 제어 헤더가 응답에 설정되지 않을 수 있음을 의미합니다.
이 사용자 정의 특성을 사용하려면, 달리 명시되어 있지 않은 한 특정 태스크의 컨텍스트에 애플리케이션 서버 JVM 사용자 정의 특성으로 지정하십시오.
com.ibm.ws.cache.CacheConfig.cascadeCachespecProperties
하위 페이지나 단편에 상위 페이지나 단편의 계단식 속성 저장 및 쿠키 저장 특성이 상속되도록 하려면 이 특성을 사용하십시오. 기본값은 false입니다.
동적 캐시 서비스의 기본 작동은 캐시 스펙에 명시적으로 대체하도록 지정된 경우가 아니면 하위 페이지나 단편의 요청 속성을 저장하는 것입니다. 이 요청 속성이 너무 큰 시나리오의 경우 애플리케이션 서버에 메모리 부족 조건이 발생할 수 있습니다. 기본적으로 저장된 속성이 직렬화 가능하지 않으면 이 캐시 항목의 디스크 오프로드로 인해 java.io.NotSerializableExceptions가 발생합니다.
이 사용자 정의 특성을 사용하려면, 달리 명시되어 있지 않은 한 특정 태스크의 컨텍스트에 애플리케이션 서버 JVM 사용자 정의 특성으로 지정하십시오.
com.ibm.ws.cache.CacheConfig.filteredStatusCodes
동적 캐시 서비스에서 서블릿 출력을 캐시하지 않는 오류 상황을 나타내려면 이 특성을 사용하십시오.
이 특성에 지정된 값은 공백으로 구분된 HTTP 응답 오류 코드 목록입니다. 캐시 미스에서 리턴되는 상태 코드가 나열되는 응답 오류 코드 중 하나와 일치하면, 동적 캐시 서비스가 HTTP 요청에 대한 응답에서 확보한 데이터를 캐시하지 않습니다.
이 사용자 정의 특성을 사용하려면, 달리 명시되어 있지 않은 한 특정 태스크의 컨텍스트에 애플리케이션 서버 JVM 사용자 정의 특성으로 지정하십시오.
com.ibm.ws.cache.CacheConfig.use61EntrySetBehavior
맵에 포함된 맵핑의 세트 보기를 리턴하려면 이 특성을 사용하십시오.
com.ibm.ws.cache.CacheConfig.use61EntrySetBehavior가 정의되고 true로 설정되면 DistributedMap.entrySet() 메소드가 맵에 포함된 맵핑의 세트 보기를 리턴합니다.
이 사용자 정의 특성은
에서 JVM 사용자 정의 특성으로 설정할 수 있습니다.이 JVM 사용자 정의 특성 정의는 모든 캐시 인스턴스에 영향을 줍니다. 이 특성은 애플리케이션 서버 레벨에서 지정됩니다.
com.ibm.ws.cache.CacheConfig.useServerClassLoader
InvalidationEvent를 직렬화 해제할 때 JVM에서 사용해야 할 클래스 로더를 지정하려면 이 특성을 사용하십시오. 이 특성을 true로 설정하면 서버 클래스 로더가 InvalidationEvent를 직렬화 해제하는 데 사용됩니다. 이 특성을 false로 설정하면 애플리케이션 클래스 로더가 InvalidationEvent를 직렬화 해제하는 데 사용됩니다. 기본값은 false입니다.
InvalidationEvent를 직렬화 해제할 때 적절한 클래스 로더를 사용하면 성능이 개선됩니다.
이 사용자 정의 특성을 사용하려면, 달리 명시되어 있지 않은 한 특정 태스크의 컨텍스트에 애플리케이션 서버 JVM 사용자 정의 특성으로 지정하십시오.
com.ibm.ws.CacheConfig.alwaysTriggerCommandInvalidations
skipCache 속성과 무관하게 명령 무효화가 트리거되도록 하려면 이 특성을 사용하십시오.
요청 오브젝트에 <previewRequest> 속성이 포함되어 있으면 동적 캐시는 skipCache 속성을 true로 설정합니다. skipCache 속성이 true인 경우 명령이 항상 무효화되지는 않습니다. skipCache 속성과 무관하게 명령 무효화가 트리거되도록 하려면 com.ibm.ws.CacheConfig.alwaysTriggerCommandInvalidations 사용자 정의 특성을 true로 설정하십시오. 이 사용자 정의 특성은 설정되면 모든 캐시 인스턴스에 영향을 줍니다. 기본값은 false입니다.
이 사용자 정의 특성은 애플리케이션 서버 레벨에서만 설정됩니다.
이 사용자 정의 특성을 사용하려면, 달리 명시되어 있지 않은 한 특정 태스크의 컨텍스트에 애플리케이션 서버 JVM 사용자 정의 특성으로 지정하십시오.
com.ibm.ws.cdi.immediate.ejb.start
애플리케이션이 시작할 때 모든 EJB 모듈에 대해 CDI(contexts and dependency injection) 컨테이너 및 해당 라이프사이클이 시작되도록 하려면 이 특성을 사용하십시오.
이 특성이 true 값으로 설정되면, 애플리케이션이 시작될 때 모든 EJB 모듈에 대해 CDI 컨테이너와 해당 라이프사이클이 시작됩니다. 이 특성의 기본값은 false입니다.
com.ibm.ws.classloader.allowDisposedClassLoad
애플리케이션이 중지될 때 JVM이 애플리케이션 클래스 로더를 완전히 처리해야 하는지 여부를 지정하려면 이 특성을 사용하십시오. JVM이 애플리케이션 클래스 로더를 완전히 처리하지 않는 경우, 해당 클래스 로더에서 클래스를 계속 로드할 수 있습니다.
이 특성이 true 값으로 설정되면 애플리케이션이 중지될 때 JVM이 애플리케이션 클래스 로더를 완전히 처리하지 않습니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.classloader.encodeResourceURLs
애플리케이션 클래스 로더(예: EAR, 웹 모듈 및 공유 라이브러리 로더)가 자원 URL의 공백을 인코딩할지 여부를 지정하려면 이 특성을 사용하십시오. 이 특성을 true로 설정한 경우 getResource 또는 getResources 호출에서 리턴하는 URL에서 공백이 "%20"으로 인코딩됩니다.
기본값은 true입니다. 이 특성이 false로 설정된 경우 로그에 경고 메시지 WSVR0333W가 표시됩니다. 이 메시지는 이 특성에 대해 false 설정이 더 이상 사용되지 않음을 표시합니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.classloader.strict
META-INF 디렉토리에 추적 슬래시가 포함되지 않은 경우에도 getResources 호출을 통해 META-INF 디렉토리에 액세스하기 위해 WebSphere Application Server 애플리케이션 클래스 로더를 사용 가능하게 하려면 이 특성을 사용하십시오.
추적 슬래시가 META-INF 디렉토리 경로의 끝에 지정된 경우를 제외하고 WebSphere Application Server 애플리케이션 클래스 로더는 기본적으로 getResources 호출을 통해 META-INF 디렉토리에 액세스합니다. 추적 슬래시가 META-INF 디렉토리 경로의 끝에 지정되지 않은 경우에도 WebSphere Application Server 애플리케이션 클래스 로더가 getResources 호출을 통해 META-INF 디렉토리에 액세스하려는 경우, 이 특성을 true로 설정하십시오.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.classloader.zipFileCacheSize
자원 및 클래스 로딩에 대해 열어둘 수 있는 최대 애플리케이션 JAR 파일 수를 지정하려면 이 특성을 사용하십시오. JAR 파일을 열어야 하는 횟수를 줄이면 자원 또는 클래스 로딩 집약적인 애플리케이션의 성능을 향상시킵니다.
열려 있는 JAR 파일 수가 지정된 한계에 도달하면 클래스 로더는 JAR 파일이 마지막으로 액세스된 시간을 기준으로 해당 파일을 닫고 제거하기 시작합니다. 가장 최근에 액세스된 JAR 파일을 열어둡니다. 이 특성에 지정한 값은 자주 액세스하는 애플리케이션 JAR 파일의 총계를 기반으로 해야 합니다.
이 특성의 기본값은 8입니다. 0 값을 지정하면 캐시를 사용할 수 없고 애플리케이션 JAR 파일을 열어둘 수 없습니다.
![[Windows]](../images/windows.gif)
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.cscope.HighlyAvailableIORsEnabled
이 특성을 사용하면 관리자가 분산형 비즈니스 활동 CORBA 오브젝트에 대해 고가용성 IOR을 생성하도록 보상 서비스를 구성할 수 있습니다. 그러면 실패한 분산형 종속 비즈니스 활동이 피어 복구 도중 완료될 수 있습니다. 이 특성은 노드 에이전트가 실행되지 않을 때도 새 비즈니스를 활동을 허용합니다.
이 특성의 기본값은 false입니다. true의 값을 지정하면 이 특성이 사용 가능합니다. 이 특성은 클러스터의 각 애플리케이션 서버에 설정해야 합니다.
com.ibm.ws.el.reuseEvaluationContext
스레드당 기준으로 동일한 EvaluationContext 오브젝트를 재사용할 수 있음을 표시하려면 이 특성을 사용하십시오.
일반적으로 표현식 평가 중에 통합 EL 코드는 수행되는 각 호출에 대해 새 org.apache.el.lang.EvaluationContext 오브젝트를 작성합니다. 이러한 오브젝트는 이후에 가비지 콜렉션에 사용할 수 있게 되므로 작성된 오브젝트 수가 증가하면 메모리 이용 및 가비지 콜렉션도 증가합니다. com.ibm.ws.el.reuseEvaluationContext 특성을 true로 설정하면 동일한 EvaluationContext 오브젝트를 스레드당 기준으로 재사용할 수 있으며 그에 따라 메모리 이용 및 발생해야 하는 가비지 콜렉션 양을 줄일 수 있습니다.
기본값은 false입니다.
com.ibm.ws.http.ConnectionIOTimeout
연결이 설정되는 시간과 클라이언트로부터 데이터 전송이 시작하는 시간 사이의 SOAP 포트의 제한시간을 확장하려면 이 특성을 사용하십시오. 기본값은 5초(Liberty에서는 15초)입니다. SOAP 서버 또는 클라이언트 JVM이 바쁘거나 SSL 핸드쉐이크가 늘어난 기간 동안 수행되는 경우 이 값을 늘릴 수도 있습니다. 이 제한시간 초과가 발생하는 경우 SOAP 서버에서 HTTP 408 메시지가 수신될 수 있습니다.
![[z/OS]](../images/ngzos.gif)
com.ibm.ws.iiop.channel.disableOnewayLocateRequiredMessage
오브젝트에 대한 단방향 GIOP 요청에 앞으로 찾기 주소 지정이 추가로 필요할 때마다 CWZGB0005I 메시지 표시 여부를 제어하려면 이 특성을 사용하십시오. 이 특성을 false로 설정하면 CWZGB0005I 메시지가 표시됩니다. 이 특성을 true로 설정한 경우에는 CWZGB0005I 메시지가 표시되지 않습니다.
기본값은 false입니다.
com.ibm.ws.jsf.allow.interpolator.per.app
JSF 컨테이너가 각 애플리케이션에 대해 MessageInterpolator가 정의 및 사용될 수 있도록 업데이트되었으며, 애플리케이션 사이에 공유되지 않습니다. 새 동작을 사용으로 설정하려면 이 특성을 true로 설정해야 합니다.
com.ibm.ws.jsf.call.publishevent.with.sourceclass
javax.faces.Application.publishEvent를 호출할 때 적절한 소스 클래스가 사용되도록 이 특성을 사용하십시오. 기본적으로 javax.faces.Application.publishEvent를 호출할 때 UIComponent.class는 항상 실제 소스 클래스보다 더 사용됩니다. 그러나 sourceBaseType 매개변수는 이 이벤트가 공개할 리스너를 검색하는 데 사용되어야 하는 소스 이벤트를 표시합니다. 이 인수가 널인 경우 source.getClass()의 리턴은 sourceBaseType으로 사용되어야 합니다.
기본값은 false입니다.
com.ibm.ws.jsp.enhance_el_support
표현식이 처리되는 방법을 제어하려면 이 특성을 사용하십시오. 표현식 평가 중에 값은 Expression Language Specification 버전 2.1의 1.8.2 절을 기반으로 하는 예상 유형으로 강제됩니다. 이는 표현식 값이 예상된 유형이 아닐 수 있으므로 예상치 못한 결과가 될 수 있습니다. 이러한 강제를 방지하려면 이 특성을 true로 설정하십시오.
기본값은 false입니다.
com.ibm.ws.management.application.task.AppTypeDeploymentTask.isLongRunningApp
이 특성은 정보용으로만 나열되었습니다. 이 특성은 자동으로 작성되고, 자동 구성에 사용되며 변경하지 말아야 합니다.
기본값은 true입니다.
com.ibm.ws.management.connector.soap.logClientInfo
SOAP 클라이언트 요청의 호스트, 포트 및 사용자 이름을 로그하려는지 여부를 표시하려면 이 특성을 사용하십시오. 이 특성을 true로 설정하면 SOAP 클라이언트 세부사항이 SystemOut.log에 로그됩니다. SOAP 커넥터의 추적 레벨이 all로 설정된 경우 해당 세부사항은 trace.log에도 추가됩니다.
기본값은 false입니다.
![[Windows]](../images/windows.gif)
com.ibm.ws.management.connector.soap.waitBeforeCloseTime
서버 SOAP 연결 제한시간에 지정된 시간을 변경하려면 이 특성을 사용하십시오. Microsoft Windows 운영 체제에서 로컬 호스트 어댑터를 사용하는 경우, 기본값이 10밀리초로 설정된 서버 SOAP 연결 제한시간을 사용하면 많은 데이터 양을 중단 없이 스트림할 수 있습니다.
이 특성에 너무 짧은 시간이 지정되는 경우, 대용량 데이터가 스트림될 때 서버측 연결에서 스트림의 너무 이른 종료에 대한 SOAPException이 발생할 수 있습니다.
값 0을 지정하면 제한시간이 사용 불가능합니다.
com.ibm.ws.management.event.max_polling_interval
클라이언트에서 알림을 요청하거나 가져오기 전에 서버가 대기하는 최대 시간을 지정하려면 이 특성을 사용하십시오. 기본 폴링 간격은 1000밀리초(1초)입니다. 특성 값이 지정되지 않은 경우 기본값이 사용됩니다.
SOAP 또는 IPC 커넥터를 사용하는 경우, 이 특성을 사용하여 서버가 클라이언트의 폴 알림을 기다리는 시간이 RMI 커넥터를 사용하는 경우 서버가 기다리는 시간 간격과 일치하도록 해당 커넥터를 튜닝할 수 있습니다.
이 특성 값을 -1로 설정한 경우, 클라이언트가 수신하는 알림의 수에 따라 폴링 간격을 변경하는 기본 제공의 적응적 알고리즘을 기반으로 알림을 폴링합니다. 3 - 20초의 시간 간격은 처음 알림이 수신되기 전 폴 사이의 간격입니다.

클라이언트측 JVM에 대해 이 특성을 지정해야 합니다.
com.ibm.ws.management.event.pull_notification_timeout
클라이언트가 서버의 폴 알림 전달을 기다리는 시간을 지정하려면 이 특성을 사용하십시오. 기본 제한시간은 60000밀리초(60초 또는 1분)입니다. 특성 값이 지정되지 않은 경우 기본값이 사용됩니다.
특성 값이 0(영) 또는 음수(예: -1)로 설정된 경우 알림을 사용할 수 없더라도 서버가 클라이언트로 즉시 리턴됩니다.

서버측 JVM에 대해 이 특성을 지정해야 합니다.
com.ibm.ws.management.repository.tempFileKeepTimeMinutes
구성 저장소 임시 디렉토리 정리 태스크로 디렉토리에서 파일이 삭제되기 전에 구성 저장소 임시 디렉토리에 파일이 보관되는 기간(분)을 지정하려면 이 특성을 사용하십시오. 이 특성의 기본값은 1440분으로, 24시간에 해당됩니다. 제품의 이전 버전에서는 파일이 60분 동안 보관되었습니다.
일반적으로 사용 중인 파일을 삭제하지 않고 필요한 정리를 수행하는 데에는 기본값이 충분합니다. 하지만 값을 더 크거나 작게 지정해야 하는 경우가 있습니다. 이 특성의 최소값인 60분을 지정할 수 있습니다. 그러나 매우 큰 파일이 전송 또는 동기화되고 있거나 네트워크가 느려지고 파일 전송 조작의 시간이 오래 걸리는 상황에 적절한 몇 시간 정도의 값을 지정하는 것이 좋습니다. 이 경우 너무 짧은 시간을 지정하면 파일이 전송 중일 때 삭제될 수 있습니다.
com.ibm.ws.management.repository.tempFileSweepIntervalMinutes 특성이 0으로 설정되면 정리 기능이 사용 불가능하고, 서버 프로세스 실패 후 뒤에 남겨진 파일은 수동으로 제거되거나 정리 기능이 사용 가능하게 될 때까지 구성 저장소 임시 디렉토리에 남아 있습니다.
com.ibm.ws.management.repository.tempFileSweepIntervalMinutes
구성 저장소 임시 디렉토리 정리 태스크가 실행되는 간격(분)을 지정하려면 이 특성을 사용하십시오. 이 태스크는 구성 저장소 임시 디렉토리에서 서버 프로세스 실패로 인해 제대로 제거되지 않은 파일을 제거합니다.
정리 태스크는 서버가 시작되면 항상 실행되고, 이 특성에 지정한 시간 길이가 만료된 후 다시 실행됩니다. 이 특성의 기본값은 720분으로, 12시간에 해당됩니다. 구성 저장소 임시 디렉토리 정리 태스크가 정리 프로세스를 완료하는 데에는 일반적으로 이 시간이 충분합니다. 이 특성을 0으로 설정해서 정리 기능을 사용 불가능하게 할 수 있습니다.
제품의 이번 버전에서는 서버가 시작될 때 정리 태스크가 실행된 후 30분마다 다시 실행되었습니다.
com.ibm.ws.management.suppressPortScan
새 서버가 작성될 때 배치 관리자에 의한 포트 활동 검사를 억제하려면 이 특성을 true 값으로 설정하십시오. true로 설정되면, 배치 관리자가 서버 구성의 포트를 사용하기 전에 새 포트를 바인드하거나 연결하려고 시도하지 않습니다. 포트 활동 검사를 억제하면 다른 애플리케이션이 활성 포트를 갖는 경우 포트 충돌이 발생할 수 있습니다. 기본값은 false입니다.
com.ibm.ws.management.taskcommandtimeoutsec
장기 실행 중인 애플리케이션 업데이트를 수행할 때 TaskCommandSessionMgr의 SessionTimeoutException이 발생하는 경우 이 특성을 초 단위 값으로 설정하십시오. 기본값은 1200초(20분)입니다.
com.ibm.ws.odr.plugincfg.config.ASDisableNagle
플러그인과 프록시 서버 사이의 연결에 필요한 Nagle 알고리즘을 사용 안함으로 설정할지 여부를 지정하려면 이 특성을 사용하십시오.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 false이며, 플러그인과 프록시 서버 사이의 연결에 대해 Nagle 알고리즘이 사용 가능함을 의미합니다.
com.ibm.ws.odr.plugincfg.config.AcceptAllContent
- 모든 요청에 대한 컨텐츠를 읽는 경우 True입니다.
- POST 및 PUT 요청에 대한 컨텐츠만 읽는 경우 False입니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.config.AppServerPortPreference
sendRedirect에 대해 URI를 빌드하는 데 사용되는 포트 번호를 지정하려면 이 특성을 사용하십시오.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 HostHeader입니다.
com.ibm.ws.odr.plugincfg.config.ChunkedResponse
응답에 Transfer-Encoding : Chunked 응답 헤더가 있는 경우 플러그인이 클라이언트에 대한 응답을 그룹화할지 여부를 지정하려면 이 특성을 사용하십시오.
- 응답에 Transfer-Encoding : Chunked 응답 헤더가 있을 때 플러그인이 클라이언트에 대한 응답을 청크하는 경우 True입니다.
- 응답이 청크되지 않는 경우 False
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.config.IISDisableNagle
nagle 알고리즘을 사용 불가능하게 할지 여부를 지정하려면 이 특성을 사용하십시오.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.config.IISPluginPriority
- 높음
- 중간
- 낮음
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 높음입니다.
com.ibm.ws.odr.plugincfg.config.IgnoreDNSFailures
플러그인이 시작 시 구성 내의 DNS 장애를 무시할지 여부를 지정하려면 이 특성을 사용하십시오.
이 특성이 true로 설정되면, 각 ServerCluster에서 최소한 하나 이상의 서버가 호스트 이름을 분석하는 경우에는 플러그인이 하나의 구성 내에서 DNS 장애를 무시하고 정상적으로 시작합니다. 호스트 이름을 해석할 수 없는 서버는 구성 수명에 사용 불가능으로 표시됩니다. 요청의 라우팅 중에는 나중에 호스트 이름이 분석되지 않습니다. DNS 장애가 발생하면, 로그 메시지가 플러그인 로그 파일에 기록되고 웹 서버가 시작되지 않는 대신 플러그인 초기화가 계속됩니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.config.RefreshInterval
플러그인이 업데이트 또는 변경사항의 구성 파일을 검사해야 하는 간격(초)을 지정하려면 이 특성을 사용하십시오. 플러그인은 플러그인 구성이 로드된 이후에 발생하는 모든 수정사항에 대해 파일을 검사합니다.
변경이 자주 이루어지는 개발 환경에서는, 시간 간격을 60초 미만으로 설정하십시오.
프로덕션 환경에서는, 구성에 대한 업데이트가 자주 발생하지 않으므로 기본값보다 큰 값을 설정해야 합니다.
플러그인 다시 로드가 실패하면, 플러그인 로그 파일에 오류 메시지가 포함되며 플러그인 구성 파일이 다시 로드될 때까지 이전 구성이 사용됩니다. 오류가 발생하는 경우 자세한 정보는 플러그인 로그 파일을 참조하십시오.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 60입니다.
com.ibm.ws.odr.plugincfg.config.ResponseChunkSize
플러그인이 응답 본문을 읽을 때 사용해야 하는 최대 청크 크기(KB)를 지정하려면 이 특성을 사용하십시오(예: Config ResponseChunkSize="N". 여기서 N은 청크 크기임).
기본적으로 플러그인은 모든 응답 데이터를 읽을 때까지 64K 청크로 응답 본문을 읽습니다. 이 프로세스는 응답 본문에 많은 양의 데이터를 포함하는 요청에 대해 성능 문제점을 유발할 수 있습니다. 응답 본문의 컨텐츠 길이를 알 수 없는 경우, NKB의 버퍼 크기가 할당되고 전체 본문을 읽을 때까지 NKB 크기 청크로 본문을 읽습니다. 컨텐츠 길이를 아는 경우, 컨텐츠 길이 또는 N 중 하나의 버퍼 크기가 응답 본문을 읽는 데 사용됩니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 64입니다.
com.ibm.ws.odr.plugincfg.config.VHostMatchingCompat
- 요청을 수신한 포트 번호를 사용하여 물리적으로 일치를 수행하는 경우 True입니다.
- 호스트 헤더에 포함된 포트 번호를 사용하여 논리적으로 일치를 수행하는 경우 False입니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.config.TrustedProxyEnable
- 신뢰 프록시를 포함하려는 경우 True입니다.
- 신뢰 프록시를 포함하지 않으려는 경우에는 False입니다.
신뢰 프록시는 정의된 신뢰 보안 프록시에서 수집됩니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 구성 요소에 적용됩니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.log.Name
플러그인이 오류 메시지를 기록하는 로그 파일의 완전한 경로를 지정하려면 이 특성을 사용하십시오.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 로그 요소에 적용됩니다.
기본값은 profileRoot/logs/http_plugin.log입니다.
com.ibm.ws.odr.plugincfg.log.LogLevel
- Trace. 요청 프로세스의 모든 단계가 자세하게 로그됩니다.
- Stats. 각 요청에 대해 선택된 서버와 요청 처리와 관련된 다른 로드 밸런스 정보가 로그됩니다.
- Warn. 비정상적인 요청 처리의 결과인 모든 경고 및 오류 메시지가 로그됩니다.
- Error. 비정상적인 요청 처리의 결과인 오류 메시지만 로그됩니다.
- Debug. 요청 처리에서 수행된 중요한 단계 모두가 로그됩니다.
- Detail. 요청과 응답에 대한 모든 정보가 로그됩니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 로그 요소에 적용됩니다.
기본값은 Error입니다.
com.ibm.ws.odr.plugincfg.cluster.CloneSeparatorChange
플러그인에 더하기(+) 문자를 복제 구분 기호로 사용할 수 있음을 표시하려면 이 특성을 사용하십시오.
일부 퍼베이시브 디바이스는 세션 선호도가 있는 복제본 ID를 분리하는 데 사용되는 콜론 문자(:)를 처리할 수 없습니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 서버 클러스터 요소에 적용됩니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.cluster.LoadBalance
적합한 로드 밸런싱 옵션(라운드 로빙 또는 임의)을 지정하려면 이 옵션을 사용하십시오.
라운드 로빙 구현은 임의 시작점을 갖습니다. 첫 번째 프록시 서버는 임의로 선택됩니다. 그 다음부터 라운드 로빈을 사용하여 프록시 서버를 선택할 수 있습니다. 이 구현은 다중 프로세스 기반 웹 서버에서 첫 번째 요청을 동일한 프록시 서버에 전송해도 모든 프로세스가 시작되지 않도록 합니다.
임의 구현에도 임의의 시작점이 있습니다. 그러나 이 구현에서는 후속 프록시 서버 모두가 무작위로 선택됩니다. 따라서 다른 프록시 서버가 유휴 상태인 동안에는 동일한 프록시 서버가 반복적으로 선택됩니다.
기본값은 Round Robin입니다.
com.ibm.ws.odr.plugincfg.cluster.PostSizeLimit
플러그인이 서버로 보낼 수 있는 요청 컨텐츠의 최대 크기(바이트)를 지정하려면 이 특성을 사용하십시오. 지정된 값보다 큰 요청을 수신하는 경우 플러그인이 요청을 종료합니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 서버 클러스터 요소에 적용됩니다.
기본값은 -1이며, 요청 크기에 제한이 없음을 표시합니다.
com.ibm.ws.odr.plugincfg.cluster.RemoveSpecialHeaders
요청을 서버에 전달하기 전에 플러그인이 요청에 특수 헤더를 추가할지 여부를 지정하려면 이 특성을 사용하십시오. 이러한 헤더는 애플리케이션이 사용하는 요청에 대한 정보를 저장합니다. 기본적으로 플러그인은 필수 헤더를 추가하기 전에 수신 요청에서 이러한 헤더를 제거합니다.
이 특성을 false로 설정하면, 수신 요청에서 잠재적 보안 노출 헤더가 제거되지 않습니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 서버 클러스터 요소에 적용됩니다.
기본값은 true입니다.
com.ibm.ws.odr.plugincfg.cluster.RetryInterval
프록시 서버가 작동 중지로 표시되는 시간과 플러그인이 연결을 다시 시도하는 시간 사이의 간격(초)을 지정하려면 이 특성을 지정하십시오.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 서버 클러스터 요소에 적용됩니다.
기본값은 60입니다.
com.ibm.ws.odr.plugincfg.odrIncludeStopped
- 중지된 프록시 서버를 포함하려는 경우 True입니다.
- 중지된 프록시 서버를 포함하지 않으려는 경우에는 False입니다.
이 특성은 프록시 서버에만 유효합니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.server.ConnectTimeout
플러그인이 연결을 기다리는 시간(초)을 지정하려면 이 특성을 사용하십시오.
특성에 값을 지정하면 플러그인이 프록시 서버와의 비차단 연결을 수행할 수 있습니다. 포트의 사용 가능 또는 사용 불가능 여부를 판단하기 위해 플러그인을 대상에 접속할 수 없는 경우에는 이러한 연결이 유용합니다.
0보다 큰 값을 지정하고 시간이 경과한 후에도 연결이 이루어지지 않으면, 플러그인이 프록시 서버를 사용 불가능으로 표시하고 클러스터에 정의된 다른 프록시 서버 중 하나에 대한 연결을 진행합니다.
이 특성에 대해 값이 지정되지 않은 경우, 플러그인은 운영 체제의 제한시간이 초과될 때까지 대기하는 블로킹 연결을 수행하고 플러그인이 프록시 서버를 사용 불가능으로 표시할 수 있습니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 서버 요소에 적용됩니다.
기본값은 0입니다.
com.ibm.ws.odr.plugincfg.server.ExtendedHandShake
플러그인에 프록시 서버로 요청을 보내기 전에 해당 프록시 서버의 가용성을 확인해야 함을 표시하려면 이 특성을 사용하십시오.
일반적으로 플러그인은 connect()가 종료되면 프록시 서버를 중지됨으로 표시합니다. 그러나, 프록시 방화벽이 플러그인과 프록시 서버 사이에 있을 때 connect()는 백엔드 프록시 서버가 중지되는 경우에도 성공합니다. 이 상황은 플러그인이 다른 프록시 서버로 올바르게 장애 조치(failover)하지 않게 합니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 서버 요소에 적용됩니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.server.MaxConnections
특정 시점에 웹 서버 프로세스를 통해 플로우할 수 있는 프록시 서버에 최대 연결 보류 시간을 지정하려면 이 특성을 사용하십시오.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 서버 요소에 적용됩니다.
기본값은 -1이며, 특정 시점에 웹 서버 프로세스를 통해 플로우할 수 있는 프록시 서버에 보류 중인 연결 수에 대한 최대수가 없음을 표시합니다.
com.ibm.ws.odr.plugincfg.cluster.WaitForContinue
요청 컨텐츠를 프록시 서버에 전송하기 전에 HTTP 1.1 100 Continue 지원을 사용할지 여부를 지정하려면 이 특성을 사용하십시오.
일반적으로 플러그인은 요청 컨텐츠를 전송하기 전에 프록시 서버에서 100 Continue 응답을 기다리지 않습니다. 특정 유형의 프록시 방화벽에서 작동하는 플러그인을 구성할 때 HTTP 1.1 100 Continue 지원을 사용해야 합니다.
프록시 서버가 제한시간 초과로 인해 연결을 닫는 경우에 발생하는 실패를 방지하기 위해 POST 요청에 대한 이 특성은 무시됩니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 서버 요소에 적용됩니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.property.ESIEnable
ESI(Edge Side Include) 프로세서를 사용 가능 또는 사용 불가능하게 하려면 이 특성을 사용하십시오. ESI 프로세서를 사용 불가능하게 한 경우, 파일의 기타 ESI 요소는 무시됩니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 특성 요소에 적용됩니다.
기본값은 true입니다.
com.ibm.ws.odr.plugincfg.property.ESIMaxCacheSize
캐시의 최대 크기(1KB 단위)를 지정하려면 이 특성을 사용하십시오. 캐시의 기본 최대 크기는 1024KB(1MB)입니다. 캐시가 가득 찬 경우, 캐시에서 제거할 첫 번째 항목은 만기 시간에 가장 가까운 항목입니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 특성 요소에 적용됩니다.
기본값은 1024입니다.
com.ibm.ws.odr.plugincfg.property.ESIInvalidationMonitor
ESI 프로세서가 프록시 서버로부터 무효화를 수신하는지 여부를 지정하려면 이 특성을 사용하십시오.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 특성 요소에 적용됩니다.
기본값은 false입니다.
com.ibm.ws.odr.plugincfg.property.https.keyring
전송의 프로토콜이 HTTPS로 설정될 때 SAF 키 링의 디렉토리 위치를 지정하려면 이 특성을 사용하십시오.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 특성 요소에 적용됩니다.
기본값은 profileRoot/etc/plugin-key.kdb입니다.
com.ibm.ws.odr.plugincfg.property.https.stashfile
숨김 파일의 위치를 지정하려면 이 특성을 사용하십시오.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 특성 요소에 적용됩니다.
기본값은 profileRoot/node/etc/plugin-key.sth 입니다.
com.ibm.ws.odr.plugincfg.property.PluginInstallRoot
플러그인의 설치 경로를 지정하려면 이 특성을 사용하십시오.
이 특성을 플러그인 설치 루트의 완전한 경로로 설정해야 합니다. 기본값을 사용하는 경우, 특성이 plugin-cfg.xml 파일에 표시되지 않습니다.
이 특성은 프록시 서버에만 유효하며, 프록시 서버가 자동으로 생성되는 plugin-cfg.xml 파일의 특성 요소에 적용됩니다.
기본값은 ""입니다.
com.ibm.ws.pm.checkingDBconnection
이전에 사용 불가능으로 표시된 데이터베이스에 대한 연결이 설정될 때까지 지속 관리자가 이 데이터베이스의 가용성을 계속해서 점검할 지 여부를 지정하려면 이 특성을 사용하십시오.
지속 관리자가 데이터베이스에 연결을 시도할 때 이 데이터베이스 서비스가 작동 중지된 경우에는 사용 불가능으로 표시됩니다. 일반적으로 데이터베이스가 사용 불가능으로 표시된 후에는 지속 관리자가 연결을 다시 시도하지 않습니다. 이 특성을 true로 설정하면 지속 관리자는 데이터베이스에 연결될 때까지 이 데이터베이스의 가용성을 계속해서 확인합니다.
기본값은 false입니다.
com.ibm.ws.policyset.exportEncodedPasswords
암호화된 비밀번호를 포함하는 WS-Security 정책 세트 바인딩을 XOR 인코딩된 비밀번호를 대신 사용하여 내보낼 수 있도록 하려면 이 특성을 true로 설정하십시오.
올바른 값은 true 및 false입니다.
기본값은 false입니다.
com.ibm.ws.recoverylog.disableNonHARegistration
애플리케이션 서버가 트랜잭션 로그 복구의 장애 조치(failover) 기능을 사용할 수 있는 클러스터 멤버가 아닌 경우, 복구 로그 서비스를 HA 관리자에 등록할 필요가 없습니다.
그러나 나중에 장애 조치(failover)가 사용되고 클러스터가 부분적으로만 다시 시작되는 경우에는 복구 로그 서비스가 HA 관리자에 등록하지 않도록 이 사용자 정의 특성을 true로 설정하십시오.
올바른 값은 true 및 false입니다.
기본값은 false입니다.
com.ibm.ws.recoverylog.spi.NoMemoryMappedFiles
트랜잭션 로그 파일이 애플리케이션 서버에 로컬인 경우 해당 로그 파일의 메모리 맵핑 성능을 향상시키려면 이 특성을 사용하십시오.
그러나 트랜잭션 로그가 원격 파일 시스템에 정의된 경우(이는 고가용성(HA) 지원을 사용하는 경우에 일반적임) 모든 성능 향상은 무시해도 될 정도입니다. 또한 로그 처리가 더 복잡합니다. 이러한 복잡성 때문에 HA 환경 메모리에서는 트랜잭션 로그의 맵핑을 사용하지 마십시오.
com.ibm.ws.runtime.component.ResourceMgr.postBindNotify
자원 어댑터가 시작될 때 연결 팩토리 MBean을 사용할 수 있게 하려면 이 특성을 사용하십시오. 일반적으로 자원 어댑터가 시작될 때 자원 어댑터는 연결 팩토리 MBean을 조회할 수 없습니다. 그러나 IMS™ DB 자원 어댑터와 같은 특정 자원 어댑터에서는 초기화에 이 기능이 필요합니다.
초기화 시 연결 팩토리 MBean을 사용해야 하는 자원 어댑터를 사용하지 않는 경우, 이 특성을 JVM 설정에 추가하고 값을 false로 설정하십시오.
기본값은 true입니다.
com.ibm.ws.runtime.dumpShutdown
- 노드 에이전트가 정지된 서버를 중지했으므로 서버가 종료됩니다.
- System.exit()가 서버에서 실행 중인 애플리케이션 코드에서 호출될 때 서버가 종료됩니다.
- 산발적으로 서버가 종료됩니다.
IBM Software Development Kit을
사용하는 플랫폼(AIX, Windows, Linux, z/OS)에서 Java 코어 스레드 덤프가 애플리케이션 서버의
작업 디렉토리에 생성됩니다.
다른 플랫폼(Solaris, HP-UX)의 경우,
Java 코어 스레드 덤프가 애플리케이션 서버의 native_stdout.log 파일에
기록됩니다.
Java 코어 스레드 덤프 외에, 종료를 처리하는 현재 스레드의 스택 추적이 애플리케이션 서버의 SystemErr.log에 기록됩니다.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
com.ibm.ws.runtime.logThreadPoolGrowth
늘릴 수 있는 스레드 풀의 최대 크기가 구성되어 있지만 해당하는 최대 크기를 초과하여 늘릴 수 있습니다. 그러나 기본적으로 최대 크기를 초과했음을 나타내는 메시지는 발행되지 않습니다.
늘릴 수 있는 스레드 풀이 구성된 최대 크기를 초과하여 늘어날 경우 서버가 로그 파일에 메시지를 전송하도록 하려면 이 특성을 true로 설정하십시오.
com.ibm.ws.scripting.apptimeout
애플리케이션 설치 또는 애플리케이션 업데이트 제한 시간까지의 시간(초)을 지정하려면 이 특성을 사용하십시오. 기본값은 86400으로, 24시간에 해당됩니다.
이 특성에 적합한 값을 지정하면 설치나 업데이트 스크립트가 완료되지 못하게 방해되는 경우에 설치 또는 업데이트 프로세스가 무제한 계속됩니다. 예를 들어, 스크립트가 연결된 배치 관리자가 중지되어 완료할 수 없는 EAR 파일을 업데이트하는 JACL 스크립트가 있을 수 있습니다.
com.ibm.ws.sib.webservices.useSOAPJMSTextMessages
기본적으로 WebSphere Application Server 버전 6 이상에서는, 웹 서비스 게이트웨이가 전송한 JMS를 통한 SOAP 웹 서비스 메시지가 JmsBytesMessage로 전송됩니다.
기본 작동을 수정하고 호환 가능한 JmsTextMessage를 전송하려면 이 특성을 true로 설정하십시오. 이 특성을 설정하면 서비스 통합 버스에서 전송된 모든 아웃바운드 JMS 웹 서비스 호출의 기본 작동이 수정됩니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.soap.handleRST
웹 서버가 SOAP 메시지를 읽을 때를 인식하고, RequestSecurityToken(RST) 요소를 FIN 메시지 유형으로 처리하려는 경우 이 특성을 사용하십시오.
일부 인스턴스에서 연결 재설정이 발생하면 웹 서버는 보안 비활성화를 시작합니다. 그러나 파일의 표준 FIN/end 대신 RST를 수신했기 때문에 웹 서버가 시작하고 작동하지 않더라도 웹 서버가 시작하지 못했음을 나타내는 오류 메시지가 관리 콘솔에 나타납니다. 웹 서버 콘솔 페이지의 새로 고치기가 올바른 운영 상태를 표시합니다.
com.ibm.ws.soap.handleRST 사용자 정의 특성을 true로 설정한 경우 웹 서버는 전체 SOAP 메시지를 읽을 때 인식되고 FIN으로 RST를 처리하며 RST가 수신될 때 오류 메시지를 수신하지 않습니다.
com.ibm.ws.use602RequiredAttrCompatibility
<required> 속성이 cachespec.xml 파일의 다른 속성보다 먼저 평가되는지 여부를 지정하려면 com.ibm.ws.use602RequiredAttrCompatibility 사용자 정의 특성을 사용하십시오.
버전 6.0.2에서 <required> 속성을 false로 설정하면 cachespec.xml 파일 내의 기타 속성이 모두 무시되고 캐시 ID가 생성됩니다.

이 사용자 정의 특성을 사용하려면, 달리 명시되어 있지 않은 한 특정 태스크의 컨텍스트에 애플리케이션 서버 JVM 사용자 정의 특성으로 지정하십시오.
com.ibm.ws.webcontainer.allowDefaultErrorPage
web.xml 파일에 서블릿 3.0 스펙을 준수하는 오류 페이지 정의가 포함된 경우 이 특성을 사용하십시오. 서블릿 3.0 스펙은 <location> 매개변수만 필수임을 표시합니다. <error-code> 및 <exception-type> 매개변수는 선택적입니다. 그러나 이 특성을 JVM 설정에 추가하고 true로 설정하지 않으면 <location> 매개변수만으로 정의된 오류 페이지가 무시됩니다.
기본값은 false입니다.
이 특성을 사용하는 경우 애플리케이션 서버 레벨에 설정되어야 합니다.
com.ibm.ws.webservices.allowNoSOAPActionHeader
웹 서비스 엔진에 SOAPAction 헤더가 포함되지 않은 수신 웹 서비스 요청을 허용하려면 이 특성을 사용하십시오. 이 특성은 애플리케이션 서버 레벨에서 설정해야 합니다.
SOAP 스펙에는, soapbind:operation의 soapAction이 없거나 빈 문자열 값으로 존재하는 경우 HTTP 요청 메시지에 따옴표가 있는 빈 문자열 값의 SOAPAction HTTP 헤더 필드가 포함되어야 한다고 명시되어 있습니다. 하지만 웹 서비스 엔진에서 SOAPACTION 헤더가 포함되지 않은 요청을 처리하려면 이 특성을 애플리케이션 서버 설정에 추가하고 true로 설정하십시오.
이 특성이 지정되지 않거나 true로 설정되지 않은 경우 수신 SOAP 요청 메시지에 SOAPAction 헤더가 없으면 클라이언트에 SOAP 결함이 리턴됩니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.allowStatusCode202OneWay
JAX-RPC 단방향 서비스가 200 상태 코드 대신 202 상태 코드를 보내게 하려면 이 특성을 사용하십시오.
WebSphere Application Server에 배치된 JAX-RPC 단방향 서비스는 일반적으로 200 HTTP 상태 코드를 리턴합니다. 일부 JAX-RPC 구현은 200 상태 코드 대신 202를 선호합니다. 기본 프로파일 버전 1.1에 따라 단방향 서비스에 대한 올바른 상태 코드는 200과 202입니다.
특성이 true로 설정되면, JAX-RPC 단방향 서비스가 202 상태 코드를 리턴합니다.
기본값은 false입니다.
이 특성은 애플리케이션 서버 JVM에만 적용됩니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.appendRootCauseToWSF
JAX-RPC 사용자는 이 특성을 사용하여 응답에 리턴되는 예외에 대한 결함 세부사항에 원래 예외 정보를 포함하는지 여부를 지정할 수 있습니다.
일반적으로 응답에 리턴되는 예외에 대한 결함 세부사항에는 최신 예외 정보만 포함됩니다. 대부분 최신 예외가 아닌 원래 예외에 대한 정보는 포함되지 않습니다. 예외는 자주 결함 세부사항이 응답에 리턴되기 전에 다른 예외를 트리거합니다. 일반 사용자가 서비스 제공자의 로그에 액세스할 수 없는 경우 이러한 불일치으로 인해 해당 사용자가 문제점을 판별하기 더 어려워질 수 있습니다.
일반 사용자가 문제점과 연관된 모든 예외에 대한 예외 세부사항을 확인해야 하는 경우, 서비스 제공자의 애플리케이션 서버에서 JVM에 대해 이 사용자 정의 특성을 true로 설정해야 합니다. 서비스 제공자의 애플리케이션 서버에서 이 사용자 정의 특성을 true로 설정하면, 애플리케이션 서버가 모든 예외 원인을 루프를 돌려서 처리하고 응답에 리턴되는 결함 세부사항에 각 예외의 세부사항을 연결합니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버에 대한 JVM 사용자 정의 특성으로 지정해야 합니다.
![[z/OS]](../images/ngzos.gif)
com.ibm.ws.webservices.cacheEngineList
JAX-RPC 웹 서비스를 사용한 WebSphere Application Server for z/OS 구성에서 클라이언트 웹 서비스 엔진 캐싱을 사용하지 않으려면 이 특성을 사용하십시오.
애플리케이션을 여러 번 다시 시작하면 클라이언트 엔진 캐시가 로컬 시스템 스토리지를 채워 메모리 부족 오류가 발생할 수 있습니다. 이 특성이 true로 설정되면 엔진 캐싱이 사용 가능합니다. 메모리 부족 오류 발생 시 엔진 캐싱을 사용하지 않으려면 이 특성을 false로 설정하십시오.
기본값은 true입니다.
com.ibm.ws.webservices.contentTransferEncoding
- 웹 서비스는 지정된 범위 내의 정수에 대해 인코딩을 사용할 수 없습니다.
- HTTP 전송 메시지에 이 사용자 정의 특성에 지정된 값으로 설정되는 ContentTransferEncoding 헤더가 포함됩니다.
127보다 큰 정수만 인코딩하려면 7비트를 지정하십시오. 255보다 큰 정수만 인코딩하려면 8비트를 지정하십시오. 모든 정수를 인코딩하지 않으려면 2진을 지정하십시오.
기본값은 7비트입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.disableSOAPElementLazyParse
SOAPElement의 지연 구문 분석을 사용 불가능하게 하려면 이 특성을 사용하십시오. 지연 구문 분석은 클라이언트가 SOAPElement를 구문 분석하지 않는 경우를 위한 디자인입니다. 클라이언트가 SAAJ의 SOAPElement를 구문 분석하는 경우에는 웹 서비스 컴포넌트의 구문 분석을 지연시키지 않는 것이 좋습니다.
서버 또는 클라이언트 레벨에서 이 특성을 JVM 사용자 정의 특성으로 설정할 수 있습니다. 이 특성이 서버 또는 클라이언트 레벨에서 설정되면 JVM의 모든 애플리케이션에 설정이 적용됩니다. 기본값은 false입니다.
배치 관리자에서 관리하는 모든 서버 대신, 특정 서버에서 애플리케이션-애플리케이션 기반으로 SOAPElements의 지연 구문 분석을 사용 불가능하게 하려는 경우 애플리케이션 어셈블리 도구를 사용하여 이 특성을 포트 컴포넌트 바인딩에 대한 새 웹 서비스 설명 바인딩 항목으로 지정할 수도 있습니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.engine.transport.jms.propagateOneWaySystemExceptions
단방향 JMS 웹 서비스 처리 중에 발생하는 예외를 EJB 컨테이너로 다시 전파할 수 있으려면 이 특성을 사용하십시오. 이 전파로 인해 표준 오류 복구가 가능해집니다.
이 특성을 false로 설정한 경우, 예외가 WebServicesFault 메시지에 랩핑되고 클라이언트로 다시 전송됩니다. 웹 서비스는 예외를 인식하지 못하므로 복구를 시도하지 않습니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.forceLegacyDispatchFromSOAPConnection
JAX-WS 엔진 대신 JAX-RPC 엔진이 SAAJ(SOAP with Attachments API for Java) 클라이언트에 발신되는 요청을 처리하는 데 사용되도록 지정하려면 이 특성을 사용하십시오.
이 특성은 웹 서비스를 호출하는 데 JAX-RPC 또는 JAX-WS API를 사용하는 웹 서비스 클라이언트에 적용되지 않습니다. JAX-WS 엔진이 클라이언트 요청을 처리하는 데 사용되면, JAX-RPC 엔진이 사용되는 경우와 결과는 다를 수 있습니다. 예를 들어 일부 SAAJ 클라이언트는 SAAJ API를 사용하여 SOAPAction 헤더를 MIME 헤더로 설정합니다. JAX-RPC 엔진이 이러한 요청을 처리하는 데 사용되면, 사용자 설정 값을 가진 이 SOAPAction 헤더가 요청에 전송됩니다. 그러나, JAX-WS 엔진이 동일 요청을 처리하는 데 사용되면, 빈 SOAPAction 헤더가 요청에 전송됩니다. JAX-RPC 엔진을 사용하여 SAAJ 클라이언트 요청을 처리하고 이 동작을 유지하려면, 이 특성을 JVM 설정에 추가하고 true로 설정하십시오.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.HttpRedirectWithProxy
HTTP 경로 재지정 요청을 프록시 서버를 통해 전송하려면 이 특성을 true로 설정하십시오. 이 특성을 true로 설정하는 경우, JAX-RPC 런타임에서 전송된 모든 아웃바운드 HTTP 경로 재지정 요청의 기본 동작을 변경합니다. 이 특성을 false로 설정하면, 프록시 서버가 구성되어 있는 경우에도 경로 재지정 요청이 원격 서버로 직접 전송됩니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 프록시 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.ignoreUnknownElements
리터럴 SOAP 조작 응답에서 때때로 발견되는 여분의 XML 요소를 클라이언트가 무시할 수 있는지 여부를 제어하려면 이 특성을 사용하십시오.
이 특성을 true로 설정하면 클라이언트 코드를 즉각적으로 업데이트하여 이 추가 정보를 처리하지 않고도 더 많은 응답 정보를 포함하도록 서버 코드를 업데이트할 수 있는 유연성이 생깁니다. 그러나 이 기능이 사용되는 경우, SOAP 메시지에서 예상 메시지 구조를 검사하는 것이 이 특성을 false로 설정할 경우보다 더 편리합니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.jaxrpc.parse.tolerate.invalid.namespace
JAX-RPC 엔진에서 수신 JAX-RPC 메시지를 허용할지 여부를 판별할 때 보다 관대한 알고리즘을 사용하려면 이 특성을 사용하십시오.
일반적으로 수신 JAX-RPC 메시지의 본문 요소에 유효하지 않은 네임스페이스가 사용되면 JAX-RPC 엔진이 메시지를 거부합니다. 이 특성을 true로 설정하면 JAX-RPC 엔진은 네임스페이스 불일치를 무시하는 보다 관대한 알고리즘을 사용합니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.resolveXMLSchemaDTD
_AbsoluteImportResolver 클래스에 표시된 스키마나 WSDL 파일도 http://www.w3.org/2001/XMLSchema.dtd DTD를 참조하는 경우에도, JAX-RPC 애플리케이션이 제대로 시작되게 하려면 이 사용자 정의 특성을 사용하십시오.
WSDDPort W com.ibm.ws.webservices.engine.deployment.wsdd.WSDDPort expand
WSWS3114E: Error: Internal error.
java.net.UnknownHostException: www.w3.org
이 사용자 정의 특성을 true로 설정하면 _AbsoluteImportResolver 클래스에 표시된 스키마나 WSDL 파일도 http://www.w3.org/2001/XMLSchema.dtd DTD를 참조하는 경우에도, JAX-RPC 애플리케이션이 제대로 시작됩니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.searchForAppServer
DualMetaDataLoaderImpl E loadWebContainerPorts could not find any http or https ports 메시지가 시스템 로그에 전송되는지 여부를 제어하려면 이 특성을 사용하십시오.
시스템 구성에 따라, 웹 서비스 애플리케이션이 웹 서버와 애플리케이션 서버에 모두 설치되어 있으면 유효한 구성인 경우에도 오류가 발생했음을 나타내는 이 메시지가 시스템에서 발행될 수 있습니다. 그러므로 웹 서버와 애플리케이션 서버 모두에서 웹 서비스 애플리케이션을 설치하는 경우, 이러한 메시지가 시스템 로그에 전송되지 않기를 원할 수도 있습니다.
com.ibm.ws.webservices.searchForAppServer 특성이 true로 설정되면 발행된 DualMetaDataLoaderImpl E loadWebContainerPorts could not find any http or https ports 메시지가 시스템 로그에 전송되지 않습니다. 이 특성을 지정하지 않거나 false로 설정하는 경우에는 시스템 로그로 메시지가 전송됩니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.serialize.2DimArray.asArrays
JAX-RPC 런타임이 2차원 XML 배열을 일련의 배열로 직렬화하게 하려면 이 특성을 사용하십시오.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
기본값은 false입니다.
다음 메시지 스니펫에는 이 특성을 false로 설정할 때 2차원의 XML 배열을 나타내기 위한 올바른 형식인 일련의 요소가 표시됩니다.
<p565:sayHelloResponse xmlns:p565="http://ibm.com">
<sayHelloReturn xsi:type="soapenc:Array"
soapenc:arrayType="xsd:string[2,3]">
<item xsi:type="xsd:string">array1 element1</item>
<item xsi:type="xsd:string">array1 element2</item>
<item xsi:type="xsd:string">array1 element3</item>
<item xsi:type="xsd:string">array2 element1</item>
<item xsi:type="xsd:string">array2 element2</item>
<item xsi:type="xsd:string">array2 element3</item>
</sayHelloReturn>
</p565:sayHelloResponse>
다음 메시지 스니펫에는 이 특성을 true로 설정할 때 2차원의 XML 배열을 나타내기 위한 올바른 형식인, 각각 세 개의 요소가 있는 두 개의 배열 중 하나가 표시됩니다.
<p565:sayHelloResponse xmlns:p565="http://ibm.com">
<sayHelloReturn xsi:type="soapenc:Array"
soapenc:arrayType="xsd:string[][2]">
<item soapenc:arrayType="xsd:string[3]">
<item>array1 element1</item>
<item>array1 element2</item>
<item>array1 element3</item>
</item>
<item soapenc:arrayType="xsd:string[3]">
<item>array2 element1</item>
<item>array2 element2</item>
<item>array2 element3</item>
</item>
</sayHelloReturn>
</p565:sayHelloResponse>
com.ibm.ws.webservices.serializeDetailElementUsingDefaultNamespace
애플리케이션 서버가 실제 접두부 이름을 사용하여 결함 세부사항을 정의하는 네임스페이스를 찾는지 또는 기본 네임스페이스를 사용하여 결함 세부사항을 정의하는지 여부를 지정하려면 이 특성을 사용하십시오.
JAX-RPC 웹 서비스가 SOAP 결함에 응답할 경우 일반적으로 실제 접두부 이름을 사용하여 결함 세부사항 컨텐츠를 정의하는 네임스페이스를 찾습니다. 이런 상황에서 애플리케이션 서버가 일반적으로 발행하는 메시지 예제는 다음과 같습니다.
<soapenv:Fault
xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/">
<faultcode xmlns="http://sample">
sampleFault
</faultcode>
<faultstring>sample text</faultstring>
<detail encodingStyle="">
<sampleFault
xmlns="http://sample">
...
</sampleFault>
</detail>
<soapenv:Fault>
애플리케이션 서버가 .Net 클라이언트와 통신해야 하고 이 .Net 클라이언트에서 기본 네임스페이스를 사용하여 결함 세부사항의 컨텐츠를 정의해야 할 경우 이 특성을 true로 설정하십시오. 이 특성을 true로 설정한 경우 애플리케이션 서버가 발행한 메시지는 이전 버전에서 버전 6.x 애플리케이션 서버로 전송한 메시지와 유사합니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.webservices.suppressHTTPRequestPortSuffix
이 특성을 사용하여 SOAP 메시지를 전송하는 HTTP POST 요청에 포트 번호를 남겨둘 수 있는지 여부를 제어합니다.
일부 웹 서비스 구현은 SOAP 메시지를 전송하는 HTTP POST 요청에 포트 번호가 있는 경우 이를 제대로 허용하지 못합니다. SOAP 메시지를 전송하는 HTTP POST 요청에 포트 번호가 있는 것을 허용할 수 없는 웹 서비스와 상호 운용해야 하는 웹 서비스 클라이언트를 보유한 경우 이 사용자 정의 특성을 true로 설정하십시오.
이 특성을 true로 설정하면 전송하기 전에 HTTP POST 요청에서 포트 번호가 제거됩니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.websvcs.attachments.sizethreshold
JAX-WS 클라이언트 또는 서비스에서 메모리에 쓸 수 있는 최대 첨부 크기(바이트)를 지정하려면 이 특성을 사용하십시오. 기본적으로 최대 첨부 파일 크기는 11MB로 설정됩니다. 이 값을 사용하는 중에 첨부 파일이 11MB를 초과하는 경우, 첨부 파일은 메모리에 기록되는 대신 파일 시스템에 캐시됩니다. 이 사용자 정의 특성을 사용하는 경우 최대 캐시 크기를 늘리면 성능 및 Java 힙에 대해서는 잠재적으로 더 큰 영향을 미칩니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.websvcs.getJAXBContext.cacheClassList
패키지에 포함된 JAXB(Java Architecture for XML Binding) 클래스의 목록을 캐시하려면 이 특성을 사용하십시오.
일반적으로 JAXBContext를 빌드할 때 패키지에 ObjectFactory 또는 package-info 클래스 파일이 포함되지 않은 경우 모든 잠재적인 JAXB 클래스에 대해 패키지를 검색합니다. 이 검색 프로세스에 시간이 걸릴 수 있고, JAR 파일 잠금으로 이 프로세스가 지연될 수 있습니다. 각 패키지의 클래스 목록을 캐시하여 동일한 패키지를 이후에 검색할 필요성이 사라지게 하려면 이 특성을 true로 설정하십시오. 이후에 JAXBContext를 작성할 때 새로운 검색을 시작하는 대신 클래스 목록의 캐시된 버전을 검색하도록 요청합니다.
SoftReference를 사용하여 클래스 목록 캐시가 작성되므로 사용 가능한 메모리가 적을 경우에는 캐시를 해제할 수 있습니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.websvcs.getJAXBContext.cacheClassList.persist
패키지에 포함된 JAXB(Java Architecture for XML Binding) 클래스의 디스크 캐시를 작성하려면 이 특성을 사용하십시오.
일반적으로 JAXBContext를 빌드할 때 패키지에 ObjectFactory 또는 package-info 클래스 파일이 포함되지 않은 경우 모든 잠재적인 JAXB 클래스에 대해 패키지를 검색합니다. 이 검색 프로세스에 시간이 걸릴 수 있고, JAR 파일 잠금으로 이 프로세스가 지연될 수 있습니다. 각 패키지의 클래스 목록의 디스크 캐시를 작성하여 동일한 패키지를 이후에 검색할 필요성이 사라지게 하려면 이 특성을 true로 설정하십시오. 이후에 JAXBContext를 작성할 때 새로운 검색을 시작하는 대신 클래스 목록의 캐시된 버전을 검색하도록 요청합니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.websvcs.logOperationExceptionAsDebug
SOAP 결함 예외는 항상 SystemOut.log 및 Trace.log에 기록되는 log.error를 사용하여 기록됩니다. 추적이 사용으로 설정된 경우에 SOAP 결함 예외가 Trace.log에만 로그되고 SystemOut.log에 로그되지 않도록 하려면 이 특성을 사용하십시오. 이 특성은 SystemOut.log에 로그되는 SOAP 결함 예외의 유형을 구분하지 않습니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.websvcs.suppressHTTPRequestPortSuffix
JAX-WS 런타임이 포트 번호를 요청에 대한 HTTP 호스트 헤더 값에 추가하지 않도록 하려면 이 특성을 사용하십시오.
특히 클라이언트와 클라이언트가 호출하려는 웹 서비스 사이에 비IBM 웹 서버가 있는 경우, JAX-WS 클라이언트는 요청에 대한 응답으로 java.io.IOException을 수신할 수 있습니다. JAX-WS 런타임이 포트 번호를 HTTP 호스트 헤더 값에 추가했기 때문에 이 매개체 서버는 요청을 라우트할 위치를 인식하지 못할 수 있습니다. 예를 들어 JAX-WS 런타임이 헤더 값을 엔드포인트 URL lilygirl.austin.mycompany.com에서 포트 번호를 포함하는 URL lilygirl.austin.mycompany.com:80으로 변경했을 수 있습니다.
JAX-WS 런타임이 포트 번호를 HTTP 호스트 헤더 값에 추가하지 않도록 하려면 이 사용자 정의 특성을 JVM 설정에 추가하고 이를 true로 설정하십시오. 이 특성을 true로 설정하면 호스트 헤더에는 엔드포인트 URL의 호스트 이름만 포함됩니다(예: Host: lilygirl.austin.mycompany.com).
이 특성의 기본값은 false입니다. 이 값은 포트 번호가 호스트 헤더 값에 추가되었음을 의미합니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.websvcs.transport.enableProxyTunnel
기본값은 false입니다.
이 사용자 정의 특성을 사용하기로 결정한 경우 이를 프록시 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.websvcs.relaxClientPolsetMatching
클라이언트 코드가 둘 이상의 아카이브 파일에 걸쳐 적용되는 경우 JAX-WS 클라이언트측 정책 세트가 관리 콘솔을 통해 서비스 또는 하위 레벨에 적용되도록 하려면 이 특성을 사용하십시오.
기본값은 false입니다.
com.ibm.ws.websvcs.transport.jms.enableBasicAuthOnResponse
JMS 정책 세트 기본 권한 부여 사용자 ID 및 비밀번호가 JMS 응답 메시지에 적용되는지 여부를 지정하려면 이 특성을 사용하십시오. 기본적으로 JMS 정책 세트 기본 권한 부여 사용자 ID 및 비밀번호는 JSM 응답 메시지에 적용되지 않습니다.
이 특성을 JSM 설정에 추가하고 true를 이 특성 값으로 지정하면, JMS 정책 세트 기본 권한 부여 사용자 ID 및 비밀번호가 JMS 응답 메시지에 적용됩니다. 이 특성이 false로 설정되면, 사용자 ID도 비밀번호도 적용되지 않습니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.websvcs.unifyServiceMessage
브라우저에 서비스 URL을 입력할 때 JAX-WS 애플리케이션이 브라우저 창에 JAX-WS 특정 메시지 "Hello! This is an Axis2 Web Service!" 대신 JAX-RPC 메시지 "Hi there, this is a Web service!"를 표시하도록 하려면 이 특성을 true로 설정하십시오.
기본값은 false입니다.
com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri
관리 콘솔에서 대체된 엔드포인트 URL 필드에 지정된 엔드포인트 URL에 비관리 JAX-WS 클라이언트 서비스의 요청을 전송하려는 경우가 있습니다. 웹 서비스 클라이언트 포트 구성의 일부로 설정되는 이 관리 필드의 값은 WSDL 파일에 지정된 엔드포인트를 겹쳐씁니다. 이 필드에 대한 자세한 정보는 웹 서비스 클라이언트 포트를 참조하십시오.
일반적으로는 비관리 JAX-WS 클라이언트 서비스가 이 관리 클라이언트 서비스 기능에 액세스하도록 원하지 않습니다. 그러나 이 URL에 액세스하는 비관리 JAX-WS 클라이언트 서비스에 종속될 수 있습니다. 기본적으로 com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri 사용자 정의 특성은 false로 설정되어 비관리 JAX-WS 클라이언트 서비스가 WSDL 파일의 엔드포인트를 겹쳐쓰는 엔드포인트 URL에 액세스할 수 있습니다.
이 사용자 정의 특성은 launchClient를 실행하는 경우 Java EE 클라이언트가 있거나 JAX-WS 클라이언트가 설치된 애플리케이션 서버 레벨에서 설정됩니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.ws.ws.wsba.protocolmessages.twoway
웹 서비스 비즈니스 활동(WS-BA)에 대한 요청을 핸들 중인 애플리케이션 서버의 성능을 개선하려면 이 특성을 사용하십시오. 이 사용자 정의 특성을 true로 지정하면 두 애플리케이션 서버 간에 WS-BA 프로토콜 메시지가 전송될 때 애플리케이션 서버 성능이 개선됩니다. 기본값은 true입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
![[z/OS]](../images/ngzos.gif)
com.ibm.ws390.SystemOutErrCodepage
EBCDIC가 아닌 println, print 및 write 메소드와 함께 System.out 및 System.err를 사용하여 발행된 메시지에 인코딩 스키마를 지정하려면 이 사용자 정의 특성을 사용하십시오. 인코딩 스키마를 지정하지 않은 경우, 기본 인코딩 스키마인 EBCDIC가 이러한 메시지에 사용됩니다.
이 특성에 지정된 값은 문자열 형식이어야 합니다.
이 사용자 정의 특성을 사용하려면, 하위(servant)에 대한 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.wsspi.amm.merge.ignoreValidationExceptions
AnnotativeMetadataManagerImpl merge caught exception while merging com.ibm.wsspi.amm.validate.ValidationException:
the interface com.xyz.app.myappRemote does not define a
valid remote business interface; the method mygetMethod does not
conform to RMI rules.
JVM이 이러한 유효성 검증 예외를 무시하게 하려면 이 특성을 true로 설정하십시오.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버에 대한 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.wsspi.wssecurity.dsig.enableEnvelopedSignatureProperty
7.0.0.21 이하 버전 및 8.0.0.3 이하 버전에서 사용한 동일한 방법으로 WS-Security 런타임에서 XML 디지털 서명을 확인하도록 JVM에 표시하려면 이 사용자 정의 특성을 사용하십시오.
SAML Assertion signature is verified.Core validity=false
Signed info validity=true Signed info
message='null'(validity=false message='Digest value mismatch:
calculated: KCuNwlUAk5+G2PYb8fZ+Y1hTMtw='
uri='#Assertion-1234' type='null')
서명할 요소에 네임스페이스 접두부가 있는 속성이 포함된 경우, WS-Security 런타임은 다이제스트 값을 계산하기 전에 요소를 정규화합니다.
제품의 이 버전 및 7.0.0.23 이상 버전과 8.0.0.4 이상 버전에서 WS-Security 런타임은 네임스페이스 접두부가 있는 요소 속성을 올바르게 처리합니다.
- 이 특성을 true로 설정한 경우,
다음 WS-Security 사용자 정의 특성도 WS-Security 정책 세트 바인딩의
인바운드, 아웃바운드 또는 인바운드 및 아웃바운드 사용자 정의 특성 중
하나로 지정해야 합니다.
com.ibm.wsspi.wssecurity.dsig.oldEnvelopedSignature=true
- 이 특성을 true로 설정하고 SAMLTokenFactory를
사용하여 SAML 토큰을 작성하는 경우, 다음 특성을 SAMLIssuerConfig.properties
파일에 추가하십시오.
com.ibm.wsspi.wssecurity.dsig.oldEnvelopedSignature=true
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버에 대한 JVM 사용자 정의 특성으로 지정해야 합니다.
com.ibm.xml.xlxp.jaxb.opti.level
사용자 정의 특성 값 | 영향 |
---|---|
com.ibm.xml.xlxp.jaxb.opti.level=0 | 최적화 메소드가 사용 가능하지 않습니다. |
com.ibm.xml.xlxp.jaxb.opti.level=1 | 마샬링(marshalling) 해제 최적화 메소드만 사용 가능합니다. |
com.ibm.xml.xlxp.jaxb.opti.level=2 | 마샬링(marshalling) 최적화 메소드만 사용 가능합니다. |
com.ibm.xml.xlxp.jaxb.opti.level=3 | 마샬링(marshalling) 해제 및 마샬링(marshalling) 최적화 메소드가 모두 사용 가능하며, 이는 기본값입니다. |
최적의 성능을 위해서는, 사용자 정의 특성 값을 3으로 설정하십시오. 이 값은 JAXB를 직접 사용하는 애플리케이션 및 웹 서비스의 처리량을 늘립니다. 이 값을 설정한 후 최적화에 대한 문제가 발생하는 경우 임시 해결책으로 값을 0으로 변경하십시오.
이 사용자 정의 특성은 애플리케이션 서버 레벨에서만 설정할 수 있습니다.
com.ibm.xml.xlxp2.api.util.encoding.DataSourceFactory.bufferLength
이를 사용 시 64KB 버퍼(기본값)가 InputStream에 의해 부분적으로만 채워지는 경우 2048과 같은 더 작은 값에 이 JVM 사용자 정의 특성을 설정하면 메모리 사용을 줄일 수 있습니다. 버퍼는 XML 구문 분석기 com/ibm/xml/xlxp2/api/wssec/WSSXMLStreamReader 내에서 캐시됩니다. 메모리 사용량 감소는 각 구문 분석기 오브젝트에 링크된 전체 메모리를 줄입니다.
com.ibm.xml.xlxp2.api.util.Pool.STRONG_REFERENCE_POOL_MAXIMUM_SIZE
이 시스템 특성의 값은 정수이고 설정하면 밀접한 참조를 사용하여 캐시된 XMLStreamReaders 및 XMLStreamWriters의 수를 제한합니다.
OutOfMemoryError를 피하려면, 시스템 특성을 0으로 설정하십시오. 그러면 모든 XMLStreamReaders가 강제로 SoftReferences를 사용하여 캐시되며, 가비지 콜렉터가 임의 시간에 캐시에서 차지하는 메모리를 재확보할 수 있게 합니다.
이 시스템 특성을 설정하지 않는 경우 기본값은 10입니다.
config_consistency_check
- 셀에 정의된 애플리케이션 서버 또는 클러스터가 많을수록 구성 변경을 저장하는 데 많은 시간이 소요됩니다.
- 셀에 배치된 애플리케이션이 많을수록 구성 변경을 저장하는 데 많은 시간이 소요됩니다.
구성 변경을 변경하는 데 필요한 시간이 불충분한 경우, JVM 설정에 config_consistency_check 사용자 정의 특성을 추가하고 이 특성 값을 false로 설정할 수 있습니다.

deactivateWildCardURIMapping
웹 애플리케이션에서 ibm-web-ext.xmi 파일의 file.serving.patterns.allow 속성에 지정된 URI 패턴이 plugin-cfg.xml 파일 생성기에 인식되도록 하려면 이 특성을 사용하십시오.
plugin-cfg.xml 파일 생성자는 ibm-web-ext.xmi 파일의 FileServingEnable 속성이 true로 설정된 경우 file.serving.patterns.allow 속성에 지정된 URI 패턴만 인식합니다. 그러나 FileServingEnabled 속성이 true로 설정되면 plugin-cfg.xml 파일 생성기가 plugin-cfg.xml 파일에 와일드카드 URI 맵핑, /* ,을 자동으로 추가하므로, 고유 파일 제공 패턴을 정의할 필요가 없게 됩니다.
deactivateWildCardURIMapping 특성을 true로 설정하면 plugin-cfg.xml 파일 생성자가 /*를 plugin-cfg.xml 파일에 추가하지 않으며, plugin-cfg.xml 파일 생성자에서 file.serving.patterns.allow 속성에 지정된 URI 패턴이 인식됩니다. 이 특성이 JVM 설정에 추가되지 않거나 false로 설정된 경우 /*가 plugin-cfg.xml 파일에 자동으로 추가됩니다.
이 특성은 배치 관리자 레벨에서 설정됩니다.
DISABLE_LOCAL_COMM_WHEN_SSL_REQUIRED
전송 레벨 SSL이 클라이언트측 또는 서버측에서 지원되고 다른 측에서는 필수인 경우 localComm 또는 SSL을 사용해야 하는지 여부를 지정합니다.
전송 레벨 SSL이 클라이언트측 또는 서버측에서 지원되고 다른 측에서는 필수인 경우 localComm을 사용하면 안됩니다. 이 경우 localComm 대신 SSL을 사용하도록 이 사용자 정의 특성을 true로 설정해야 합니다.
이 특성의 기본값은 false이며, localComm이 사용됨을 의미합니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
- CSIv2 인바운드 전송 설정을 SSL 지원 또는 SSL 필수로 설정해야 합니다. 이러한 설정에 대한 자세한 정보는 인바운드 전송 구성 주제를 참조하십시오.
- 클라이언트측의 sas.client.props 파일에서 com.ibm.CORBA.loginSource 특성을 none으로 설정해야 합니다.
- 다음 설정 중 하나가 클라이언트측에 있어야 합니다.
- com.ibm.CSI.performTransportAssocSSLTLSRequired=true
- com.ibm.CSI.performTransportAssocSSLTLSSupported=true
또는 WebSphere 서버가 클라이언트의 역할을 하는 경우, 해당 서버에서 CSIv2 인바운드 전송 설정을 SSL 지원 또는 SSL 필수로 설정해야 합니다.
disableWSAddressCaching
웹 서비스의 주소 캐싱을 사용 불가능하게 하려면 이 특성을 사용하십시오. 시스템이 일반적으로 많은 클라이언트 스레드로 실행되며 wsAddrCache 캐시에서 잠금 회선 경합이 발생하는 경우 이 사용자 정의 특성을 true로 설정하여 웹 서비스 데이터가 캐싱되지 않게 할 수 있습니다.
0의 값 또는 다른 양의 정수로 networkaddress.cache.ttl을 지정하는 경우 이 특성은 웹 서비스 엔진에서 IP 주소의 캐싱을 방지하려면 true로 설정해야 합니다. Networkaddress.cache.ttl은 성공적인 검색을 캐시하는 시간(초)을 나타내는 데 사용됩니다.
기본값은 false입니다.
DRS_BATCH_INTERVAL_SIZE
DRS(Data Replication Service) 복제 HTTP 세션 데이터의 일괄처리에 포함할 수 있는 최대 수의 오브젝트를 지정합니다. 복제하는 HTTP 세션 데이터에 지정된 수 미만의 오브젝트가 있는 경우, 모든 세션 데이터가 단일 일괄처리에 복제됩니다.
기본적으로 DRS는 일괄처리에 50개의 HTTP 세션 데이터 오브젝트를 복제합니다. 대용량 메시지를 직렬화하면 메모리 부족 조건이 발생할 수 있으므로, 특히 완전히 채워져 설정된 복제 도메인을 결합하는 애플리케이션 서버가 있는 경우 각 일괄처리에 보다 적은 수의 오브젝트를 포함할 수 있습니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
DRS_THREADPOOL_MINSIZE
DRS(Data Replication Servic) 스레드 풀에 허용할 최소 스레드 수를 지정합니다.
애플리케이션 서버가 시작될 때 스레드는 초기에 스레드 풀에 지정되지 않습니다. 애플리케이션 서버에 지정된 워크로드에 스레드가 필요한 경우, 풀의 스레드 수가 이 사용자 정의 특성에 지정된 스레드 수와 동일해질 때까지 스레드가 스레드 풀에 추가됩니다. 시간 상으로 이 시점 뒤에 추가 스레드가 추가되고 워크로드 변경사항으로 제거됩니다. 그러나 일부 스레드가 대기 상태가 되더라고 풀의 스레드 수는 이 사용자 정의 특성에 지정된 수 아래로는 감소하지 않습니다.
이 사용자 정의 특성의 기본값은 40개의 스레드입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
DRS_THREADPOOL_MAXSIZE
DRS 스레드 풀에서 유지보수할 최대 스레드 수를 지정합니다.
이 사용자 정의 특성의 기본값은 100개의 스레드입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
DRS_THREADPOOL_ISGROWABLE
DRS 스레드 풀에 대해 구성된 최대 크기를 초과하여 스레드 수를 늘릴 수 있는지 여부를 지정합니다.
작성할 수 있는 최대 스레드 수는 JVM(Java Virtual Machine) 및 운영 체제 한계 내에서만 제한됩니다. 커질 수 있는 스레드 풀이 최대 크기를 초과하여 확장될 경우, 추가 스레드는 다시 사용되지 않고 작성된 대상 작업 항목의 처리가 완료된 후에 풀에서 버려집니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
dynacache.jms.cacheInstance
동적 캐시 서비스 다중 셀 및 다중 코어 그룹 무효화가 사용될 때 이 특성을 사용하여 무효화 처리에 사용할 캐시 인스턴스를 지정하십시오. 이 특성을 "*"로 설정하면 모든 캐시 인스턴스에서 무효화 ID가 처리됩니다. 이 특성은 서비스 통합 버스 서버에 설정해야 합니다.
기본적으로 baseCache 캐시 인스턴스가 사용됩니다. 관리 콘솔을 사용하여 시스템에 정의된 캐시 인스턴스의 이름을 판별할 수 있습니다.
이 사용자 정의 특성을 사용하려면, 달리 명시되어 있지 않은 한 특정 태스크의 컨텍스트에 애플리케이션 서버 JVM 사용자 정의 특성으로 지정하십시오.
dynacache.jms.connRetryInterval
동적 캐시 서비스 다중 셀 및 다중 코어 그룹 무효화가 사용될 때 이 특성을 사용하여 서비스 통합 버스 서버에 다시 연결하려 시도하기 전에 클러스터 멤버가 대기하는 시간(초)을 지정하십시오.
이 특성의 기본값은 30입니다.
이 사용자 정의 특성을 사용하려면, 달리 명시되어 있지 않은 한 특정 태스크의 컨텍스트에 애플리케이션 서버 JVM 사용자 정의 특성으로 지정하십시오.
dynacache.jms.invProcessingDelay
동적 캐시 서비스 다중 셀 및 다중 코어 그룹 무효화가 사용될 때 이 특성을 사용하여 서비스 통합 버스 서버에서 무효화 ID가 처리되기 전에 큐에서 대기하는 시간(초)을 지정하십시오.
이 특성의 기본값은 20입니다.
이 사용자 정의 특성을 사용하려면, 달리 명시되어 있지 않은 한 특정 태스크의 컨텍스트에 애플리케이션 서버 JVM 사용자 정의 특성으로 지정하십시오.
dynacache.jms.numStoredInvalidations
동적 캐시 서비스 다중 셀 및 다중 코어 그룹 무효화가 사용될 때 이 특성을 사용하여 서비스 통합 버스 서버가 사용 가능하게 될 때까지 대기하는 동안 클러스터 멤버가 저장할 수 있는 무효화 ID의 최대 수를 지정하십시오. 임계값에 도달하면 새 ID가 추가될 때 가장 오래된 무효화 ID가 제거됩니다.
이 특성의 기본값은 10000입니다.
이 사용자 정의 특성을 사용하려면, 달리 명시되어 있지 않은 한 특정 태스크의 컨텍스트에 애플리케이션 서버 JVM 사용자 정의 특성으로 지정하십시오.
![[z/OS]](../images/ngzos.gif)
invocationCacheSize
호출 캐시의 크기를 제어하려면 이 특성을 사용하십시오. 호출 캐시는 요청 URL을 서블릿 자원에 맵핑하기 위한 정보를 보유합니다. 요청을 처리하는 데 사용 가능한 각각의 작업자 스레드에 대해 요청된 크기의 캐시가 작성됩니다. 호출 캐시의 기본 크기는 50입니다. 50개를 초과하는 고유한 URL을 사용 중인 경우(각각의 JavaServer 페이지가 고유한 URL임), 호출 캐시의 크기를 늘려야 합니다.
캐시가 클수록 보다 많은 Java 힙이 사용되므로 최대 Java 힙 크기를 늘려야 할 수도 있습니다. 예를 들어, 각 캐시 항목에 2KB가 필요하고 최대 스레드 크기는 25로 설정되어 있으며 URL 호출 캐시 크기가 100이면 5MB의 Java 힙이 필요합니다.
캐시 크기에 대해 0보다 큰 숫자를 지정할 수 있습니다. 값을 0으로 설정하면 호출 캐시를 사용할 수 없습니다.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
java.net.preferIPv4Stack
IPv6 지원을 사용 불가능하게 하려면 이 특성을 사용하십시오. IPv6 지원이 사용 가능한 운영 체제에서 제품에 사용되는 기본 소켓은 IPv6 소켓입니다. IPv6 맵핑된 주소를 지원하는 IPv4 네트워크 스택에서는 IPv6 소켓을 사용하여 IPv4 및 IPv6 호스트로 연결하거나 이들 호스토루버틔 연결을 허용할 수 있습니다.
이 특성을 true로 설정하면 JVM에서 이중 모드 지원이 사용 불가능하게 되어 제품이 제대로 기능하지 않을 수 있습니다. 따라서 이 특성을 사용하기 전에 전체 의미를 이해해야 합니다. 일반적으로 이 특성의 설정은 권장되지 않습니다.
이 사용자 정의 특성의 기본값은 false입니다(기본값이 true인 Microsoft Windows 운영 체제 제외).
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
java.net.preferIPv6Addresses
IPv4 지원을 사용 불가능하게 하려면 이 특성을 사용하십시오. 이 특성을 true로 설정하면 JVM에서 이중 모드 지원이 사용 불가능하게 되어 제품이 제대로 기능하지 않을 수 있습니다. 따라서 이 특성을 사용하기 전에 전체 의미를 이해해야 합니다. 일반적으로 이 특성의 설정은 권장되지 않습니다.
이 사용자 정의 특성의 기본값은 false입니다(기본값이 true인 Windows 운영 체제 제외).
java.util.logging.configureByLoggingPropertiesFile
JVM이 JSR-47 로깅을 구성하는 데 logging.properties 파일을 사용하는지 여부를 지정하려면 이 사용자 정의 특성을 사용하십시오.
이 특성이 JVM 구성 설정값에 추가되지 않거나 false로 설정된 경우, 제품이 기본 JSR47 로깅 구성을 java.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager 시스템 특성 설정으로 대체하므로 logging.properties 파일에 포함된 구성 설정값은 선택되지 않습니다. 이러한 상황에서는 핸들러 및 포맷터 추가와 같이 프로그래밍 방식으로 변경할 수 있는 로깅 설정만 수정할 수 있습니다.
logging.properties 파일은 <<WAS_install>>/java/jre/lib/logging.properties 디렉토리에 있으며,
필요에 따라 사용자 정의할 수 있습니다.
logging.properties 파일은
<<WAS_install>>/java/J*/lib/logging.properties 디렉토리에 있으며,
필요에 따라 사용자 정의할 수 있습니다.
기본값은 false입니다.
jaxws.asyncClient.maxThreadPoolSize
JAX-WS 비동기 클라이언트 요청에 대해 동시에 실행되는 스레드 수를 제한하려면 이 특성을 사용하십시오.
기본적으로 스레드 수는 제한되지 않습니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
jaxws.handler.reducecaching
JAX-WS 스레드가 SOAP 메시지를 올바르게 업데이트하도록 하려면 이 특성을 사용하십시오.
JAX-WS 핸들러로 업데이트된 SOAP 메시지는 핸들러에서 덤프 시 올바르게 표시되지만 메시지를 전송하면 변경사항이 누락됩니다. 핸들러가 getMessage()를 여러 번 호출하고 메시지가 유실되면 이 특성을 true로 설정하십시오.
기본값은 false입니다.
jaxws.ignore.extraWSDLOps
클라이언트에 빌드된 오퍼레이션보다 많은 오퍼레이션이 WSDL에 있는 경우 이 특성을 사용하십시오.
기본 클라이언트 동작은 WSDL의 오퍼레이션에 대해 클라이언트에 빌드된 오퍼레이션의 유효성을 검증하는 것이고 해당 오퍼레이션이 일치하지 않는 경우 실패합니다. 클라이언트에 빌드된 오퍼레이션보다 많은 오퍼레이션이 WSDL에 있고 WSDL 유효성 검증에 성공하여 클라이언트를 호출할 수 있는 경우 이 특성을 true로 설정하십시오.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
jaxws.ignoreMetadataComplete
모듈에서 metadata-complete이 설정되어 있는 경우라도 웹 서비스 어노테이션 스캔을 수행하려면 이 JVM 특성을 true로 설정하십시오. 기본값은 false입니다.
기본적인 경우 JAX-WS 웹 서비스는 metadata-complete이 true로 설정되어 있는 경우 발견되지 않습니다.
jaxws.JAXBContext.permStoreCostThresholdMsec
구성을 위해 지정된 시간보다 더 많은 시간이 필요한 JAXBContext 오브젝트의 캐싱을 사용하려면 이 특성을 사용사십시오.
JAX-WS 웹 서비스나 클라이언트에서 수백 개의 클래스를 처리하는 JAXBContext 오브젝트 구성 시 실행 중에 지연이 발생할 수 있습니다. 시간 집약적인 JAXBContext 오브젝트를 캐싱하면 각 사용에서 JAXBContext 오브젝트를 재구성할 필요가 없어져 웹 서비스 및 클라이언트의 실행이 가속화됩니다.
구성을 위해 지정된 시간보다 더 많은 시간이 필요한 JAXBContext 오브젝트의 캐싱을 사용하려면 이 특성을 0보다 큰 값(밀리초)으로 설정하십시오. JVM가 다시 시작될 때까지 캐시가 지속됩니다. 권장값은 5000밀리초 이상입니다.
기본값은 0이며, 이는 캐싱을 사용 가능하게 하지 않습니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
jaxws.JAXBContext.permStoreMaxSize
JAXBContext 캐시의 최대 항목 수를 지정하려면 이 특성을 정수 값으로 설정하십시오. 캐시가 가득 차면 무효 항목이 먼저 대체되고 다음으로 구성 시간이 가장 짧은 항목이 대체됩니다.
기본값은 32입니다.
jaxws.JAXBContext.permStoreStaleThresholdHours
일정 시간 후에 액세스되지 않은 JAXBContext 캐시의 항목은 무효로 간주하도록 이 특성을 일정 시간에 해당하는 값(시간)으로 설정하십시오. 캐시가 가득 차면 무효 항목이 먼저 대체됩니다.
기본값은 24시간입니다.
jaxws.payload.highFidelity
손실 없는 전송을 사용 가능하게 하려면 이 특성을 사용하십시오. 이 특성을 true로 설정하면 웹 서비스 런타임 시 수신 메시지와 SOAPHandler 경계의 메시지가 동일하도록 보장됩니다.
일반적으로 JAX-WS SOAPHandler에 의해 수신되는 SOAP 메시지는 인바운드 SOAP 메시지와 정확하게 동일하지 않습니다. 예를 들어 JAX-WS SOAPHandler에 의해 수신되는 메시지는 원래의 인바운드 메시지와 다른 xml 접두부를 사용할 수 있습니다. 이렇게 감지하기 힘든 변경사항은 메시지의 논리적 해석에 영향을 미치지 않습니다. 그러나 SOAPHandler 경계의 메시지가 수신 메시지와 정확하게 동일해야 하는 경우에는 이 특성을 JVM 설정에 추가하고 특성을 true로 설정해야 합니다. 예를 들어 정규 스펙(C14N)에서는 접두부 이름이 보존되어야 합니다.

기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
jaxws.provider.interpretNullAsOneway
javax.xml.ws.Provider 어노테이션을 사용하여 제공자 기반 엔드포인트를 정의하는 JAX-WS 웹 서비스가 있고 WSDL 파일이 지정되지 않은 경우, 이 사용자 정의 특성을 사용하여 제공자가 invoke() 메소드에서 널값을 리턴할 때 JAX-WS 런타임 환경이 작동하는 방법을 제어할 수 있습니다. 기본적으로 런타임 환경은 비어 있는 SOAPBody 요소를 포함하는 SOAPEnvelope으로 구성된 응답을 전송합니다.
이 특성을 true로 설정하면, 제공자 구현이 널값을 리턴하고 WSDL 파일이 정의되지 않은 경우에는 언제나 런타임 환경이 제공자 구현으로부터 리턴되는 널값을 요청 전용 조작으로 해석하므로 응답이 리턴되지 않습니다. 모든 요청 전용 조작의 경우처럼 WS-Transactions 같은 일부 서비스 품질은 사용할 수 없게 됩니다.
javax.xml.ws.WebServiceProvider 어노테이션이 WSDL 값을 지정하고 WSDL이 요청 및 응답 조작을 정의하는 경우, JAX-WS 런타임 환경은 항상 이 특성의 설정과 관계 없이 비어 있는 SOAPBody를 포함하는 SOAPEnvelope으로 구성된 응답을 리턴합니다.
기본값은 false입니다.
기본값을 변경할 필요가 있는 각 서버에 대해 이 특성을 true로 설정해야 합니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
jaxws.runtime.inheritedImplMethodsAccessible
상속된 메소드를 호출할 수 있도록 웹 서비스 런타임을 수정하려면 이 특성을 사용하십시오. 이러한 동작 변경을 사용하려면 특성을 true로 설정하십시오.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
jaxws.runtime.restrictStaticWebmethod
정적 조작의 노출을 방지하려면 이 특성을 사용하십시오. 이 특성을 true로 설정하면, JAX-WS 런타임이 정적 조작의 노출을 방지합니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
jaxws.soapfault.local.exceptions.disable
JAX-WS 클라이언트에서 로컬로 발생하는 예외가 SOAPFault로 처리되지 않도록 하려면 jaxws.soapfault.local.exceptions.disable 특성을 사용하십시오. 기본적으로 JAX-WS 클라이언트에서 로컬 예외가 발생할 경우 예외에 대한 SOAPFault가 작성됩니다. 잘못된 호스트 또는 포트로 인해 발생한 ConnectException이 로컬 예외 예제입니다. 관련 JAX-WS 애플리케이션 핸들러 handleFault 메소드가 SOAPFault와 함께 호출된 다음, JAX-WS 클라이언트의 호출된 메소드를 통해 SOAPFaultException이 발생합니다.
이 특성을 true로 설정하면 로컬 예외에서 빈 메시지를 작성합니다. 관련 JAX-WS 애플리케이션 핸들러 handleMessage 메소드가 빈 메시지와 함께 호출된 다음, JAX-WS 클라이언트의 호출된 메소드를 통해 WebServiceException이 발생합니다. 이는 이전 릴리스의 동작입니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
jaxws.useSafeIPC
웹 컨테이너에서 enableInProcessConnections 특성이 true로 설정되고 JAX-WS 웹 서비스에서 오류가 발생하는 경우 애플리케이션 서버에서 이 특성을 true로 설정하십시오. 서로를 호출하는 웹 서비스 애플리케이션에서 단일 스레드를 안전하게 공유할 수 없는 경우 이러한 문제가 발생할 수 있습니다. 이 특성을 true로 설정하면 애플리케이션이 개별 스레드에서 실행되게 됩니다.
기본값은 false입니다.
jdk.corba.allowOutputStreamSubclass
org.omg.CORBA_2_3.portable.OutputStream을 서브클래스로 분류하려면 이 특성을 true로 설정하십시오.
보안 관리자로 실행하는 애플리케이션은 보안 관리자가 설치될 때 org.omg.CORBA_2_3.portable.OutputStream 기본 생성자를 보안하기 위해 현재 수행되는 추가 보안 검사 때문에 성능 저하가 발생할 수 있습니다. 이러한 추가 보안 검사는 기존 애플리케이션 배치와 비호환성 문제가 발생할 수 있습니다. 이 특성을 JVM 설정에 추가하고 true로 설정하면 이러한 비호환성 문제를 방지할 수 있습니다.
이 특성은 애플리케이션 서버, 노드 에이전트 또는 배치 관리자에서 설정할 수 있지만 일반적으로 애플리케이션 서버 레벨에 지정합니다.
ODCClearMessageAge
이 특성을 사용하여 수신자가 메시지를 수신확인하지 않은 경우에도 게시판에서 ODC 메시지를 제거하는 시간(밀리초)을 설정합니다. 이 특성 값을 지정하면 어떤 이유로든 수신확인되지 않은 메시지를 빌드하지 않을 수 있습니다.
이 특성 값으로 양의 정수를 지정할 수 있지만, 메시지를 너무 일찍 제거하지 않으려면 300000(5분) 이상의 값이 권장됩니다.
기본값은 300000밀리초입니다.
ODCInit.disabled
모든 로컬 ODC 처리 및 On Demand Configuration(ODC) 컴포넌트에 대한 프로세스 사이의 통신을 사용 불가능하게 하려는 경우 이 특성을 true로 설정하십시오.
웹 서비스 기반 애플리케이션을 배치할 경우, 그리고 WebSphere Application Server Proxy Server를 사용하여 요청을 처리할 경우 On-Demand 구성 컴포넌트를 사용합니다. On-Demand 구성 컴포넌트는 셀 범위를 기반으로 활성화 또는 비활성화됩니다. 따라서 토폴로지에 프록시 서버 또는 웹 서비스 기반 애플리케이션이 포함된 경우 On-Demand 구성 서비스를 비활성화해야 합니다.
웹 서비스 기반 애플리케이션이 배치되지 않거나 WebSphere Application Server Proxy Server를 사용하여 요청을 처리하지 않는 대형 토폴로지 환경에서 실행 중인 경우 On-Demand 구성 컴포넌트가 사용되지 앟고 이 특성을 true로 설정할 수 있습니다. 이 특성을 true로 설정하면 네트워크 대역폭 및 CPU 사용량을 줄일 On Demand Configuration 컴포넌트를 사용 불가능하게 할 수 있습니다.
기본값은 false입니다.
org.apache.aries.blueprint.header.mandatory
true로 설정된 경우 설계도가 있는 번들에는 설계도 헤더가 있어야 합니다. 따라서 Apache는 설계도 헤더가 없는 경우 비용이 많이 드는 스캐닝을 회피할 수 있습니다.
org.apache.axiom.attachments.tempfile.expiration
AxisXXXXXX.att 양식의 임시 파일이 과도하게 축적된 경우, 일정 시간 후에 JAX-WS 런타임에서 MTOM 첨부 항목이 저장된 임시 파일을 삭제하도록 이 특성을 일정 시간에 해당하는 값(초)으로 설정하십시오.
기본값은 0입니다. JVM이 있으면 파일이 삭제됩니다.
org.apache.el.parser.SKIP_IDENTIFIER_CHECK
EL 변수 ID의 발생 검사를 완화하려면 이 특성을 사용하십시오. 완화된 검사 동작은 버전 8.0 이전의 WebSphere Application Server 버전에서 관찰되는 동작과 동등합니다.
버전 8.0부터 EL 변수 ID의 검사가 더 엄격합니다. 검사 프로세스는 이제 Java 예약 키워드뿐 아니라 예약된 EL 키워드를 검사합니다. 버전 8.0 이전의 경우 검사 프로세스는 예약된 EL 키워드만 검사했습니다.
JSTL/EL 스크립트에 사용된 변수 ID에 예약된 JSP 키워드가 포함되어 있는 경우에는 변수 ID가 변환되지 않아 예외가 발생합니다. 이러한 예외를 처리하는 기본 방법은 변수 이름으로 예약된 키워드의 사용을 제거하기 위해 JSTL/EL 코드를 수정하는 것입니다. 그러나 이 방법이 불가능하거나 실용적이지 않은 경우 버전 8.0 이전 레벨에 발생하는 검사 레벨을 완화시키려면 이 특성을 true로 설정하십시오.
예약된 JSP 키워드의 목록은 http://docs.oracle.com/javaee/5/tutorial/doc/bnahq.html#bnail에 있습니다.
org.eclipse.jst.j2ee.commonarchivecore.disableZip
ZIP 아카이브를 단순 파일로 처리하려면 이 사용자 정의 특성을 사용하십시오.
배치된 애플리케이션의 파일을 스캔할 때 ZIP 아카이브를 단순 파일로 처리하려면 이 특성을 true로 설정하십시오.
기본값은 false입니다.
이 특성은 무시되는 ZIP 파일의 애플리케이션을 실행하는 IBM WebSphere Application Server 프로세스의 사용자 정의 특성으로 설정해야 합니다.
org.eclipse.jst.j2ee.commonarchivecore.ignore.ejb.in.war
- Java EE 5 애플리케이션이 있습니다.
- 이 애플리케이션에는 WAR 파일에 EJB가 포함됩니다.
- 애플리케이션은 WebSphere Application Server 버전 7.x를 실행하는 독립형 서버에 배치됩니다.
- WebSphere Application Server 버전 8.0 이상을 실행하는 배치 관리자에서 버전 7.x를 실행하는 노드로 배치를 시도하면 애플리케이션 배치가 실패합니다.
이전 조건 모두가 true이면, 애플리케이션이 배치 도중 Java EE 6 레벨로 승격되므로 배치가 실패할 수 있습니다. WebSphere Application Server 버전 7.x는 Java EE 5를 구현하고, EJB는 Java EE 6까지 WAR 파일에 도입되지 않았습니다. WebSphere Application Server 버전 8.0 이상이 WAR 파일에서 EJB를 찾으면, WAR를 버전 3.0으로, 애플리케이션을 Java EE 6으로 승격시킵니다. 이런 경우 애플리케이션은 WebSphere Application Server 버전 7.x를 실행 중인 노드에 배치될 수 없습니다.
WAR 파일에서 EJB를 무시하고 애플리케이션 버전이 업그레이드되지 않도록 하려면, 배치 관리자에서 특성을 true로 설정하십시오. 기본값은 false입니다.
Ignore-Ejb-In-War-Annotation: true
org.eclipse.jst.j2ee.commonarchivecore.FILTERBINARIES
런타임 처리 중에 특정 애플리케이션 파일이 나열될 수 없도록 이 사용자 정의 특성을 사용하십시오.
새 JavaEE5 어노테이션 처리 요구사항으로 인해, 일반적으로 이전 버전의 제품에 나열된 애플리케이션 파일보다 많은 파일이 런타임 처리 시에 나열됩니다. 추가 목록으로 인해 애플리케이션 파일을 나열하는 데 시간이 보다 소요되므로 이전 버전의 제품에서 마이그레이션된 애플리케이션은 더 늦게 시작합니다.
기본값은 설정되어 있지 않습니다.
이 사용자 정의 특성을 사용하려면, 애플리케이션 서버 JVM 사용자 정의 특성으로 지정해야 합니다.
org.eclipse.jst.j2ee.commonarchivecore.ignore.jee6.annotation
- Java EE 5 애플리케이션이 있습니다.
- 애플리케이션이 Java EE 6 어노테이션을 포함합니다.
- 애플리케이션이 WebSphere Application Server 버전 7.x를 실행 중인 독립형 서버에 배치됩니다.
- WebSphere Application Server 버전 8.0 이상을 실행 중인 배치 관리자에서 WebSphere Application Server 버전 7.x를 실행 중인 노드로의 배치를 시도하면 애플리케이션 배치가 실패합니다.
이전 조건 모두가 true이면, 애플리케이션이 배치 도중 Java EE 6 레벨로 승격되므로 배치가 실패할 수 있습니다. WebSphere Application Server 버전 7.x는 Java EE 5를 구현하고 Java EE 6 어노테이션을 무시합니다. WebSphere Application Server 버전 8.0 이상에서는 Java EE 6을 구현하므로 Java EE 6 어노테이션이 처리됩니다. 이것은 Java EE 6 어노테이션을 포함하는 Java EE 5 애플리케이션이 Java EE 6 레벨로 승격되게 합니다. 애플리케이션을 승격시킨 후 WebSphere Application Server 버전 8.0 이상에서는 WebSphere Application Server 버전 7.x를 실행하는 노드에 애플리케이션을 배치하지 않습니다.
Java EE 6 어노테이션을 무시하고 애플리케이션의 버전이 업그레이드되지 않게 하려면 배치 관리자에서 특성을 true로 설정하십시오. 기본값은 false입니다.
Ignore-JEE6-Annotation: true
org.eclipse.jst.j2ee.commonarchivecore.ignore.jee7.annotation
- Java EE 5 또는 Java EE 6 애플리케이션이 있습니다.
- 애플리케이션에 Java EE 7 어노테이션이 있습니다.
- 애플리케이션이 WebSphere Application Server 버전 7.x 또는 8.x를 실행 중인 독립형 서버로 배치됩니다.
- WebSphere Application Server 버전 9.x를 실행 중인 배치 관리자에서 WebSphere Application Server 버전 7.x 또는 8.x를 실행 중인 노드로 배치를 시도하면 애플리케이션 배치가 실패합니다.
이전 조건 모두가 true이면, 배치 도중 애플리케이션이 Java EE 7 레벨로 승격되므로 아마 배치는 실패합니다. WebSphere Application Server 버전 7.x 및 8.x는 각각 Java EE 5와 Java EE 6을 구현합니다. WebSphere Application Server 버전 9.x는 Java EE 7을 구현하므로, Java EE 7 어노테이션이 처리됩니다. 이로 인해 Java EE 7 어노테이션을 포함하는 Java EE 5 또는 Java EE 6 애플리케이션이 Java EE 7 레벨로 승격됩니다. 애플리케이션을 승격시킨 후 WebSphere Application Server 버전 9.x는 버전 7.x 또는 8.x를 실행하는 노드에 애플리케이션을 배치하지 않습니다.
Java EE 7 어노테이션을 무시하고 애플리케이션 버전이 업그레이드되지 않도록 하려면 배치 관리자에서 특성을 true로 설정하십시오. 기본값은 false입니다.
Ignore-JEE7-Annotation: true
org.eclipse.jst.j2ee.commonarchivecore.ignore.web.fragment
- Java EE 5 애플리케이션이 있습니다.
- 이 애플리케이션에는 웹 단편이 있는 WAR 파일이 포함됩니다.
- 애플리케이션은 WebSphere Application Server 버전 7.x를 실행하는 독립형 서버에 배치됩니다.
- WebSphere Application Server 버전 8.0 이상을 실행하는 배치 관리자에서 버전 7.x를 실행하는 노드로 배치를 시도하면 애플리케이션 배치가 실패합니다.
이전 조건 모두가 true이면, 애플리케이션이 배치 도중 Java EE 6 레벨로 승격되므로 배치가 실패합니다. WebSphere Application Server 버전 7.x는 Java EE 5를 구현합니다. 웹 단편은 Java EE 6때까지 WAR 파일에 도입되지 않았습니다. WebSphere Application Server 버전 8.0 이상에서 웹 단편을 발견하면, WAR을 버전 3.0으로 승격시키고 애플리케이션은 Java EE 6으로 승격시킵니다. 이런 경우 애플리케이션은 WebSphere Application Server 버전 7.x를 실행 중인 노드에 배치될 수 없습니다.
웹 단편을 무시하고 애플리케이션의 버전이 업그레이드되지 않도록 하려면 배치 관리자에서 특성을 true로 설정하십시오. 기본값은 false입니다.
Ignore-Web-Fragment: true
org.eclipse.jst.j2ee.commonarchivecore.openAllArchivesTrue
이 사용자 정의 특성을 사용하여 모든 아카이브를 확장할 서버를 설정하십시오.
배치 중 비표준 아카이브의 확장을 가능하게 하려면 배치에 포함된 Application Server 프로세스에 특성을 설정하십시오. 배치 관리자를 사용하는 경우 배치 관리자 프로세스에 특성을 설정하십시오.
earExpander 스크립트에 의한 확장을 가능하게 하려면 earExpander 스크립트를 편집하여 특성을 Java 사용자 정의 특성으로 설정하십시오.
기본값은 false입니다.
org.eclipse.jst.j2ee.commonarchivecore.PM62467.Disabled
아카이브 항목 경로에 허용되지 않는 값이 포함될 때 발생하는 동작을 지정하려면 이 사용자 정의 특성을 사용하십시오.
WebSphere Application Server에 애플리케이션을 배치한 경우, 파일의 아카이브 항목 경로를 사용하는 애플리케이션 서버 프로파일의 installedApps 디렉토리에 애플리케이션 아카이브 및 모듈 파일의 컨텐츠를 추출합니다. installedApps 디렉토리에 애플리케이션 파일을 추출해야 하지만 파일의 아카이브 항목 경로에 ../ 값이 포함되어 있으면 아카이브 파일을 다른 디렉토리에 추출할 수 있습니다. 이 사용자 정의 특성이 false이고 아카이브 항목 경로에 ../ 값이 있으면 ArchiveRuntimeException이 발생하고 아카이브 처리가 중지됩니다. 경고 메시지를 로그하고 계속해서 애플리케이션을 배치하려면 이 특성을 true로 설정하십시오.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면 애플리케이션 서버 및 배치 관리자 노드에서 JVM 사용자 정의 특성으로 지정해야 합니다.
overrideAutoProp
plugin-cfg.xml을 원격 노드 저장소 및 원격 웹 서버 위치 둘 다로 전파하려면 이 사용자 정의 특성을 사용하십시오.
수동 전파에서 이 특성이 true로 설정된 경우 plugin-cfg.xml은 원격 노드 저장소와 원격 웹 서버 위치 둘 다에 전파됩니다. 수동 전파에서 이 특성이 false로 설정되면 plugin-cfg.xml은 원격 노드 저장소에만 전파되며 웹 서버 위치에는 전파되지 않습니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면 노드 JVM 사용자 정의 특성으로 지정해야 합니다.
노드에 이 특성이 설정되면 이 변경사항을 노드와 동기화해야 합니다. 이 특성을 설정한 후 이를 적용하기 위해 노드를 중지하고 다시 시작할 필요는 없습니다.
plugin.syncdisabled
웹 서버 플러그인 구성 전파를 통해 호출되는 노드 동기화를 사용하지 않으려면 이 사용자 정의 특성을 사용하십시오.
이 특성을 true로 설정하면 웹 서버 플러그인 구성 변경사항이 노드에서 자동으로 동기화되지 않습니다. 즉, 수동 동기화를 수행할 때까지 웹 서버 플러그인 구성 변경사항은 웹 서버에 전파되지 않습니다.
기본값은 false입니다.
이 사용자 정의 특성을 사용하려면 노드 JVM 사용자 정의 특성으로 지정해야 합니다.
threadpool.maxsize
새로 작성된 스레드 풀에 포함할 수 있는 스레드 수를 제어하려면 이 특성을 사용하십시오. 전용 스레드가 각 애플리케이션 서버 JVM(Java Virtual Machine)을 시작하도록 작성되었습니다. 이 스레드 풀의 전용 스레드가 있는 JVM은 노드 에이전트가 시작될 때마다 동시에 시작되는 JVM입니다.
0 - 5의 정수를 이 특성 값으로 지정할 수 있습니다. 지정한 값이 0보다 큰 경우, 해당 값을 새로 작성된 스레드 풀에 포함할 수 있는 최대 스레드 수로 사용하여 스레드 풀이 작성됩니다. 다음 표에는 이 사용자 정의 특성에 지원되는 값과 영향이 나열됩니다.
threadpool.maxsize 값 | 영향 |
---|---|
threadpool.maxsize 특성이 0으로 설정되거나, 지정되지 않습니다. | 노드 에이전트가 다섯 개의 JVM을 병렬로 시작합니다. |
threadpool.maxsize 특성이 1로 설정됩니다. | 노드 에이전트가 JVM을 계속해서 시작합니다. |
threadpool.maxsize 특성이 2 - 5 사이의 정수 값으로 설정됩니다. | 노드 에이전트가 지정된 값과 동일한 수의 JVM을 병렬로 시작합니다. |
예를 들어, 노드 에이전트에 running 상태로 설정된 10개의 JVM(즉, 노드 에이전트가 시작할 때마다 시작됨)이 있다고 가정하십시오. 이 특성에 3을 지정하면, 노드 에이전트를 중지하고 시작할 때마다 10개의 JVM 중 세 개만 동시에 시작합니다.
- 관리 콘솔을 사용하고 노드 에이전트의 새 JVM 사용자 정의 특성 이름으로 threadpool.maxsize를 지정하면 이 새 사용자 정의 특성의 값 필드에 값을 지정해야 합니다. 값을 지정하지 않으면, 오류 메시지가 표시됩니다.
- 명령행에서 공백 값을 특성으로 전달하는 경우, 공백 값은 잘못된 값으로 간주되며 노드 에이전트의 기본 동작이 복원됩니다.
이 특성은 기본적으로 지정되지 않습니다. 이 사용자 정의 특성을 사용하려면, 노드 에이전트 JVM 사용자 정의 특성으로 지정해야 합니다.
![[z/OS]](../images/ngzos.gif)
was.xcfmonitor.enabled
애플리케이션 서버 상태를 모니터하는 데 z/OS XCF(Cross-system Coupling Facility)를 이용하려면 이 특성을 사용하십시오. 이 특성이 true로 설정되면 노드 에이전트는 XCF를 사용하여 애플리케이션 서버를 모니터하고, 애플리케이션 서버는 XCF를 사용하여 노드 에이전트를 모니터하며, 관리 에이전트 서버는 XCF를 사용하여 등록된 애플리케이션 서버를 모니터할 수 있습니다. 이 특성을 false로 설정한 경우에는 TCP/IP 핑 메소드를 사용하여 애플리케이션 서버와 노드 에이전트 상태를 모니터합니다.
기본값은 false입니다.
webservices.unify.faults
JAX-WS 및 JAX-RPC에 대해 SOAP 결함 통합을 사용으로 설정하려면 webservices.unify.faults 특성을 사용하십시오. 기본적으로 웹 서비스 런타임 환경(JAX-WS 및 JAX-RPC)은 런타임 환경에서 생성된 모든 결함을 Server의 faultcode 및 Internal Error의 faultstring을 포함하는 단일 유형의 결함으로 통합합니다. 결함에는 결함의 실제 원인을 식별하는 추가 정보는 포함되지 않습니다. 결함을 통합하면 시스템의 보안이 개선되고, 인바운드 메시지 처리 실패 이유와 관련된 자세한 정보가 메시지를 보낸 사람에게 리턴되지 않습니다.
이 특성의 기본값은 true로 결함이 통합됩니다. 애플리케이션에서 결함 세부사항을 요구할 경우 이 특성을 false로 설정하여 결함 통합을 비활성화함으로써 결함의 자세한 정보가 리턴되도록 합니다. 특성 설정과 상관없이 WSDL에 정의된 확인된 예외사항과 서비스 제공자 메소드 구현에서 발생한 확인된 예외사항은 통합되지 않습니다. 그리고 이 특성 설정과 상관없이 추적을 활성화한 경우 이 결함 원인과 관련된 자세한 정보가 로깅됩니다.
wink.client.readTimeout
제한 시간이 초과되기 전에 RestClient 오브젝트가 요청에 대한 응답을 대기하는 시간(밀리초)을 지정하려면 이 특성을 사용하십시오. 영(0) 값은 클라이언트가 무제한 대기하며 제한시간이 초과되지 않음을 의미합니다.
기본값은 60,000밀리초입니다.
wink.client.connectTimeout
대상 자원에 연결하려 시도할 때 제한 시간이 초과되기 전에 RestClient 오브젝트가 대기하는 시간(밀리초)을 지정하려면 이 특성을 사용하십시오. 영(0) 값은 클라이언트가 무제한 대기하며 제한시간이 초과되지 않음을 의미합니다.
기본값은 60,000밀리초입니다.