Troubleshooting

Heads up! These docs are for Portofino 3, which is a legacy product. Check out Portofino 4!

Understanding the server logs

The server logs contain a great deal of information that is useful to troubleshoot any problem. Messages from the application and stacktaces may easily reveal the cause of a problem.

Location of the server logs:
Tomcat: CATALINA_HOME/logs/catalina.out or CATALINA_HOME/logs/catalina.YYYY-MM-DD.log (where YYYT-MM-DD is today's date).

Below is how the logs should look on a correct installation. Compare it with your logs and spot any significant differences to start troubleshooting.

A dashed line marks the beginning of the initialization:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener contextInitialized
INFO: --------------------------------------------------------------------------------

The installation path on the server's file system:

ManyDesigns Portofino servlet context 'ManyDesigns Portofino' at '/Users/predo/apache-tomcat-6.0.18/webapps/portofino/' starting...

Portofino's version:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener contextInitialized
INFO: ManyDesigns Portofino version: 3.1

Java and operating system identification:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util logSystemProperty
INFO: java.runtime.name: Java(TM) 2 Runtime Environment, Standard Edition
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util logSystemProperty
INFO: java.runtime.version: 1.5.0_20-b02-315
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util logSystemProperty
INFO: java.vm.name: Java HotSpot(TM) Client VM
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util logSystemProperty
INFO: java.vm.version: 1.5.0_20-141
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util logSystemProperty
INFO: java.vm.vendor: Apple Inc.
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util logSystemProperty
INFO: os.name: Mac OS X
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util logSystemProperty
INFO: user.language: en
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util logSystemProperty
INFO: user.region: null

Application server identification:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener contextInitialized
INFO: Server info: Apache Tomcat/6.0.18
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener contextInitialized
INFO: Servlet API version: 2.5

Loading the portofino-custom.properties:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener contextInitialized
INFO: Loading configuration from 'portofino-custom.properties' in default search paths (classpath, user's home dir)...

The database connection setting:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener contextInitialized
INFO: Creating database abstraction...
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: database.configurationType=jdbc
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: database.jdbc.driverClass=org.postgresql.Driver
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: database.jdbc.connectionURL=jdbc:postgresql://localhost:5432/portofinodb
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: database.jdbc.username=portofino
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getPasswordPropertyAndLog
INFO: database.jdbc.password=**********

Testing the connection: if no error is reported, the connection is successful:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener createDatabaseAbstraction
INFO: Testing database connection...

Database and JDBC driver identification (PostgreSQL 8.3 in the example):

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener createDatabaseAbstraction
INFO: Database product name: PostgreSQL
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener createDatabaseAbstraction
INFO: Database product version: 8.3.5
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener createDatabaseAbstraction
INFO: Database major/minor version: 8.3
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener createDatabaseAbstraction
INFO: Driver name: PostgreSQL Native Driver
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener createDatabaseAbstraction
INFO: Driver version: PostgreSQL 8.1 JDBC3 with SSL (build 408)
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener createDatabaseAbstraction
INFO: Driver major/minor version: 8.1
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener createDatabaseAbstraction
INFO: JDBC version: 3.0

Various configuration parameters:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener contextInitialized
INFO: Creating MDConfigContainer and registering on servlet context...
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: versioning.cvs.command=cvs
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: versioning.cvs.repository=null
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: versioning.cvs.workingDirectory=null
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: model.application.name=My Application
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: model.cvs.module=null
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: model.schema=model
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.base.MDConfigContainer getSecurityTypePropertyAndLog
INFO: security.type=application
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: model.users.enabled=false
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: model.users.anonymous.enabled=true
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: model.locale.language=en
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: model.locale.dateformat=dd-MM-yyyy
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: model.stylesheet=/default.css
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getLongPropertyAndLog
INFO: model.users.pwd.expiry.days=-1
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getIntPropertyAndLog
INFO: model.users.pwd.minlength=6
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getLongPropertyAndLog
INFO: model.users.pwd.inactivity.maxdays=-1
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getIntPropertyAndLog
INFO: model.users.pwd.attempts.maxnumber=-1
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getIntPropertyAndLog
INFO: model.users.pwd.keep.old.number=-1
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: model.users.registration.auto.enabled=false
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: model.users.registration.moderated.enabled=false
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: mail.sender=null
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: mail.bounce.enabled=false
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: model.mail.keep.sent=false
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: mail.pop3.login=null
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: mail.pop3.password=null
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: mail.pop3.ssl.enabled=false
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: mail.pop3.host=null
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getIntPropertyAndLog
INFO: mail.pop3.port=110
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: mail.smtp.login=null
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: mail.smtp.password=null
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: mail.smtp.ssl.enabled=false
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: mail.smtp.host=null
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getIntPropertyAndLog
INFO: mail.smtp.port=25
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: meta.enabled=true
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: meta.schema=meta
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: meta.users.enabled=false
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getBooleanPropertyAndLog
INFO: meta.users.anonymous.enabled=true
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: meta.locale.language=en
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: meta.locale.dateformat=dd-MM-yyyy
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: meta.stylesheet=/upstairs/upstairs.css
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: metameta.schema=metameta
Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.util.Util getStringPropertyAndLog
INFO: versioning.template.location=

Loading the metadata for the upstairs level:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.base.MDConfigImpl <init>
INFO: Resetting MDConfig 'ManyDesigns Portofino'...

Loading the metadata for the downstairs level:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.base.MDConfigImpl <init>
INFO: Resetting MDConfig 'My Application'...

Warning about email configuration (relevant only if you intend to send emails using Portofino):

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener contextInitialized
WARNING: User admin email or smtp server not set in portofino-custom.properties

Confirmation of successful initialization:

Nov 11, 2009 11:40:06 AM com.manydesigns.portofino.methods.PortofinoServletContextListener contextInitialized

INFO: ManyDesigns Portofino servlet context 'ManyDesigns Portofino' at '/Users/predo/apache-tomcat-6.0.18/webapps/portofino/' successfully started in 445 ms.

Struts 2 initialization:

Nov 11, 2009 11:40:07 AM com.opensymphony.xwork2.util.logging.commons.CommonsLogger info
INFO: Parsing configuration file [struts-default.xml]
Nov 11, 2009 11:40:07 AM com.opensymphony.xwork2.util.logging.commons.CommonsLogger info
INFO: Parsing configuration file [struts-plugin.xml]
Nov 11, 2009 11:40:07 AM com.opensymphony.xwork2.util.logging.commons.CommonsLogger info
INFO: Unable to locate configuration files of the name struts.xml, skipping
Nov 11, 2009 11:40:07 AM com.opensymphony.xwork2.util.logging.commons.CommonsLogger info
INFO: Parsing configuration file [struts.xml]
Nov 11, 2009 11:40:07 AM com.opensymphony.xwork2.util.logging.commons.CommonsLogger info
INFO: Loading global messages from strings-lib
Nov 11, 2009 11:40:07 AM com.opensymphony.xwork2.util.logging.commons.CommonsLogger info
INFO: Loading global messages from strings-rad
Nov 11, 2009 11:40:07 AM com.opensymphony.xwork2.util.logging.commons.CommonsLogger info
INFO: Loading global messages from com.manydesigns.elements.messages

Previous: Upgrading from an older version

Next: Configuration reference