Getting Started

 Requirements

  • 1 virtual or physical machine, exclusively dedicated to serially run a number of Alyvix test cases
    • 2 or more machines are needed to run parallel test cases or to geographically distribute them
  • screen resolution at least 1280×720 HD or 1280×800 WXGA; screen color depth 24bit RGB or 32bit RGBA
  • WindowsOS 64bit (7, 8, 10, Server 2012, Server 2016) with .NET v4.x; WinOS 32bit versions are not compatible

 

Install with Internet

If your probe can reach Internet through Command Prompt, you can install Alyvix thanks to Anaconda Cloud that takes care about its version and dependencies.

 

1. Install Anaconda

- download Anaconda installer, browsing https://repo.continuum.io/archive/Anaconda2-4.3.1-Windows-x86_64.exe (i.e. strictly download Anaconda2 4.3.1, based on Python 2.7, for Windows 64bit)

- run Anaconda installer (e.g. Anaconda2-4.3.1-Windows-x86_64.exe) as administrator, installing Anaconda for all users and right in C:\Anaconda2

 

2. Install Alyvix (conda package)

- run Command Prompt as administrator and execute the following command to fetch and install the last Alyvix master release together with its Windows service:

conda install -c https://conda.anaconda.org/alyvix alyvix

 

Install without Internet

If your probe can NOT reach Internet through Command Prompt.. do not worry! You can install Alyvix anyway, moving on the probe the three necessary ingredients: Anaconda installer, PyQt, Pillow and Alyvix conda packages.

 

1. Install Anaconda

- move Anaconda installer from an Internet connected machine: download Anaconda installer, browsing https://repo.continuum.io/archive/Anaconda2-4.3.1-Windows-x86_64.exe (i.e. strictly download Anaconda2 4.3.1, based on Python 2.7, for Windows 64bit)

- run Anaconda installer (e.g. Anaconda2-4.3.1-Windows-x86_64.exe) as administrator, installing Anaconda for all users and right in C:\Anaconda2

 

2. Install PyQt (conda package)

- move PyQt archive from an Internet connected machine: download PyQt conda package, browsing https://repo.continuum.io/pkgs/free/win-64/ and strictly clicking the 2.7.1 version based on Python 2.7.1 for Windows 64bit (pyqt-4.10.4-py27_1.tar.bz2)

https://repo.continuum.io/pkgs/free/win-64/pyqt-4.10.4-py27_1.tar.bz2

- rename the filename:

pyqt-4.10.4-py27_1.tar.bz2

- run Command Prompt as administrator and execute the following command to install PyQt:

<path_to_pillow_archive>\conda install –offline pyqt-4.10.4-py27_1.tar.bz2

 

3. Install Pillow (conda package)

- move Pillow archive from an Internet connected machine: download Pillow conda package, browsing https://anaconda.org/anaconda/pillow/files and strictly clicking the 2.7.0 version based on Python 2.7.0 for Windows 64bit (win-64-pillow-2.7.0-py27_0.tar.bz2)

https://anaconda.org/anaconda/pillow/2.7.0/download/win-64/pillow-2.7.0-py27_0.tar.bz2

- rename the filename:

pillow-2.7.0-py27_0.tar.bz2

- run Command Prompt as administrator and execute the following command to install Pillow:

<path_to_pillow_archive>\conda install –offline pillow-2.7.0-py27_0.tar.bz2

 

4. Install Alyvix (conda package)

- move Alyvix archive from an Internet connected machine: download Alyvix conda package, browsing https://anaconda.org/alyvix/alyvix/files and clicking on the last main release (alyvix-2.4.1-py27_1.tar.bz2)

https://anaconda.org/alyvix/alyvix/2.4.1/download/win-64/alyvix-2.4.1-py27_1.tar.bz2

- rename the filename:

alyvix-2.4.1-py27_1.tar.bz2

- run Command Prompt as administrator and execute the following command to install Alyvix together with its Windows service:

<path_to_alyvix_archive>\conda install –offline alyvix-2.4.1-py27_1.tar.bz2

 

Check Alyvix deployment

Follow these steps to be sure everything is well deployed and works fine, both in case of install with or without Internet.

1. run Command Prompt, execute the following command and check the presence of pyqt 4.10.4 py27_1pillow 2.7.0 py27_0 and alyvix 2.4.1 py27_1 within the list of installed conda packages:

conda list “alyvix|pillow|pyqt”

01_alyvix_install_check

2. run Services (under Control Panel\System and Security\Administrative Tools in File Explorer) and and check the presence of Alyvix Wpm Service

02_alyvix_install_check

3. browse Anaconda folder to <path_to_anaconda>\Lib\site-packages\alyvix\robotproxy, where Alyvix will save your test case .py libraries of keywords, and create (within \robotproxy) the folder \alyvix_testcases, where you will save your test case .robot scripts

4. run RIDE, the Alyvix test case editor, double clicking <path_to_anaconda>\Scripts\RIDE.lnk; could be useful to send its shortcut to desktop or taskbar

5. create a new project, clicking on file menu: type its name (e.g my_first_alyvix_testcase_suite) and point to the folder <path_to_anaconda>\Lib\site-packages\alyvix\robotproxy\alyvix_testcases you have created

6. create a new test case, right clicking on the project name (e.g my_first_alyvix_testcase_suite) in the left panel of the editor: type its name (e.g my_first_alyvix_testcase)

7. import the Alyvix library of basic keywords: click on the project name, then on library button, type alyvixlib and click OK button; a library import is successful if its name appears black, otherwise is red

07_alyvix_ride_test_case_suite

8. edit the test case, clicking on its name and type the following command (and its arguments) in the first table row, from the first to the third column:

Create Process | C:\\Program Files\\Internet Explorer\\iexplore.exe | http://www.alyvix.com/

08_alyvix_ride_test_case_edit

9. save the test case with CTRL+S and run it with F8: if Internet Explorer opens Alyvix website, you are ready to build serious Alyvix test cases