(Build ID: 177955)

Cameo Systems Modeler™ Reader edition is made for reading and previewing system models created with Cameo Systems Modeler and is free of charge. It is extremely useful when you want to share your ideas expressed in SysML with partners, colleagues, or clients, who do not have their copy of Cameo Systems Modeler. This edition is also equipped with printing and the image export capabilities.

* Sometimes when running the application, the OutOfMemory error occurs. This means that your computer has not enough memory for working with the application. Ways of solving the problem are described in section OutOfMemory problem.

Operating system: Any Java SE 7 or later compatible operating system, i.e., Windows XP/ Vista/ 7/ 8, Linux, OS X (most testing procedures and debugging have been performed on these operating systems).

HTML browser: Any. Preferred Firefox or Internet Explorer and Safari for OS X. 

Java Virtual Machine:

• Oracle Java SE 7 Update 55 is recommended for Windows and Linux.
• Oracle Java SE 8 Update 20 is recommended for OS X Lion, OS X Mountain Lion, and OS X Mavericks.

http://www.nomagic.com/support/jvm-list.html

First, obtain the Cameo Systems Modeler Reader installation files. You can download the latest version from the Cameo Systems Modeler homepage http://www.nomagic.com/products/cameo-systems-modeler.html

If you are going to install Cameo Systems Modeler Reader on Unix, MAC OS, or other operating system that is not Windows OS, then JVM must be installed on your computer. For more information about the recommended Java version, see http://www.nomagic.com/support/jvm-list.html

If you use an operating system other than Windows, Unix, or OS X, we recommend to run Cameo Systems Modeler Reader from the no-install package (see section Using no-install package).

Using the installer

1. Ensure that your computer meets the system requirements for running the application.

2. Download either:

• Cameo_Systems_Modeler_Reader_<version number>_win.exe for 32-bit Windows
• Cameo_Systems_Modeler_Reader_<version number>_win64.exe for 64-bit Windows

3. Double-click the installer.

4. In case the User Account Control dialog appears asking your permission for the installer to make changes in your computer, click Yes.

5. Follow the on-screen instructions to install Cameo Systems Modeler Reader.

NOTES:

• For more information about the recommended Java, see http://www.nomagic.com/support/jvm-list.html

• For more information on how to change the Java version, see Changing Java version.

• For more information about memory allocation, see section "Memory allocation" in MagicDraw UserManual.pdf.

Unix

1. Download Cameo_Systems_Modeler_Reader_<version number>_unix.sh.

2. Double-click the installer.
   IMPORTANT!  Be sure you have:

   • JVM installed.
   • The execute permission on install files.

OS X

IMPORTANT! Be sure you have installed JVM. OS X Lion and OS X Mountain Lion do not include a Java runtime by default. It must be installed separately.

1. Download Cameo_Systems_Modeler_Reader_<version number>_mac.dmg.

2. Open the Applications folder and create a new folder named, for example, Cameo Systems Modeler Reader <version number>.
   NOTE: We suggest creating a new folder for each Cameo Systems Modeler version in order to not overwrite earlier versions. After installing a new version in the newly created folder you will be able to import the configurations from an earlier Cameo Systems Modeler version.

3. Double-click the installer.
   

4. Drag the Cameo Systems Modeler folder to the Applications/Cameo Systems Modeler <version number> or some other folder.

Using no-install package

Windows 95/ 98/ NT/ 2000/ XP/ Vista/ 7/ 8

1. Download Cameo_Systems_Modeler_Reader_<version number>_no_install.zip.

2. Extract the file.

3. Open the bin directory and run csm.exe to start Cameo Systems Modeler.

Unix

1. Download Cameo_Systems_Modeler_Reader_<version number>_no_install.zip.

2. Extract the file.

3. Open the bin directory and run csm to start Cameo Systems Modeler.
   IMPORTANT! Be sure you have installed JVM.

OS X

IMPORTANT! Be sure you have installed JVM. OS X Lion and OS X Mountain Lion do not include a Java runtime by default. It must be installed separately.

1. Download Cameo_Systems_Modeler_Reader_<version number>_no_install.zip.

2. Extract the file.

