If you are experiencing problems in executing a build, you can generate and export a log file that includes the output of your build, and send it to IncrediBuild Support. Using these logs, IncrediBuild Support can help you discover where errors occur in your specific build.

This section includes the following:

Before the Log Export: Re-Executing Problematic Builds with Special Commands

Before you generate and export log files, it is recommended to re-execute the problematic build with one or two special commands: -d1 and --ib-crash. These commands add important information to the log file, thus facilitate the detection of the issue that causes the problems in your build.  

Depending on the type of execution problem you are experiencing, use the special commands as follows:

Using the -d1 Command

Use the -d1 command for re-executing the build before exporting its log, if your build hangs or gets stuck during execution, or if the build fails with error messages.

> To use the -d1 command for re-executing a build:

Using the --ib-crash Command

If your build crashes, it is recommended to use the --ib-crash command in addition to the -d1 command when re-executing the build.

> To use the --ib-crash command for re-executing a build:

Viewing the Details of Execution Commands

The Build History screen enables you to see if a build was executed with the -d1 and --ib-crash commands.  

> To view the details of the execution commands of a build:

Exporting a Log File for the Entire Build

You can generate and export a log file for an entire build. The generated log file will include different data, according to the commands used for executing the build. Depending on the type of data you want to include in the log file, perform one of the following:

> To export a log file for the entire build:

  1. Execute the build using the -d1 command, as follows:

    ib_console -d1 <Your_Build_Tool_Command> <Multiprocessing_Command> <Number_of_Processes_to_Run_in_Parallel >

    Notes:

    -  If you want the log file to include only the Build History data, you can execute the build as usual, without the -d1 command.

    -  If your build crashes, add the --ib-crash command after the -d1 command.

     For example:

    ib_console -d1 make -j 200

    The build is executed.

  2. In the Build History screen, locate the build whose log file you want to export. Then, and click its Action button on the Action column:

  3. On the Action menu, select History -> Export Logs:

    A confirmation message appears, informing you that the log export was completed successfully.

    The log file is downloaded to your machine:

    You can now send the downloaded log file to IncrediBuild Support.

Exporting a Log File for a Specific Process

In addition to exporting a log file for an entire build, you can generate and export a log file for a specific process that is a part of an executed build. In order to export a log file for a specific process, you need to execute its build using the -d1 command. Without the -d1 command, no log data will be generated for individual processes.

> To export a log file for a specific process that is a part of a build:

  1. Execute the build using the -d1 command, as follows:

    ib_console -d1 <Your_Build_Tool_Command> <Multiprocessing_Command> <Number_of_Processes_to_Run_in_Parallel >

    The build is executed.

  2. In the Build History screen, double-click the required build.

    The build is displayed in the Build Progress screen.

  3. In the Build Progress screen – Graphical View tab, locate in the Build Progress Graph area the process whose log you want to export, and click it:

    An Information message appears, containing additional details on the selected process.

  4. On the Information message, click the Export Log option to generate the log.

    The log file is downloaded to your machine, and you can now send it to IncrediBuild Support.

Sending Logs to IncrediBuild Support

Logs should be sent to IncrediBuild Support in one of the following ways: