Difference between revisions of "Installation/en"

From expecco Wiki (Version 2.x)
Jump to navigation Jump to search
Line 47: Line 47:
 
=== Required Linux Packages ===
 
=== Required Linux Packages ===
   
The 32bit version of expecco can execute on both 32- and on 64-bit Linux systems. The 64bit version requires a 64bit Linux installation. If the 32bit version is installed on a 64bit system, 32bit standard libraries (in /lib and /usr/lib) are required. If missing, please install the 32bit support via the package manager. The C standard library "glibc" must have a version >= 2.10.
+
expecco can be installed on both 32- and on 64-bit Linux systems. The 64bit expecco version requires a 64-bit Linux operating system.
  +
We recommend to install the 64-bit expecco Version on a 64-bit Linux system.
  +
  +
If the 32bit version is installed on a 64bit system, 32bit standard libraries (in /lib and /usr/lib) are required. If missing, please install the 32bit support via the package manager. The C standard library "glibc" must have a version >= 2.10.
   
 
Please use the package manager and install the following packages (32bit packages for the 32bit version, 64bit packages for the 64bit version):
 
Please use the package manager and install the following packages (32bit packages for the 32bit version, 64bit packages for the 64bit version):
   
* libXinerama
+
* <code>libXinerama</code>
* libxrandr
+
* <code>libxrandr</code>
* libXft
+
* <code>libXft</code>
* libusb
+
* <code>libusb</code>
* unixODBC
+
* <code>unixODBC</code>
  +
* <code>libglib-2_0-0</code>
  +
* <code>gnuplot</code> (optional - if Plot/Graph Actions are used)
   
 
Some of those may depend on other packages, which the package manager will install automatically for you.
 
Some of those may depend on other packages, which the package manager will install automatically for you.
   
On Ubuntu 15.04 (32-bit) packages are installed with:
+
On Ubuntu (15.04) packages are installed with:
   
 
sudo apt-get update && sudo apt-get install -y \
 
sudo apt-get update && sudo apt-get install -y \
 
libxinerama1 libxft2 libxrandr2 unixodbc odbcinst libusb-1.0.0
 
libxinerama1 libxft2 libxrandr2 unixodbc odbcinst libusb-1.0.0
  +
  +
==== Installing a 32-bit expecco on a 64-bit Linux (not recommended!) ====
  +
  +
We do not recommend this configuration. Better install the 64-bit expecco Version.
  +
If you want to install expecco-32-bit on 64-bit-Linux anyway, you require the linux packages in der 32-bit version.
  +
  +
The C standard library "glibc" must have a version >= 2.14.
  +
  +
In Ubuntu 64-bit (>= 15.04 64-bit) you have to install the 32-bit packages with the command:
  +
  +
<code>sudo apt-get update && sudo apt-get install -y \
  +
libxinerama1:i386 libxft2:i386 libxrandr2:i386 unixodbc:i386 odbcinst:i386 libusb-1.0.0:i386</code>
   
 
=== Installation of expecco (Linux) ===
 
=== Installation of expecco (Linux) ===

Revision as of 18:49, 12 September 2019

Installation (Windows)[edit]

You will receive an email containing a download link to the expecco installation files. These files are named like:

  • expeccoSetup-2.7.0.22.exe -> expecco base system installation
  • expeccoPluginSetup-2.7.0.22.exe -> optional plugins.

in this example, "2.7.0" is the expecco version and "22" the build number. You will only need the plugin installation file, if you have licensed any of the optional plugins. The version numbers of expeccoSetup and expeccoPluginSetup must match.
Notice: starting with expecco18.1, both the base-system and the plugins are distributed in one common installation file. This was done as occasional users installed mismatching versions, which introduced subtle errors during execution.

Please download those installation programs onto your computer and start with the base installation (expeccoSetup-***.exe). The assistant will guide you through the installation, giving suggestions for the installation drive and folder, which can be changed as required. In addition, the set of components to be installed can be changed. We suggest that you install all packages (incl. sources and examples).

If you have licensed any additional extension/plugin for expecco, you should then start the plugin setup program (expeccoPluginSetup-***.exe). The assistant offers to install all plugins, including those for which no license is available. Any unlicensed plugins will be non-functioning later and corresponding menu items will be greyed and disabled or invisible.

Installed but unlicensed plugins will become available whenever corresponding licenses have been installed. Other than that, they only waste some disk space.

