This article applies to these versions of LandingLens:
            LandingLens            LandingLens on Snowflake

​
Installation Requirements

  • Before installing any apps from the Snowflake Marketplace, a user with the ORGADMIN role must accept the Consumer Terms of Service for the Snowflake Marketplace. For more details, go to the Snowflake Documentation.
  • To install an app, you must use the ACCOUNTADMIN role or another role with the IMPORT SHARE and CREATE privileges. For more details, go to the Snowflake Documentation.
  • You must have a warehouse to run the LandingLens installer. The warehouse can be any size (including X-Small) and can have auto-suspend enabled.
  • LandingLens is not available on Snowflake trial accounts.

​
Request the LandingLens App

Access to the LandingLens app is available by request. To request the app, follow the instructions below:
  1. Open the LandingAI provider page in the Snowflake Marketplace.
  2. Locate and click the LandingLens - Visual AI Platform listing.
  3. Click Request. LLSF_VisualAI_Request
  4. Fill out and submit the request form.
  5. The LandingAI team will review the request and contact you with more information.

​
Install the LandingLens App

After you’ve requested the app and been granted access it, follow the instructions below to install it in Snowflake:
  1. Open the LandingAI provider page in the Snowflake Marketplace.
  2. Locate and click the LandingLens - Visual AI Platform listing.
  3. Click Get. LL_VisualAIPlatform(1)
  4. Select the Warehouse to use for the installation process. The warehouse can be any size (including X-Small) and can have auto-suspend enabled.
  5. If you want to change the name of the application, click Options and enter a name in Application Name.
  6. Click Get. LLSF_install_1_11_2024
  7. Go to Snowsight > Data Products > Apps. Click the LandingLens app listing. (Although the app is listed in the Installed Apps section, it is not installed yet.) LLSF_update_1
  8. A new page opens. It has a series of steps that guide you through the installation process.
  9. In Step 1, click Grant. These permissions allow LandingLens to create compute pools and perform other tasks in your account. LLSF_install_3_11_2024
  10. In Step 2, click Review. Review the allowed endpoints on the pop-up and click Connect. This allows LandingLens to access the Internet. LLSF_install_4_internet
  11. Scroll to the top of the page and click Activate. LLSF_install_5_11_2024(2)
  12. LandingLens opens in your Apps. Click Launch App. LLSF_install_7_11_2024
  13. The installer opens in the APP_WIZARD tab.
  14. Click Install. The installer installs all the required services for the LandingLens app. This process takes about 20 to 30 minutes. Do NOT close the tab until the upgrade process is complete. LLSF_install_8_11_2024
  15. Once the upgrade process is complete, all services will have a green checkmark, and this message will display:“Installation Completed” LLSF_update_5(1)

​
Log In to the LandingLens App on Snowflake

After you install LandingLens, the URL to access your instance of LandingLens displays. Copy and paste the URL into a new tab to open the LandingLens app. We recommend bookmarking this URL. Only users with the correct privileges in the account can access the LandingLens app. LLSF_URL

​
Upgrade LandingLens on Snowflake

Users with the ACCOUNTADMIN role can upgrade LandingLens when a new version is available.

​
Check if a New Version of LandingLens Is Available (In the App)

When a new version of LandingLens is available, a button displays in the top right corner of the app with this text:
Upgrade to [current_version].
Click the button to launch the app installer in Snowsight. upgrade_app_v1_2_42

​
Check if a New Version of LandingLens Is Available (In Snowsight)

To check if there’s a new version of LandingLens available in Snowsight:
  1. Open Snowsight.
  2. Go to Data Products > Apps. Click the LandingLens app listing. LLSF_update_1
  3. Click Launch App. LLSF_update_2(1)
  4. The APP_WIZARD tab opens. If a new version of LandingLens is available, this message displays:
The app is out of date. Please use the installer to upgrade from [installed version] to [current_version].
LLSF_update_3

​
Before You Upgrade

Be aware of this information before you start the upgrade:
  • The upgrade process takes about 20 to 30 minutes.
  • The upgrade process will interrupt any active training jobs. Ensure that all training is completed before you start the upgrade.
  • Users will not be able to access LandingLens during the upgrade.

​
Upgrade the App

To update :
  1. If you’re in the LandingLens app and a new version is available, click the Upgrade button that displays in the top right corner to launch the installer and go to step 6. Otherwise, go to step 2. upgrade_app_v1_2_42
  2. Open Snowsight.
  3. Go to Data Products > Apps. Click the LandingLens app listing. LLSF_update_1
  4. Click Launch App. LLSF_update_2(1)
  5. The APP_WIZARD tab opens.
  6. Click Upgrade. The installer updates all the required services for the LandingLens app. This process takes about 20 to 30 minutes. Do NOT close the tab until the upgrade process is complete. LLSF_update_4
  7. Once the upgrade process is complete, all services will have a green checkmark, and this message will display:“Installation Completed” LLSF_update_5(1)

​
LandingLens Warehouse

During the installation process, LandingLens creates an X-Small warehouse called LANDINGLENS_NATIVE_APP. The LandingLens app uses this warehouse to run database queries.

​
Troubleshooting Tips

​
Errors During the Installation or Upgrade Process

During the installation or upgrade process, you might get errors, such as Number of retries exceeded. Or, some of the services might still have the status MISSING (yellow triangle). To resolve these issues, click Upgrade or Resume. This triggers the installer to attempt to install the service again.

​
Error: Initializing the Configuration Flow

During the installation process, you might get this error: There was an error initializing the configuration flow. Close the dialog and try again.If you get this error message, try selecting a different warehouse from the drop-down menu in the top right corner.