Silent Install Procedures for Single Server

The Clarify Single Server can be installed silently on both Windows and Linux using a configuration file. This is useful for automated deployments, scripted installations, or environments where GUI access is limited.

Before You Begin

Ensure you have completed all items in the Pre-Install Requirements section above, including:

• PostgreSQL database is installed, configured, and accessible
• Database connection information (host, name, port, user, password)
• Installation executable from Cleo
• Domain user credentials (Linux: user must exist prior to installation)
• Network access confirmed (port 5432 open between Clarify server and database server)

Required Files

• Clarify Server installer executable
• server_single.silent configuration file (see template below)

Place both files in the same directory for ease of installation.

Silent Install Configuration File

Create a file named server_single.silent with the following content. Update all <placeholder> values with your environment-specific information:

###############################
# Install Mode
#
# Do Not Change This Value
INSTALLER_UI=silent

###############################
# Server Installation Type:
#
# STANDARD - Single Server - Non cluster, single node installation
#
# Do Not Change This Value
STANDARD=1

###############################
# Install Locations
SILENT_INSTALL_DIR=<clarify_server_dir>
SERVER_SHARE_LOCATION=<clarify_share_dir>

# Example for Linux:
# SILENT_INSTALL_DIR=/opt/Cleo/Clarify_6_Server
# SERVER_SHARE_LOCATION=/opt/Cleo/Clarify_6_Runtime_Workspace

# Example for Windows:
# SILENT_INSTALL_DIR=C:\Cleo\Clarify_6_Server
# SERVER_SHARE_LOCATION=C:\Cleo\Clarify_6_Runtime_Workspace

###############################
# Memory Setting
SERVER_MEM=2048m

###############################
# Email Settings
# Leave blank if not configuring email during installation
SMTP_SERVER=""
SMTP_PORT=25

###############################
# Database Configuration for Server
# REQUIRED: Connection details for external PostgreSQL database
DB_HOST=<database_host_or_ip>
DB_NAME=<clarify_database_name>
DB_PORT=5432
DB_USER=<database_username>
DB_PASSWORD=<database_password>

# Example:
# DB_HOST=10.10.102.211
# DB_NAME=clarify6
# DB_PORT=5432
# DB_USER=clarify_user
# DB_PASSWORD=SecurePassword123

###############################
# User for property ownership (Linux only)
USER_NAME=<linux_username>

# Example:
# USER_NAME=clarify

Installation Commands

For Windows

From an elevated Command Prompt (Run as Administrator):

start /w <Clarify_Installer.exe> -i silent -f server_single.silent

Example:

start /w Clarify_6_Server_Installer.exe -i silent -f server_single.silent

For Linux

As root or with sudo:

./<Clarify_Installer.sh> -i silent -f server_single.silent

Example:

./Clarify_6_Server_Installer.sh -i silent -f server_single.silent

Verify Installation

1. Check installation logs located in the installer's home directory:

File: Clarify_Install_Result.log

For Linux: If installer is run as root, the log is in /root

2. Verify installation directories were created:

<SILENT_INSTALL_DIR> should contain server utilities and executables

<SERVER_SHARE_LOCATION> should contain workspace directories

3. Test database connectivity from the Clarify server:

# Using psql command (if available):
psql -h <DB_HOST> -p <DB_PORT> -U <DB_USER> -d <DB_NAME>

# Using curl to test port connectivity:
curl <DB_HOST>:<DB_PORT>

4. Start the server,  See instructions in Starting the Single Server.

Common Issues and Troubleshooting

Issue: Installation fails with database connection error

• Verify database is running: Check PostgreSQL service status
• Verify network connectivity: Ensure port 5432 is open between servers
• Verify credentials: Test database login manually using psql or a database client
• Check firewall rules on both Clarify server and database server

Issue: Installation completes but server won't start

• Check installation logs for errors
• Verify DB_USER has required permissions (see Pre-Install Requirements)
• Verify database is accessible from the Clarify server host

Issue: Permission errors during installation (Linux)

• Ensure installer is run as root
• Verify USER_NAME specified in silent file already exists
• Check directory permissions for installation paths

Issue: "Invalid silent install file" error

• Verify all required properties are present in the silent file
• Check for typos in property names
• Ensure no extra spaces around = signs
• Verify file encoding is UTF-8 without BOM