Additional plugins can be installed any time later by re-executing the plugin-setup and selecting the missing plugin check boxes. Also, additional licenses can be acquired at any time later.

After the installation, an "expecco"-icon should be shown on your desktop and also in the start-menu. Expecco can now be started by double-clicking on that icon, via the start menu, or via command line by navigating to the "bin"-folder in the installation folder, and typing "expecco" to the command-prompt.

When started for the very first time, a window asking for a license is shown. Depending on the kind of license you have (single user vs. floating license), you should now follow the license installation procedure which is described below.

Update Installation of expecco (Windows)[edit]

Likewise to a first installation, you will get links to the installation files via email, which you should download onto your machine. When executing the base installation expeccoSetup-***.exe, the installer will detect that there exists a previous installation and ask for confirmation to remove the old files. If you confirm, the old version with all plugins will be deinstalled. Alternatively, you can choose to keep the previous version and install the new one into a different folder. This is often a good choice in that you can try any existing test cases for compatibility issues (which we try hard to prevent, but occasionally happen, for example when existing functions have been improved or bugs fixed for which your previous test suites contain work arounds). In any case will your settings, license files and existing test suites be kept unchanged and will never be removed by the installer (unless you saved any suites in or under the expecco installation folder, which you should never do).

After the update installation of the base system, proceed installing any plugins from the plugin-update installation file.

Installing a License[edit]

When started for the very first time, expecco will ask for a license. Depending on the type of license (single user or floating) perform according one of the following procedures.

Configuration of a Single User License

Configuration of a Floating-License

Installation (Linux)[edit]

Required Linux Packages[edit]

expecco can be installed on both 32- and on 64-bit Linux systems. The 64bit expecco version requires a 64-bit Linux operating system. We recommend to install the 64-bit expecco Version on a 64-bit Linux system.

If the 32bit version is installed on a 64bit system, 32bit standard libraries (in /lib and /usr/lib) are required. If missing, please install the 32bit support via the package manager. The C standard library "glibc" must have a version >= 2.10.

Please use the package manager and install the following packages (32bit packages for the 32bit version, 64bit packages for the 64bit version):

  • libXinerama
  • libxrandr
  • libXft
  • libusb
  • unixODBC
  • libglib-2_0-0
  • gnuplot (optional - if Plot/Graph Actions are used)

Some of those may depend on other packages, which the package manager will install automatically for you.

On Ubuntu (15.04) packages are installed with:

   sudo apt-get update && sudo apt-get install -y \
       libxinerama1 libxft2 libxrandr2 unixodbc odbcinst libusb-1.0.0

Installing a 32-bit expecco on a 64-bit Linux (not recommended!)[edit]

We do not recommend this configuration. Better install the 64-bit expecco Version. If you want to install expecco-32-bit on 64-bit-Linux anyway, you require the linux packages in der 32-bit version.

The C standard library "glibc" must have a version >= 2.14.

In Ubuntu 64-bit (>= 15.04 64-bit) you have to install the 32-bit packages with the command:

   sudo apt-get update && sudo apt-get install -y \
       libxinerama1:i386 libxft2:i386 libxrandr2:i386 unixodbc:i386 odbcinst:i386 libusb-1.0.0:i386

Installation of expecco (Linux)[edit]

You will receive an email containing a link to the expecco installation file:

  • expecco-2.7.0.22.x86.package

here, "2.7.0" is the expecco version number and "22" the build number. The single file contains both the base installation and all plugins, independent of which plugins have been licensed.

The installation package was generated for the "autopackage" installer. In order to install it, you may also need to install the "autopackage" package. If that is not present on your machine, you can download it from: http://download.exept.de/transfer/autopackage/autopackage.tar.bz2

Download the expecco installation file and if required also the autopackage.tar.bz2 into the same folder (any temporary folder or your home folder will do).

expecco can be installed as root or as unprivileged user. If logged in as root, the installation will be into "/opt/expecco". If installing as normal user, it will be installed into your home folder under ".local".

Please execute (on the command line):

   bash ./expecco-2.7.0.22.x86.package

and you will see an installation log similar to:


