Apêndice A. Material de Referência

A migração iiop pode ser realizada quando o servidor está no modo admin-only

A operação migrate requer iniciar o servidor em modo admin-only, que é feito ao adicionar o parâmetro --admin-only ao comando de início do servidor:

$ EAP_HOME/bin/standalone.sh --admin-only

Propriedades X não podem ser emuladas utilizando OpenJDK ORB e não são suportadas

A configuração de propriedade específica não é suportada e não é incluída na configuração do novo subsistema iiop-openjdk. O comportamento exibido por esta propriedade na versão anterior de JBoss EAP não é migrado e o administrador deve verificar se o novo subsistema iiop-openjdk no JBoss EAP 7 é capaz de operar corretamente sem esse comportamento.

Propriedades não suportadas incluem: cache-poa-names, cache-typecodes, chunk-custom-rmi-valuetypes, client-timeout, comet, indirection-encoding-disable, iona, lax-boolean-encoding, max-managed-buf-size, max-server-connections, max-threads, outbuf-cache-timeout, outbuf-size, queue-max, queue-min, poa-monitoring, print-version, retries, retry-interval, queue-wait, server-timeout, strict-check-on-tc-creation, use-bom, use-imr.

As propriedades X usam expressões. Propriedades de configuração que são usadas para resolver essas expressões devem ser transformadas manualmente para o novo formato do subsistema iiop-openjdk

Propriedades que usam expressões devem ser configuradas manualmente pelo administrador.

Por exemplo, o subsistema jacorb no JBoss EAP 6 definia uma propriedade giop-minor-version. O subsistema iiop-openjdk no JBoss EAP 7 define uma propriedade giop-version. Suponha que o atributo da versão de manutenção do subsistema jacorb está definido para ${iiop-giop-minor-version} e a propriedade de sistema está configurada no arquivo standalone.conf como -Diiop-giop-minor-version=1. Após a operação migrate, o administrador deve alterar o valor da propriedade de sistema para 1.1 para certificar-se que o novo subsistema está configurado corretamente.

Não é possivel migar: o novo subsistema iiop-openjdk já está definido

A mensagem contém a explicação.

A operação migrate não pode realizada: o servidor deve estar em modo admin-only

A operação migrate requer iniciar o servidor em modo admin-only, que é feito ao adicionar o parâmetro --admin-only ao comando de início do servidor:

$ EAP_HOME/bin/standalone.sh --admin-only

Não foi possível migar o atributo local-bind-address a partir do recurso X. Alternativamente, utilize o atributo socket-binding para configurar este broadcast-group.

A mensagem contém explicação e indica como fazer para corrigir o problema.

Não foi possível migar o atributo local-bind-port a partir do recurso X. Alternativamente, utilize o atributo socket-binding para configurar este broadcast-group.

A mensagem contém explicação e indica como fazer para corrigir o problema.

Não foi possível migrar o atributo group-address a partir do recurso X. Alternativamente, utilize o atributo socket-binding para configurar este broadcast-group.

A mensagem contém explicação e indica como fazer para corrigir o problema.

Não foi possível migar o atributo group-port a partir do recurso X. Alternativamente, utilize o atributo socket-binding para configurar este broadcast-group.

O recurso broadcast-group não aceita mais os atributos local-bind-address, local-bind-port, group-address, ou group-port. Aceita somente um atributo socket-binding. O aviso é uma notificação de que o recurso X tem um atributo sem suporte. Você deve definir manualmente o atributo socket-binding no recurso e certificar-se que corresponde a um recurso socket-binding definido.

As classes que fornecem X são descartadas durante a migração. Para usá-las no novo subsistema messaging-activemq, você deve estender o Interceptor baseado em Artemis.

O suporte de interceptores de mensagem está significativamente diferente no JBoss EAP 7. Todos os interceptores configurados em versões prévias do subsistema são descartados durante a migração. Consulte Migrando interceptores de mensagem para mais informações.

Não foi possível migrar a configuração de alta disponibilidade de X. Os seus atributos shared-store e backup contêm expressões e não é possível determinar sem ambiguidade como criar a ha-policy correspondente para o servidor do messaging-activemq.

