Q100589: How to launch Mari with Verbose Output to aid troubleshooting

Follow
  1. Foundry
  2. Mari
  3. Troubleshooting

SUMMARY

This article explains how to launch Mari with verbose logging in each OS, either from the command line or a desktop shortcut.

Launching Mari 7.0v2 (Verbose Output) launches a separate Mari Verbose Debug Log window alongside Mari that generates a live report of everything that Mari actions and processes. It can be extremely useful to see how Mari is handling tasks moment by moment, specially when troubleshooting is required.

 

 

MORE INFORMATION

It is helpful for both users and the Support team to review verbose output from Mari when an issue occurs in the application. It produces the same content as the MariLog.txt file (aside from licensing checkouts, which are only shown in the Verbose Output). 

If for some reason the MariLog.txt file isn't being correctly generated (due to permissions or other networking conflicts), but the Support team has asked you for it, launching in Verbose Mode allows the console to be displayed, which means you can copy Mari’s output to a text file and send this to the Support team. 

The user can also use Verbose Output to learn more about Mari and how the application processes their actions, just by keeping an eye on it as they work.

 


Launching Mari with Verbose Output from the Command Line:

Open the Terminal and use it to launch Mari with the --verbose startup flag. You can use the command relevant to your OS from the following options:

Windows: "C:\Program Files\Mari7.0v2\Bundle\bin\Mari7.0v2.exe" --verbose

       Linux: /usr/local/Mari7.0v2/mari --verbose

    macOS: /Applications/Mari4.7v7/Mari4.7v7.app/Contents/MacOS/Mari4.7v7 --verbose

Please note that these examples assume the default installation directory and that you are launching Mari 7.0v2 (or 4.7v7 on macOS). Please replace all instances of the version number to launch other Mari releases, or change the path if your Mari install is located elsewhere:

 

 

Launching Mari with Verbose Output from a Desktop Shortcut:

A shortcut called Mari 7.0v2 (Verbose Output) is created on Windows when Mari is installed. On Linux and macOS, a shortcut must be created manually. Please select your OS and follow the instructions within to launch Mari in Verbose Mode through a shortcut. 

WINDOWS

In the Windows Start menu or Search Bar, please type Mari 7.0v2 (Verbose Output), then press Enter to launch the application:

Alternatively, the shortcut file is available in your ProgramData Windows directory. Assuming the default installation path, you can find it in:

C:\ProgramData\Microsoft\Windows\Start Menu\Programs\The Foundry\Mari 7.0v2

NOTE: The ProgramData directory is generally hidden by default. To display and access a folder's hidden items, turn on Show Hidden Items in the File Explorer.

LINUX

This icon unfortunately needs to be created manually due to Mari's Linux installation package not including pre-registered desktop shortcut icons. Please review the following article for creating one, and append the --verbose startup flag to the application path:
 Q100521: Creating a desktop shortcut on Linux operating systems

MACOS

Unfortunately, macOS does not automatically generate a verbose output Mari shortcut, and will need to be generated manually. Please do the following to create a Mari icon with verbose output through the Terminal:

  1. Open a text editor and create a new empty file.

  2. Add the following code into the empty file. The second line consists of the full path to the Mari application, with the --verbose flag appended:

    #!/bin/bash
    /Applications/Mari4.7v7/Mari4.7v7.app/Contents/MacOS/Mari4.7v7 --verbose
  3. Save the file to your desktop with an appropriate name and the extension .command, for example:

    Mari4.7v7(Verbose Output).command

    NOTE: If you save the file with a .command extension, Mari will open with a Terminal window and print the verbose output of the application while in use. If you save the file with an .app extension, although Mari still logs the information, it will not be visible in a terminal window.

  4. Open a new Terminal window, and change directory to your desktop, using the command:

    cd ~/Desktop

  5. Run the following command in the Terminal window, changing Mari4.7v7(Verbose Output) for the name of your shortcut:

    chmod 744 "Mari4.7v7(Verbose Output)"

  6. When double-clicking the desktop shortcut, Mari 4.7v7 should open with verbose output in the Terminal.

 

 

FURTHER READING

Information about where the MariLog.txt file is located can be found in the following article:
Q100020: Default Mari directory paths for config and log files

 

 

FURTHER HELP

If you are still having trouble launching Mari with verbose logging after performing the steps outlined in this article, then please create a support ticket and provide us with the information requested in this article:
Q100090: Reporting a Mari issue

For more information on how to open a support request, please refer to this article:
Q100064: How to raise a support ticket

 

    We're sorry to hear that

    Please tell us why