# Preparing package: expecco - Graphical Test Modeling                                                                                                                
# Checking for required C library versions ... passed
This may take a moment, please wait ... done
# Installing package: expecco - Graphical Test Modeling (package 1 of 1)                                                                                              
# 100%[==================================================] Extracting
# Copying files to /opt/expecco/plugin
# 100%[==================================================] Copying
# Copying files to /opt/expecco/packages/exept/technologyBridge
# Copying files to /opt/expecco/packages/exept/technologyBridge/javaBridge
# Copying files to /opt/expecco/packages/exept/technologyBridge/javaBridge/javaBridge_Server_Client
# 100%[==================================================] Copying
# Copying files to /opt/expecco/packages/stx/libsnmp
# Copying files to /opt/expecco/packages/stx/libsnmp/net-snmp-5.7.2/mibs
# 100%[==================================================] Copying
# Copying files to /opt/expecco/testsuites/libraries
# 100%[==================================================] Copying
# Copying files to /opt/expecco/bin
# 100%[==================================================] Copying
# Copying files to /opt/expecco/lib
# 100%[==================================================] Copying
# Copying files to /opt/expecco/packages/exept/expecco/doc
# 100%[==================================================] Copying
# Copying files to /opt/expecco/testsuites/libraries
# 100%[==================================================] Copying
# Copying files to /opt/expecco/testsuites/examples
# 100%[==================================================] Copying
# Copying files to /opt/expecco/packages/exept/expecco/reportGenerator/tools
# Copying files to /opt/expecco/packages/exept/pdf/afm
# 100%[==================================================] Copying
# Installing USB Dongle access...
# Updating package database...
The following package was successfully installed:
* expecco - Graphical Test Modeling
This installation used 478.74 MiB (502.00 MB) of disk space.
Remove this package by running package remove expecco from the command line.

Special Options for the Installation[edit]

You can define a different target folder for the installation with:

   sh expecco-2.7.0.22.x86.package
            Installation as root to /opt/expecco (Start with: /opt/expecco/bin/expecco)
   sh expecco-2.7.0.22.x86.package --prefix /opt/expecco-2.7
            Installation as root to /opt/expecco-2.7 (Start with: /opt/expecco-2.7/bin/expecco)
   sh expecco-2.7.0.22.x86.package --local-only
            Installation as user to $HOME/.local (Start with ~/.local/bin/expecco)
   sh expecco-2.7.0.22.x86.package --local-only --prefix ~/expecco
            Installation as user to $HOME/expecco (Start with ~/expecco/bin/expecco)

Of course, if you choose any other installation directory, the $PATH setting needs to be changed, if you want to start expecco via the command line later.

Update Installation of expecco (Linux)[edit]

Likewise to a first installation, you will get links to the installation files via email, which you should download onto your machine. When executing the installation sh expecco-***.x86.package, the installer will detect that there exists a previous installation and ask for confirmation to remove the old files. If you confirm, the old version with all plugins will be deinstalled. Alternatively, you can choose to keep the previous version and install the new one into a different folder. This is often a good choice in that you can try any existing test cases for compatibility issues (which we try hard to prevent, but occasionally happen, for example when existing functions have been improved or bugs fixed for which your previous test suites contain work arounds). In any case will your settings, license files and existing test suites be kept unchanged and will never be removed by the installer (unless you saved any suites in or under the expecco installation folder, which you should never do).


Additional symbolic Links (Ubuntu - libodbc,...)[edit]

Due to a bug in Ubuntu 14.04 and 14.10, you have to manually create a few missing symbolic links. Those bugs have been fixed in Ubuntu 15.04.
The missing links are "libodbc.so.2" and "libodbcinst.so.2", in the "/usr/lib/i386-linux-gnu" folder.

Please check their presence and if absent, create them with:

   cd /usr/lib/i386-linux-gnu
   sudo ln -s libodbc.so.1 libodbc.so.2
   sudo ln -s libodbcinst.so.1 libodbcinst.so.2

License Installation[edit]

Please install the license as described in the chapter below.

Installation (macOS)[edit]

Required macOS packages[edit]

expecco requires a 64-bit x64_64 macOS system (a version for older 32bit systems is available upon request). The OS must be macOS 10.6 or newer.

expecco requires XQuartz. Please install this from the Apple Store or xquartz.org unless already present on your machine (it is free).

Installation of expecco (macOS)[edit]

You will receive an email containing a link to the expecco installation file. The file will be named similar to:

  • expecco-2.7.0.22.dmg

here, "2.7.0" is the version number of expecco, and "22" the build number. The installation file contains the expecco base package and all plugins.

To install, open the "dmg"-file and move (drag) "expecco.app" into the "Application"-folder. You will need admin rights to move it to the system's Application folder. Alternatively move it to your private Application folder or onto the desktop. You can also execute expecco right out of the mounted "dmg".