Isto significa que os atributos hornetq-server X: shared-store ou backup continham uma expressão, tal como ${xxx}, e a operação de migração não conseguiu resolvê-la para uma expressão concreta. O valor é descartado e a ha-policy para o messaging-activemq deve ser atualizada manualmente.

Não foi possível migar o atributo local-bind-address a partir do recurso X. Alternativamente, utilize o atributo socket-binding para configurar este discovery-group.

A mensagem contém explicação e indica como fazer para corrigir o problema.

Não foi possível migar o atributo local-bind-port a partir do recurso X. Alternativamente, utilize o atributo socket-binding para configurar este discovery-group.

A mensagem contém explicação e indica como fazer para corrigir o problema.

Não foi possível migar o atributo group-address a partir do recurso X. Alternativamente, utilize o atributo socket-binding para configurar este discovery-group.

A mensagem contém explicação e indica como fazer para corrigir o problema.

Não foi possível migar o atributo group-port a partir do recurso X. Alternativamente, utilize o atributo socket-binding para configurar este discovery-group.

O recurso discovery-group não aceita mais os atributos local-bind-address, local-bind-port, group-address, ou group-port. Aceita somente um atributo socket-binding. O aviso é uma notificação de que o recurso X tem um atributo sem suporte. Você deve definir manualmente o atributo socket-binding no recurso e certificar-se que corresponde a um recurso socket-binding definido.

Não foi possível criar legacy-connection-factory baseado em connection-factory X. Ele utiliza um conector in-vm HornetQ que não é compatível com o conector in-vm Artemis.

Os recursos remotos herdados de connection-factory de HornetQ são migrados para os recursos legacy-connection-factory para permitir que clientes JBoss EAP 6 conectem-se ao JBoss EAP 7. Entretanto, os recursos legacy-connection-factory são criados somente quando connection-factory estiver usando conectores remotos. Qualquer connection-factory que estiver utilizando in-vm não será migrado pois clientes in-vm são baseados em JBoss EAP 7, não JBoss EAP 6. Este aviso é uma notificação de que in-vm connection-factory não foi migrado.

Não foi possível migrar o atributo X a partir do recurso Y. O atributo utiliza uma expressão que pode ser resolvida de modo diferente dependendo das propriedades do sistema. Após a migração, este atributo deve ser adicionado novamente com um valor real ao invés de uma expressão.

Este aviso aparece quando a migração não consegue resolver o atributo X para um valor concreto durante o processo de migração. O valor é descartado e o atributo deve ser migrado manualmente. Isto acontece nos seguintes casos:

Não foi possível migrar atributo X a partir do recurso Y. Este atributo não é suportado pelo novo subsistema messaging-activemq.

Alguns atributos não são mais suportados no novo subsistema messaging-activemq e são simplesmente descartados:

Não é possível migrar o atributo failback-delay a partir do recurso X. Artemis detecta failback de forma determinística e não exige mais que um atraso seja especificado para que ocorra o failback.

A mensagem contém a explicação.

Operação de migração permitida somente em modo admin

A operação migrate requer iniciar o servidor em modo admin-only, que é feito ao adicionar o parâmetro --admin-only ao comando de início do servidor:

$ EAP_HOME/bin/standalone.sh --admin-only

Não foi possível migrar recurso X

O comportamento exibido por este recurso na versão anterior de JBoss EAP não foi migrado. O administrador deve verificar se o novo subsistema Undertow em JBoss EAP 7 é capaz de operar corretamente sem este comportamento ou se o comportamento deve ser migrado manualmente.

Não foi possível migrar o atributo X a partir do recurso Y.

O comportamento exibido por este atributo de recurso na versão anterior de JBoss EAP não foi migrado. O administrador deve verificar se o novo subsistema Undertow em JBoss EAP 7 é capaz de operar corretamente sem este comportamento ou se o comportamento deve ser migrado manualmente.

See Web Subsystem Migration Operation Attribute Warnings for the list of attributes that are not migrated.

