ActiveVOS Designer Plug-in Installation

ActiveVOS Designer is an intuitive graphical development environment based on the Eclipse framework. Leveraging the power of Eclipse, ActiveVOS Designer allows developers to immediately become productive in visually creating business orchestrations, while providing flexibility to also take advantage of other plug-ins offered by the Eclipse community. We offer a full distribution of ActiveVOS Designer which is a complete pre-configured Eclipse environment, as well as this plug-in only distribution for developers who wish to simply add ActiveVOS functionality to their existing Eclipse installation.

Pre-requisites

Please ensure you have the proper version of Eclipse for your ActiveVOS installation. The plugin distribution contains everything else you need - including plugins for Web Tools Platform Project (WTP) and EMF Validation.

Note to Mac OS 10.6 Users:


To install ActiveVOS Designer you will need to install Eclipse and then install the corresponding ActiveVOS Designer Eclipse Plug-ins as noted below.

ActiveVOS 9:


The only pre-requisite for installing the ActiveVOS Designer plug-in distribution is to have Eclipse 3.6 installed on your client machine.

ActiveVOS 8:


The only pre-requisite for installing the ActiveVOS Designer plug-in distribution is to have Eclipse 3.5.2 installed on your client machine.

ActiveVOS 7:


The only pre-requisite for installing the ActiveVOS Designer plug-in distribution is to have Eclipse 3.4.1 installed on your client machine.

Plug-in Install

Prior to installing the ActiveVOS plugins it is recommended that you first back-up your existing Eclipse environment.

ActiveVOS 9:


To install ActiveVOS Designer into your existing Eclipse 3.6 for RCP and RAP Developers development environment. The plug-in is installed by using the Eclipse "Install New Software" option and pointing directly to your local copy of this distribution.

ActiveVOS 8:


To install the ActiveVOS 8 plug-ins to an existing Eclipse 3.5.2 framework:
  • Unzip (Linux users will untar) the compressed distribution to a temporary folder
  • Download the plugin distribution (designer_update_site_8.0.0.zip) from the ActiveVOS download site (the link was provided with your license key)
  • In eclipse, navigate to Help / Install New Software
  • Select the Add button
  • Provide a name that will appear in the available-software list
  • Browse to the location of the designer_update_site_8.0.0.zip on your file system
  • Select the new item in the list of available software, and select <Next>
  • Follow prompts provided in the eclipse dialogs to complete the installation

ActiveVOS 7:


To install the ActiveVOS 7 plug-ins to an existing Eclipse 4.3.1 framework:
  • Unzip (Linux users will untar) the compressed distribution to a temporary folder
  • Exit from Eclipse if it is currently running
  • Copy the contents of the "/eclipse/dropins" folder from the temporary location to "eclipse/dropins" folder in your Eclipse environment

Running the Designer

Installing the ActiveVOS Designer License

  • Start Eclipse
  • When Eclipse first starts, select the <Activate> button when prompted
  • Enter your name and <browse> to the location of your ActiveVOS license file
  • Select the <Update> button
  • Select <OK> on the update confirmation dialog
  • Switch to the ActiveVOS perspective (Window / Open Perspective / Other / ActiveVOS)

Creating a New ActiveVOS Embedded Server


The ActiveVOS embedded server provides you a way to test deployment of processes. If this is a new installation, you will need to create a new embedded server.
  • If you haven't already done so, switch to the ActiveVOS perspective (Window / Open Perspective / Other / ActiveVOS)
  • Select the Servers View
  • In the Servers View, Right-mouse and select New / Server
  • The ActiveVOS Server is selected by default, so just select the <Next> Button
  • Accept default information on the following panel and select <Finish>

Installing the ActiveVOS Embedded Server License

  • Start the embedded server by clicking on start-server button in the toolbar of the Servers View
  • When the server has started, navigate to http://localhost:8080/activevos/home.action either in a standalone browser, or by selecting the ActiveVOS Console toolbar button.
  • Select the "Admin" link in the console
  • Select "License Information" from the console
  • Select the <Add License> button
  • Copy the ENTIRE CONTENTS of your DESIGNER license file into the dialog
  • Select the <Add License> button
  • For the first time only, you will need to start the ActiveVOS engine (going forward, this will happen automatically when the embedded server starts)
    • Select the "Admin" menu item in the console
    • Select "Server Status" from the console menu
    • Select <Start Server> button