Possible Problems[edit]

Expecco requires a number of other packages (actually shared libraries) to be installed and up-to-date on your system. It will fail to start and a notifier box might be shown if libraries are incompatible or missing (one library we found to make trouble on older macOS installations is "libfontconfig.dylib" (usually in "/opt/X11/lib"), which is required by the Xlibrary).

To analyze, what is going on, open a terminal window and change-directory to "/Volumes/expecco.dmg/expecco.app/Contents/MacOS". There, type in the command: "./expecco" and watch the output.

This should tell you, which part of the system is missing. More detail about which versions are needed is presented by: "otool -L expecco", which lists all required shared library versions, and the versions present on the system.

License Configuration[edit]

Expecco will ask for a license when started for the very first time. Please follow the license installation procedure as described below.

Configuration of a Single User License[edit]

Single user licenses are normally used with a USB-dongle. In special cases, time limited single user licenses are available without dongle ("Demo Licenses"). In both cases, you will have received a license file. License file and dongle must match, but within a company any dongle can be used with any license file (both contain a customer-ID, which must match).

  1. if you received a dongle, place it into any available USB port of your machine.
  2. store the license file anywhere on your computer (i.e. on the desktop)
  3. drag the license file into the license dialog or alternatively navigate to or enter the path of the license file directly.
  4. you will be asked to restart expecco. After that, expecco can be used and the license dialog will not reappear.

License files without dongle are always time limited.

If you pull the dongle and start expecco, it will tell you that your license has expired. After insertion of the dongle and a restart of expecco, this warning will no longer be shown.

While running, expecco will periodically check for the presence of the dongle. If you remove the dongle while expecco is executing, you will get a warning notice and any test execution or editing will no longer be possible. However, you will still be able to save your current work so that no changes or your work are lost.

Configuration of a Floating-License[edit]

To use floating licenses, you will need an expecco license server. The license server is to be reached inside your local network and you need its hostname or ip-address and a port number. Your network/systems administrator should give you this information, especially, if he used a port number different from the default. Please make sure, that a TCP-connection to the license server's port can be established. If required, you may have to configure routers and firewalls to enable this port access.

When the license dialog opens upon startup, choose the tab labelled "License Server". Enter the name or ip-address and the port number of the license server. Usually, the shown default port number can be used, except in rare cases, when the sysadmin had to use a different port due to other services or because some ports are blocked by firewalls or routers. The network/system administrator should be able to give you that information.

You can now choose which shape of expecco to use: expecco-developer or expecco-runtime. The button labelled Update List of Plugins from Server shows a list of available plugins and if any floating licenses are currently available. Choose the plugins which are needed for your tests. Most plugins will need a single license instance, however some plugins may need multiple if the plugin implements tests which are distributed among multiple test machines. If that is the case (which is unlikely), choose the number of licenses you will need. The dialog displays how many of each license are currently available in the license server. The tooltip also shows the overall total amount of licenses; the difference is the number of licenses used by other users within your company.

Click on Install License to acquire the license(s) from the license server.

When you terminate expecco, those licenses will be returned to the license server and can then be reused by other users. While running, expecco will periodically contact the license server and renew those. If the license server can no longer be reached (with some grace period), expecco will disable any test execution and editing will no longer be possible. However, you can still save your suite so any work done will not be lost.

If expecco is not terminated regularly (i.e. if it is killed or if you simply power off your computer), all acquired licenses will also be returned to the license server after that grace period. They can then be used by other users in your company.

expecco remembers which licenses where acquired the last time, and will try automatically to re-acquire the same set when started. If that is not possible, because some licenses are currently in use by other users, the license dialog reappears and missing licenses are highlighted in red color. You can now either wait or discuss with other users about those licenses, or work with other test suites, which require a different set of plugin licenses.

If you need additional licenses during your work or you no longer need any previously acquired license, you can reopen the license dialog and change the set of plugin licenses without a need to restart expecco. The license dialog is reached via the "Extras→ → "Settings" → "License" menu item.

Changing the License After the Installation[edit]

Via "Extras" → "Settings" → "License", any setting such as the set of licenses or the license server contact information (host + port) can be changed at any time later. Any changes in the settings must be made permanent by clicking on "Save Settings". Otherwise, those changes will only affect your current session.



Copyright © 2014-2018 eXept Software AG