Não foi possível migrar conector SSL pois nenhuma configuração SSL está definida.

A mensagem contém a explicação.

Não foi possível migrar atributo verify-client X para o equivalente de Undertow

A mensagem contém a explicação.

Não foi possível migrar a expressão verify-client X

A mensagem contém a explicação.

Não foi possível migrar a válvula X

O comportamento exibido por este recurso na versão anterior de JBoss EAP não foi migrado. O administrador deve verificar se o novo subsistema Undertow em JBoss EAP 7 é capaz de operar corretamente sem este comportamento ou se o comportamento deve ser migrado manualmente.

This warning can occur for the following valves:

Não foi possível migrar atributo X a partir da válvula Y

The behavior exhibited by this valve attribute in the previous release of JBoss EAP was not migrated. The administrator must verify if the new undertow subsystem in JBoss EAP 7 is able to operate correctly without that behavior or whether the behavior must be migrated manually. This warning can occur for the following valve attributes:

ca-revocation-url

The file or URL that contains the revocation list.

No equivalent in Undertow.

certificate-file

When using OpenSSL encryption, the path to the file containing the server certificate.

No equivalent in Undertow.

ssl-protocol

The SSL protocol string.

No equivalent in Undertow.

verify-depth

The maximum number of intermediate certificate issuers checked before deciding that the clients do not have a valid certificate.

No equivalent in Undertow.

disabled

Enable the default Servlet mapping.

No equivalent setting in Undertow.

file-encoding

File encoding to be used when reading static files.

No equivalent setting in Undertow.

max-depth

Maximum recursion for PROPFIND.

This is a WebDAV setting and WebDAV is not supported by Undertow.

read-only

Allow write HTTP methods (PUT, DELETE).

This is a WebDAV setting and WebDAV is not supported by Undertow.

secret

Secret for WebDAV locking operations.

This is a WebDAV setting and WebDAV is not supported by Undertow.

sendfile

Enable sendfile if possible, for files bigger than the specified byte size.

This is set to a sensible default value in Undertow and is not configurable.

webdav

Enable WebDAV functionality.

WebDAV is not supported by Undertow.

cache-container

Name of the cache container to use for clustered SSO.

This setting is no longer needed in Undertow. This works by default across a distributed clustered environment.

cache-name

Name of the cache to use for clustered SSO.

This setting is no longer needed in Undertow. This works by default across a distributed clustered environment.

reauthenticate

Whether each request should cause a reauthentication.

There is no equivalent setting in Undertow, which behaves similarly to the reauthenticate=true setting in JBoss EAP 6. While reauthenticate=false could possibly improve performance, it could also create security issues.

resolve-hosts

Whether to enable resolving hosts for access logging.

Use the setting on the connector to accomplish the same behavior.

executor

The name of the executor that should be used to process the threads of this connector.

You now reference a worker that is defined in the io subsystem.

See Migrate the Threads Subsystem Configuration for more information.

proxy-binding

The socket binding to define the host and port that is used when sending a redirect.

There is no direct equivalent.

See https-listener Attributes in the JBoss EAP Configuration Guide for available configuration options.

redirect-port

The port for redirection to a secure connector.

This attribute was deprecated in JBoss EAP 6 and replaced with redirect-binding. Undertow provides the redirect-socket attribute on the http-listener element, which is a replacement for redirect-binding.

See https-listener Attributes in the JBoss EAP Configuration Guide for more information.

JBoss EAP 6 System Property

Description

Equivalent in JBoss EAP 7

jvmRoute

Provides a default value for the jvmRoute attribute. It does not override the automatically generated value when using the standalone-ha.xml configuration file.

It supports reload.

Management CLI command:

/subsystem=undertow:write-attribute(name=instance-id,value=VALUE)

org.apache.tomcat.util.buf.StringCache.byte.enabled

If true, the String cache is enabled for ByteChunk. If the value is not specified, the default value of false is used.

No equivalent configuration

org.apache.tomcat.util.buf.StringCache.char.enabled

If true, the String cache is enabled for CharChunk. If the value is not specified, the default value of false is used.

