Install AgilePoint NX Developer

To install AgilePoint NX Developer, do the procedure in this topic.

Prerequisites

  • Your system meets the minimum system requirements for this component.

    For more information, refer to System Requirements for AgilePoint NX Developer.

  • You have completed all of the pre-installation instructions for this component.

    For more information, refer to Set Up Your Environment for AgilePoint NX.

  • Sign in to Windows using a user login that belongs to the local system's Administrators group.
  • If AgilePoint Server is not installed on the same computer that you will be installing on, it should be installed and running on a server that you can access via the internet from the computer where you are installing.

Good to Know

  • The installer UI is optimized for system resolutions 1366x768 or 1920x1080 with 100% scaling. If you use other screen resolutions, the installer UI may not display correctly, which can cause installation errors.

How to Start

  1. On the AgilePoint Server machine, right-click the AgilePoint NX installer package, and click Run as administrator.
  2. On the End User License Agreement screen, review the license agreement, and click Yes. I accept the terms in the license agreement.

    End User License Agreement For AgilePoint Software screen
  3. On the Extract files to directory field, click the Ellipses (...) button to select the folder where you want to extract the installation files.

    The default location for the installer is C:\AgilePoint. It is recommended that you decompress the installation package directly under you C:\ drive folder. The installation file path must be fewer than 50 characters.


    End User License Agreement For AgilePoint Software screen
  4. Click Extract.

    Information screen
  5. On the Information screen, click Open Extracted Folder.

    Information screen
  6. In your specified folder, right-click the AgilePoint NX PreSetup.exe file, and click Run as administrator.

    PreSetup dot exe file
  7. On the Welcome Please Read Before You Begin screen, make sure you have completed the tasks, and select all the items on this screen.

    Welcome Please Read Before You Begin screen
  8. Click Next.
  9. If a supported version of .NET Runtime is not installed, this screen shows.
    1. Click Close.
    2. Install the supported version of .NET Runtime.
    3. Right-click the AgilePoint NX PreSetup.exe file, and click Run as administrator.

    Welcome Please Read Before You Begin Screen

Procedure

  1. On the AgilePoint NX v9.0 screen, click Install AgilePoint NX Developer.

    AgilePoint NX v7 screen
  2. On the AgilePoint NX Developer screen:
    • If Microsoft Visual Studio 2019 is installed on your machine, click AgilePoint NX Developer (x86).
    • If Microsoft Visual Studio 2022 is installed on your machine, click AgilePoint NX Developer (x64).

    The installation procedures are the same for both AgilePoint NX Developer (x64) and AgilePoint NX Developer (x86).

    The screens used in this procedure are for AgilePoint NX Developer (x86).


    AgilePoint NX Developer screen
  3. This screen shows if an AgilePoint NX installation is running on this machine.
    • To resume the installation, click Continue.
    • To restart the installation, click Start.

    Welcome Please Read Before You Begin Screen
  4. On the Welcome to AgilePoint NX Developer Installation screen, select I have installed and activated Visual Studio 2019.

    Welcome To AgilePoint NX Developer Installation screen
  5. On the Verifying System Requirements screen:
    • If there are any errors, do this procedure:
      1. Click Cancel.
      2. Correct the errors.
      3. Right-click the AgilePoint NX Setup.exe file, and click Run as administrator.

        The AgilePoint NX installation starts.


      Verifying System Requirements Error screen AgilePoint NX Developer
      IssueResolution

      Supported version of Visual Studio is installed

      Install a supported version of Visual Studio on this machine.

      For more information, refer to System Requirements for AgilePoint NX Developer.

      User Account Control (UAC) is turned off

      Turn user access control (UAC) off.

      For more information, refer to Turn Off User Account Control (UAC).

      Supported version of .NET Framework is installed

      Install a supported version of .NET Framework on this machine.

      For more information, refer to System Requirements for AgilePoint NX Developer.

      Current user has local administrator privileges

      Sign in to this machine as a user with administrator privileges.

    • If there are no errors, click Next.

      Verifying System Requirements screen AgilePoint NX Developer
  6. On the AgilePoint NX Developer v9.0 Installation screen, complete these fields.

    AgilePoint NX Developer Installation screen
    Field NameDefinition

    Install location

    The folder where you want to install AgilePoint NX Developer.

    User Name

    Usually the first and last name of the person responsible for the AgilePoint NX Developer component or software license.

    Organization

    The name of your organization, or company.

    License Key

    Your AgilePoint NX Developer license key.

  7. Click Next.
  8. On the AgilePoint NX Installation screen, click Install.

    Click Install

    The AgilePoint NX Developer installation starts.


    AgilePoint NX Developer Installation Start screen
  9. After the installation completes, click Next.

    AgilePoint NX Developer Installation Completed screen
  10. On the Finish screen, click Finish.

    AgilePoint NX Developer Installation Completed Message screen
  11. Restart the machine.

    This is optional, but recommended. Rarely AgilePoint users have reported an issue with shortcuts not displaying if the machine is not restarted. There are no other known issues if you do not restart the machine. Windows sometimes prompts to restart, and sometimes not. This is determined by the operating system.

  12. Open Microsoft Visual Studio as an administrator.
Note: The first time you run the application after installing it, you will be prompted to activate it. This step is required. For more information, refer to Activating AgilePoint Licenses.