Oracle Communications Design Studio

Installation Guide Release 3.1.1

E16802-01

April 2010

Oracle Communications Design Studio Installation Guide, Release 3.1.1 E16802-01 Copyright 2006, 2010, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065. This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Contents
Preface ................................................................................................................................................................. v 1 System Requirements 2 Design Studio and Eclipse Installation
Installing Eclipse ...................................................................................................................................... 2-1 eclipse.ini File Configuration ........................................................................................................... 2-2 Launching Eclipse .................................................................................................................................... 2-3 Configuring Proxy Settings in Eclipse ................................................................................................. 2-4 Installing Additional Required Features............................................................................................. 2-4 Obtaining Design Studio Software ...................................................................................................... 2-5 Creating the Design Studio Update Site.............................................................................................. 2-5 Installing the Update Site as a Shared Folder ................................................................................ 2-6 Installing the Update Site onto a Web Server or FTP server ....................................................... 2-6 Configuring the Update Site Feature Descriptor........................................................................... 2-7 Example: Configuring the Update Site Feature Descriptor.................................................. 2-7 Defining the Update Policy .............................................................................................................. 2-8 Installing Design Studio Features into Eclipse .................................................................................. 2-8 Adding a Design Studio Update Site .............................................................................................. 2-9 Completing the Installation .............................................................................................................. 2-9 Verifying the Installation ............................................................................................................... 2-10 Distributing the Design Studio Environment................................................................................. 2-11

3 Installing Design Studio Patches

Applying Patches via Upgrades to Existing Environments ............................................................. 3-1

iii

iv

Preface
The Design Studio Installation Guide contains the procedures and information you need to install Oracle Communications Design Studio. Some information is included on third-party software products used by Design Studio, but this guide is limited to information needed for installation and maintenance of Design Studio. If you need additional information on a third-party software application, consult the documentation provided by the product's manufacturer. This guide contains the following sections:

Chapter 1: System Requirements lists the hardware and software required to install and run Design Studio. Chapter 2: Design Studio and Eclipse Installation describes how to install the Eclipse platform and how to install Design Studio into Eclipse. Chapter 3: Installing a Patch for Design Studio describes how to prepare to install a Design Studio patch.

Audience
This guide is intended for installation administrators who have a working knowledge of Windows. Installation administrators preconfigure the initial Design Studio features, install updates to the Design Studio configuration, and provide the individual users within an organization a preconfigured environment for quick installation. Preconfigured environments simplify installation for users, reduce download times, and ensure correct installation.

vi

1
1

System Requirements

To successfully install and run Design Studio, you need to have the following hardware and software:
Note:

Application performance is directly related to processor performance and memory. For larger projects, consider increasing the processor power, and the initial memory and maximum memory settings for the Java heap size.

Minimum Hardware Requirements CPU: Recommended Intel dual core (or equivalent) Memory: Recommended 2048MB or above Screen Resolution: Recommended 1024x768 or above Operating System Requirements Windows XP Platform Eclipse 3.4.2 (Ganymede SR2) JDK Version Java 6 Runtime Environment (update 16 or later) and Java 6 Developer Kit

Note:

When working with Design Studio for Unified Inventory Management plug-in cartridges, you run Eclipse Ganymede using JDK 1.6, but build cartridges using JDK 1.5. See Unified Inventory Management Version 7.1.1 Release Notes for more information.

System Requirements 1-1

1-2 Oracle Communications Design Studio Installation Guide

2
2

Design Studio and Eclipse Installation

This chapter describes how to install Design Studio and the Eclipse platform on your computer. Installation is described in the following topics:

"Installing Eclipse" "Launching Eclipse" "Configuring Proxy Settings in Eclipse" "Installing Additional Required Features" "Obtaining Design Studio Software" "Creating the Design Studio Update Site" "Installing Design Studio Features into Eclipse" "Distributing the Design Studio Environment"
Note:

The following setup instructions are intended for installation administrators. Design Studio users should contact the installation administrator for instructions on obtaining and installing a preconfigured zip file or archive.

