Zeligsoft CX for CBDDS

Size: px

Start display at page:

Download "Zeligsoft CX for CBDDS"

Susan Johns
5 years ago
Views:

1 Zeligsoft CX for CBDDS

2 Copyright Notice 2012 PrismTech Limited. All rights reserved. This document may be reproduced in whole but not in part. The information contained in this document is subject to change without notice and is made available in good faith without liability on the part of PrismTech Limited or PrismTech Corporation. All trademarks acknowledged. Zeligsoft CX for CBDDS: Installation Guide 2

3 Table of Contents Chapter 1 Preface...4 About the Guide...4 Conventions...4 Contacts...5 Chapter 2 Introduction...6 About Zeligsoft CX for CBDDS...6 Chapter 3 Installation Pre-requisites Obtaining RSA 8.0.x RSA8 Installation Procedure Obtaining the CX4CBDDS plugin Installing the CX4CBDDS plugin Product documentation Product Licensing Importing the RSA license Importing the CX4CBDDS License...19 Zeligsoft CX for CBDDS: Installation Guide 3

4 1 Preface About the Guide The Guide provides instructions and information needed to install Zeligsoft CX for CBDDS (also referred to as CX4CBDDS). Conventions The conventions listed below are intended to assist the reader in using the Guide. Item of special significance or where caution needs to be taken. i WIN UNIX Item contains helpful hint or special information. Information applies to Windows (e.g. XP, 2003, Windows 7) only. Information applies to Unix-based systems (e.g. Solaris) only. Hypertext links are shown as blue italic underlined. On-Line (PDF) versions of this document: Items shown as cross references to other parts of the document, e.g. see Contacts, behave as hypertext links: jump to that section of the document by clicking on the cross reference. % Commands or input which the user enters on the command line of their computer terminal Courier, Courier Bold, or Courier Italic fonts indicate programming code. These fonts can also indicate terminal commands, file names, and variable names and values. Zeligsoft CX for CBDDS: Installation Guide 4

5 Italics and Italic Bold indicate new terms, or emphasise an item. Sans-serif and sans-serifbold indicate GUI or IDE elements and commands, such as File > Save. Step 1: One of several steps required to complete a task. Contacts PrismTech can be contacted at the following contact points for information and technical support: USA Corporate Headquarters PrismTech Corporation 400 TradeCenter Suite 5900 Woburn, MA USA European Head Office PrismTech Limited PrismTech House 5th Avenue Business Park Gateshead NE11 0NG UK Tel: Tel: +44 (0) Users of the on-line version of this manual can click the links below to launch their web browser or client to send directly. CX4CBDDS Support: CX4CBDDS Web: cbdds-support@prismtech.com Web: Technical questions:crc@prismtech.com (Customer Response Center) Sales enquiries: sales@prismtech.com Zeligsoft CX for CBDDS: Installation Guide 5

6 2 Introduction About Zeligsoft CX for CBDDS Zeligsoft CX for CBDDS (CX4CBDDS) is a plugin to IBM Rational Software Architect (RSA8), which must be installed first. The following instructions guide you through installation of RSA8 and the CX4CBDDS plugin, and applying both the RSA8 and CX4CBDDS licenses. Zeligsoft CX for CBDDS: Installation Guide 6

7 3 Installation 3.1 Pre-requisites Zeligsoft CX for CBDDS (CX4CBDDS) is a plugin to IBM Rational Software Architect (RSA8), which must be installed first. Note: Installation and updating should be performed from an account with root/admin privileges. On Linux systems you may need to increase the number of file handles. The default is usually 1024 and this should be increased to 4096, by using the ulimit command. See man ulimit for details on increasing the number of files. On Linux, if you want the product to be used by users other than root, then set the umask variable to 0022 before you install the product. To set this variable, log in as root user, start a terminal session, and type umask Obtaining RSA 8.0.x If you do not have RSA8 installed or your organization does not have an installation site, then the simplest method is to use the IBM developerworks download: This site will guide you through the procedure for downloading and installing RSA8 and will provide you with a 30-day evaluation license (if needed). Note: If you are not able to use the IBM developerworks facility, then please contact PrismTech support and they will make alternate arrangements. 3.3 RSA8 Installation Procedure Step 1: If you are installing from electronic disks downloaded from IBM Passport Advantage, open a command line and change to the directory where you extracted the disk images, and then do one of the following: Zeligsoft CX for CBDDS: Installation Guide 7

$Step 2: Step 3: Step 4: WIN Run RSA_SETUP\InstallerImage_win32\install.$

8 Step 2: Step 3: Step 4: WIN Run RSA_SETUP\InstallerImage_win32\install.exe UNIX Run RSA_SETUP/InstallerImage_linux/install Install the IBM Installation Manager if it is not already installed on your system. Follow the prompts and accept the license agreement to install the IBM Installation Manager. Click Restart Installation Manager. From the IBM Installation Manager, click Install. Select IBM Rational Software Architect and click Next. Note: During the installation you may be prompted to browse to a specific installation disk. Browse to the each requested disk each time you are prompted to do so. Step 5: Step 6: Step 7: Click Next twice. Accept the license agreement. Click Next. Zeligsoft CX for CBDDS: Installation Guide 8

9 Step 8: On this screen you can either select a different directory for the shared resource or keep the default. Step 9: Step 10: Step 11: Click Next. On the next screen you can either select a different directory to install into or keep the default. Click Next. Zeligsoft CX for CBDDS: Installation Guide 9

