Freeze – Troubleshooting Guide

by GRAPHISOFT, Greg Kmethy and Csaba Kézér · updated: 01.27.2017

A “freeze” or “hang” is the state of the program when it does not respond to the operating system. A situation when ARCHICAD does not respond to user actions (You see the hourglass on PC or the beachball on Mac ) does not necessarily mean its frozen, it might just be busy. In a “busy” state, you might not be able to interact with ARCHICAD, but ARCHICAD still responds to events initiated by the operating system. When ARCHICAD is frozen, it does not even respond to system events.


How to Report a Freeze on PCs in general

The running process in ARCHICAD during a freeze can be recorded into dump files. Unfortunately, the dump file is only human readable with the assistance of a debugger and the symbol tables that are created when ARCHICAD is compiled, therefore only developers at Graphisoft can investigate the data written in the dump file.

Create Minidump files with Process Explorer

In most of the cases the best solution is to create so-called Minidump files.

  1. Use process explorer (Free tool; Part of the Sysinternals suite of programs http://technet.microsoft.com/en-us/sysinternals/bb896653.aspx )
  2. Choose the freezing ARCHICAD process
  3. Right click on it; then choose Create Dump -> Create Minidump
  4. Create 4-5 Minidump files with 6-8 seconds time between the creatio

Process

{i} A few process dumps are more helpful to the developers than just one. Often the value of the dump is a question of timing; a dump may present more useful information at one time than another. With more dumps the developer can compare the instructions that are being run by the CPU. This time averaged view often gives better insights into the cause of the race or lock.

How to Report a Freeze on Mac

To investigate a Freeze on Mac, please provide the following data to your ARCHICAD reseller’s tech support:

  • Your description of the problem (how frequent does this happen? What were you doing before it happened?)
  • 4-5 process samples (see below)
  • a hang log (see below)

Process sample

While ARCHICAD is frozen, open the Activity monitor, select the ARCHICAD process, and click the Sample Process icon. This will take a few second sample from ArchiCAD, and will display it in text format. Click Save to save this in a txt file. Please repeat the process and create at least 3-4 samples.

Activity Monitor

hang log

When you are finished with taking the sample, pleas force-quit ARCHICAD. This should open up the Mac reporter (Note: this is not ARCHICAD’s GSReporter with the ladybug icon). If the Mac reporter does not appear then ARCHICAD was not frozen from a technical point of view – it was just busy.

reporter.png

Click Report… then on the appearing window select the Problem details tab. Copy the text from here, and paste it into a text file.

Details

 ARCHICAD Known Issues

  • Was this Helpful ?
  • 1   ​2