Contacting Datical Support

When you encounter an issue and contact Datical Support, the first step in detailed diagnosis is to get information about the project that you are experiencing difficulty with.

The information required depends on the problem. The hammer debug export command provides a simple way to archive the needed files into a zip file that you then send to Datical Support. 

Command: hammer debug export

The command creates a zip file of files in a project directory to send to Datical Support. 

Options provide control over what files are packaged and how they are handled. 

Project Directory

The project directory is the source of all files needed. 

Output Location

By default the command zips the files and places the zip archive file in the project directory:

<project>/Reports/debug/<project>.zip

Use the --report option to specify a different file name and location. 

Hiding Sensitive Information

By default, the hammer debug export  command ensures that sensitive information is redacted. Values are replaced with tokens. Each token uniquely replaces a particular item of information.

The following information is redacted by default:

• hostname or IP address
• port
• database names
  • Oracle: service name, TNS name, SID
  • Other database:  database name
• user names
• passwords

Including and Excluding Files

Include (–include) or exclude (–exclude) files. The value for either option is a search string. All files with names and/or extensions that match the string search are included.  

All files must be in the project file hierarchy. If you want to add a file from outside the project, copy it to the file hierarchy. Place it in the root <project-name> directory.  

Including Files by Last Modified Date

You can include only files modified within a specified number of hours.  

Use the --lastmodified option to specify a number of hours.  All files are included that have a last modified date within the number of hours measured from the time the command is run. 

Including Non-Project Files

If Datical Support asks you to include files that are not already part of the Datical project directory, you must place them in the project directory. 

For example, if you use automation software like Jenkins to run packager or deploys, Datical Support may ask you for the packager.log or daticaldb.log from the automation job. You must copy them into the project directory before running the hammer debug export command. 

Common Use Case Scenarios

Datical has found patterns in customer needs, customer security policies, and requirements for files to fully diagnose a problem.  Here are four example scenarios. 

• Minimum for Problem Diagnosis - provide the minimum number of files to start diagnosis.
• Default - provide all data in the project directory
• Exclude All SQL Files - provide all files except SQL files. Security policy may determine whether you are allowed to share SQL files outside of your company.  
• Exclude DML Files - provide all files except DML files. Security policy may determine whether you are allowed to share DML files. DML files may contain sensitive information about people and accounts. 

Scenarios

Minimum for Problem Diagnosis

Scrub and provide the minimum information required for Datical Support to start diagnosing a problem. 

• datical.project - definition of the project
• changelog.xml - all changesets (changes applied to the database)
• daticaldb.log - main Datical DB log
• packager.log - log from running the Deployment Packager, which refactors SQL files into changesets and deploys them to the REF database

Example of Minimum

hammer debug export --include=datical.project,changelog.xml,daticaldb*.log,packager.log

Default

Include and scrub all files in the project directory.

Example of Default

hammer debug export

Exclude DML

Scrub and include files in the project directory except DML files and generated SQL in the html reports.

Example of Excluding DML

hammer debug export --exclude=*.html,Resources/sql,Resources/sql_scripts