On-Premise Setup Prerequisites


This article outlines the essential steps and requirements for a successful on-premise setup. Understanding these prerequisites before installing the software is important to ensure a smooth installation process. So, follow the recommendations and requirements given in this document to avoid any issues during the installation process.


Software, Hardware, and other Requirements

Requirements Details
Server Configuration
  • OS: Ubuntu (22.04 LTS) or higher
  • CPU: 24 core
  • RAM: 64 GB
  • DISK: 1 TB - 2 TB (Depending on usage)
  • Software Requirements
  • Internet connectivity on server
  • Docker installation capability on server
  • Root privileges on server
  • Permissions to install/Start the following libraries/executables on customer employee machines:
    - Java/JVM
    - Appium
    - ADB from android
    - Ability to run xcrun on mac os machines
    - Ability to run xattr on mac os machines
  • Machine Configuration
  • It is recommended to install Ubuntu at the root with a 256GB machine.
  • Additionally, it is advised to mount a 2TB and above (based on the usage) hard disk for storage.
  • All required software will be installed at the root, and storage configurations will be set to utilize the mounted disk.
  • Network Requirements
  • If the firewall enabled, *.docker.com, *.amazon.com, *.amazonaws.com, *.maven.org, these should be whitelisted.
  • If they wanted to use the Testsigma mail service, *.sendgrid.com needs to be whitelisted.
  • Database Requirements
  • MySQL database would be installed by default.
  • The user must use only MySQL version 5.7
  • If the customer is going to use a MySQL installation, then we need to install the following commands to setup DB:

    CREATE DATABASE IF NOT EXISTS tstmp;
    CREATE DATABASE IF NOT EXISTS identity;
    CREATE DATABASE IF NOT EXISTS master;
    CREATE DATABASE IF NOT EXISTS tenant1;
    CREATE DATABASE IF NOT EXISTS kibbutz;

    SET session sqlmode='STRICTTRANSTABLES,NOZEROINDATE,NOZERODATE,ERRORFORDIVISIONBYZERO,NOAUTOCREATEUSER,NOENGINE_SUBSTITUTION';

    SET global sqlmode='STRICTTRANSTABLES,NOZEROINDATE,NOZERODATE,ERRORFORDIVISIONBYZERO,NOAUTOCREATEUSER,NOENGINE_SUBSTITUTION';

  • For cloud databases like AWS RDS if the setting of sql_mode is not allowed the provider-specific option can be used like AWS RDS parameter groups.
  • For external databases we would be encouraged to have disk space of 512GB - 1TB depending on customer usage.
  • Backup information Customers would be responsible for taking backup of the Database.
    SMTP Requirements Customers need to produce their SMTP settings in case they desire to use their internal SMTP instead of Testsigma SMTP servers.
    Additional Requirements
  • Depending on user preference, the agent can run on Linux, Windows, or Mac machines.
  • The final storage location for screenshots, apps, and other permanent files is the host server where Testsigma containers run.
  • Temporary files like screenshots may need periodic cleaning depending on usage and disk space availability.
  • The server operation does not require any Windows machines.
  • Customer IT teams must regularly perform data backups through regular disk or specific data folder backups.
  • Testsigma On-Prem Server is not a hypervisor-based installation.
  • By default, the customer would be provided URLs ending with testsigmaprivate.com (like https://cutomername.testsigmaprivate.com)
  • If the customer desires to have these pointed to their domain name (like customername.com), then we need the following:
    - Inform Testsigma before the Onprem build is generated.
    - Get the SSL certificates of the domain in interest and copy them to the server where installation would happen.
  • For installing Testsigma Recorder on chrome browsers,
    - We need the ability to enable developer mode.
    - We need the ability to install the Testsigma recorder in unpacked mode.
  • Additional Checks
  • Check the internet connection to the server machine.
  • Please unblock the ports if blocked. Ports: 3306, 7010, 8080, 8082, 8084, 9090, 9095, 9096, 9097, 4200, 4201, 4203, 4210, 4211, 4220, 4230.
  • NOTE:
    • Testsigma will provide a MySQL docker container; if you want to use the hosted MySQL, please acquire one with the above specification.
    • It is recommended to have a scheduled image backup.
    • Admin access is necessary for On-Prem installation.