synd program
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
|
On Windows, License Manager server runs as the synd service, synlm.
On UNIX, License Manager runs as the synd daemon.
Windows
License Manager server, synd, is a background process that runs on license servers and on machines that have local licensing. Synd runs as the service synlm. To start or stop License Manager server, you must have administrator privileges.
Options
synd [-h] [-q] [-r] [-rs] [-u] [-v] [-x]
-h
Display a list of synd options.
-q
Stop the synlm service.
-r
Register the synlm service.
-rs
Register the synlm service (if it is not already registered) and then start it.
-u username/password
Register synd with the specified username and password. Used with -r and -rs. If -u is not specified, the service runs using the local system account. If using clear text, separate the username and password with a forward slash. Optionally, you can run setruser -n and pass the encoded output. (See setruser utility.) The account can be on the local machine or it can be a domain controller account. If the latter, use either user_name@domain_name/password or domain_name\user_name/password. See Registering License Manager server to run as a specific user for more information.
-v
Display the synd version.
-x
Unregister the synlm service. If the service is running, -x will stop it and then unregister it.
Starting License Manager server automatically
License Manager server is started automatically when you install Synergy/DE Core Components.
Starting License Manager server manually
To start License Manager server manually, do either of the following. This will start the service synlm, which starts synd.
- In the Windows Services console, select Synergy/DE License Manager and click the Start button.
- At a command prompt enter
net start synlm
If you receive the error “Could not start the Synergy/DE License Manager service. The system could not find the file specified,” you should unregister and reregister the synlm service. After reregistering, try starting synlm again.
The License Manager service synlm always logs its version and start/stop time to the Windows application event log, which can be viewed with the Windows Event Viewer. For information on extended event logging for the synlm service, see Error logging. |
Stopping License Manager server
To stop (but not unregister) the synlm service, do one of the following:
- In the Windows Services console, select Synergy/DE License Manager and click the Stop button.
- At a command prompt enter
synd -q
- At a command prompt enter
net stop synlm
To stop and unregister the synlm service, at a command prompt enter
synd -x
Registering License Manager server to run as a specific user
By default, synd runs under the local system account. You can specify a different account using the -u option. The account used to run synd must have administrator privileges as well as the user right “Log on as a service.” Because License Manager server is registered and started automatically, you’ll need to stop and unregister the service, then reregister it with the -u option. For example,
synd -x synd -r -u username/password net start synlm
Optionally, you could register and start the service in one step by using -rs instead of -r.
Another way to specify the user account for a service is from the Windows Services console (which can be accessed from Control Panel > Administrative Tools > Services). Locate Synergy/DE License Manager in the list of services, right-click on it, and select Properties from the context menu. Go to the Log On tab and specify the account and password. Then click Apply. |
UNIX
The License Manager daemon, synd, is a background process that must be running in order for Synergy/DE products to run. It provides licensing and SEND/RECV message services to Synergy/DE products. It is initially started when you execute install.sde.
Options
When run with no options, synd starts the License Manager daemon.
synd [-bsize] [-h] [-p] [-q] [-v]
-bsize
Change the message queue buffer size. The default is 4096. Use -b if you SEND/RECV messages larger than 4096 bytes.
-h
Display a list of synd options.
-p
Ping the License Manager daemon to see if it is responding; also displays synd version.
-q
Stop the License Manager daemon. You must be UID=0 to do this.
-v
Display the synd version.
Starting License Manager automatically
To start License Manager automatically when the system reboots, add the full path name of synd to your system start-up file (e.g., rc or systemd [for help using systemd on Linux, see Synergex KnowledgeBase article 2522]). This ensures that synd will restart automatically if your system goes down. Consult your UNIX system administrator manual for more information about starting multi-user daemons.
Because synd needs to contact the Synergy License Web Service, you should ensure that all networking has been started (e.g., named, dnsmasq, networkmanager, winbindd, nmdb) before synd starts. |
For example, on some machines you might add this line to the /etc/rc file:
/usr/synergyde/lm/synd
Starting License Manager manually
To start License Manager manually, restart synd without rebooting or reinstalling. For example, on some machines you might enter
/usr/synergyde/lm/synd
Stopping License Manager
To stop License Manager, you must be UID=0. Use this command:
synd -q
Running License Manager as a non-root user
Synd is distributed with the setuid bit on and owned by root. If you do not want to run it as root, you can change the account that “owns” synd. The procedure for this varies, depending on how you intend to start synd. For a new installation, do this after the installation completes, and before you apply the install code.
We recommend that you set the SYNDLOG environment variable to a location that the non-root account has permission to write to, rather than relying on the default synd log location. Although a non-root user will be able to write to the synd log in the default location, if the logfile is ever deleted, a non-root user will not have authority to re-create it in the default location, and you’ll get a write access error on synd.log. |
Running synd as a specific, non-root user regardless of who starts it
This procedure ensures that synd always runs as a specific user regardless of who starts it. To do this, you’ll need to change the owner and set the setuid bit. If you start synd from a start-up file as described in Starting License Manager automatically, this method will ensure it starts as the correct user (otherwise it would start as root because the rc file runs as root).
1. | Stop synd: |
synd -q
2. | Change the owner of synd and lmu to the desired account. (We recommend you use the UNIX sudo command to ensure you have the necessary privileges.) |
sudo chown LicenseManagerAccount synd sudo chmod LicenseManagerAccount lmu
3. | Set the setuid bit for both synd and lmu. This ensures that synd starts as the correct user. |
sudo chmod u+s synd sudo chmod u+s lmu
4. | Run lmu without any options. You should see a registration string mismatch error and the license will be in forced expiration. |
5. | Apply your install code: |
- If this is a new installation (and you did not apply the install code before starting this procedure), apply the install code sent you by Synergex when you ordered the license; see Applying an install code. If the install code has expired (they are valid for 14 days), you’ll need to get a new one; see Obtaining an install code.
- If products were already registered on the system, get a new install code (see Obtaining an install code) and apply it (see Applying an install code).
6. | Run lmu again to ensure everything is working properly. |
Running synd as the non-root user who starts it
Follow this procedure if you want synd to run as the user who starts it. To do this, follow the instructions above, but replace step 3 with this:
3. Unset the setuid bit for both synd and lmu:
sudo chmod u-s synd sudo chmod u-s lmu