Where Are My Files?

MT Showcase files are organized across multiple folders:

• Configuration files: To find the *.yaml files, see the section below.

• Log files: To find the MT Showcase logs, see Where Are the Log Files?.

• License files: To find your license file, see Where Is My License?.

Where Are the *.yaml Configuration Files?

Where is production_users.yaml?

If you need to edit production_users.yaml, find the file here:

• Ubuntu application computers: Find the file here: /etc/MultiTaction/mt-showcase/server/production_users.yaml

• Windows application computers: Find the file here: C:\Program Files\MT Showcase\server\production_users.yaml

Note

You need to edit this file if you want to:

• Password-protect the Editor; see Configure MT Showcase.

• Set up data gathering. As part of the setup, you must configure MT Showcase to use a reporting database.

• Change the default backup folder.

Where Are the Log Files?

Server Log Files

Log entries are generated each time the MT Showcase server starts.

• Ubuntu servers: The log file is here: /var/log/upstart/mt-showcase-server.log

• Windows servers: The log file is here: %LOCALAPPDATA%\MultiTaction\showcase\logs\server-log_<date>.txt

  Where %LOCALAPPDATA% refers to the runtime user's profile folder. If the user logged on when the MT Showcase server starts is multi, the expanded path is: C:\Users\multi\AppData\Local\MultiTaction\showcase\logs\server-log_<date>.txt

Client Log Files: Generated by MT Launcher

Applies to both Ubuntu and Windows application computers.

Log entries are generated each time MT Showcase is started from MT Launcher. MT Showcase client logs take this file name format: mt-showcase-<ver>-<date>.log

Where <ver> is the MT Showcase version.

• Ubuntu application computers: Log files are here: ~/MultiTaction/launcher/logs/

  Where ~/ refers to the runtime user's home folder. For example, if the user logged on when MT Showcase starts is multi, the expanded path is: /home/multi/MultiTaction/launcher/logs/

• Windows application computers: Log files are here: %LOCALAPPDATA%\MultiTaction\launcher\logs

  Where %LOCALAPPDATA% refers to the runtime user's profile folder. For example, if the user logged on when MT Showcase starts is multi, the expanded path is: C:\Users\multi\AppData\Local\MultiTaction\launcher\logs

Client Log Files: Generated by MT Showcase

Applies to Windows application computers only. Applies when Showcase is started directly (not from MT Launcher).

Log entries are generated each time MT Showcase is started. MT Showcase client logs take this file name format: mt-showcase-<date>.log

• Windows application computers: Log files are here: %LOCALAPPDATA%\MultiTaction\showcase\logs

  Where %LOCALAPPDATA% refers to the runtime user's profile folder. For example, if the user logged on when MT Showcase starts is multi, the expanded path is: C:\Users\multi\AppData\Local\MultiTaction\showcase\logs

Client Log Files: Created Manually

If MT Showcase was started from a terminal (not from MT Launcher or Windows shortcut), log files are not generated but log entries are written to standard output (STDOUT).

If you need to create a log file manually (for example, for troubleshooting purposes), you can add a "log file" argument to the MT Showcase startup command. Follow these steps:

1. If required, create a target folder for your log file. For example:

   • Ubuntu: ~/MultiTaction/showcase/logs/

     Where ~/ refers to the runtime user's home folder. For example, if the user logged on when MT Showcase starts is multi, the expanded path is: /home/multi/MultiTaction/showcase/logs/

   • Windows: %LOCALAPPDATA%\MultiTaction\showcase\logs

     Where %LOCALAPPDATA% refers to the runtime user's profile folder. For example, if the user logged on when MT Showcase starts is multi, the expanded path is: C:\Users\multi\AppData\Local\MultiTaction\showcase\logs

2. (Applies to Ubuntu application computers only) Right-click the desktop and launch a terminal emulator. Then run this command:

   $ mt-showcase --trace-file "/<folder>/<file>"
   

   Where <folder> is the folder you created in step 1 and <file> is the new log file. For example:

   $ mt-showcase --trace-file "/home/multi/MultiTaction/showcase/my_showcase.log"
   

3. (Applies to Windows application computers only) Open the Start menu and launch a command prompt. Then run this command:

   "C:\Program Files\MT Showcase\bin\showcase.exe" --trace-file "<folder>\<file>"
   

   Where <folder> is the folder you created in step 1 and <file> is the new log file. For example:

   --trace-file "C:\Users\multi\AppData\Local\MultiTaction\showcase\logs\my_showcase.log"
   

4. The new log file is created when you start MT Showcase directly.

Where Is My License?

Note

For full details about licensing, see Licensing.

The MT Showcase license is installed in the home folder (Ubuntu) or user profile (Windows) of the user who was logged on when the license was first activated:

• Ubuntu application computers: The license is saved to ~/MultiTaction/Licenses

  Where ~/ refers to the home folder of the MT Showcase runtime user. If the user logged on while MT Showcase runs is multi, the expanded path is: /home/multi/MultiTaction/Licenses/

• Windows application computers: The license is saved to %LOCALAPPDATA%\MultiTaction\Licenses

  Where %LOCALAPPDATA% is the MT Showcase runtime user's profile. If the user logged on while MT Showcase runs is multi, the expanded path is: C:\Users\multi\AppData\Local\MultiTaction\Licenses