Installing and updating the Sage X3 Automated Test Platform library

This chapter explains how to install and update the Sage X3 Automated Test Platform library.

Verify the prerequisites

Part 1: Verify the software prerequisites

  1. Ensure that the following programs are installed on your local machine. The installation is controlled, and the installation cannot be executed if it is not installed.
  2. You can confirm if those programs were installed by following these steps:

    1. In the Windows search bar, type program and click Add or remove programs

      Example for Windows 11:

    2. In the search box, filter on the program you are looking for and confirm that the program is installed on your system

      Search for java or zulu and chrome (version of java or Azul Zulu or Google Chrome may differ if newer releases are available or depending on your system configuration):

If the programs mentioned above are not installed, the installation files can be found here:

Make sure you install the version compliant with your operating system. For example, if you have Windows 10 64-bit, ensure to install the 64-bit version of Java.

Part 2: Verify/Create the JAVA_HOME environment variable

When installing the Java runtime, some installers such as Azul Zulu suggest creating the JAVA_HOME environment variable automatically during the installation process.

You can create it manually if you didn’t select this option or if it wasn’t suggested during the Java runtime installation.

This variable is used to automatically locate the version of the JAVA runtime installed on your system.

  1. Enter Environment in the Windows search bar.

  2. Select Edit the system environment variables.

  3. Select the Environment Variables button.

  4. Check if the JAVA_HOME variable exists in the System variables section.

  5. If not, follow these steps to create the JAVA_HOME variable:

    1. Select New.

    2. Enter JAVA_HOME for the variable name.

    3. Enter the value for your JAVA_HOME variable. It is the path where Java or Azul Zulu is installed. Generally, it is under C:\Program Files\....

  6. Select OK to close the Environment variables window.

  7. Select OK to close the System properties window.

Part 3: Prepare the installation files

  1. Copy the atp-M.m.p-win ZIP file on your local machine.

  2. Unzip the atp-M.m.p-win ZIP file.

  3. The following folder and files are extracted:

    Folder File Description
    \atp-M.m.p-win\01-ClientInstaller-updater sagex3atp-setup-M.m.p.jar Installer/updater setup wizard to install/update the ATP Client on a local machine.
    \atp-M.m.p-win\02-JenkinsPipelines ATP-TemplateRunAutomatedTests.xml

    sagex3atp-jenkins-setup-M.m.p.jar

    ATP Jenkins installer to install/update ATP for your ATP-RunAutomatedTest pipeline.

Install Sage X3 Automated Test Platform

  1. Double-click the sagex3atp-setup-M.m.P.jar file to execute the installation process.

  2. The setup wizard opens and the welcome page displays.

  3. Select the Next button to continue.

  4. The License agreements page displays.

  5. To continue the installation process, select I accept the terms of this license agreement.

  6. Select the Next button to continue.

  7. The Prerequisite software page displays.

    Note - warningThe installation will stop if Chrome or Java are not installed:
    1. Select the Quit button to close the setup wizard.
    2. Refer to the Verify the prerequisites section of this documentation and follow the guidelines.
  8. If the prerequisites are OK, select the Next button to continue.

    (Version of java or Azul Zulu or Google Chrome may differ if newer releases are available or depending on your system configuration)

  9. The Required software page displays. Visual Studio Code is required. At that stage, the installer only informs you of what it will install on your system.

  10. Select Visual Studio Code is not installed and will be downloaded, and Next to install Visual Studio Code if it is not already installed on your device.

  11. If Visual Studio Code is already installed, select the Next button to continue. If your current version of Visual Studio Code is already installed, then its installation will be skipped.

  12. The Optional software page displays. At this stage, the installer informs you of what it will install on your system.

  13. Indicate if you want to install Git or not and select Next to continue.

  14. The Destination installation folder page displays.

  15. Click the Browse button to select the path where you want to install Sage X3 Automated Test Platform.

  16. Select the Next button to continue.

  17. Select the OK button to confirm the creation of the folder.

  18. The Installation summary page displays. It summarizes the third-party software and Sage X3 Automated Test Platform library that will be installed on your system.

  19. Select the Install button to proceed with the installation of the third-party software and Sage X3 Automated Test Platform.

  20. The Unpacking installation files page displays.

  21. Select the Next button to continue.

  22. The Configuring 3rd party software page displays and the previously selected third-party software are installed on your system.

  23. Wait until the end of the third-party software installation and select the Next button to continue.

    (Version of Git and Visual Studio Code may differ if newer releases are available or depending on your system configuration)

  24. Select the Next button to continue and install Sage X3 Automated Test Platform.

  25. The Installing Sage X3 Automated Test Platform page displays and the installation of Sage X3 Automated Test Platform starts.

  26. Once Sage X3 Automated Test Platform is installed, the following message displays: Sage X3 Automated Test Platform M.m.p installed successfully!

  27. Select the Next button to continue.

  28. The Installation finished page displays.

  29. To open Visual Studio Code and load Sage X3 Automated Test Platform, select the Open install folder button. This opens the ATP folder in the Windows file explorer.

  30. Double-click the LaunchVsCode application to launch Visual Studio Code and to load Sage X3 Automated Test Platform.

  31. In Visual Studio Code, select Yes, I trust the authors.

  32. Close Visual Studio Code.

  33. Go to the setup wizard and select Done to finish the installation.

  34. The next time you will open Visual Studio Code, the application will launch with Sage X3 Automated Test Platform.

