Retrieving Information about your Container

These logs are on the container in /usr/local/apache-tomcat/logs, you can copy them from the container by finding the ID of the container and then calling copy on the container's log directory.

If you are using docker-compose

1docker-compose logs 2>&1 | tee out.log
2docker ps ## get container ID
3docker cp container_id:/usr/local/apache-tomcat/logs ./mylogs

If you are using only docker

1docker ps ## get container ID
2docker logs <container id> 2>&1 | tee out.log

If you are using the Windows installer, the logs are present at /<install directory>/apache-tomcat/logs.

If you refer to the logs, it should be present there as an entry:

1INFO: {"PDFNet_version":8.0172545,"num_cpu":8,"os_arch":"amd64","os_name":"Linux","os_version":"5.2.14-arch2-1-ARCH","server_version":"1.4.0","total_memory":481.5}

If you cannot see the start of the logs, you can also go to the demo application on the server at server-link/demo?s and select the Server Info button to see the version.

On Linux

• The logs retrieved from docker-compose logs as described above.
• The marker files at /usr/local/apache-tomcat/internal/Markers/*

1docker cp <container id> /usr/local/apache-tomcat/internal_data/Markers ./

• hs_err_pid files from within the container if available, at the path /usr/local/apache-tomcat

1docker cp <container id> /usr/local/apache-tomcat/hs_err_pid* ./

• A way to reproduce the issue if possible

If your container has shut down, it is possible to start it back up by finding its ID and calling docker start on it. To view shutdown containers and start them, do the following:

1docker ps -a
2docker start <container id>

On Windows

• The logs at:

install_dir/logs/*install_dir/internal/logs/*

• The marker files at `install_dir/internal/Markers/*
• hs_err_pid files from within the container if available, at the path /usr/local/apache-tomcat
• A way to reproduce the issue if possible

WebViewer Server as of 1.5.7 supports an automated crash collection system that will make reporting issues to our team easier. To use it, set the following variables in your docker-compose or as environment variables:

• AWS_ERROR_REPORTING: 'true'
• ERROR_REPORTING_S3: 'name of your s3 bucket'
• AWS_ACCESS_KEY_ID: 'your access key for AWS with access to s3'
• AWS_SECRET_ACCESS_KEY: 'your secret access key for AWS'
• AWS_DEFAULT_REGION: 'your aws region'

After adding the following variables, WebViewer Server will zip crash data and upload it to this external bucket. You can then provide us this zip files to investigate your issue. Even without these variables set, a dump zip file will be created inside of /usr/local/apache-tomcat/dumps which you can also provide us.