Skip to content

Web Server Installation

AskSenseOps provides a web interface where you can interact with your data, explore insights, and work with analytics. You can use AskSenseOps directly through the web interface or connect it to supported platforms using the Qlik Sense Extension and MCP clients.

This guide walks you through installing the AskSenseOps Web Server using the Setup Wizard and completing the initial application setup.

Installation

Step 1: Obtain the Installer

Obtain the AskSenseOps Server Setup installer provided by SenseOps and run it on the Windows server where AskSenseOps is to be deployed.

Step 2: Launch the Setup Wizard

Launch the installer to open the AskSenseOps Server Setup Wizard. The welcome screen provides an overview of the installation process.

AskSenseOps Server Setup Welcome

Step 3: Accept the License Agreement

Review the End-User License Agreement and accept its terms to proceed with the installation.

End-User License Agreement

Step 4: Configure the Server Port

Specify the port on which the AskSenseOps Web Server will listen. The default port is 3010.

Use the Check option to verify that the selected port is available on the server. A confirmation message indicates whether the port is free.

Server Port Configuration

Step 5: Select the Destination Folder

Specify the installation directory for AskSenseOps Server.

The default installation directory is:

C:\Program Files\AskSenseOps\

To install AskSenseOps in a different location, use Change to select the required directory.

Destination Folder

Step 6: Install AskSenseOps Server

The Ready to Install screen displays the installation configuration. Review the selected settings and initiate the installation using Install.

Ready to Install AskSenseOps Server

The Setup Wizard displays the installation progress while the server components are being installed.

Installing AskSenseOps Server

Step 7: Complete the Installation

Once installation is complete, the Setup Wizard displays a confirmation message indicating that the AskSenseOps service is starting.

Select Finish to close the Setup Wizard. Allow the service to start before proceeding with the initial application setup.

AskSenseOps Server Setup Completed

Initial Application Setup

After the AskSenseOps service starts, open your web browser and navigate to:

http://localhost:3010

The AskSenseOps setup page opens. Complete the following steps to configure the application.

Step 1: Configure the Database

AskSenseOps uses PostgreSQL to store application configuration and chat data. You must provide the database connection details before completing the setup.

On the Configure Database page, enter the following details:

Field Description
Host Enter the hostname of the PostgreSQL server. If PostgreSQL is running on the same machine, enter localhost.
Port Enter the PostgreSQL port. The default port is 5432.
Database Name Enter the name of the database to be used by AskSenseOps.
Username Enter your PostgreSQL username.
Password Enter the password associated with the username.

After entering the details:

  1. Click Test Connection to check whether AskSenseOps can connect to the database.
  2. Confirm that the connection test is successful.
  3. Click Save & Continue to save the database configuration and proceed to the next step.

Screenshot

If the connection test fails, check that the database is available and verify the hostname, port, database name, username, and password before trying again.

Step 2: Enter the License Key

After configuring the database, enter the license details provided by SenseOps.

On the Enter License Key page, provide the following details:

Field Description
Host Enter the host address registered with the SenseOps license service.
User Directory Enter the user directory associated with the license.
User Name Enter the username registered with SenseOps.
License Key Paste the license key provided by SenseOps or upload the key.json file.

To configure the license:

  1. Enter the host address, user directory, and username associated with the license.
  2. Paste the license key into the License Key field, or click Choose key.json to upload the license file.
  3. Click Save & Continue to validate and save the license details.
  4. Once the license is successfully validated, proceed to create the administrator account.

The license key is validated through the SenseOps license service. The server remains in setup mode until a valid key is saved.

License Key Configuration

Step 3: Create the Administrator Account

Next, create a local administrator account to access and manage AskSenseOps.

On the Create Admin Account page, enter the following details:

Field Description
Username Enter a username for the local administrator account.
Display Name Enter a display name. This field is optional.
Password Enter a password for the account.
Confirm Password Enter the password again to confirm it.

Once you have entered the details:

  1. Verify that the username and password are correct.
  2. Click Create Admin & Finish Setup to complete the initial setup.

Screenshot

The local administrator account provides emergency access when SSO is unavailable. It can also be used to configure models and connections through the admin settings.