3. Mac: Installation and startup
3.1 Getting started with the menu bar app
The Mac version is distributed as a DMG. Copy the app into your Applications folder before use.
After installation, treat the menu bar icon (top-right of the screen, or open the app from Launchpad so the icon appears there) as your main place for day-to-day tasks. From its menu you can:
- Start / stop / restart the service
- See status
- Open the log folder or web console at
http://localhost:8089 - Install or remove a LaunchAgent
Sync work runs in a background service. You can rely on the menu bar app—you do not need the command line for normal use.
3.2 Background service and file locations
This section is for troubleshooting or IT staff who need the on-disk layout. Installation may require administrator rights (sudo).
- Binary:
/Library/Application Support/HandbookXAggregationTool/handbookx_aggregation_tool - Working directory: The Application Support folder above (base path for DB and app logs)
- Stdout / stderr:
.../HandbookXAggregationTool/logs/stdout.logandstderr.log
After installation, verify:
http://localhost:8089/api/ping
You should see a response such as Handbook X Content Aggregation Tool is running.
Database and application logs
The local database handbookXSync.db and daily application logs are created under the service working directory (the install path above). If you back up or delete files, consider the impact on sync state with Coordinator.
Uninstall (general outline)
Follow your distributor’s procedure. It commonly includes:
- Stop and unload the service
- Remove
com.asteria.handbookx.aggregationtool.plist - Remove
/Library/Application Support/HandbookXAggregationTool