Installation

  1. How do I install Lattix?
  2. Follow the steps in the Installation Manual. It also describes how to install the web repository and application on different platforms.

  3. What version of Java is required to run Lattix?

    Since Lattix installers for Windows and Macs include Java, you don't need to install Java to run Lattix on Windows and Macs. For other platforms or if you are not using the installer on Windows and Macs you need to install Java. Lattix can run on the following versions of Java:

    • Windows: 1.7+
    • Mac: Java 1.7+
    • Linux: OpenJDK 1.7+ or Java 1.7+
  4. On Macs, I get an error when I try to run on OS X. What should I do?

    Sometimes, the error reports the Lattix application as "damaged". Generally, this problem occurs with older versions of OS X. Lattix has been tested on OS X 8.4 and higher. However, you should still be able to run Lattix using the shell script.

    • Open a Terminal Window
    • Run /Applications/Lattix9.4.1.app/Contents/Resources/Java/bin/lattixarchitect.sh. (Please adjust "9.4.1" with the version of Lattix that you are trying to run).
  5. Do I need to uninstall Lattix applications in order to install a new version?
  6. You do not need to uninstall the older version of Lattix applications. In fact, you can have multiple versions of Lattix on your computer. Note that projects created on later versions of Lattix may not always be loadable on older versions.

    You must uninstall Lattix Web prior to installing a new version of Lattix Web.

  7. When I update the Lattix Web will I lose the data in my repository?
  8. No, you will not lose your data. When you install Lattix Web you specify the directory where the repository is located. Note that when you uninstall Lattix Web, the repository is left intact. Simply uninstall the older version of Lattix Web, install the new version, and specify the same directory for the repository.

  9. How do I move Lattix Web and the repository to another host?

    Follow these steps to move Lattix Web from one host to another:

    • Stop the Lattix Web Repository Service. On Windows, you can do that from the Services panel: Control Panel\System and Security\Administrative Tools
    • Backup the repository data directory. In Windows, the default location of the directory is: C:\LattixRepository
    • Restore the repository data directory on the new host
    • Install Lattix Web on the new host. Specify the new repository data directory during installation.
    • Verify by connecting to the new repository using your browser. For example: http://hostname:8080/LattixWeb
    • Install the new license from Admin→License
  10. Remember to let repository users know what the new host name and port number are.

  11. I run out of heap memory when I try to load a large project. How can I increase heap memory?
  12. Windows and Linux

    By default, Lattix tries to create a heap size of 1GB for 32-bit systems and a size based on the actual memory for 64-bit systems. On some systems, based on actual memory organization, the default heap size is not set correctly. You can check the max heap size and the heap size used on your system by bring up the About box from Help→About.

    Note that 32-bit applications are always limited to about 1GB of heap space regardless of how much physical memory you have on your computer. You can change the heap size that is used by Lattix by using the '-Xmxnumber' argument to either lattixarchitect.exe/lattixarchitect.bat/lattixarchitect.sh or to any of the other programs. If you are running Lattix Architect from the Windows shortcut, bring up the Properties dialog and append the heap size argument to the Target.

    For instance:

    lattixarchitect.exe -Xmx12g will allocate a maximum of 12 GB of heap for Lattix Architect.
    ldcupdate.exe -Xmx8g will allocate a maximum of 8 GB of heap for ldcupdate.
    

    Mac

    The Info.plist file in the Lattix application package controls how the heap allocated when JVM is started. This steps shown here will start Lattix with 4 GB of heap memory. Please adjust according to your usage, while not specifying heap size larger than the physical memory on your system.

    1. In finder, select "Applications" on left.
    2. Search for Lattix in top right and find the "Lattix" application.
    3. Option-click (or right mouse click) on Lattix Architect application and select "Show Package Contents".
    4. Expand "Contents" to view "Info.plist" file. Open file (using xcode or other editor).
    5. Add "string" argument to "JVMOptions": -Xmx4g
    6. Expand "Contents/MacOS" in finder and double click on "JavaAppLauncher"

     

  13. When I run Lattix, I get an error message "GC Overhead Limit Exceeded." What is going on?
  14. This error results from lack of sufficient heap memory. The virtual machine produces this message when the garbage collector is called too often because memory is running low. Increase the heap memory to resolve this problem. You can also turn off the Atom Database to reduce the memory footprint.

  15. Lattix Architect memory use appears to increase in time. Is Lattix Architect holding on to unused memory?
  16. Lattix applications can grow in size over time based on use. However, we take pains to reclaim the memory that is no longer in use. This is done by freeing the memory and letting the Java garbage collector reclaim it. This can create a time gap between when memory is unused and when it is freed.

    However, there is another important issue that can be misleading. Sometimes users look at memory usage in Windows Task Manager. It can show a lot of memory used by the Lattix Architect process even when the project that was loaded is closed. Note that this does not imply that there is a memory leak. This just reflects a large virtual size of the application when the project was loaded and does not reflect the what the current size of the application is.

    Nevertheless, this is an important issue for us. We have fixed memory leaks in the past and so we are always interested in learning of scenarios where you may have experienced this problem. Please contact us if you think that you are running into a memory leak.

  17. I specify a valid license but I get the message "No license for product (-1)."

    Typically this happens when you first run Lattix as a user with admin privileges, and then run as regular user. The problem is that the license files are no longer accessible. Follow these steps to clear the license files:

    • Delete the file "architect.lic" in the config directory where you have installed Lattix (typically, c:\Program Files\Lattix9.4\config). Note that you may have to alter the directory to match your installation. Do nothing if there is no such file in the directory.
    • Delete the directory c:\Users\your-name\.lattix. The ".lattix" directory contains license and config information that Lattix generates when it runs.
  18. Now start Lattix as a regular user and specify the License File. Please make sure that the license file on your file system is readable. If for any reason the file is not readable or you see an error message, copy the contents of the file and paste them as text directly into the Key text area of the License Dialog box. This bypasses having to read the license file.

  19. When I go to run Lattix Architect from the desktop shortcut I get an error. What should I do?

    Here are a few things to try:

    • Try bringing up Lattix by running the batch file "lattixarchitect.bat" in the Lattix bin directory.
    • If the error message suggests that you are running out of Java heap space, you can also try running "lattixarchitect.exe" with the argument "lattixarchitect.exe -Xmx1024m".
  20. Please contact us if you are not able to start up for any reason.

  21. When using the floating license manager, I specify the License Host and Port number in the License dialog. However, nothing happens and I get a message that there is a "Communication Error" or "Connection is Refused". What should I do?
  22. Verify that the License Manager is up and running. Then ensure that there are no firewalls that are preventing the connection request from being sent to the License Manager.

  23. How do I install the Eclipse plugin?

    There are two ways to install Eclipse:

    • You can update Eclipse plugin for Lattix from the update site.
    • Download the compressed archive for the Eclipse plugin. Extract files from the compressed zip archive into the Eclipse plugin directory.
  24. How do I uninstall the Lattix Eclipse plugin?
  25. You can uninstall the Eclipse plugin through the Eclipse menu Help->Software Updates. You can also manually uninstall by removing all Lattix files and directories under 'plugins' and 'features' directory where you installed Eclipse.

  26. On my Linux system, the fonts in the Lattix Architect header don't look good (they are bold and squished). How do I fix it?
  27. Your Linux systems may not have the correct fonts. This can happen because you are using a different JDK from the one that comes from Sun. Change the look and feel from "Metal" to the default. This should fix the problem.

    In the shell script lattixarchitect.sh, which is in the Lattix bin directory, change the line:

    $JAVA_HOME/bin/java -Xmx999m -Dswing.systemlaf=javax.swing.metal.MetalLookAndFeel -cp "$FULL_CLASSPATH" com.lattix.application.cmds.LattixArchitect $*

    to

    $JAVA_HOME/bin/java -Xmx999m -cp "$FULL_CLASSPATH" com.lattix.application.cmds.LattixArchitect $*

  28. On my Vista PC, I copy the license file into the config directory but Lattix still comes up with the message that the license file does not exist. How do I turn on licensing?

    This is a problem caused by Vista User Access Controls (UAC). There are a number of workarounds:

    • Open the license file in Notepad and copy and paste the contents of the file into the Key field of the License Dialog. Click OK.
    • Disable UAC prior to copying the license file into the config directory and then you can re-enable UAC. You can disable and enable UAC by running MSCONFIG and then going to the Tools tab. Select Disable UAP or Enable UAP and click on Launch.
  29. I have dual monitors on my PC. However, Windows crashes when I try to run Lattix.

    If you experience this problem, it may be related to the interaction between the display hardware on your PC and the Java runtime. Here is a solution that has been reported by a user of Lattix:

    • Bring up Display Properties Dialog.
    • Select the Settings tab.
    • Click on the Advanced button.
    • Select the Troubleshoot tab.
    • Turn off the Enable write combining. Alternatively, you can also move the Hardware Acceleration slider to “None”.