Installing Eclipse
Design Studio runs on the Eclipse Ganymede 3.4.2 platform. Before you install the Design Studio plug-ins, you must download and install Eclipse. To install Eclipse, you must install Java 6 Runtime Environment (update 16 or later, Java 6 Developer Kit). The following steps describe how to obtain and install Eclipse and the Java 6 Runtime Environment. To download and install Eclipse Ganymede 3.4.2
1.

Navigate to: http://wiki.eclipse.org/Older_Versions_Of_Eclipse

Note:

Site layout, content, and procedures are subject to change based on updates by Eclipse.org administrators.

2. 3.

Click the Eclipse Ganymede SR2 Packages link. Click the Eclipse IDE for Java EE Developers link. The Eclipse downloads - mirror selection page appears.
Design Studio and Eclipse Installation 2-1

Installing Eclipse

4.

Click a mirror site located close to your location. The File Download dialog appears.

5.

Click Save. Select the location to save the eclipse-jee-ganymede-SR2-win32.zip file.

6. 7.

After you specify the install location, click Save again to begin the download process. When the download completes, unzip the file and create a shortcut on your desktop to the eclipse.exe file. For example, you might unzip the file in a new folder that you create under Program Files called Oracle Studio.

8.

Right-click the shortcut to eclipse.exe and select Properties. The Properties dialog box appears.

9.

Append the following property to value in the Target field: -vmargs -Dsun.lang.ClassLoader.allowArraySyntax=true For example: C:\ganymede\eclipse.exe -vmargs -Dsun.lang.ClassLoader.allowArraySyntax=true

10. Copy the JRE 1.6 folder (for example, jre1.6.0_16) into the Eclipse folder at the

same location as the eclipse.exe file. You can obtain Java 6 Runtime Environment from the Sun Microsystems web site at: http://java.sun.com/javase/downloads/widget/jdk6.jsp. If you have previously installed Java 6, the JRE 1.6 folder typically resides in Program Files/Java folder.
Note:

If Eclipse does not locate the JRE folder in the Eclipse home directory, it attempts to find the JRE using the JAVA_HOME windows environment variable. Design Studio supports only Java 6 Developer Kit and Java 6 Runtime Environment (update 16 or later).

11. Rename the JRE 1.6 folder name to jre. 12. Add additional command lines to the eclipse.ini file located in the Eclipse folder.

For example, Design Studio can experience memory issues if the MaxPermSize jvm flag has not been set. See "eclipse.ini File Configuration" for more information. For more information about jvm flags, refer to the Eclipse Launcher topic in the Eclipse Platform Plug-in Developer Guide. For more information about the eclipse.ini file, see: http://wiki.eclipse.org/Eclipse.ini

eclipse.ini File Configuration

You can control Eclipse startup by configuring command line options in the eclipse.ini file, located in your Eclipse root directory. In the following example, the eclipse.ini file settings are configured for a machine with at least 2Gb of memory (the jar entry may vary, per installation):
-showsplash 2-2 Oracle Communications Design Studio Installation Guide

Launching Eclipse

org.eclipse.platform --launcher.XXMaxPermSize=140M -Dosgi.requiredJavaVersion=1.6 -framework plugins\org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar -vmargs -XX:NewRatio=5 -XX:+UseAdaptiveSizePolicy -XX:+UseParallelGC -XX:MaxPermSize=140M -Xms256m -Xmx1300m

Note:

If you are working on a machine with 1024MB of memory, define the Xmx option as -Xmx512M. In this scenario, you will be limited to the size of cartridges that you can develop in Design Studio.

Launching Eclipse
To verify that Eclipse installed, launch the program. To launch Eclipse
1.

Double-click the Eclipse shortcut that you created in the previous section. Alternatively, double-click the eclipse.exe file. The Workspace Launcher dialog appears.

2.

Specify a workspace. In the Workspace Launcher dialog box, installation administrators can select a temporary folder or accept the default location. However, Design Studio users should identify the appropriate working directory on their local machine. To help Design Studio users identify in which directory configuration information should be stored on their computer, installation administrators can specify in the Workspace Launcher dialog box a location where most users will want to place their configuration files. The directory and folder structure that the installation administrator specifies in this step will become the default value for the Workspace field in the Workspace Launcher.
Note: Installation administrators should not select the Use this as the default check box on the Workspace Launcher dialog box. However, administrators can instruct Design Studio users to select this check box to enable them to use their specified directory as the default workspace.

