Debugging

Logging

By default, the app server logs at the “INFO” level but logging can be increased to “FINE” on the fly with (for example) ./asadmin set-log-levels edu.harvard.iq.dataverse.api.Datasets=FINE. Running ./asadmin list-log-levels will show the current logging levels.

Java Server Faces (JSF) Configuration Options

Some JSF options can be easily changed via MicroProfile Config (using environment variables, system properties, etc.) during development without recompiling. Changing the options will require at least a redeployment, obviously depending how you get these options in. (Variable substitution only happens during deployment and when using system properties or environment variables, you’ll need to pass these into the domain, which usually will require an app server restart.)

Please note that since Payara 5.2021.1 supporting MicroProfile Config 2.0, you can use profiles to maintain your settings more easily for different environments.

JSF Option

MPCONFIG Key

Description

Default

javax.faces.PROJECT_STAGE

dataverse.jsf.project-stage

Switch to different levels to make JSF more verbose, disable caches etc. Read more at various places.

Production

javax.faces.INTERPRET_EMPTY _STRING_SUBMITTED_VALUES_AS_NULL

dataverse.jsf.empty-string-null

See Jakarta Server Faces 3.0 Spec

true

javax.faces.FACELETS_SKIP_COMMENTS

dataverse.jsf.skip-comments

See Jakarta Server Faces 3.0 Spec

true

javax.faces.FACELETS_BUFFER_SIZE

dataverse.jsf.buffer-size

See Jakarta Server Faces 3.0 Spec

102400 (100 KB)

javax.faces.FACELETS_REFRESH_PERIOD

dataverse.jsf.refresh-period

See Jakarta Server Faces 3.0 Spec

-1

primefaces.THEME

dataverse.jsf.primefaces.theme

See PrimeFaces Configuration Docs

bootstrap


Previous: Writing Documentation | Next: Coding Style