Skip to content

Installing to an existing Eclipse instance

This chapter describes the steps that are needed to install itemis CREATE to an existing Eclipse instance. Let’s assume you already have Eclipse up and running and now you want to install itemis CREATE as an additional software item (plugin).

Please note: On macOS, this only works if your .app file is located in your Applications folder.

Attention!

  • Below version 5.2.0 CREATE is not compatible with Eclipse versions 2023-03 or higher.
  • From version 5.2.0 CREATE is only compatible with Eclipse versions 2022-03 or higher.

In the the Help menu, select the Install New Software menu item:

Selecting "Help → Install New Software" in the main menu

Selecting Help → Install New Software in the main menu

The Install wizard opens:

The "Install" wizard

The Install wizard

Click on the Add... button near the upper right corner of the wizard.

A dialog opens, asking you to specify the update repository you want to install the new software from.

Please note: Update site URLs are available online via the itemis CREATE download page.

Adding a software repository

Adding a software repository

After entering name and location of the update repository, click Add.

Eclipse establishes a network connection to the update repository, asks it for available software items and shows them in the install wizard:

Selecting itemis CREATE software items

Selecting itemis CREATE software items

Please check the items you want to install. (You can select any itemis CREATE version.)

Click Next >.

Eclipse tries to integrate the new software with the software that is already installed. If it detects any mismatches between requirements and provisions, Eclipse will try to find a solution in order to mitigate this problem. The screenshot below shows such a case:

Install remediation page

Install remediation page

Select the most appropriate solution, then click Next >.

The wizard shows the software to be installed and gives you the opportunity to review the changes:

Reviewing the items to be installed

Reviewing the items to be installed

Click Next >.

The wizard asks you to review and accept the terms of the new software’s license agreements.

Accepting the new software's license agreements

Accepting the new software’s license agreements

Select the radio button labelled I accept the terms of the license agreements (if you do), then click Finish.

Eclipse starts to download the software and installs it on your computer. This may take some time.

Installing software in progress ...

Installing software in progress ...

If the installation was completed successfully, Eclipse needs a restart in order to have the changes take effect. A dialog asks whether you want to restart Eclipse right now or later:

Restarting Eclipse after software installation

Restarting Eclipse after software installation

After the restart, Eclipse displays its Welcome window, now also featuring itemis CREATE:

Eclipse presenting the "Welcome" window

Eclipse presenting the Welcome window