WriteBackExtreme
WebsiteAll products
V5.0
V5.0
  • Prologue
    • WriteBackExtreme v5
    • Release Notes
    • Changelogs
    • Architecture
      • Data Handling and Security in WriteBackExtreme (SaaS)
  • Installation guide
    • Requirements
      • Windows
      • Linux
    • Getting started
      • Windows
      • Linux
      • Containerization
        • Docker standalone
        • Docker compose
        • Repository database
        • ODBC connections
    • Installation wizard
      • License
      • Repository database
        • SQL Server
        • MySQL
        • PostgreSQL
        • SQLite
      • Create a user
      • URL & SSL Certificate
      • Run as a service
      • Summary
        • Running on Linux
    • Configuration panel
      • Home page
      • Domain & SSL Management
      • Repository Database
      • License Management
      • User Management
      • Ip Whitelisting
      • Primary keys in Data Add
    • Upgrade
      • Upgrade from 2.x
    • Update license
    • Moving to production
  • Product Guide
    • Getting started
    • Tableau Extension
      • Getting started
        • Create a worksheet with Username()
        • Add the Extension to your dashboard
        • Ready to start
      • Configuration
        • General
          • Schemas
          • Authentication
          • Popup
          • Theming
          • Tabs
          • Mapping
          • Tableau
          • Import/Export
          • Tableau Datasource
        • Schemas
          • General
            • Editable Conditions
          • Field Formatting
            • Single line text
            • Paragraph text
            • Number
            • Boolean
            • Dropdown select
              • Dynamic Populated content
              • Cascading dropdown
            • Date/DateTime
          • Form Builder
            • Features
            • Dynamic Values
              • Troubleshoot | values
        • Changelog
      • End-user
        • Features
          • Dynamic Filtering
          • Bulk Import
          • Audits (History)
          • Bulk Edit
          • Duplicate rows
        • Add Data
          • Overview
          • Add rows
          • Edit rows
        • Collaboration
          • Overview
          • Add / Edit
          • Reply
        • Data Helper
          • Overview
          • Add rows
          • Edit rows
        • Data Correction
          • Add records
          • Edit records
          • Remove records
          • Interpolate
          • Calculations
          • Vertical layout
        • SSO/SAML or Oauth authentication
    • Management console
      • Setup security
        • OAuth Setup
          • Microsoft Entra
          • Auth0
          • Google
        • SSO Setup
          • OKTA Example
          • PingOne Example
          • Azure Example
          • Troubleshooting SSO
      • Connections
      • Schemas
        • Permissions
        • Audits
        • Import/export
        • Row Level Security
        • Schema data
        • Workflows
          • Stored procedures
          • Tutorial (video)
      • Tableau sync
      • User management
      • Group management
      • Info & License
    • Database Connections
      • DataBricks
        • Windows
        • Linux
      • Snowflake
        • Using ODBC
          • Windows
          • Linux
        • OAuth Authentication
        • Key Pair
    • NEW: InputTables
  • Support
    • Troubleshoot
      • Errors
    • FAQ
Powered by GitBook
On this page
  • Configured with direct access from the Internet
  • Configured behind Reverse Proxy/Load Balancer
  • Troubeshooting SSL Certifications

Was this helpful?

  1. Installation guide
  2. Installation wizard

URL & SSL Certificate

PreviousCreate a userNextRun as a service

Was this helpful?

The final step is the configuration of the domain the application will be running on. There are 2 possible setups:

Configured with direct access from the Internet

This indicates that the machine is not running behind a reverse proxy or load balancer.

The protocol (e.g. http:// or https://) should be omitted in the domain field.

Configured behind Reverse Proxy/Load Balancer

When the machine where WriteBackExtreme is going to be installed is not directly accessible from outside and has a load balancer or reverse proxy that redirects the incoming traffic from the domain to this machine, tgen you need to check the Application is running behind a load balancer option. The message on the top indicates how it should be configured at the load balancer/proxy side.

The protocol (e.g. http:// or https://) should be omitted in the domain and hostname field.

Troubeshooting SSL Certifications

Sometimes the application does not like the provided ssl certificates. These error could occur:

Failed to decode PEM block containing private key
  1. Open keyfile and check if it starts with -----BEGIN PRIVATE KEY-----

If there is something above this line, delete it. (Same applies to certificates!)

  1. Open your keyfile and check if it is encrypted. (Encrypted private keys start with -----BEGIN ENCRYPTED PRIVATE KEY-----) When it is encrypted, you need to decrypt it. You can do that via openssl (if installed on your machine) in your terminal using the following command:

openssl rsa -in <encrypted_private.key> -out <decrypted_private.key>

Could not unpackage pfx/p12 file - pkcs12: expected exactly two safe bags in the PFX

The PFX file does not have the correct format. The best way is to convert pfx into a .crt and .key file. You can do this via openssl when this is installed on your system:

## extract the key from the pfx file
openssl pkcs12 -in [yourfile.pfx] -nocerts -out certificate.key

## extract the certificate from the pfx file
openssl pkcs12 -in [yourfile.pfx] -clcerts -nokeys -out certificate.crt

## Decrypt the keyfile
openssl rsa -in certificate.key -out certificate-decrypted.key

# Upload the certificate-decrypted.key and certificate.crt to writeback. 

Server startup problems

Could not startup server, Contact Apps For Tableau support when the problem persists

The app server is unable to start. This can have multiple causes like:

  • Application is configured as administrator but is currently not running with administrator previleges.

  • Check if there is no other WriteBackExtreme proces running in the background. Open Task manager and select the Details tab. You should have only one process called WriteBackExtreme.

  • Check if there is no other process running on the port that is configured in WriteBackExtreme. You can do that with this command in cmd:

netstat -aon
  • Check is the application log. This log file is located at <path>/.wbe-runtime/storage/logs/wbe-application.log

  • Open powershell and navigate to the directory where WriteBackExtreme.exe is located. run this command to manually trigger the application server:

./WriteBackExtreme.exe serve

This command might give more details about what went wrong.

listen tcp :443: bind: Only one usage of each socket address (protocol/network address/port) is hormally permitted

When this error appears in your wbe-application.log it is not able to spin the server because the port you have configured is already in use by another program.

asdsad

The application is running behind a reverse-proxy or load-balancer
The application is exposed to the internet