ArcPro 3.1 Installation Guide
=============================

This guide covers the steps to install and license ArcPro 3.1, set up the
Python environment, and configure GPT on a development station.

#. **Install .NET 6.0 Desktop Runtime**

   Download and install .NET 6.0 Desktop Runtime (v6.0.5) for Windows x64
   from:

   `https://dotnet.microsoft.com/download/dotnet/6.0 <https://dotnet.microsoft.com/download/dotnet/6.0>`_

#. **Install ArcGIS Pro 3.1**

   Download and install ArcGIS Pro 3.1 from the official Esri site:

   `https://www.esri.com/en-us/arcgis/products/arcgis-pro/overview <https://www.esri.com/en-us/arcgis/products/arcgis-pro/overview>`_

#. **Firewall Exceptions**

   If ArcGIS Pro firewall exceptions are not configured on the server, follow
   this guide:

   `https://www.esri.com/en-us/arcgis/products/arcgis-pro/resources <https://www.esri.com/en-us/arcgis/products/arcgis-pro/resources>`_

#. **License ArcGIS Pro**

   - Make sure you are on the same subnet as the license server
     (for example, ``10.0.0.129``). You may need to connect manually.
   - Open ArcGIS Pro and complete the licensing steps.

   .. image:: _images/Picture1.png
      :alt: ArcGIS Pro licensing
      :align: center
      :width: 7in

#. **Set Up the Python Environment**

   ArcPro manages Python environments and allows you to clone and modify them.

   - Follow this tutorial for cloning the base environment and switching to it
     in the Python Command Prompt:

     `https://pro.arcgis.com/en/pro-app/latest/arcpy/get-started/what-is-conda.htm <https://pro.arcgis.com/en/pro-app/latest/arcpy/get-started/what-is-conda.htm>`_

   - List the available environments using the command shown below.

   .. image:: _images/Picture2.png
      :alt: List of available Python environments
      :align: center
      :width: 7in

#. **Set Up the Python Interpreter in PyCharm**

   - Open GPT3 in PyCharm.
   - Go to **File -> Settings -> Project -> Python Interpreter**.
   - Select **Add Python Interpreter**.
   - Choose **Conda Environment** on the left panel.
   - Choose **Existing environment**.
   - Browse to the directory of your cloned environment and select
     ``python.exe``.
   - Click **OK** to confirm.

   .. image:: _images/Picture3.png
      :alt: PyCharm interpreter configuration step 1
      :align: center
      :width: 7in

   .. image:: _images/Picture4.png
      :alt: PyCharm interpreter configuration step 2
      :align: center
      :width: 7in

#. **Manage Python Packages**

   Download the missing packages that PyCharm indicates are required.

   Use the Anaconda Gallery and install the following packages using
   ``conda-forge`` if available:

   - ``openpyxl``
   - ``pyyaml``
   - ``requests``
   - ``prettytable``
   - ``pyodbc``

#. **Configure the GPT Application**

   Configure the following ``.bat`` files for the GPT application:

   - ``runprocess.bat``
   - ``runpreprocess.bat``

   These files are located in:

   ``C:\ProgramData\axioma\gpt``

   .. image:: _images/Picture5.png
      :alt: GPT batch files location
      :align: center
      :width: 7in

   **Edit** ``run_process.bat``:

   - Change the first row to the directory of GPT's library.
   - Modify the environment created in step 5 and set the path to
     ``activate.bat``.
   - Point to the ``python.exe`` of the cloned environment.
   - Change the directory of ``provision.py`` to GPT3's ``provision.py``.

   .. image:: _images/Picture6.png
      :alt: Editing run_process.bat
      :align: center
      :width: 7in

   **Edit** ``run_preprocess.bat``:

   - Follow the same steps as for ``run_process.bat``.

   .. image:: _images/Picture7.png
      :alt: Editing run_preprocess.bat
      :align: center
      :width: 7in

#. **Final Setup**

   Verify that the GPT application is running by checking the logs and
   ensuring that the UI-SERVER is executing the correct GPT executable.

For additional support, refer to the official documentation or contact your
administrator.