Installation

Installation

This guide will walk you through the process of installing CIB ins7ght in your environment.

Prerequisites

Before beginning the installation, ensure you have:

  • A supported database system installed and running
  • Access to a CIB seven instance with REST API enabled
  • Java Development Kit (JDK) installed
  • Node.js and npm installed (for frontend)
  • Sufficient system resources (RAM, CPU, storage)

Installation Steps

1. Download CIB ins7ght

Download the latest CIB ins7ght release package from [distribution location].

The package includes:

  • Backend application (JAR file)
  • Frontend application (static assets)
  • Configuration templates
  • Documentation

2. Database Setup

Create a dedicated database for CIB ins7ght:

CREATE DATABASE cib_ins7ght;
CREATE USER ins7ght_user WITH PASSWORD 'your_secure_password';
GRANT ALL PRIVILEGES ON DATABASE cib_ins7ght TO ins7ght_user;

3. Configure Application Properties

Navigate to the configuration directory and edit the application.yml or cib-ins7ght.yaml file.

server:
  port: 8899

spring:
  banner:
    location: classpath:banner/cib-ins7ght-banner.txt
  config:
    import:
      - optional:classpath:environment-config.yaml
      - optional:classpath:cib-ins7ght.yaml
  datasource:
    url: jdbc:h2:file:/ins7ght-h2-dbs/cib_ins7ght_db
    username: sa
    password: sa
    driver-class-name: org.h2.Driver
  jpa:
    database-platform: org.hibernate.dialect.H2Dialect
    hibernate:
      ddl-auto: create
    properties:
      hibernate:
        dialect: org.hibernate.dialect.H2Dialect
        jdbc:
          batch_size: 1000
          batch_versioned_data: true
        order_inserts: true
        order_updates: true

webclientCockpitUrl: http://localhost:8080/webapp/#/seven/auth/processes/dashboard

polling:
  time: 10
  engineRestUrl: http://localhost:8080/engine-rest
  maxPageSizeDeployments: 500
  maxPageSizeActivityInstances: 100000
  maxPageSizeProcessInstances: 500
  maxPageSizeIncidents: 500
  batchIntervalInHours: 24
  auth:
    type: basic
    basic:
      username: demo
      password: demo
    webclient:
      url: http://localhost:8080/cib-seven-webclient/rest/login
      username: admin
      password: admin
    sso:
      url: http://localhost:8088/auth/realms/cib/protocol/openid-connect/token
      client-id: ''
      client-secret: ''
      useWebclient: true
      webclientUrl: http://localhost:8080/cib-seven-webclient/rest/login

For production configuration options, see the Configuration Guide.

4. Initialize the Database

The database schema will be automatically created on first startup:

  • H2 and PostgreSQL: Schema is created automatically with ddl-auto: create

No manual migration is required.

5. Start the Backend Application

Launch the CIB ins7ght backend server:

java -jar cib-ins7ght-web.war

Or deploy the WAR file to Tomcat 10+:

# Copy to Tomcat webapps directory
cp cib-ins7ght-web.war /opt/tomcat/webapps/ins7ght.war

The application will start on the configured port (default: 8899). Check the logs to confirm successful startup.

6. Deploy the Frontend Application

The frontend can be deployed as static files to any web server (Nginx, Apache, etc.) or served directly by the backend.

Option A: Standalone Web Server

# Copy frontend files to web server
cp -r frontend/dist/* /var/www/cib-ins7ght/

Option B: Embedded with Backend

# Frontend is automatically served by the backend at http://localhost:8080

7. Verify Installation

Navigate to http://your-server:8899 (or your configured port) in your web browser. You should see the CIB ins7ght application.

Check the info endpoint to verify the installation:

curl http://localhost:8899/info

This should return the application version.

Initial Data Import

Upon first startup, CIB ins7ght will automatically begin importing historical data from your CIB seven instance. This process may take several minutes to hours depending on the volume of data.

You can monitor the import progress in the application logs or through the Polling status page.

Post-Installation Steps

  1. Verify Polling: Check that data is being imported from CIB seven

    • Monitor application logs for polling activity
    • Data should start appearing within the configured polling interval (default: 10 seconds)

  2. Configure Security: Review and adjust security settings

    • Update default passwords
    • Configure authentication method for CIB seven connection
    • Use environment variables for sensitive information

  3. Schedule Backups: Implement a backup strategy for the CIB ins7ght database

    • Regular database backups
    • Export configuration files

  4. Monitor Performance: Check system resource usage and adjust as needed

    • Monitor memory usage
    • Review polling performance
    • Adjust batch sizes if needed

Troubleshooting

Application Won’t Start

  • Check Java version compatibility
  • Verify database connection settings
  • Review application logs for error messages

Cannot Connect to CIB seven

  • Verify CIB seven API URL is correct
  • Check network connectivity
  • Confirm API credentials are valid

Frontend Not Loading

  • Clear browser cache
  • Check browser console for errors
  • Verify backend API is accessible

On this Page: