Skip to main content

Deploying Standalone

Deploy the LimePoint Solifi Consumer as a standalone Java application.

Prerequisites​

Before deployment, ensure you have:

  • ✅ OpenJDK 21 installed
  • ✅ License file (license.license) from LimePoint
  • ✅ Signature file (sign256.sign) from LimePoint
  • ✅ Consumer JAR file (solifi-consumer-<version>.jar)
  • ✅ Configured application.yml file

Deployment Steps​

Step 1: Prepare Files​

  1. Download the latest solifi-consumer-<version>.jar from LimePoint Support
  2. Place the application.yml in the same folder as the JAR file
  3. Place the license files in a desired folder and update the paths in application.yml

Your directory structure should look like:

/consumer/
├── solifi-consumer-2.2.4.jar
├── application.yml
├── license.license
└── sign256.sign

Step 2: Configure application.yml​

Ensure your application.yml has the correct paths to the license files:

solifi:
  license:
    path: /consumer/license.license
    signature:
      path: /consumer/sign256.sign

Or use relative paths if the files are in the same directory:

solifi:
  license:
    path: ./license.license
    signature:
      path: ./sign256.sign

Step 3: Start the Consumer​

Navigate to the folder containing the JAR file and application.yml, then run:

java -jar solifi-consumer-<version>.jar

For example:

java -jar solifi-consumer-2.2.4.jar

Step 4: Verify Startup​

The consumer will:

  1. Validate the license
  2. Connect to the Kafka brokers
  3. Create database tables for configured topics
  4. Begin consuming messages

You should see log output indicating successful startup:

INFO  - Started SolifiConsumerApplication in X.XXX seconds
INFO  - Consumer group 'clientname-dev' subscribed to topics

JVM Options​

For production deployments, consider adding JVM options:

java -Xmx2g -Xms1g -XX:MaxDirectMemorySize=64m -jar solifi-consumer-<version>.jar
OptionDescriptionExample
-XmxMaximum heap size-Xmx2g
-XmsInitial heap size-Xms1g
-XX:MaxDirectMemorySizeDirect memory limit-XX:MaxDirectMemorySize=64m

Running as a Background Service​

Linux (systemd)​

Create a service file /etc/systemd/system/solifi-consumer.service:

[Unit]
Description=LimePoint Solifi Consumer
After=network.target

[Service]
Type=simple
User=solifi
WorkingDirectory=/opt/solifi-consumer
ExecStart=/usr/bin/java -Xmx2g -jar solifi-consumer-2.2.4.jar
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Enable and start the service:

sudo systemctl daemon-reload
sudo systemctl enable solifi-consumer
sudo systemctl start solifi-consumer

Windows (as a Service)​

Consider using tools like NSSM or WinSW to run the consumer as a Windows service.

Troubleshooting​

Common Issues​

IssueSolution
License validation failedVerify license file paths in application.yml
Connection refused to brokersCheck bootstrap-servers and network connectivity
Database connection failedVerify datasource URL, username, and password
Out of memory errorsIncrease -Xmx JVM option

Viewing Logs​

Logs are output to stdout by default. To write to a file:

java -jar solifi-consumer-<version>.jar > consumer.log 2>&1

Or configure logging in application.yml:

logging:
  file:
    name: /var/log/solifi/consumer.log

Next Steps​