Sentera Stitching Service Install Manual

FieldAgent Desktop - Sentera Stitching Service Install Manual

1 Requirements for Installing

1.1 PREREQUISITES

  • Microsoft .NET Framework 4.6.1 (x86 and x64)

1.2 SYSTEM REQUIREMENTS

  • A 64-bit version of Windows 8/10/11 Pro [help]
  • 32 GB of RAM
  • Minimum of a 4 core / 8 thread CPU
  • 500 GB free disk space
  • Virtualization must be enabled on your PC

1.3 USER WINDOWS ACCOUNT REQUIREMENTS

  • You must have a Windows administrator account on the machine.
  • You must have a password on your Windows account.
  • You must be able to access installs.sentera.com.
  • Sentera Stitching Service Installer must be able to make HTTP requests to api.sentera.com.
  • You must be able to store data on a local, non-removable disk.
  • You should have the latest .NET and Windows patches applied (not necessary with the exception of version 4.6.1 of the .NET framework).

2 Download and Install

The purpose of this document is to guide a FieldAgent user through the download and installation of the Sentera Stitching Service. If you have any issues, contact Support at Sentera.

2.1 Download

To download the stitching service, the user must log into FieldAgent Desktop and have an internet connection to download all of the components.


1. Launch the Sentera Stitching Service Installer from the Start menu, as shown Figure 1.

Figure 1: Launch Sentera Stitching Service Installer

2. The default Internet browser will launch and display the install page, as shown in Figure 2. Select Update the Senter Stitching Service Radio button and then click Next.

Figure 2: Installation Information

3. The download install dialog box appears with a status bar, as shown in Figure 3Error! Reference source not found..

Figure 3: Installation Status Bar


4. Follow the prompts in the Install dialog boxes to complete the process. Be patient as some steps may take several minutes to complete before you can click Next, as shown in Figure 4.


Figure 4: Click Next

5. Close the Installation dialog boxes once you receive confirmation the Local Stitching Service was updated successfully, as shown in Figure 5.


Figure 5: Install Complete

2.2 Install Docker


6. The Docker for Windows.exe files downloads. The file is quite large, and depending on the speed of your internet connection, it may take some time to download.

7. Once the download is complete, double-click Docker Desktop Installer.exe to start the install process.

8. If prompted, select Yes in the User Account Control dialog box, as shown in Figure 7.

Figure 7: User Account Control

Note: When the Configuration window displays, make sure there is a check mark in the box Install required Windows components for WSL 2.


Figure 8: Configuration


10. Docker for Windows installs. Once complete, an installation success notification displays, as shown in Figure 9.

Figure 9: Installation Success

11. Click Close.

Note: Make sure that any work is saved before continuing with the next steps.

12. Click Start in the lower left corner of the screen, select Docker for the Windows icon as shown in Figure 10. It will take a few minutes to launch.


Figure 10: Windows Docker


13. If the WSL 2 Kernel is not installed or up-to-date, Docker will prompt to install the update. Select the link in the dialog box, as shown in Figure 11.

Figure 11: Click URL Link

14. In the web page displayed under Step 4, click the link for WSL2 Linux kernel update package for x64 machines, as shown in Figure 12.

Figure 12: Click WSL2 Link


15. Run the installer for the downloaded wsl_update_x64.exe file.

Figure 13: Click Next


17. If prompted, click Yes in the User Account Control dialog box, as shown in Figure 14.

Figure 14: Click Yes


18. Once the install of the wsl_update-x64.exe is complete, click Finish, as shown in Figure 15.

Figure 15: Click Finish


19. From the WSL 2 installation is incomplete dialog box, select Restart.

20. Wait until Docker restarts and displays the message “Docker Desktop is running,” which will display in the bottom left corner of the Docker dialog box. Restart the PC and log into Windows, as shown in Figure 16.

Figure 16: Click Restart

Note: It is important to select Restart versus Shutdown.

21. Once the PC has restarted, select Docker from the Hidden Icons menu at the bottom right corner of the screen, as shown in Figure 17, to confirm Docker Desktop is running.

Figure 17: Hidden Icons


22. On your desktop, select the Sentera Stitching Service icon, as shown in Figure 18.

Figure 18: Sentera Stitching Service

23. Choose Install Sentera Stitching Service, as shown in Figure 19.