3. Open the root directory and double-click Cameo Systems Modeler Reader <version number>.app to start Cameo Systems Modeler.

Changing Java version

In the csm.properties file, which is located in <Cameo Systems Modeler installation directory>\bin, add the value for the following parameter:

JAVA_HOME=<path to new JRE>

NOTE: Integrated Cameo Systems Modeler runs on the JVM specified by the IDE. In order to change JVM, you need to modify startup properties for the IDE, Cameo Systems Modeler Reader integrates with. If you are running Cameo Systems Modeler Reader integrated with the IDE, read the appropriate readme.html for the specific integration, which can be found in <Cameo Systems Modeler installation directory>\integrations\<IDE directory>.

Changing the location for storing configuration files

Configuration files are by default stored in the following locations:

If Cameo Systems Modeler Reader is running, you can open this folder directly from the application. Do the following:

1. On the main menu, click Help > About Cameo Systems Modeler.
2. Open the Environment tab.
3. Click the Configuration Files hyperlink.

• <Cameo Systems Modeler installation directory>
• Common Application Data location (on Windows OS)
• Other directory

1. Open the csm.properties file, which is located in <Cameo Systems Modeler installation directory>\bin.
2. Change the parameter value from

   -DLOCALCONFIG=true

   to

   -DLOCALCONFIG=false

3. On Windows OS, add the additional parameter

   -DWINCONFIG=false

   IMPORTANT: It is important to add the DWINCONFIG parameter on Window OS, otherwise the configuration files will not be stored in Cameo Systems Modeler installation directory.

1. Open the csm.properties file, which is located in <Cameo Systems Modeler installation directory>/bin.
2. Change the parameter value from

   -DLOCALCONFIG=true

   to

   -DLOCALCONFIG=false

NOTE: The Common Application Data location is the following:
• On Windows NT4 - C:\WINNT\Profiles\All Users\Application Data
• On Windows 2000/XP - C:\Documents and Settings\All Users\Application Data
• On Windows Vista/7/8 - C:\ProgramData

Do either:

1. Open the folder, where the configuration files are stored (for the exact location, see the preceding table).
2. Create a new file named cameoearedirect.
3. In the file, type the absolute path to the folder, wherein Cameo Systems Modeler Reader configuration files will be saved, e.g., C:\<directory name>.

1. Open the csm.properties file, which is located in <Cameo Systems Modeler installation directory>\bin.
2. Change the parameter value:
   

   -DLOCALCONFIG.location=<absolute path to a chosen location>

   NOTE: If you have defined to store files in the Cameo Systems Modeler installation directory (see section To store configuration files in the Cameo Systems Modeler application installation directory), files will not be stored in the defined location.

Redirecting output info to the console

The Cameo Systems Modeler Reader output information by default goes into the csm.log file. If there is a need, you can redirect the output to the console.

NOTE: If you cannot find the csm.log file, see section csm.log file location.

On all operating systems

In the csm.properties file, which is located in <Cameo Systems Modeler installation directory>\bin, add the value for the following parameter:

APP_ARGS =-verbose

OutOfMemory problem

Sometimes when running the program the OutOfMemory error occurs.

Windows, Linux, OS X

If you are running the Sun's JVM, set the following java properties in your cmb.properties file to avoid the above problem:
in the line JAVA_ARGS=-Xmx600M, change the number of the heap size '600' to the maximal heap size in megabytes.

For example, the java heap size would be:
JAVA_ARGS=-Xmx800M
This sets the java heap size to 800 megabytes.

NOTE: Integrated Cameo Systems Modeler runs on the JVM, specified by the IDE. If you are running Cameo Systems Modeler, integrated with the IDE, you will need to modify startup properties for the appropriate IDE.

OutOfMemory PermGen space problem

If you get the exception "java.lang.OutOfMemoryError: PermGen space", please check, if PermSize is specified in the configuration file.

Windows, Linux, OS X (not applicable for IBM JVM)

If PermSize is specified in the cmb.properties file and the same problem still appears, MaxPermSize should be increased. PermSize is a part of heap size, so MaxPermSize should always be smaller than the heap size specified with the Xmx parameter.

For example:
JAVA_ARGS=-Xmx800M -XX\:PermSize\=40M -XX\:MaxPermSize\=200M