Update Sage X3 Automated Test Platform

  1. Double-click the sagex3atp-setup-M.m.p.jar file to execute the update process.

  2. The setup wizard opens and the welcome page displays.

  3. Select the Next button to continue.

  4. The License agreements page displays.

  5. Select I accept the terms of this license agreement and Next to continue the update process.

  6. The Prerequisites software page displays. It will only display if you update Sage X3 Automated Test Platform from a version prior to 2.8.0.

    1. For more information on software prerequisites, refer to the Verify the prerequisites section of this documentation.

    2. If the prerequisites are OK, select the Next button to continue.

  7. The Required software page displays. As you already used a previous version of Sage X3 Automated Test Platform, the setup wizard indicates which version of Visual Studio Code you are using.

  8. The Optional software page displays. As you already used a previous version of Sage X3 Automated Test Platform, the setup wizard indicates which version of Git you are using.

  9. If you didn’t install Git before, indicate if you want to install Git or not and select Next to continue.

  10. The Destination installation folder page displays if you update Sage X3 Automated Test Platform from a version prior to 2.8.0.

    1. Click the Browse button to select the path where Sage X3 Automated Test Platform is already installed.

    2. Select the Next button to continue.

    3. Select Yes to confirm that existing files will be overwritten. Only the necessary files will be overwritten. Your existing feature files won’t be modified.

    Note - tipIf you update from Sage X3 Automated Test Platform version 2.8.0 or later, the installation summary page displays directly and you don’t need to indicate where Sage X3 Automated Test Platform is installed anymore.
  11. The Installation summary page displays. It summarizes the third-party software and Sage X3 Automated Test Platform library that will be installed or updated on your system.

  12. Select the Install button to proceed with the update.

  13. The Unpacking installation files page displays.

  14. Select the Next button to continue.

  15. The Installing Sage X3 Automated Test Platform page displays and the update of Sage X3 Automated Test Platform starts.

  16. Once Sage X3 Automated Test Platform is updated, the following message displays: Sage X3 Automated Test Platform updated to version M.m.p.

  17. Select the Next button to continue.

  18. The Installation finished page displays.

  19. Select the Done button to finish the update.

Uninstall Sage X3 Automated Test Platform

This section explains how to uninstall Sage X3 Automated Test Platform.

The uninstallation process only uninstalls the Sage X3 Automated Test Platform. Third-party components, such as Visual Studio Code, and Git, are not uninstalled as you can continue using them for other purposes.

  1. Back up the feature test files you have created before uninstalling Sage X3 Automated Test Platform.

  2. Make sure that all your applications are closed.

  3. Enter Program in the Windows search bar. (Example with Windows 11)

  4. Select Add or remove programs.

  5. Search for Sage X3 Automated Test Platform in the list.

  6. Select Uninstall.

  7. The uninstaller wizard launches.

  8. Select the Force the deletion of ... checkbox.

  9. Select the Uninstall button.

  10. Wait until the end of the Sage X3 Automated Test Platform uninstallation process.

  11. Select the Quit button when the uninstallation process is finished.

Find out more

First steps with Sage X3 Automated Test Platform library

To know more about using the Sage X3 Automated Test Platform library, refer to the section First steps with Sage X3 Automated Test Platform library in the document Sage X3 Automated Test Platform - User guide.