3.

Click OK. The Welcome screen appears.

4. 5.

Select Help, then About Eclipse Platform. Verify that you have installed the correct version of Eclipse. Ensure that the Eclipse Platform version indicated in the dialog is 3.4.2. Versions later than 3.4.2 may be compatible, but are not certified.

Design Studio and Eclipse Installation 2-3

Configuring Proxy Settings in Eclipse

Configuring Proxy Settings in Eclipse

If you are using a proxy server, you must configure the proxy in Eclipse. To configure the proxy server in Eclipse
1. 2.

If you know the proxy address and port of the intranet proxy, skip to step 4. If the proxy is statically configured, obtain the proxy address and port from your Internet browser LAN Connection settings. In Internet Explorer:
a. b.

Click Tools, then Internet Options, then Connections. Click the LAN Settings button, and obtain the values in the Proxy Server Address and Port fields

In Firefox:
a. b.

Click Tools, then Options, then Advanced, then Network. Click the Settings button, and obtain the values in the HTTP Proxy and Port fields.
Note:

If you are not able to access the Internet browser settings, contact your network administrator for more information.

3.

If the proxy is not statically configured, acquire the settings from the automatic configuration script. If the proxy is not statically configured, no specific proxy address and port number entries are defined in the connection settings. You can open the .dat file in a text editor to obtain the proxy address and port number. To locate the .dat file in Internet Explorer, use the Address value under the Use automatic configuration script check box. In Firefox, use the Automatic proxy configuration URL.

4. 5. 6. 7. 8.

To configure the proxy in Eclipse, navigate to Window, then Preferences, then General. Expand the General menu and select Network Connections. Select the Manual proxy configuration option. Enter the HTTP proxy and port. Click OK.

Installing Additional Required Features

Design Studio requires additional Eclipse features to be installed. To install additional required features
1. 2.

Launch Eclipse. Navigate to Help, then Software Updates. The Software Updates and Add-ons dialog box appears.

3. 4.

Click the Available Software tab. Expand the Ganymede Update Site folder.

2-4 Oracle Communications Design Studio Installation Guide

Creating the Design Studio Update Site

In the Ganymede Update Site folder, you will require features from two different subfolders: Models and Model Development and Graphical Editors and Frameworks.
5.

Expand the Models and Model Development subfolder and select the following features:

EMF SDK - Eclipse Modeling Framework SDK EMF SDO SDK - Service Data Objects SDK XSD SDK - XML Schema Definition SDK

6.

Expand the Graphical Editors and Frameworks subfolder and select the following feature:

Graphical Editing Framework Zest Visualization Toolkit

7.

Click Install. The Install dialog box appears, listing the features you selected for install.

8. 9.

Click Finish. When prompted, click Yes to restart Eclipse.

Obtaining Design Studio Software

To download the software from the Oracle E-Delivery web site
1.

Navigate to the Oracle E-Delivery web site: http://edelivery.oracle.com/

2. 3.

Select the applicable product media pack for your platform from the Oracle E-Delivery web site. Download the Design Studio software and documentation. The Design Studio software and documentation zip file contains the .tar files that you need to install Design Studio.

Creating the Design Studio Update Site

Note:

The instructions in this section assume that you have downloaded the software from Oracle E-Delivery.

The system administrator must first create a Design Studio update site to enable users to install or upgrade to the current Design Studio release. A Design Studio update site defines the repository where Design Studio users obtain Design Studio components for installation into the Eclipse platform. The files contained in the Design Studio-related software include the update site structure and the related Design Studio features. There are a number of ways to make the update site available to Design Studio users:

Provide access to the uncompressed contents via a web server or FTP server. Install the uncompressed contents as a shared folder. Provide a copy to each user (not recommended).

Design Studio and Eclipse Installation 2-5

Creating the Design Studio Update Site

Oracle recommends that the system administrator provide network access to a common uncompressed version. This approach is recommended for the following reasons:

It simplifies distribution of Design Studio components and upgrades. It enables access control. It reduces resource usage.

