Installation and Upgrade

Before installing Alyvix, first check that your setup meets the system requirements. If it does, you will then need to install Python on your Windows machine before installing Alyvix itself.


System Requirements

Note

Alyvix assumes that you have one virtual or physical machine exclusively dedicated to running Alyvix test cases.

You should check that your designated machine meets the following requirements before you install Alyvix:

Requirements

  • Screen color depth: 24-bit RGB or 32-bit RGBA

  • OS: Windows 64-bit 10, 8, 7, Server 2012 or Server 2016 (32-bit versions of Windows are not compatible with Alyvix)


Installing Python

Follow this procedure to install Python on your system:

  1. Download the 64-bit Windows installer for Python version 3.7.6. Alyvix is not compatible with 32-bit versions of Python.

  2. Start the installation by right-clicking on the executable and selecting “Run as administrator”. Check the box “Add Python 3.7 to PATH” and then choose “Customize installation”.

    The first panel of the python installation process.
  3. On the second panel all the option boxes should already be checked. Click “Next” to continue.

    The second panel of the python installation process.
  4. On the third panel, make sure the advanced options are set as shown below. Then under “Customize install location”, insert the recommended location C:\Python37\. Finally, click on “Install”. At this point Python will begin installing, typically requiring about 5 minutes.

    The third panel of the python installation process.
  5. The installation is correct if the following command returns a version number rather than an error message (if not, you will need to edit your Path environment variable):

    C:\> python --version
    Python 3.7.6
    

Installing Alyvix

Alyvix itself is installed via pip, the official Python package manager. pip will automatically detect that your system is running Python 3 and will install Alyvix 3, placing all executables in the directory C:\Python37\Lib\site-packages\alyvix\.

As with the installer, this command prompt must also be started in Adminstrator mode. Only this single step is required:

  1. Run the following command to download and install the latest Alyvix master release along with all of its dependencies:

    C:\> pip install alyvix
    

You should place your Alyvix test cases in a separate data directory.


Upgrading Alyvix

Only two steps are needed to upgrade to the latest version:

  1. Close Alyvix

    • Save all of your currently open projects

    • Close all Alyvix user interfaces and applications

    • Terminate all running Alyvix processes

  2. Upgrade Alyvix with pip

    • Start a Command Prompt in administrator mode

    • Run the following command to download and upgrade to the latest Alyvix master release along with all of its dependencies:

      C:\> pip install --upgrade alyvix
      

Offline Installation

In order to create an offline installation, you will need two machines:

  • An internet-connected installer machine with a working Python 3 installation to serve as a source for downloading the required software packages

  • A second target machine that will serve as the offline probe

Both machines must meet the second system requirement above, and have access to removable media in order to physically transfer the software from the installer to the target.

The following steps will then enable you to install Alyvix on the target machine:

  1. On the installer Windows 64-bit machine with an existing Python 3 installation (not Python 2):

  2. Copy the entire directory onto the removable media, then copy that directory onto the target machine

  3. Use the Python installer now on the target machine to install Python following the instructions above

  4. Open a command prompt in the directory on the target machine and install Alyvix with this command:

    C:\...\MyFolder> pip install alyvix-3.0.0-cp37-cp37m-win_amd64.whl --no-index --find-links .
    
  5. Check that the installation was successful by starting Alyvix Editor:

    C:\> alyvix_editor
    

    If the Editor window appears, the installation was successful.