On this page

Scripts

The following is the script package used in this page:

When you report an issue with your modeling tool, Cameo Collaborator or Teamwork Cloud, always include related log files. Log files provide useful information that we need to investigate and troubleshoot your problem.

Using the log file script package

The script package contains utilities for gathering and managing log files on your Teamwork Cloud server. These scripts are designed to run from a Linux or Windows Cygwin command line.

  • Create log file package
    Use the getlogfiles.sh script to create a package of all log files associated with Teamwork Cloud operations. This script will create a TAR archive file containing all the latest logs, as well as some system information. The TAR package can be sent along with your support request to help analyze Teamwork Cloud-related issues.
  • Reset log files
    Sometimes you may need to create a fresh set of log files. Use the clearlogfiles.sh script to reset the log files associated with Teamwork Cloud operations. Please make sure all Teamwork Cloud services are stopped before running the script. This script will then rename all the current log files so that new log files can be generated when the Teamwork Cloud services are restarted. Resetting the log files will ensure that the logs will only contain the latest startup information.

Accessing log files

Installation paths

PACKAGEOSVERSIONINSTALL_ROOT
Teamwork
Cloud
Linux22xR2, 24x<install_root> /CATIANoMagicServices
22xR1 and older<install_root> /TeamworkCloudSuite
Windows22xR2, 24x<install_root>\CATIANoMagicServices
22xR1 and older<install_root>\ TeamworkCloudSuite
Magic
Collaboration
Studio
LinuxAll<install_root>/MagicCollaborationStudio
WindowsAll<install_root>\MagicCollaborationStudio
  • For a modeling tool:

Open your modeling tool and in the main menu go to Help > About <modeling tool name>. In the Environment tab, click the link provided in the Log File line to open a log file.

Or 

Go to the <user.home>\<.modeling tool name>\<modeling tool version> directory and obtain <modeling tool name>.log file.

Default path for Windows: C:\Users\<USERNAME>\AppData\Local\.<modeling tool name>\<modeling tool version number>
Default path for other operating systems: <user.home>/.<modeling tool name>/< modeling tool version number>

  • For Web Application Platform/Cameo Collaborator for Teamwork Cloud:

Log files (e.g., webapp.logcollaborator.log, etc.)
Linux: <install_root> /WebAppPlatform/logs/webappplatform
Windows: <install_root> \WebAppPlatform\logs\webappplatform

Configuration
Linux: <install_root>/WebAppPlatform/shared/conf/webappplatform.properties
Windows: <install_root>\WebAppPlatform\shared\conf\webappplatform.properties

Teamwork Cloud/Magic Collaboration Studio

Log file for 2024x and later
Linux : <install_root>/TeamworkCloud/logs/server.log
Windows: <install_root>\TeamworkCloud\logs\ server.log

Configuration
Linux: <install_root>/TeamworkCloud/configuration/application.conf
Windows: <install_root>\TeamworkCloud\configuration\application.conf

Log file for earlier versions
Linux: /home/twcloud/.twcloud/<version>/server.log
Windows: C:\Users\<user>\.twcloud\<version>\server.log

  • For Authentication server:

Log file for 2022x and later
Linux: <install_root> /WebAppPlatform/logs/webappplatform/authentication.log
Windows: <install_root>\ WebAppPlatform\logs\webappplatform\authentication.log

Configuration for 2022x and newer
Linux: <install_root>/WebAppPlatform\shared\conf\authserver.properties
Windows: <install_root>\WebAppPlatform\shared\conf\authserver.properties

Log file for earlier versions
Linux: /home/twcloud/.authserver/<version>/authserver.log
Windows: C:\Users\<user>\.authserver\<version>\authserver.log

Configuration for earlier versions
Linux: <install_root> /AuthServer/config/authserver.properties
Windows: <install_root>\ AuthServer\config\authserver.properties

  • For Cassandra:

Log file
Linux: /var/log/cassandra/system.log

Configuration files 
Linux: /etc/cassandra/conf

  • Properties files for Teamwork Cloud:

Default for Linux:
/opt/local/TeamworkCloud/configuration/application.conf
/opt/local/TeamworkCloud/Authserver/config/authserver.properties
/opt/local/TeamworkCloud/WebAppPlatform/shared/conf/webappplatform.properties

Default for Windows:
C:\Program Files\TeamworkCloud\configuration\application.conf
C:\Program Files\TeamworkCloud\Authserver\config\authserver.properties
C:\Program Files\TeamworkCloud\WebAppPlatform\shared\conf\webappplatform.properties

Generating a log file

If the performance of your modeling tool declines or it freezes, go to <modeling tool installation directory>\bin, and run the submit_issue.exe or submit_issue.sh file several times. It dumps threads into the log file of your modeling tool. Then you can access the log file as described above.

Java crash log files

If your modeling tool crashes (disappears), try searching for Java crash log files. They are stored in the running location of the modeling tool, e.g., the <modeling tool installation directory>/bin or <modeling tool installation directory> directory. The names of these log files start with "hs_err", e.g., hs_err_pid15693.log. If you find the Java crash log file, it indicates that Java was the reason of your modeling tool crash.