Your environment and IT policies will dictate whether you should employ a web access or shared folder solution.
Note: Some Design Studio features have dependencies to other Design Studio features. Failing to include the required Design Studio features may prevent users from installing dependent features. The Design Studio Platform feature is required by all other Design Studio features and must always be present on the update site. Refer to the product documentation for details on feature dependencies.

To create an update site, the system administrator performs the following steps:
1. 2. 3.

Install the update site as a shared folder or onto a web server. Configure the update site feature descriptor. Define the update policy.

Installing the Update Site as a Shared Folder

To install the update site as a shared folder
1.

Uncompress each Design Studio .tar file to the target location. If you are extracting multiple .tar files, you can overwrite the files that are common.

2. 3.

Share the target folder. Update file and folder sharing permissions to Readable for the required user community.
Note:

Design Studio users will require the path to the shared folder (for example: \\myserver\StudioUpdateSite) for use during setup.

Installing the Update Site onto a Web Server or FTP server

To install the update site onto a web server
1. 2. 3.

Access the server and uncompress each Design Studio .tar file to a target location on the server. Configure the target location in the web server to allow access to the files. Configure access privileges on the server to allow access by the Design Studio user community.
Note:

Design Studio users will require the URL to the target (for example: http://myserver:8080/StudioUpdateSite) for use during setup.

2-6 Oracle Communications Design Studio Installation Guide

Creating the Design Studio Update Site

Configuring the Update Site Feature Descriptor

To configure the update site feature descriptor
1.

Edit the site.xml file to remove feature entries that are not included in the update site. The site.xml file is included in the .tar file that you obtain from eDelivery. When you extract the .tar file, open the update folder to locate the site.xml file.
Note:

The Platform feature entries are required regardless of the product. For information about the .jar files included in your .tar file, including information about each feature and its dependencies, see the product-specific Installation guide.

2.

Update the URL entries to match the corresponding .jar file name in the features folder of the update site. To update a URL entry, replace the .jar name in the URL attribute with the exact name in the features folder. The actual file entries include a version and build qualifier. For example: url="features/oracle.communications.sce.osm.feature_ 3.1.0.v200907310211-b767.jar"

3.

Update the version entry to match the version and build qualifier. To update version entry, replace the Version attribute with the full version, including the qualifier. For example: version="3.1.0.v200907310211-b76"

4. 5. 6.

Remove feature entries for features not present in the features folder of the update site. Update the description of the update site to reflect the purpose and nature of the site. Save the changes.

Example: Configuring the Update Site Feature Descriptor

The following example includes the Platform feature and the Order and Service Management (referred to in the example as provisioning) features. Prior to editing site.xml, it may resemble the following:
<?xml version="1.0" encoding="UTF-8"?> <site> <description url="ftp://srvtorvobs/pub/Studio/update"> Oracle Communications Design Studio internal update site. </description> <feature url="features/oracle.communications.sce.core.feature_3.1.1.qualifier.jar" id="oracle.communications.sce.core.feature" version="3.1.1.qualifier"> <category name="Oracle Communications Design Studio"/> </feature> <feature url="features/oracle.communications.sce.osm.feature_3.1.1.qualifier.jar" id="oracle.communications.sce.osm.feature" version="3.1.1.qualifier"> <category name="Oracle Communications Design Studio"/> </feature> <category-def name="Oracle Communications Design Studio" label="Oracle Communications Design Studio Modules"/> </site>

Design Studio and Eclipse Installation 2-7

Installing Design Studio Features into Eclipse

To properly configure the update site feature descriptor, you would edit this example site.xml in the following manner. This will enable you to install the AIA and Examples related plug-ins:
<?xml version="1.0" encoding="UTF-8"?> <site> <description url="ftp://srvtorvobs/pub/Studio/update"> Oracle Communications Design Studio internal update site. </description> <feature url="features/oracle.communications.sce.core.feature_ 3.1.1.v200803181510-b54.jar" id="oracle.communications.sce.core.feature" version="3.1.1.v200803181510-b54"> <category name="Oracle Communications Design Studio"/> </feature> <feature url="features/oracle.communications.sce.osm.feature_ 3.1.1.v200803181607-b241.jar" id="oracle.communications.sce.osm.feature" version="3.1.0.v200803181607-b241"> <category name="Oracle Communications Design Studio"/> </feature> <feature url="features/oracle.communications.sce.osm.orchestration.aia.feature_ 3.1.1.v2 00912151454-b1226.jar" id="oracle.communications.sce.osm.orchestration.aia.feature" version="3.1.1.v200912151454-b1226"> <category name="Oracle Communications Design Studio"/> </feature> <feature url="features/oracle.communications.sce.osm.examples.feature_ 3.1.1.v2009121514 54-b1226.jar" id="oracle.communications.sce.osm.examples.feature" version="3.1.1.v200912151454-b1226"> <category name="Oracle Communications Design Studio"/> </feature> <category-def name="Oracle Communications Design Studio" label="Oracle Communications Design Studio Modules"/> </site>

Defining the Update Policy

You must update the URL property within the UpdatePolicy.xml file to point to your newly created update site. You must edit the plugin_customization.ini file (found in the primary product feature) to define the default value of the updatePolicyURL property as follows: org.eclipse.update.core/updatePolicyURL = <URL value> where <URL value> is the location of your update site.

Installing Design Studio Features into Eclipse

Note:

The instructions in this section assume that you have successfully installed Eclipse and the Eclipse installation does not include a previous version of Design Studio.

To install Design Studio features into Eclipse

1.

Launch Eclipse.

2-8 Oracle Communications Design Studio Installation Guide

Installing Design Studio Features into Eclipse

2.

Select Help, then Software Updates. The Software Updates and Add-on dialog box appears.

3. 4.

Click Available Software. Configure the Design Studio update site.

Note: Installation administrators can configure Eclipse to get the latest updates for Design Studio from a shared folder (local configuration) or from a web server on your company's intranet (remote configuration). The choice depends on the physical location of the update site, which is set up by the installation administrator.

If you have already defined a local or remote site, proceed now to the "Completing the Installation"procedure. If you have not yet defined a local or remote site for Design Studio, you need to do this now to enable installation of Design Studio into Eclipse and to enable subsequent Design Studio updates. Proceed to "Adding a Design Studio Update Site" section, then continue to the Completing the Installation procedure.

Adding a Design Studio Update Site

To define a local Design Studio update site
1.

Select Help, then Software Updates. The Software Updates and Add-on dialog box appears.

2. 3.

Click Available Software. Click Add Site. The Add Site dialog box appears.

4.

Click the Local... button. The Browse for Folder dialog box appears.

5. 6.

Navigate to and select the folder location for the local update site. Click OK. The added update site now appears in the window of the Software Updates and Add-ons dialog box.

7.

Click Close.

Completing the Installation

After you add the Design Studio update site, you can complete the Design Studio installation. To complete the Design Studio installation
1.

In the Software Updates and Add-ons dialog box, click the Available Software tab. Expand your Design Studio update site option.

2.

Select the Design Studio update site option to select all available Design Studio features, or select specific features within the Design Studio suite.
Design Studio and Eclipse Installation 2-9

Installing Design Studio Features into Eclipse

Note:

The list of available features is dependent on the Design Studio .tar files installed on the Design Studio update site. Plug-ins may have dependencies on other plug-ins. Refer to the product-specific installation guides for information plug-in dependencies.

3.

Click Install. The Install dialog box appears and displays the components to be installed.

4.

Click Finish. The Update Manager downloads the Eclipse and Design Studio components. The download time will vary based on network and server variants.
Note:

If the system displays an error after you click Finish indicating that the Design Studio Platform requires the plug-in org.eclipse.draw2d, perform the steps in the "Installing Additional Required Features" and at Step 6, select the GEF (Graphical Editing Framework) packages.

5. 6. 7. 8.

When prompted, click Yes to restart Eclipse. To verify that Design Studio installed properly, ensure that the Studio menu option appears in the Eclipse main menu bar. Close Eclipse. Configure Design Studio as the primary application. When you make the following changes to the config.ini file, you change the product branding from Eclipse to Oracle Design Studio. Additionally, performing this step ensures that Design Studio users cannot uninstall the Design Studio Platform feature. Perform the following changes to the eclipse\configuration\config.ini file: Default Splash Path entry: osgi.splashPath = platform:/base/plugins/org.eclipse.platform Change to: osgi.splashPath = platform:/base/plugins/com.mslv.studio.branding Default product entry: eclipse.product=org.eclipse.platform.ide Change to: eclipse.product=com.mslv.studio.branding.Studio

Verifying the Installation

After installing the Eclipse platform and Design Studio, you can verify that the features were installed properly. To verify the installation
1.

In Design Studio, select Help, then About Eclipse SDK.

2-10 Oracle Communications Design Studio Installation Guide

Distributing the Design Studio Environment

The About Eclipse SDK dialog box appears.

2.

In the About Eclipse SDK dialog box, click Feature Details. The About Eclipse SDK Features dialog box appears, listing all of the features currently installed.

3.

Verify that the Oracle features you installed are included in the feature list.

Distributing the Design Studio Environment

Installation administrators should provide the Design Studio users with a preconfigured environment for quick installation. Preconfigured environments simplify installation for users, reduce download times, and ensure correct installation.
Note:

Preconfigure the environment after you have created the Design Studio update site and installed Eclipse and Design Studio features.

To pre-configure an environment for your users

1.

ZIP the Eclipse folder and all subdirectories. At this stage of the installation, the Eclipse folder contains a properly configured Eclipse platform, the update site, and the Design Studio plug-ins, all ready for distribution.

2.

Provide access to the ZIP file via web access or shared folder. It may be convenient to use the same share or web server of the Design Studio update site.

3.

Instruct users to download and extract the ZIP file.

Design Studio and Eclipse Installation 2-11

Distributing the Design Studio Environment

2-12 Oracle Communications Design Studio Installation Guide

3
3

Installing Design Studio Patches

The following procedures describe how to prepare to install a patch of Oracle Communications Design Studio.
Note:

To apply patches by performing an installation to a new environment, refer to the Design Studio and Eclipse Installation section for information about how to install Design Studio software.

Applying Patches via Upgrades to Existing Environments

To apply a patch by performing an upgrade to an existing environment, you must remove from your environment any existing plug-in features affected by the patch, then reinstall the new feature versions.
Note:

When updating features with a patch, Design Studio does not delete existing configuration metadata from your workspaces.

Removing Existing Feature Versions To remove existing feature versions from your environment
1. 2.

Launch Eclipse. Select Help, then Software Updates. The Software Updates and Add-ons dialog box appears.

3. 4.

Click the Installed Software tab. If you are applying a patch that affects a single Design Studio feature only:
a. b. c. d.

Right-click the feature affected by the patch and select Uninstall. When prompted, confirm that you want to uninstall this feature. Click Yes when prompted to restart Eclipse. Skip the remaining steps in this procedure and refer to the "Design Studio and Eclipse Installation" chapter for information about how to install Design Studio software.

Installing Design Studio Patches

3-1

Applying Patches via Upgrades to Existing Environments

Note:

The Design Studio Platform feature contains platform features on which all other Design Studio plug-ins depend. If you are applying a patch that affects the Design Studio Platform feature, you must remove all other Design Studio features first. In this case, proceed to step 5.

5.

If you are applying a patch that affects multiple Design Studio features, highlight all of the features affected by the patch and click Uninstall. The Uninstall dialog box appears, listing the features you selected for uninstall.
Note: If the patch affects the Design Studio Platform feature, ensure that you remove all dependent Design Studio features before or in conjunction with the Design Studio Platform feature. Additionally, you may have other dependencies among your features. Design Studio displays a configuration error if you attempt to remove a plug-in on which other features depend. Review the Design Studio error details to determine the feature dependencies.

6. 7.

Click Finish. After you remove all features affected by the patch, click Yes when prompted to restart Eclipse. After Eclipse restarts, you are ready to install the new feature versions to your environment.

Installing New Feature Versions To install new feature versions to your environment, refer to the "Design Studio and Eclipse Installation" chapter for information about how to install Design Studio software.

3-2 Oracle Communications Design Studio Installation Guide