(Build ID: 173316)

Cameo Enterprise Architecture™ Reader edition is made for reading and previewing UPDM, SysML, BPMN, SoaML, TOGAF, Zachman Framework, 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.

* 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 7 or later compatible operating system, i.e., Windows XP/ Vista/ 7/ 8, 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:

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

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

First, obtain the Cameo Enterprise Architecture Reader installation files. You can download the latest version from the Cameo Enterprise Architecture Reader homepage http://www.nomagic.com/products/cameo-enterprise-architecture.html

If you are going to install Cameo Enterprise Architecture 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 Mac OS X, we recommend to run Cameo Enterprise Architecture 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_Enterprise_Architecture_Reader_<version number>_win.exe for 32-bit Windows
• Cameo_Enterprise_Architecture_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 Enterprise Architecture 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 "Memomy allocation" in MagicDraw UserManual.pdf.

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 on install files.

Mac OS X

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

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

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

3. Double-click the installer.
   

4. Drag the Cameo Enterprise Architecture Reader folder to the Applications/Cameo Enterprise Architecture Reader <version number> or some other folder.

Using no-install package

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

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

2. Extract the file.

3. Open the bin directory and run cameoea.exe to start Cameo Enterprise Architecture Reader.

Unix

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

2. Extract the file.

3. Open the bin directory and run cameoea to start Cameo Enterprise Architecture Reader.
   IMPORTANT! Be sure you have installed JVM.

Mac OS X

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

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

2. Extract the file.

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

Changing Java version

In the cameoea.properties file, 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>
• Common Application Data location (on Windows OS)
• Other directory

1. Open the cameoea.properties file, which is located in <Cameo Enterprise Architecture installation directory>\bin.
2. Change the parameter value from

   -DLOCALCONFIG=true

   to

   -DLOCALCONFIG=false

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

1. Open the cameoea.properties file, which is located in <Cameo Enterprise Architecture 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 the following:

1. Open the folder, wherein 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 Enterprise Architecture Reader configuration files will be saved, e.g., C:\<directory name>.

1. Open the cameoea.properties file, 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 cea.log file. If there is a need, you can redirect the output to the console.

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

On all operating systems

In the cameoea.properties file, 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 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 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 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 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.

Java Virtual Machine could not be started

Open the <Cameo Enterprise Architecture Reader installation directory>/bin/cameoea.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 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 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.

Sometimes Cameo Enterprise Architecture Reader becomes unpredictable

1. Open the <Configuration files directory>\.cameoea\<version number> and delete all cache folders. For more information about configuration files location, see section Changing the location for configuration files storage.
2. Restart Cameo Enterprise Architecture Reader.
   

cea.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.

If for some reasons Cameo Enterprise Architecture cannot be started, look for the cea.log file in configuration files directory. For more information about configuration files location, see section Changing the location for configuration files storage.

Frequently Asked Questions