.. .. Vortex Link .. .. This software and documentation are Copyright 2010 to 2018 ADLINK .. Technology Limited, its affiliated companies and licensors. All rights .. reserved. .. .. Licensed under the ADLINK Software License Agreement Rev 2.7 2nd October .. 2014 (the "License"); you may not use this file except in compliance with .. the License. .. You may obtain a copy of the License at: .. docs/LICENSE.html .. .. See the License for the specific language governing permissions and .. limitations under the License. .. .. _`Installation`: ############ Installation ############ ******************************************** Obtain the Vortex Platform installation file ******************************************** Check that the file that you have obtained (by downloading or other method) is the appropriate one for your system. The name of the file indicates the target platform as well as the Vortex Platform version. Example installer file names:: VortexPlatform_v2-linux-x32-installer.run VortexPlatform_v2-linux-x64-installer.run VortexPlatform_v2-windows-x32-installer.exe VortexPlatform_v2-windows-x64-installer.exe (It is possible to install a 32-bit version of Vortex on a 64-bit system, but for the best performance you should install the 64-bit version.) |info| If you wish to install on a system other than Windows or Linux, then you can obtain an archive file from ADLINK and unzip that instead of using the installer. ************************************ Run the Vortex Platform Setup Wizard ************************************ Start the installer =================== Navigate to the directory which contains the Vortex installer file. If you are using a GUI, you can usually just double-click on the installer to run it. If you are using a console ('command line'), enter the appropriate command for your platform. (On most versions of Windows and Linux this means typing the file name, excluding the ``.exe`` or ``.run`` extension, and pressing the ```` key.) |linux| |windows| Once it starts, the operation of the installer is the same on both Windows and Linux platforms; the example screens shown in the following steps are from a Windows system. The Vortex installer splash screen appears briefly before the Setup Wizard 'Welcome' screen is displayed. Proceed with the Setup Wizard ============================= .. _`Figure 1 Welcome to the Setup Wizard`: .. figure:: /images/vinstall_xp_001.png :alt: Welcome to the Setup Wizard **Figure 1 Welcome to the Setup Wizard** Click **Next**. Accept the License Agreement ============================ .. _`Figure 2 Accept the License Agreement`: .. figure:: /images/vinstall_xp_002.png :alt: Accept the License Agreement **Figure 2 Accept the License Agreement** If you do not accept the terms of the license, the installation is cancelled. Click **Next**. .. _`Choose a location for the Vortex Platform Installation`: Choose a location for the Vortex Platform installation ====================================================== .. _Figure 3: .. _`Figure 3 Choose a location for the Vortex Platform installation`: .. figure:: /images/vinstall_xp_003.png :alt: Choose a location for the Vortex Platform installation **Figure 3 Choose a location for the Vortex Platform installation** You can either accept the default destination directory or choose a different location by typing its path or by navigating to it using the 'browse' button. |windows| On Windows, the default installation directory (shown in `Figure 3`_) is: ``C:\Program Files\ADLINK`` (For this example, the Vortex Platform will be installed in ``C:\apps\ADLINK\Vortex_v2``.) |linux| On Linux, the default installation directory is: ``/home//ADLINK/Vortex_v2`` Click **Next**. Choose which components to install ================================== .. _`Figure 4 Choose which components to install`: .. figure:: /images/vinstall_xp_005.png :alt: Choose which components to install **Figure 4 Choose which components to install** Click on a component name to display a description of the component. All Vortex Platform components are selected for installation by default. If any Vortex Platform components are already installed in the location chosen at `Choose a location for the Vortex Platform installation`_, their names are greyed-out and they cannot be de-selected. (To remove Vortex Platform components from your system, use the uninstaller described in the Uninstallation section `Uninstalling Vortex Platform`_). Click **Next**. Enter the location of your license file ======================================= .. _`Figure 5 Indicate location of existing license file (1)`: .. figure:: /images/vinstall_xp_006.png :alt: Indicate location of existing license file (1) **Figure 5 Indicate location of existing license file (1)** If you do not yet have a license file, leave *No* selected (the default) and click **Next**. You will have to obtain a license file and install it manually according to the instructions in the separate *Vortex Licensing Guide* before you can run Vortex. If you already have a license file, choose *Yes*; the Setup Wizard will then perform the necessary configuration steps automatically. Information about these changes is saved in the ``etc`` directory where Vortex is installed (``C:\apps\ADLINK\Vortex_v2`` in this example). Click **Next**. If you chose *Yes*, a dialog appears where you can enter the path to your license file, or use a browse button to navigate to it; otherwise the Setup Wizard proceeds to the next step. .. _`Figure 6 Indicate location of existing license file (2)`: .. figure:: /images/vinstall_xp_007.png :alt: Indicate location of existing license file (2) **Figure 6 Indicate location of existing license file (2)** Install for current or all users? ================================= |windows| **WINDOWS ONLY** On Windows platforms, you can choose whether to install Vortex for all users or only for the current logged-in user. .. _`Figure 7 Install for current or all Windows users`: .. figure:: /images/vinstall_xp_008.png :alt: Install for current or all Windows users **Figure 7 Install for current or all Windows users** The default is for Vortex to be installed only for the current user. If Vortex is to be made available to all users, then the current user (performing the installation) must have Administrator privileges. Click **Next**. Begin installation ================== The Setup Wizard is now ready to begin the actual installation. If you want to review or change any of the choices or entries you have made, you can use the *Back* and *Next* buttons until you return to this screen. .. _`Figure 8 Proceed or Cancel installation`: .. figure:: /images/vinstall_xp_009.png :alt: Proceed or Cancel installation **Figure 8 Proceed or Cancel installation** Click **Next** to proceed and install Vortex on your system. Click *Cancel* if you decide to abandon the installation. No changes will be made to your system, and any information you have entered will be lost. You will have to run the installer again if you decide to install Vortex later. Wait whilst installation proceeds ================================= The Setup Wizard displays a progress bar and a slideshow describing the Vortex Suite components whilst files are installed on your system. .. _`Figure 9 Progress of installation process`: .. figure:: /images/vinstall_xp_010.png :alt: Progress of installation process **Figure 9 Progress of installation process** If you click the *Cancel* button during this phase, then you may be left with a partial installation. For those Vortex components installed you will have an uninstaller that can be invoked to remove it. Installation completed ====================== When all of the necessary files have been installed and the Vortex components have been configured, the Setup Wizard displays a final dialog. .. _`Figure 10 Finish the Setup Wizard`: .. figure:: /images/vinstall_xp_012.png :alt: Finish the Setup Wizard **Figure 10 Finish the Setup Wizard** Documentation for the components of the Vortex Platform is installed in ``docs`` directories within the individual component directories. For example, on the Windows system used to illustrate the steps above, the documentation for Vortex Link is installed in ``C:\apps\ADLINK\Vortex_v2\Link\VortexLink\1.3.0\docs``. **************************** Uninstalling Vortex Platform **************************** The Vortex Platform includes a convenient uninstallation utility for either complete or partial removal of the software from your system. Location of the uninstaller =========================== The Vortex Platform Setup Wizard creates the uninstaller in the VortexPlatform installation directory, which was chosen during the running of the Setup Wizard (see :ref:`Choose a location for the Vortex Platform Installation`). |windows| On Windows, the default installation directory is ``C:\Program Files\ADLINK\VortexPlatform_`` and the uninstaller is named ``uninstall-VortexPlatformV.exe``. |linux| On Linux, the default installation directory is ``/home//ADLINK/VortexPlatform_`` and the uninstaller is named ``uninstall-VortexPlatformV.run``. Start the uninstaller ===================== |windows| Start the uninstaller either * from the Windows Start menu: Start **>** ADLINK **>** VortexPlatform ** **>** Uninstall VortexPlatform ** or * navigate to the Vortex Platform installation directory (see `Location of the uninstaller`_ above) and run ``uninstall-VortexPlatformV.exe``. |linux| Navigate to the Vortex Platform installation directory (see `Location of the uninstaller`_ above) and run ``uninstall-VortexPlatformV.run``. |linux| |windows| Once it starts, the operation of the uninstaller is the same on both Windows and Linux platforms; the example screens shown in the following steps are from a Windows system. Choose whether to uninstall VortexPlatform completely or just some components ============================================================================= .. _`Figure 12 Uninstall entire application or individual components`: .. figure:: /images/vUNinstall_xp_001.png :alt: Uninstall entire application or individual components **Figure 12 Uninstall entire application or individual components** .. _`Figure 13 Choose components to uninstall`: .. figure:: /images/vUNinstall_xp_002.png :alt: Choose components to uninstall **Figure 13 Choose components to uninstall** The names of components which are not installed are greyed-out and they cannot be selected. Click **Next**. In case you selected all the components, you're asked to confirm that you really want to uninstall the full Vortex Platform. .. _`Figure 14 Confirm uninstallation`: .. figure:: /images/vUNinstall_xp_003.png :alt: Confirm uninstallation **Figure 14 Confirm uninstallation** Click **Yes** to proceed, or **No** to cancel the operation. Uninstallation progress ======================= A progress bar is displayed as the uninstallation proceeds. .. _`Figure 15 Progress of uninstallation process`: .. figure:: /images/vUNinstall_xp_004.png :alt: Progress of uninstallation process **Figure 15 Progress of uninstallation process** Uninstallation completed ======================== .. _`Figure 16 Uninstallation completed`: .. figure:: /images/vUNinstall_xp_005.png :alt: Uninstallation completed **Figure 16 Uninstallation completed** Click **OK**. .. |caution| image:: ./images/icon-caution.png :height: 6mm .. |info| image:: ./images/icon-info.png :height: 6mm .. |linux| image:: ./images/icon-linux.png :height: 6mm .. |windows| image:: ./images/icon-windows.png :height: 6mm