No equivalent configuration

org.apache.tomcat.util.buf.StringCache.cacheSize

The size of the String cache. If the value is not specified, the default value of 5000 is used.

No equivalent configuration

org.apache.tomcat.util.buf.StringCache.maxStringSize

The maximum length of String that will be cached. If the value is not specified, the default value of 128 is used.

No equivalent configuration

org.apache.tomcat.util.http.FastHttpDateFormat.CACHE_SIZE

The size of the cache to use parsed and formatted date value. If the value is not specified, the default value of 1000 is used.

No equivalent configuration

org.apache.catalina.core.StandardService.DELAY_CONNECTOR_STARTUP

If true, the connector startup is not done automatically. It is useful in embedded mode.

No equivalent configuration

org.apache.catalina.connector.Request.SESSION_ID_CHECK

If true, the Servlet container verifies that a session exists in a context with the specified session ID before creating a session with that ID.

No equivalent configuration

org.apache.coyote.Constants.USE_CUSTOM_STATUS_MSG_IN_HEADER

If true, custom HTTP status messages are used within HTTP headers. Users must ensure that any such message is ISO-8859-1 encoded, particularly if user provided input is included in the message, to prevent a possible XSS vulnerability. If value is not specified the default value of false is used.

Must be enabled programmatically by implementing a custom io.undertow.servlet.ServletExtension. Then use the extension to call setSendCustomReasonPhraseOnError(true) on the io.undertow.servlet.api.DeploymentInfo structure instance.

org.apache.tomcat.util.http.Parameters.MAX_COUNT

The maximum number of parameters that can be parsed in a post body. If exceeded, parsing fails using an IllegalStateException. The default value is 512 parameters.

Management CLI command:

/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=max-parameters,value=VALUE)
/subsystem=undertow/server=default-server/https-listener=default:write-attribute(name=max-parameters,value=VALUE)
/subsystem=undertow/server=default-server/ajp-listener=default:write-attribute(name=max-parameters,value=VALUE)

org.apache.tomcat.util.http.MimeHeaders.MAX_COUNT

The maximum number of headers that can be sent in the HTTP request. If exceeded, parsing will fail using an IllegalStateException. The default value is 128 headers.

Management CLI command:

/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=max-headers,value=VALUE)
/subsystem=undertow/server=default-server/https-listener=default:write-attribute(name=max-headers,value=VALUE)
/subsystem=undertow/server=default-server/ajp-listener=default:write-attribute(name=max-headers,value=VALUE)

org.apache.tomcat.util.net.MAX_THREADS

The maximum number of threads a connector is going to use to process requests. The default value is 32 x 512. (512 x Runtime.getRuntime().availableProcessors() for the JIO connector)

Management CLI command:

/subsystem=io/worker=default:write-attribute(name=task-max-threads, value=VALUE)

org.apache.coyote.http11.Http11Protocol.MAX_HEADER_SIZE

The maximum size of the HTTP headers, in bytes. If exceeded, parsing will fail using an ArrayOutOfBoundsException. The default value is 8192 bytes.

Management CLI command:

/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=max-header-size,value=VALUE)
/subsystem=undertow/server=default-server/https-listener=default:write-attribute(name=max-header-size,value=VALUE)
/subsystem=undertow/server=default-server/ajp-listener=default:write-attribute(name=max-header-size,value=VALUE)

org.apache.coyote.http11.Http11Protocol.COMPRESSION

Allows using simple compression with the HTTP connector. The default value is off, and compression can be enabled using the value on to enable it conditionally, or force to always enable it.

Configure a filter using the management CLI:

# Create a filter
/subsystem=undertow/configuration=filter/gzip=gzipfilter:add()
/subsystem=undertow/server=default-server/host=default-host/filter-ref=gzipfilter:add()

org.apache.coyote.http11.Http11Protocol.COMPRESSION_RESTRICTED_UA

User agents regexps that will not receive compressed content. The default value is empty.

Configure a predicate in a filter using the management CLI:

