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

Operating system: Any Java 1.6.0 compatible virtual machine, i.e., Windows 95/ 98/ NT/ 2000/ XP/ Vista/ 7, Linux, Mac 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 Mac OS X. 

Java Virtual Machine: Sun's JDK 1.6.0_22.

You can find the up-to date JVM list at:
http://www.magicdraw.com/jvm_list.htm

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

Using installer

1. Download the installer:

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

2. Double-click the installer. 

Unix

1. Download Cameo_Enterprise_Architecture_Reader_<version number>_unix.sh.
2. Double-click the installer. 

IMPORTANT!  Be sure you have:

• JVM installed.
• The execute permission.

Mac OS X

1. Download Cameo_Enterprise_Architecture_Reader_<version number>_mac.dmg.
2. Double-click the installer.
3. Drag the Cameo Enterprise Architecture Reader folder to the Applications or some other folder.

IMPORTANT! Be sure you have JVM installed.

Using no-install package

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

1. Download Cameo_Enterprise_Architecture_Reader_<version number>_no_install.zip.
2. Extract the file.
3. Go to the bin directory and run:

• cameoea.exe to start Cameo Enterprise Architecture on the 32-bit Windows operating system
• cameoea64.exe to start Cameo Enterprise Architecture on the 64-bit Windows operating system

1. Download Cameo_Enterprise_Architecture_Reader_<version number>_no_install.zip.
2. Extract the file.
3. Go to the bin directory and run cameoea to start  Cameo Enterprise Architecture.

1. Download Cameo_Enterprise_Architecture_Reader_<version number>_no_install_mac.zip.
2. Extract the file.
3. Using the command-line prompt go to the bin directory and type the command:

./cameoea

Changing Java version

In the cameoea.properties file (or the cameoea64.properties file on 64-bit Windows), which is located in <Cameo Enterprise Architecture installation directory>\bin, add the value for the following parameter:

JAVA_HOME=<path to new JRE>

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

Changing the location for the configuration files storage

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

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

• <Cameo Enterprise Architecture installation directory>
• Other directory

1. Open the cameoea.properties file (or the cameoea64.properties file on 64-bit Windows), which is located in <Cameo Enterprise Architecture installation directory>\bin.
2. Change the parameter value from

   -DLOCALCONFIG=true

   to

   -DLOCALCONFIG=false

Do the following:

1. Go to <User home directory>\.cameoea_reader\<version number>.
2. Create a new file named cameoearedirect.
3. In the file, type the absolute path to the folder wherein Cameo Enterprise Architecture Reader configuration files will be saved, e.g., C:\<directory name>.

1. Open the cameoea.properties file (or the cameoea64.properties file on 64-bit Windows), which is located in <Cameo Enterprise Architecture 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 Enterprise Architecture installation directory (see section "To store configuration files in the Cameo Enterprise Architecture application installation directory"), files will not be stored in the defined location.

Redirecting output info to the console

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

NOTE: If you can not find the md.log file, see section "md.log file location".

On all operating systems

In the cameoea.properties file (or the cameoea64.properties file on 64-bit Windows), which is located in <Cameo Enterprise Architecture 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, Mac OS X

If you are running the Sun's JVM, set the following java properties in your cameoea.properties file (or the cameoea64.properties file on 64-bit Windows) to avoid the above problem:
in the line JAVA_ARGS=-Xmx600M, change the number of 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 Enterprise Architecture runs on the JVM, specified by the IDE. If you are running Cameo Enterprise Architecture, 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, Mac OS X (not applicable for IBM JVM)

If PermSize is specified in cameoea.properties file (or the cameoea64.properties file on 64-bit Windows) and the same problem still appears, MaxPermSize should be increased. PermSize is a part of the 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 Enterprise Architecture runs on the JVM, specified by the IDE. If you are running Cameo Enterprise Architecture, integrated with the IDE, you will need to modify startup properties for the appropriate IDE.

StackOverflow problem

Sometimes when running the program, the StackOverflowError occurs.

Windows, Linux OS, Mac OS X

If you are running the Sun's, IBM JVM, set the following java properties in your cameoea.properties file (or the cameoea64.properties file on 64-bit Windows) 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 Enterprise Architecture runs on the JVM, specified by the IDE. If you are running Cameo Enterprise Architecture, integrated with the IDE, you will need to modify startup properties for the appropriate IDE.

Computer freezes or reboots while exiting Cameo Enterprise Architecture 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 Enterprise Architecture application.
In the <Cameo Enterprise Architecture installation directory>/bin/cameoea.properties file (or the cameoea64.properties file on 64-bit Windows) to the line'JAVA_ARGS=' append the additional part
-Dsun.java2d.noddraw.

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

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

Please try one of the following solutions:

• Start Cameo Enterprise Architecture with the system property no.printer.lookup=true.
  In the <Cameo Enterprise Architecture installation directory>/bin/cameoea.properties file(or the cameoea64.properties file on 64-bit Windows)  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/). 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 Enterprise Architecture runs on the JVM, specified by the IDE. If you are running Cameo Enterprise Architecture, integrated with the IDE, you will need to modify startup properties for the appropriate IDE.

The Cameo Enterprise Architecture installer is not started or Cameo Enterprise Architecture is not started on Linux OS

The Cameo Enterprise Architecture installer may not be started or Cameo Enterprise Architecture itself may not be started, because of changes in the default system Java. In this case when starting the installer or Cameo Enterprise Architecture, 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 Enterprise Architecture 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.

Diagram printing is not working on Linux OS

1. Open the file /etc/cups/printers.conf
2. Before each line with the text </Printer>, add the following line:
   

   Options orientation-requested 3

1. Export the diagram as Image. To do this, on the main menu, click File > Save as Image.
2. Open the exported image and print it.
   For more information about saving the diagram as images see section "Saving as an Image" in the chapter "Diagramming" in MagicDraw UserManual.pdf.

md.log file location

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

• <User home directory>\.cameoea_reader\<version number>
• <Cameo Enterprise Architecture installation directory>

Frequently Asked Questions