NOTE: Integrated Cameo Systems Modeler runs on the JVM, specified by the IDE. If you are running Cameo Systems Modeler, integrated with the IDE, you will need to modify startup properties for the appropriate IDE.

StackOverflow problem

Sometimes when running the program, StackOverflowError occurs.

Windows, Linux, OS X

If you are running the Sun's, IBM JVM, set the following java properties in your cmb.properties file to avoid the above problem:
to the line JAVA_ARGS=-Xmx600M, append the string -Xss<stack size>.

For example:
JAVA_ARGS=-Xmx600M -Xss2M

This sets the java stack size to 2 megabytes.

NOTE: Integrated Cameo Systems Modeler runs on the JVM, specified by the IDE. If you are running Cameo Systems Modeler, integrated with the IDE, you will need to modify startup properties for the appropriate IDE.

Computer freezes or reboots while exiting Cameo Systems Modeler or repaint problems occur

This may happen because of JDK SDK and the Windows direct draw incompatibility. We would suggest you to turn off the direct draw for the Cameo Systems Modeler application.
In the <Cameo Systems Modeler installation directory>/bin/cmb.properties file to the line'JAVA_ARGS=' append the additional part
-Dsun.java2d.noddraw.

NOTE: Integrated Cameo Systems Modeler runs on the JVM, specified by the IDE. If you are running Cameo Systems Modeler, integrated with the IDE, you will need to modify startup properties for the appropriate IDE.

Java Virtual Machine could not be started

Open the <Cameo System Modeler Reader installation directory>/bin/csm.properties file for editing and comment the lines defining default memory settings. These lines should look like this:

# DEFAULT_MEMORY_SETTINGS_64=-Xmx2400M -XX\:PermSize\=60M -XX\:MaxPermSize\=200M -Xss1024K
# DEFAULT_MEMORY_SETTINGS_32=-Xmx800M -XX\:PermSize\=40M -XX\:MaxPermSize\=150M -Xss640K

After the install, Cameo Systems Modeler cannot be launched or it just appears on the screen and vanishes

Please try one of the following solutions:

• Start Cameo Systems Modeler with the system property no.printer.lookup=true.
  In the <Cameo Systems Modeler installation directory>/bin/cmb.properties file to the line'JAVA_ARGS=' append the additional part
  -Dno.printer.lookup=true. 

• The problem may be related with the printer driver. The description of this problem is published in the Java Bug Database (http://java.sun.com/). The bug ID is 4988827. Try to change the default printer driver on your Windows OS and load again. For example, the HP LaserJet 4000N PCL5e should be compatible, while HP LaserJet Series 4000 PCL6, HP LaserJet Series 4000 Postscript, Savin 2535 PCL6, HP LaserJet Series 5000 Postscript, HP Deskjet 560C, Acrobat PDFWriter are not.

NOTE: Integrated Cameo Systems Modeler runs on the JVM, specified by the IDE. If you are running Cameo Systems Modeler, integrated with the IDE, you will need to modify startup properties for the appropriate IDE.

Cameo Systems Modeler installer is not started or Cameo Systems Modeler is not started on Linux OS

The Cameo Systems Modeler installer may not be started or Cameo Systems Modeler itself may not be started, because of changes in the default system Java. In this case when starting the installer or Cameo Systems Modeler, no GUI appears or when starting from the command line the following message is displayed:
Configuring the installer for this system's environment... No Java virtual machine could be found from your PATH environment variable. You must install a VM prior to running this program.
We would suggest the following solution:

• Change your default system Java to recommended.
• After some Ubuntu update, the Ubuntu Java overrides the default Sun Java and the default system Java becomes Ubuntu Java. To start the Cameo Systems Modeler installer, Ubuntu-restricted-extras should be installed. For more information about installing the Ubuntu-restricted-extras, see the Ubuntu website: https://help.ubuntu.com/community/RestrictedFormats.

1. On the main menu, click Help > About Cameo Systems Modeler.
2. Open the Environment tab.
3. Click the Log File hyperlink.

• <User home directory>\..cameo.systems.modeler_reader\<version number>
• <Cameo Systems Modeler installation directory>

Frequently Asked Questions and Forum