# Use a predicate in a filter
/subsystem=undertow/configuration=filter/gzip=gzipfilter:add()
/subsystem=undertow/server=default-server/host=default-host/filter-ref=gzipfilter:add(predicate="regex[pattern='AppleWebKit',value=%{i,User-Agent}]")

org.apache.coyote.http11.Http11Protocol.COMPRESSION_MIME_TYPES

Content type prefixes of compressible content. The default value is text/html,text/xml,text/plain.

Configure a predicate in a filter using the management CLI:

# Use a predicate in a filter
/subsystem=undertow/configuration=filter/gzip=gzipfilter:add()
/subsystem=undertow/server=default-server/host=default-host/filter-ref=gzipfilter:add(predicate="regex[pattern='text/html',value=%{o,Content-Type}]")

org.apache.coyote.http11.Http11Protocol.COMPRESSION_MIN_SIZE

Minimum size of content that will be compressed. The default value is 2048 bytes.

Configure a predicate in a filter using the management CLI:

# Use a predicate in a filter
/subsystem=undertow/configuration=filter/gzip=gzipfilter:add()
/subsystem=undertow/server=default-server/host=default-host/filter-ref=gzipfilter:add(predicate="max-content-size[value=MIN_SIZE]")

org.apache.coyote.http11.DEFAULT_CONNECTION_TIMEOUT

Default socket timeout. The default value is 60000 ms.

Management CLI command:

/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=no-request-timeout,value=VALUE)
/subsystem=undertow/server=default-server/https-listener=default:write-attribute(name=no-request-timeout,value=VALUE)
/subsystem=undertow/server=default-server/ajp-listener=default:write-attribute(name=no-request-timeout,value=VALUE)

org.jboss.as.web.deployment.DELETE_WORK_DIR_ONCONTEXTDESTROY

Use this property to remove .java and .class files to ensure that JSP sources are recompiled. The default value is false. Default socket timeout for keep-alive. The default value is -1 ms, which means it will use the default socket timeout.

No equivalent configuration

org.apache.tomcat.util.buf.StringCache.trainThreshold

Specifies the number of times toString() must be invoked before activating cache. The default value is 100000.

No equivalent configuration

JBoss EAP 6 System Property

Description

Equivalent in JBoss EAP 7

org.apache.el.parser.COERCE_TO_ZERO

If true, when coercing expressions to numbers, empty strings ("") and null will be coerced to zero as required by the specification. If a value is not specified, the default value of true is used.

System property is still valid and processed by the EL

JBoss EAP 6 System Property

Description

Equivalent in JBoss EAP 7

org.apache.jasper.compiler.Generator.VAR_EXPRESSIONFACTORY

The name of the variable to use for the expression language expression factory. If value is not specified, the default value of _el_expressionfactory is used.

System property has not changed

org.apache.jasper.compiler.Generator.VAR_INSTANCEMANAGER

The name of the variable to use for the instance manager factory. If value is not specified, the default value of _jsp_instancemanager is used.

System property has not changed

org.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING

If false, the requirements for escaping quotes in JSP attributes are relaxed so that a missing required quote does not cause an error. If value is not specified, the specification compliant default of true is used.

System property has not changed

org.apache.jasper.Constants.DEFAULT_TAG_BUFFER_SIZE

Any tag buffer that expands beyond org.apache.jasper.Constants.DEFAULT_TAG_BUFFER_SIZE is destroyed and a new buffer is created of the default size. If value is not specified, the default value of 512 is used.

System property has not changed

org.apache.jasper.runtime.JspFactoryImpl.USE_POOL

If true, a ThreadLocal PageContext pool is used. If value is not specified, the default value of true is used.

System property has not changed

org.apache.jasper.runtime.JspFactoryImpl.POOL_SIZE

The size of the ThreadLocal PageContext. If value is not specified, the default value of 8 is used.

System property has not changed

org.apache.jasper.Constants.JSP_SERVLET_BASE

The base class of the Servlets generated from the JSPs. If value is not specified, the default value of org.apache.jasper.runtime.HttpJspBase is used.

System property has not changed

org.apache.jasper.Constants.SERVICE_METHOD_NAME

The name of the service method called by the base class. If value is not specified, the default value of _jspService is used.

System property has not changed

org.apache.jasper.Constants.SERVLET_CLASSPATH

The name of the ServletContext attribute that provides the class path for the JSP. If value is not specified, the default value of org.apache.catalina.jsp_classpath is used.

System property has not changed

org.apache.jasper.Constants.JSP_FILE

The name of the request attribute for <jsp-file> element of a servlet definition. If present on a request, this overrides the value returned by request.getServletPath() to select the JSP page to be executed. If value is not specified, the default value of org.apache.catalina.jsp_file is used.

System property has not changed

org.apache.jasper.Constants.PRECOMPILE

The name of the query parameter that causes the JSP engine to just pregenerate the servlet but not invoke it. If value is not specified, the default value of org.apache.catalina.jsp_precompile is used.

System property has not changed

org.apache.jasper.Constants.JSP_PACKAGE_NAME

The default package name for compiled JSP pages. If value not specified, the default value of org.apache.jsp is used.

System property has not changed

org.apache.jasper.Constants.TAG_FILE_PACKAGE_NAME

The default package name for tag handlers generated from tag files. If value is not specified, the default value of org.apache.jsp.tag is used.

System property has not changed

org.apache.jasper.Constants.TEMP_VARIABLE_NAME_PREFIX

Prefix to use for generated temporary variable names. If value is not specified, the default value of _jspx_temp is used.

System property has not changed

org.apache.jasper.Constants.USE_INSTANCE_MANAGER_FOR_TAGS

If true, the instance manager is used to obtain tag handler instances. If value is not specified, true is used.

System property has not changed

org.apache.jasper.Constants.INJECT_TAGS

If true, annotations specified in tags will be processed and injected. This can have a performance impact when using simple tags, or if tag pooling is disabled. If value is not specified, false is used.

System property has not changed

JBoss EAP 6 System Property

Description

Equivalent in JBoss EAP 7

org.apache.catalina.connector.RECYCLE_FACADES

If this is true or if a security manager is in use a new facade object is created for each request. If value is not specified, the default value of false is used.

No equivalent configuration

org.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH

If this is true the '\' character is permitted as a path delimiter. If value is not specified, the default value of false is used.

No equivalent configuration

org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH

If this is true, '%2F' and '%5C' is permitted as path delimiters. If value is not specified, the default value of false is used.

Management CLI command:

/subsystem=undertow/server=default-server/http-listener=default:write-attribute(name=allow-encoded-slash,value=VALUE)
/subsystem=undertow/server=default-server/https-listener=default:write-attribute(name=allow-encoded-slash,value=VALUE)
/subsystem=undertow/server=default-server/ajp-listener=default:write-attribute(name=allow-encoded-slash,value=VALUE)

org.apache.catalina.STRICT_SERVLET_COMPLIANCE

If value is not specified, true is used. If this is true the following actions will occur: any wrapped request or response object passed to an application dispatcher is checked to ensure that it has wrapped the original request or response. (SRV.8.2 / SRV.14.2.5.1) a call to Response.getWriter() if no character encoding has been specified results in subsequent calls to Response.getCharacterEncoding() returning ISO-8859-1 and the Content-Type response header will include a charset=ISO-8859-1 component. (SRV.15.2.22.1) every request that is associated with a session causes the session’s last accessed time to be updated regardless of whether or not the request explicity accesses the session. (SRV.7.6)

Compliant by default

org.apache.catalina.core.StandardWrapperValve.SERVLET_STATS

If true or if org.apache.catalina.STRICT_SERVLET_COMPLIANCE is true, the wrapper will collect the JSR-77 statistics for individual servlets. If value is not specified, the default value of false is used.

No equivalent configuration

org.apache.catalina.session.StandardSession.ACTIVITY_CHECK

If this is true or if org.apache.catalina.STRICT_SERVLET_COMPLIANCE is true Tomcat tracks the number of active requests for each session. When determining if a session is valid, any session with at least one active request is always be considered valid. If value is not specified, the default value of false is used.

No equivalent configuration