Install SVLive Agent macOS

Overview

This article covers the installation of the SVLive Agent macOS:

• Prerequisites
• Permissions
• Single Machine Installation
  • Step 1. Download the Package 
  • Step 2. Run the Installation Command 
  • Step 3. Enter Administrator Password 
  • Step 4. Verify Installation 
• Bulk Installation for IT Teams
  • Deployment Options
  • Option 1 - Remote Deployment via SSH
  • Option 2 - MDM Deployment (Jamf Pro)
  • Option 3 - Ansible Deployment 
  • Option 4 - Simple Network Deployment Script 
• Privacy Permissions (Important for IT Teams)
• IT/MDM Considerations
• No PPPC Profile Required
• Configuration File
• Verification
• Uninstall the SVLive Agent
• Enable Location Permission for SVLiveAgent

Prerequisites

• macOS 14 (Sonoma) or later 
• Administrator privileges (sudo access) 
• Configuration API endpoint URL from your organization 

Important Notes

• No configuration profile is required. Users must accept the Location Services prompt on first launch. Make sure you communicate this to end users as part of the rollout. 
• Restart of the machine is required after installation.

Permissions

• SVLiveAgent requires Location Services only for Wi-Fi network scanning. GPS coordinates are not collected; location permission is a macOS requirement for CoreWLAN Wi-Fi scanning. 
• Location Services is the only permission required. The app uses IOKit for idle detection and standard macOS APIs for system events; no Accessibility, Apple Events, Input Monitoring, or other TCC permissions are needed. 

Single Machine Installation

Bulk Installation for IT Teams

  #!/bin/bash     
          
    # Configuration     
    CONFIG_ENDPOINT="<your-config-endpoint-url>"     
    PKG_URL="<url-to-package-file>"     
    INSTALLER_URL="<url-to-installer-script>"     
    TEMP_DIR="/tmp/svliveagent-install"     
    PKG_FILENAME="<package-filename>.pkg"     
          
    # Create temporary directory     
    mkdir -p "$TEMP_DIR"     
    cd "$TEMP_DIR"     
          
    # Download package and installer     
    curl -L -o "$PKG_FILENAME" "$PKG_URL"     
    curl -L -o svliveagent-installer.sh "$INSTALLER_URL"     
          
    # Make installer executable     
    chmod +x svliveagent-installer.sh     
          
    # Run installation     
    sudo bash ./svliveagent-installer.sh PKGFILE="$PKG_FILENAME" CONFIGAPIADDRESS="$CONFIG_ENDPOINT"     
          
    # Cleanup     
    cd /     
    rm -rf "$TEMP_DIR"     
          
    echo ""     
    echo "If app doesn't appear in menu bar, restart the system:"     
    echo "  sudo shutdown -r now"  

# Deploy to specific hosts 
for host in <hostname1> <hostname2> <hostname3>; do 
    echo "Installing on $host..." 
    scp deploy-svliveagent.sh <username>@$host:/tmp/ 
    ssh <username>@$host "sudo bash /tmp/deploy-svliveagent.sh" 
done 

# Or deploy using host list file 
while read host; do 
    echo "Installing on $host..." 
    scp deploy-svliveagent.sh <username>@$host:/tmp/ 
    ssh <username>@$host "sudo bash /tmp/deploy-svliveagent.sh" 
done < hosts.txt 

    #!/bin/bash     
          
    # Jamf policy parameters     
    CONFIG_ENDPOINT="$4"   # e.g. https://your-config-endpoint/v1     
    PKG_URL="$5"           # URL to download the .pkg     
    INSTALLER_URL="$6"     # URL to download svliveagent-installer.sh     
    PKG_FILENAME="$7"      # Local filename, e.g. SVLiveAgent-macOS-3.5.4.pkg     
          
    TEMP_DIR="/tmp/svliveagent-install"     
    mkdir -p "$TEMP_DIR"     
    cd "$TEMP_DIR"     
          
    curl -L -f -o "$PKG_FILENAME" "$PKG_URL"     
    curl -L -f -o svliveagent-installer.sh "$INSTALLER_URL"     
    chmod +x svliveagent-installer.sh     
          
    bash ./svliveagent-installer.sh PKGFILE="$PKG_FILENAME" CONFIGAPIADDRESS="$CONFIG_ENDPOINT"     
          
    cd /     
    rm -rf "$TEMP_DIR"     
    exit 0   

name: Deploy SVLiveAgent to macOS machines 

  hosts: macos_clients 
  become: yes 
  vars: 
    config_endpoint: "<your-config-endpoint-url>" 
    pkg_url: "<url-to-package-file>" 
    pkg_filename: "<package-filename>.pkg" 
    installer_url: "<url-to-installer-script>" 
    temp_dir: "/tmp/svliveagent-install" 
   
  tasks: 

name: Create temporary directory 

      file: 
        path: "{{ temp_dir }}" 
        state: directory 
        mode: '0755' 
    
name: Download package 

      get_url: 
        url: "{{ pkg_url }}" 
        dest: "{{ temp_dir }}/{{ pkg_filename }}" 
        mode: '0644' 
   
name: Download installer script 

      get_url: 
        url: "{{ installer_url }}" 
        dest: "{{ temp_dir }}/svliveagent-installer.sh" 
        mode: '0755' 
     
name: Install PPPC profile 

      command: profiles install -path {{ temp_dir }}/SVLiveAgent-PPPC.mobileconfig 
      become: yes 
      ignore_errors: yes 
    
name: Run installer 

      command: > 
        bash {{ temp_dir }}/svliveagent-installer.sh 
        PKGFILE={{ pkg_filename }} 
        CONFIGAPIADDRESS="{{ config_endpoint }}" 
      args: 
        chdir: "{{ temp_dir }}" 
      become: yes 
     
name: Verify installation 

      command: pgrep -x SVLiveAgent 
      register: app_running 
      failed_when: app_running.rc > 1 
      changed_when: false 
     
name: Cleanup temporary directory 

      file: 
        path: "{{ temp_dir }}" 
        state: absent 
     
name: Report installation status 

      debug: 
        msg: "SVLiveAgent installed and running on {{ inventory_hostname }}" 
      when: app_running.rc == 0 
     
name: Notify if restart needed 

      debug: 
        msg: "App not running. System restart may be required on {{ inventory_hostname }}" 
      when: app_running.rc != 0 

    #!/bin/bash     
          
    # Configuration     
    NETWORK_PATH="<path-to-network-share>"     
    CONFIG_ENDPOINT="<your-config-endpoint-url>"     
    PKG_FILENAME="<package-filename>.pkg"     
          
    # Copy files locally     
    cp "$NETWORK_PATH/$PKG_FILENAME" /tmp/     
    cp "$NETWORK_PATH/svliveagent-installer.sh" /tmp/     
          
    # Install application     
    cd /tmp     
    chmod +x svliveagent-installer.sh     
    sudo bash ./svliveagent-installer.sh PKGFILE="$PKG_FILENAME" CONFIGAPIADDRESS="$CONFIG_ENDPOINT"     
          
    # Cleanup     
    rm -f /tmp/"$PKG_FILENAME" /tmp/svliveagent-installer.sh  

Privacy Permissions (Important for IT Teams)

SVLiveAgent requires one macOS privacy permission: 

IT / MDM Considerations

Apple restriction:

Location Services permission cannot be pre-approved or silently enabled via MDM or PPPC configuration profiles. 

 What IT can do: 

• Communicate to users that they must click Allow on the Location permission prompt. 
• Provide instructions for manually enabling permission if the prompt was dismissed. 

What IT cannot do: 

• Silently grant Location permission via configuration profiles. 
• Bypass the user consent requirement using PPPC.

Granting Location Permission (End User)

If the permission prompt was dismissed or denied: 

1. Open System Settings. 
2. Go to Privacy & Security > Location Services. 
3. Scroll to find SVLiveAgent. 
4. Enable the checkbox. 
5. The app will automatically detect the change (no restart needed). 

No PPPC Profile Required

 A previous version of this article included a PPPC profile with Location, Accessibility, and AppleEvents keys. That profile was invalid: 

   # List installed profiles     
    sudo profiles list | grep serraview     
          
    # Remove the old profile (use the identifier shown in profiles list)     
    sudo profiles remove -identifier com.serraview.sps.pppc-profile     
    sudo profiles remove -identifier com.serraview.sps.pppc   

Configuration File

Location 

/Library/Application Support/SVLiveAgent/sps.ini     

Format 

    [SPS]     
    config-endpoint=https://<your-config-endpoint>/v1     

The [SPS] section header is optional and the app reads config-endpoint regardless but the installer script writes this format automatically when you provide theCONFIGAPIADDRESS. 

Permissions 

    sudo chmod 644 "/Library/Application Support/SVLiveAgent/sps.ini"     
    sudo chown root:admin "/Library/Application Support/SVLiveAgent/sps.ini" 

Verification

Check if App is Running

pgrep -x SVLiveAgent     

If running, this returns the process ID. 

Check LaunchAgent Status 

launchctl list | grep com.serraview.sps

Verify Configuration 

cat "/Library/Application Support/SVLiveAgent/sps.ini"     

Check Application Location 

ls -la /Applications/SVLiveAgent.app     

Verify Location Permission 

Recommended: Use System Settings (Location Services is managed by locationd, not the standard TCC database): 

1. Open System Settings > Privacy & Security > Location Services. 
2. Confirm SVLiveAgent is listed and enabled. 

To reset Location permissions for testing (requires admin): 

tccutil reset Location com.serraview.sps     

Then restart the app and it will prompt for permission again. 

Check Logs 

  # LaunchAgent stdout/stderr     
    tail -f /tmp/svliveagent.log     
    tail -f /tmp/svliveagent.error.log     
          
    # Structured app log     
    tail -f ~/Library/Application\ Support/SVLiveAgent/SVLiveAgent.log  

Uninstall the SVLive Agent

To remove SVLiveAgent complete the following:

  # Stop the app     
    killall SVLiveAgent     
          
    # Unload LaunchAgent     
    launchctl bootout gui/$(id -u) /Library/LaunchAgents/com.serraview.sps.plist     
          
    # Remove files     
    sudo rm -rf /Applications/SVLiveAgent.app     
    sudo rm -f /Library/LaunchAgents/com.serraview.sps.plist     
    sudo rm -rf "/Library/Application Support/SVLiveAgent"     
          
    # Remove old PPPC profile if previously installed     
    sudo profiles remove -identifier com.serraview.sps.pppc-profile 2>/dev/null     
    sudo profiles remove -identifier com.serraview.sps.pppc 2>/dev/null     
          
    # Forget package receipt     
    sudo pkgutil --forget com.serraview.sps  

Enable Location Permission for SVLiveAgent

If user denies the permission, follow below instructions to enable location permission for SVLiveAgent.

1. Open Settings.
2. Go to Privacy & Security > Location Services.
3. Find "SVLiveAgent" in the list.
4. Enable Location Services.