Home
 

User login

 
 

Navigation

 
 

Events

« May 2008
SunMonTueWedThuFriSat
123
45678910
11121314151617
18192021222324
25262728293031
 
Home

Cape Clear Studio 7.0.1 Installation Guide (Windows)

Submitted by admin on Fri, 2007-05-04 14:14.

Cape Clear Studio 7.0.1 System Requirements

Operating System - Cape Clear Studio runs on Microsoft Windows 2003 (Service Pack 1) and Microsoft Windows XP (Service Pack 2) only. The following specifications are also recommended:

  • Approximately 1GB of disk space for a full Studio installation

  • 2GB of RAM is required to run both Studio and Server locally

  • A display resolution of at least 1024 x 768

Eclipse - Cape Clear Studio will only run within Eclipse 3.2 with WTP 1.5.3 installed. See “Cape Clear and the Eclipse Environment” for details on the Eclipse Platform and Cape Clear Studio. If you wish to install Cape Clear Studio into your existing Eclipse installation then it must meet these requirements. Alternatively, you can simply install Cape Clear Studio from a standalone setup executable which contains a full Eclipse and WTP installation.

JDK 5.0_11 or JDK 1.4.2_13 - Before installing and using Cape Clear Studio, you must have either Sun Microsystems' Java 2 Platform, Standard Edition (J2SE) version 1.4.2_13 (1.4.2 Update 13) or version 5.0_11 (5.0 Update 11) installed on your computer. You can download J2SE v1.4.2 or J2SE v5.0 installers from the Sun Microsystems Web site. J2SE v5.0 is the preferred execution environment for Cape Clear Studio.

Note that Cape Clear Studio 7.0.1 has not yet been tested conclusively with JDK 6.0 (or the embedded JRE6).

It is worth noting that Cape Clear Studio will also run within a Java Runtime Environemnt (JRE). All core areas of Studio functionality (i.e. creating, deploying and testing web service projects) will run within a JRE alone. However, optional features such as generating JavaDoc will necessiate the use of a JDK.

Web Browser - The Cape Clear Manager and Cape Clear Orchestration Manager web applications are supported in the following Internet browsers:

  • Microsoft Internet Explorer 6.0 or later

  • Netscape 6.0 or later

  • Mozilla Firefox 1.0 or later

Cape Clear Studio Installation Options

Cape Clear Studio may be installed using one of the following methods:

Installing Cape Clear Studio using the Setup Executable

The Cape Clear Studio design environment runs inside the Eclipse IDE and must be downloaded separately from Cape Clear Server (for information on downloading Cape Clear Server, see “Downloading Cape Clear Server ”).


Procedure 1. Download the Cape Clear Studio Setup Executable

  1. Navigate to the http://www.capeclear.com/download/ section of the Cape Clear website and register in order to access the download file.

  2. Download the Cape Clear Studio 7.0.1 Install file 7.<x.patch-number.build-number>-studio.exe file. To copy the file to your computer, click Saveor Save this program to disk.


Procedure 2. To launch the Cape Clear Studio Installer

  1. Once downloaded locally onto your machine, double-click on the 7.<x.patch-number.build-number>-studio.exe file to launch the installation. The following screen will be displayed:


    The initial Cape Clear Studio installation screen.

    Figure 1. The initial Cape Clear Studio installation screen.

    Click on Next > to continue.

  2. Read and accept the Cape Clear Studio licence agreement. Click I Agree to continue with the installation.


    The Cape Clear Studio license agreement.

    Figure 2. The Cape Clear Studio license agreement.

  3. The installer will attempt to automatically locate a suitable JDK directory on your system. If the JDK selected is not suitable, then use the browse ... button to manually locate a directory yourself.


    Selecting the JDK to use.

    Figure 3. Selecting the JDK to use.

    Click on Next > to continue.

  4. The installer will display the JDK details before continuing. Click on Next > to continue.


    JDK details.

    Figure 4. JDK details.

  5. The next step is to choose an installation directory for the Cape Clear Studio. The default location suggested by the installer will be C:\CapeClear\Studio. If you wish to select an alternative directory, use the Browse... to manually locate it.


    Choosing an installation directory for Cape Clear Studio.

    Figure 5. Choosing an installation directory for Cape Clear Studio.

    Once you've specified the installation directory, click on Next > to continue.

  6. Next, the installer will prompt you to create Windows desktop short-cuts for Cape Clear Studio. Leave the default name suggested or edit it to suit your requirements. Click on Install to begin copying the installation files to their destination directory.


    Specifying short-cut details.

    Figure 6. Specifying short-cut details.

  7. The installer will begin copying the Cape Clear Studio installation files to their destination.


    The installer begins copying the installation files.

    Figure 7. The installer begins copying the installation files.

  8. Once the Cape Clear Studio files have been copied to their destination, the installation will be complete. Click on Finish to end the installation.


    Completing the Cape Clear Studio installation.

    Figure 8. Completing the Cape Clear Studio installation.

  9. The Cape Clear Studio is now complete. The next step is to launch Cape Clear Studio.

