This article explains how to set up a Mac as a GoodSync Control Center Runner.
Download the Control Center installer for Mac here: https://www.goodsync.com/download/goodsync-vsub-cc-runner-mac.sh
Navigate to https://jobs.goodsync.com and log in to your company.
Reference your Company ID in the Settings tab of your Control Center. The Company ID is required so the installer can connect this Mac to the correct Control Center company.
Open Terminal and navigate to the folder where the installer was downloaded. By default, this is usually the Downloads folder. The cd command can be used to move through your directory structure, and the ls command can be used to view the contents of your current location.
Once you are in the folder containing the installer, grant the installer execution permissions with the following command:
chmod +x goodsync-vsub-cc-runner-mac.sh
If the command is successful, there will be no result or message shown.
Next, run the installer to connect this Mac to the Control Center. There are two runner setup types:
- User: The Control Center Runner starts after the user logs in.
- Service: The Control Center Runner starts after the system boots and runs under the specified user context.
Example of user setup:
./goodsync-vsub-cc-runner-mac.sh /cc-runner=user /cc-coid=27224 /gs-userid=company-companyname-com /gs-pwd=YourGoodSyncPassword
Note: The user value in /cc-runner=user is not replaced with an actual username. For example, /cc-runner=john is incorrect.
Example of service setup:
sudo ./goodsync-vsub-cc-runner-mac.sh /cc-runner=service /cc-coid=27224 /sys-userid=testrunner /gs-userid=company-companyname-com /gs-pwd=YourGoodSyncPassword
When using /cc-runner=service, specify /sys-userid so the Runner service runs under the intended Mac user.
Parameters and Options
Mandatory parameters:
- /cc-coid=(number) Company ID in the GoodSync Control Center.
- /cc-runner=user|service Control Center Runner launch type. Use user to start the Runner after the user logs in. Use service to start the Runner after system boot under the specified user context. When using /cc-runner=service, specify /sys-userid.
Optional parameters:
Starting with Control Center 3.2+, new Runner installs must include /gs-userid and /gs-pwd. The GoodSync User ID can be found under the Administrators tab or at the top of the Account tab in the GoodSync account. Example: company-companyname-com.
- /cc-url=(string) Custom Job Server URL.
- /cc-allow-bad-certs Allow bad SSL certificates.
- /sys-userid=(string) System user ID. Related to /cc-runner=service. Defaults to the current user if not provided.
- /cc-copin=(string) Company PIN.
- /gs-userid=(string) GoodSync user ID. Requires /gs-pwd. Starting with Control Center 3.2+, this is required for new Runner installs.
- /gs-pwd=(string) GoodSync password. Required if /gs-userid is provided. Starting with Control Center 3.2+, this is required for new Runner installs.
- /cc-proxy=(string) Proxy. Can be in the format host or host:port.
- /cc-proxy-auth=(string) Proxy authentication. Can be in the format login:password.
- /cc-server-license Force server license.
- /? Display the installer help message.
Once setup is complete, navigate to the Runners tab in Control Center. The Mac should appear in the Runner list.
Click the checkbox under “Authorized,” then click “Actions > Authorize.”
You have now successfully connected a Mac computer to Control Center.
Troubleshooting
I installed the Runner, but it is not showing in Control Center.
If the install completes successfully but the Runner does not appear in Control Center, delete the enterprise-runner.tix file from the hidden /Users/YourUserAccount/.goodsync folder. Then, run the installer again.
Note: The period at the beginning of .goodsync means this is a hidden folder.
How can I tell if the Runner is active on the machine?
Runner logs are written to /Users/useraccount/.goodsync. If the Runner is active, you should see a current Runner log in this folder. Review the log to confirm activity and check for any errors.
You may also check if the process is running with the following command:
ps aux | grep gsync
If the Runner is active, it will produce output similar to the following:
How can I manually restart the Runner if the process is not running?
If the Runner has already been installed but is not active, use the following command to manually restart the Runner:
"/Users/useraccount/Library/Application Support/GoodSync/gsync" /runner-service=main-runner &