Skip to main content

Installing the Integration Connector Agent

Integration Connector agents act as secure bridges between ServiceOps and third-party applications like Active Directory, enabling seamless integration without requiring direct connectivity.

The Integration Connector is a dedicated application that executes ServiceOps actions on on-premise or cloud platforms, providing secure integration capabilities for LDAP authentication, Active Directory operations, and workflow automation. This guide provides step-by-step instructions for installing Integration Connector agents on supported platforms.

Prerequisites​

Before installing Integration Connector agents, ensure your system meets the following requirements:

System Requirements​

Windows Systems

  • Operating System: Windows 8 and above versions
  • Architecture: 32-bit and 64-bit supported
  • Dependencies:
    • .NET version 3.5 and above
    • Microsoft Visual C++ 2015 and above

Linux Systems

  • Supported Distributions: Ubuntu, RedHat, and other Linux distributions
  • Permissions: Root access required
  • Dependencies: sudo must be installed

Required Information​

You'll need the following information from your ServiceOps portal:

  • ServiceOps Server URL: Your ServiceOps portal URL
  • Basic Authorization Token: Available in Integration Connector Credential Profile
  • Protocol: HTTP or HTTPS (depending on your configuration)
  • Port: 80 for HTTP, 443 for HTTPS

Pre-Installation Requirements​

  1. Java Environment: Java should not be pre-installed (fresh system without existing Java applications)
  2. Network Connectivity: Active Internet connectivity to the Main Server for on-premise applications
  3. SSL Certificate: Valid SSL certificate required for secure communication
  4. Credential Profile: Create or use existing Integration Connector Credential Profile
note
  • The Integration Connector is supported from version 8.6.1 onward
  • Compatible with both Windows and Linux systems
  • Supports deployment on On-Premise and SaaS platforms
  • If the Integration Connector is used to connect with on-premise applications, it must have active Internet connectivity to the Main Server

Key Features and Capabilities​

Integration Functionalities

  • LDAP User Authentication: For login authentication
  • LDAP-based User Import: Bulk user import from Active Directory
  • Active Directory Operations: Create, enable, disable, and update AD users with Workflow
  • Active Directory Self-service: Perform self-service operations in SaaS portal

Deployment Options

  • On-Premise Deployment: For internal network integration
  • SaaS Deployment: For cloud-based integration
  • Web-based UI: Remote management and troubleshooting capabilities

Installation Methods​

ServiceOps provides multiple options for installing Integration Connector agents. Choose the method that best suits your environment:

Windows Integration Connector Installation​

Step 1: Download the Agent​

  1. Navigate to the Download Links section in your ServiceOps documentation
  2. Download the latest Windows Integration Connector (.msi) file
  3. Choose the appropriate version for your system

Step 2: Run the Installation​

  1. Run the .msi file with administrator rights
  2. The User Access Control popup will appear - click Yes to continue
  3. Follow the installation wizard

Step 3: Configure Connection Settings​

  1. Click Next to proceed with the installation
  2. Enter the following details:
    • Protocol: Select HTTP or HTTPS
    • Motadata Server URL: Enter the ServiceOps URL
      • For HTTP: Enter the IP Address
      • For HTTPS: Enter the domain URL
    • Port: Specify the port number (80 for HTTP, 443 for HTTPS)
    • Storage Path: Displays the default path, which can be modified if needed
    • Token: Enter the Basic Authorization token from Integration Connector Credential Profile

For HTTP

For HTTPS

Step 4: Select Installation Folder​

  1. Browse and select the folder where you want to install the Integration Connector
  2. Click Next to continue

Step 5: Complete Installation​

  1. Click Install to begin the installation process
  2. Wait for the installation to complete
  3. Click Finish when the wizard completes

Step 6: Verify Installation​

  1. Check that the Integration Connector appears in Programs and Features
  2. Verify the connector appears in the Integration Connector List in your ServiceOps portal

Post-Installation Verification​

Check Agent Status

  1. Windows: Check Services app for the Integration Connector service
  2. Linux: Use systemctl status integration-connector.service
  3. Portal Registration: Verify the connector appears in the Integration Connector List

Verify Integration Functionality

  1. Test LDAP Connection: Verify LDAP authentication works correctly
  2. Test AD Operations: Verify Active Directory operations function properly
  3. Check Logs: Monitor Integration Connector logs for any issues

Portal Verification

  1. Log into your ServiceOps portal
  2. Navigate to Admin > Automation > Integrations > Integration Connector
  3. Verify your connector appears in the Integration Connector List tab
  4. Check that the connector status shows as "Online"

Troubleshooting Common Issues​

Installation Issues
  • Problem: Permission denied during installation
  • Solution: Ensure you're running with appropriate permissions (admin/root)
Connection Issues
  • Problem: Integration Connector cannot connect to ServiceOps server
  • Solution: Verify URL, port, and network connectivity
Authentication Issues
  • Problem: Invalid Basic Authorization token
  • Solution: Double-check the token from Integration Connector Credential Profile
Java Issues
  • Problem: Java conflicts during installation
  • Solution: Ensure no Java is pre-installed on the system
Network Issues
  • Problem: Connectivity issues with on-premise applications
  • Solution: Verify Internet connectivity to the Main Server using ping command

Uninstallation​

Windows Uninstallation

  1. Use Programs and Features to uninstall
  2. Or use the command line: msiexec /x [integration-connector-msi-file] /quiet

Linux Uninstallation

# Stop the Integration Connector service
systemctl stop integration-connector.service

# Navigate to the flotomate folder
cd /opt/flotomate/

# Remove the Integration Connector folder
rm -rf integration-connector

# Navigate to the system folder
cd /etc/systemd/system/

# Remove the Integration Connector service
rm -rf integration-connector.service

# Verify uninstallation
cd /opt/flotomate/
# Check that the integration-connector folder is not found

Configuration Best Practices​

Network Configuration
  • Ensure Integration Connector can communicate with the ServiceOps server
  • Configure appropriate firewall rules for integration communication
  • Use HTTPS for secure communication when possible
Security Considerations
  • Keep Basic Authorization tokens confidential
  • Regularly update Integration Connector to match your ServiceOps version
  • Monitor Integration Connector logs for security issues
  • Use strong authentication methods
Performance Optimization
  • Deploy Integration Connector during low-usage periods
  • Monitor system resources during integration operations
  • Configure appropriate connection timeouts

Integration Connector Management​

Credential Profile Management
  1. Create Credential Profiles: Set up custom credentials for different integration scenarios
  2. Manage Tokens: Generate and manage Basic Authorization tokens
  3. Audit Activities: Track all connector-related activities
Log Management
  1. Request Logs: Request connector logs from the portal
  2. View Logs: Access real-time log information
  3. Download Logs: Download logs as ZIP files for analysis
Connector Operations
  1. Search and Filter: Find specific connectors using search and filter options
  2. Bulk Operations: Archive or delete multiple connectors
  3. Status Monitoring: Monitor connector health and status

Next Steps​

After successfully installing the Integration Connector:

  1. Configure Credential Profiles: Set up authentication credentials
  2. Test Integrations: Verify LDAP and Active Directory connections
  3. Set Up Workflows: Configure workflow-based integrations
  4. Monitor Performance: Track integration performance and logs
  5. Deploy Additional Connectors: Install connectors on other systems as needed