Procedure 3. To launch Cape Clear Studio

  1. Launch Cape Clear Studio from the newly created Windows start menu. This is accessed using Start ->All Programs -> Cape Clear 7 -> Studio. You can also start Cape Clear Studio by directly executing the studio.exe from its installation directory.

  2. Eclipse will launch and prompt you to specify a workspace into which it will save any projects you create.


    Specifying the location of the Eclipse workspace.

    Figure 9. Specifying the location of the Eclipse workspace.

  3. Eclipse will then load the Cape Clear Studio plugin and display the initial Welcome screen:


    Cape Clear Studio running within Eclipse.

    Figure 10. Cape Clear Studio running within Eclipse.

Installing Cape Clear Studio from Cape Clear's Update Site

If you prefer to install the Cape Clear Studio plugins into your own version of Eclipse then it is recommended you use Eclipse's Update Manager to connect to Cape Clear's Update Site to download and install the plugin. Before attempting to install Cape Clear Studio into your existing Eclipse platform, ensure that the WTP 1.5.2 plug-in is already installed (see “Eclipse Requirements” ). Note too that if your Eclipse is running on JDK 1.4 a newer version of the Xerces parser (version 2.8.2) needs to be installed (see “JDK 1.4 Requirements” ).

Procedure 5. To install the Cape Clear Studio using Eclipse's Update Manager

  1. Start your Eclipse Platform and select Help > Software Updates > Find and Install...


    Launching the update manager.

    Figure 11. Launching the update manager.

  2. Since Cape Clear Studio is not a standard Eclipse SDK component you need to enable the Search for new features to install radio button and click on Next > to continue.


    Search for new features to install.

    Figure 12. Search for new features to install.

  3. By default, Eclipse is only be aware of the main Eclipse Foundation web site as a source of new Eclipse features. Therefore, click New Remote Site... to specify the location of the Cape Clear Studio plug-in. Specify the location details of the Cape Clear Update Site as follows:

    • Name: Cape Clear Software Eclipse Update Site

    • URL: http://developer.capeclear.com/eclipse/updates

  4. Select all the features within the Cape Clear Studio Updates package:


    Selecting the available features to install.

    Figure 13. Selecting the available features to install.

    If your Eclipse installation is compatible (correct version of Eclipse, WTP, and Studio features), the Finish button will be enabled. Click Finish to continue.

  5. Read and accept any license conditions that may be required.

  6. The update manager will display a list of the updates it will install. Click on Install to begin downloading and installing the updates.


    Installing the updates.

    Figure 14. Installing the updates.

  7. It may take the update manager some time to download Cape Clear Studio depending on the size and the speed of your connection. For example, a full Cape Clear Studio update file is approximately 55 MB. Now would be a good time for that cup of coffee...

  8. Once the Cape Clear Studio plugins have been downloaded and installed, Eclipse will prompt you to either apply the changes immediately or restart Eclipse in order to apply them (this is recommended).

  9. Finally, ensure that the eclipse.ini file located in the Eclipse installation directory contains the following arguments used to set JVM memory allocation and heap size: 

    -vmargs
    -Xms256m
    -Xmx512m
    -XX:MaxPermSize=256m

    Two template files studio-JDK-1-5.ini and studio-JDK-1-5.ini are provided in the Cape Clear Studio installation directory and provide examples of the default arguments that should be used (depending on the JDK). See http://help.eclipse.org/help32/topic/org.eclipse.platform.doc.isv/reference/misc/runtime-options.html for details on Eclipse launcher options. See http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/java.html for more details on JVM options.


© 2007, Cape Clear Software Inc