Figure 19: Installing Sentera Stitching Service

24. Click Next.

Figure 20: Number of Parallel Stitches


25. Click Yes, as shown in Figure 21. The Set Service dialog box displays.

Figure 21: User Account Control

26. Type your Windows username in the Set Service login dialog, as shown in Figure 22. This is the fully qualified username on the PC.

Figure 22: Login Service Set


27. If you don't know your username, it can be found by positioning the dialog boxes in order to see the circled portion, as shown in Figure 23.

Figure 23: Find a Username

28. Type the Windows password twice, as shown in Figure 24. If you don't have it, create it with User Settings in the Control Panel. The User Account Control dialog box displays.


Figure 24: Login

29. Click Yes to continue, as shown in Figure 25.

Figure 25 User Account Control

30. An installation confirmation dialog box displays, as shown in Figure 26.If the installation was not successful, follow the instructions to remedy the installation. Click Close.

Figure 26: Confirmation

31. After the successful installation of the Sentera Stitching Service, launch FieldAgent.

32. An icon displays at the top of the screen which shows the status of any stitching job. At the first launch of FieldAgent, after installation, the Sentera Stitching Service will attemtpt to stitch all fields.

33. Automatic stitching takes place in the background every time you import a new survey.

34. Once a field has been stitched, no notifications that is is complete displays. The newly stitched full mosaic will be automatically available in the FieldAgent Field View for the imported field and survey.

3 Manually Select a Field to Stitch

To manually select field to stitch:

1. Navigate to the Field View screen for the field to stitch.

2. Select the survey date and then click Add to the stitching queue, as shown in Figure 27.

Figure 27: Add to Stitching Queue

3. The Stitching Service validates that it can process the images, as shown in Figure 28.

Figure 28: Validating


4. The survey chosen to stitch displays in the stitching queue in FieldAgent.

Note: This will only stitch missing full mosaics. It will not overwrite any existing full mosaics.

4 Troubleshoot

From time to time, the Stitching Service does not work as expected. The following are some simple troubleshooting steps to get things back on track.

Note: Make sure it is a Restart and not a Shutdown or Hibernate of the PC. It really does matter.

Figure 29: Restart

2. Once the computer has restarted, log into Windows. Wait until Docker reports that it is running before logging into FieldAgent.

3. If this doesn't solve the problem, then shut down Docker by selecting it from the hidden icons area, as shown in Figure 30.

Figure 30: Hidden Icons Area


4. Right-click on the Docker icon and select Quit Docker, as shown in Figure 31.


Figure 31: Quit Docker

5. Click the Windows icon in the bottom left corner of the screen and type Services into the search box and select Services from the Best Match item list, as shown in Figure 32.

Figure 32: Services


6. Navigate to Sentera Stitching Service, right-click to select Stop, as shown in Figure 33.

Figure 33: Stop


7. Restart the computer.

8. Log in and then wait for the Docker to run.

9. Launch FieldAgent.

10. Repeat Step 6 to navigate the Services to determine if Sentera Stitching Services is running. If not, then right-click, and select Start.

5 Update Passwords

To change the password for Sentera Stitching Service:

1. Click the Windows icon in the bottom left corner of the screen, as shown in Figure 34.

Figure 34: Windows Icon

2. Click the Windows icon in the bottom left corner of the screen and type Services into the search box and select Services from the Best Match item list, as shown in Figure 35.

Figure 35: Services


3. Navigate to Sentera Stitching Service, as shown in Figure 36.

Figure 36: Sentera Stitching Service


4. Right-click on Sentera Stitching Service and select Properties, as shown in Figure 37.

Figure 37: Properties

5. Type the new Windows password in both the Password and Confirm Password fields, as shown in Figure 38.

Figure 38: Password


6. Click OK to change your password.

6 Support

Need Support? Email us at support@sentera.com or call us 844-736-8372.


Revision History

Release No.

Date

Revision Description

Rev. 1.2.1

February 1, 2020

Updated user guide.

Rev. 1.2.2

October 9, 2020

Revised steps to match service.

Rev -

February 18, 2021

Added steps to install WSL2 Linux kernel update package for x64 machines.

Rev A

April 5, 2022

Updated the steps to install Sentera Stitching Service.


7 PDF guide download



    What's New