10 Step 12: On this screen you can choose to install into an existing Eclipse installation. Zeligsoft CX for CBDDS: Installation Guide 10

11 Step 13: Click Next twice. Step 14: Select Architect - Minimal under IBM Rational Software Architect > Installation Profiles Step 15: Select Extensibility and patterns-based engineering. Zeligsoft CX for CBDDS: Installation Guide 11

12 Step 16: Step 17: Click Next. If you need to select any other software to install, select it at this time. Note: You cannot install XSD Graphical Editing and Transformations, as it is incompatible with the CX4CBDDS plugin. If you need to install this functionality, contact PrismTech support. Step 18: Step 19: Step 20: Step 21: Select Access help from the Web. Click Next. Click Install. Click Finish. Once the installation has completed, RSA8 should start. The installation will provide a 30 day trial license, so you can click ignore on the licensing message that pops up. If you have a permanent RSA8 license, you can also install it at this time by clicking Manage Licenses on the dialog that is presented. If the installation manager is still running, you will need to exit it as clicking Manage Licenses will try to start another instance of it and will fail. Alternatively, you can apply the permanent RSA8 license from the Installation Manager, by selecting Manage Licenses. 3.4 Obtaining the CX4CBDDS plugin Downloading the CX4CBDDS plugin, documentation and licenses. Step 1: Step 2: Log in to the customer portal which may be accessed at Select the Contracts & Product Downloads tab. This will display all the Contracts that you own. Zeligsoft CX for CBDDS: Installation Guide 12

13 Step 3: Select your Zeligsoft CX contract. This will display the List of Assets you own under this contract. Zeligsoft CX for CBDDS: Installation Guide 13

14 Step 4: Select the Assets you wish to download. This will display details of this Asset and a list of versions available for download. Zeligsoft CX for CBDDS: Installation Guide 14

15 Step 5: Click on the HTTP Download link for the Version you wish to download. This will initiate the download. 3.5 Installing the CX4CBDDS plugin Step 1: Make sure you started RSA from a root/admin account. Step 2: From the menu bar, choose Help > Install New Software. Step 3: Click Add. Zeligsoft CX for CBDDS: Installation Guide 15

16 Step 4: Step 5: Step 6: Click Archive and browse to the CX4CBDDS update site archive download. Click OK. Click Select All. Zeligsoft CX for CBDDS: Installation Guide 16

17 Step 7: Step 8: Click Next. You will be presented with the following Security Warning: Step 9: Step 10: Click OK. Restart RSA8. Zeligsoft CX for CBDDS: Installation Guide 17

18 3.6 Product documentation CX4CBDDS help is available in both WebHelp and FlashHelp formats. If you want to access the CX4CBDDS documentation using Eclipse help, it is provided as a separate installation. To install the product documentation, follow these steps: Step 1: Step 2: Step 3: Step 4: Step 5: Step 6: Download the documentation plugin as described in the section above on downloading the CX4CBDDS plugin, licences and documentation. Open the software update screen with Help > Install New Software. Click Add. Click Archive and browse to the downloaded zip file. Click OK. Click Select All and Next to install the documentation. 3.7 Product Licensing CX4CBDDS requires two (2) licenses to run: an RSA license is required for the base tool, and an SCX license is required to access the CX-specific functionality. The first time RSA8 is installed a 30 day trial RSA license will be installed. To make the installation permanent, you will require a permanent RSA license which can be acquired by contacting IBM directly or PrismTech (sales-admin@prismtech.com) if you purchased an RSA8 license with your CX4CBDDS seat Importing the RSA license When the 30 day trial RSA license expires, you are presented with a dialog that indicates there is no license key for Rational Software Architect Product Plug-in available. On Linux, you must be running as root to install the RSA license. Zeligsoft CX for CBDDS: Installation Guide 18

19 Step 1: Step 2: Step 3: Step 4: Step 5: Step 6: Click Help > Manage Licenses. Select Rational Software Architect and click Apply License. The IBM installation manager starts. Select Import product activation Kit. Click Next. Browse to the RSA license jar file supplied by support. Click Next and Accept. The RSA license can also be installed by following the above steps after invoking the IBM installation manager directly and not as a result of starting CX4CBDDS Importing the CX4CBDDS License The CX4CBDDS license is usually called <nodename>.lic and is downloaded from the portal as described in Obtaining the CX4CBDDS plugin. There are two license types available: trial and permanent. The first time you launch CX4CBDDS you are prompted to import a license: Step 1: Step 2: Step 3: Step 4: Step 5: Click Manage Licenses. Click Import License File and browse to the.lic file provided by PrismTech. Click OK. Review the list of features to be licensed. Click Restart Workbench. You can also access the CX4CBDDS license management wizard from Help > Manage CX Licenses. If you imported a trial license, you can view the time remaining with the license or import a permanent license. From the Help menu, select Manage CX4CBDDS Licenses. After the Manage Licenses window opens, follow the procedure as described above. If your CX4CBDDS trial license expires, the next time you open CX4CBDDS, you are prompted to import a license as described above. Zeligsoft CX for CBDDS: Installation Guide 19

Migration Guide. Release 6.x

Migration Guide. Release 6.x Migration Guide Release 6.x Vortex OpenSplice MIGRATION GUIDE Part Number: OS-MG6 Doc Issue 09, 7 November 2017 Copyright Notice 2006 to 2017 ADLINK Technology Limited. All rights reserved. This document