The platform on which the LDM package is to be installed must be prepared in advance prior to unpacking and installing the LDM distribution.
rootThis is, necessarily, a system-dependent operation. Consult with your system's administrator, if necessary.
Keep the following in mind when creating the account:
ldm", but that's not a requirement./home/ldm" and "/home/ldm are viable candidates. Workshop-specific instructions.
If the computer on which the LDM runs has firewall (alias, packet filtering) rules, then these rules must be configured to allow connections to and from the LDM. How this is done is operating-system specific, so you might have to consult with your system or network administrator.
In order for the LDM system to send data to a
downstream LDM, the firewall rules must allow incoming
TCP connections to the port on which the LDM server
is listening (the default is 388). An example of ensuring this for firewall rules based on iptables(8) is
the command iptables -A INPUT -p tcp --dport 388 -j ACCEPT
Similarly, in order for the LDM to receive data from an upstream LDM, the firewall rules must allow outgoing TCP connections to the port on which the upstream LDM server is listening (the default is 388). Because most sites don't bother filtering outgoing connections, this configuration step is usually not necessary.
Workshop-specific instructions.
/etc/systemd/logind.conf exists and contains the parameter
RemoveIPC, then ensure that its value is no and that it's not
commented-out, i.e.,
RemoveIPC=no
Then execute the command
systemctl restart systemd-logind.
This is necessary to ensure that systemd(8) doesn't delete a shared-memory segment
that the LDM uses whenever the LDM user logs out (such as when a crontab(1) job
terminates, for example).
As the LDM user, add the following entries to the appropriate login profile-file of the LDM user's user-shell. The profile-file should be the one that the user-shell reads when it's a login shell (e.g., .bash_profile, .login).
| User Shell | Entries |
|---|---|
Standard (e.g. sh, ksh, bash) |
export PATH=$HOME/decoders:$HOME/util:$HOME/bin:$PATH |
csh-like (e.g. csh, tcsh) |
set path=($HOME/decoders $HOME/util $HOME/bin $path) |
SysManPath is the pathname for the manual-pages of the operating system (e.g., /usr/man or /usr/share/man). The MANPATH environment variable might already contain this path.
If necessary, modify the setting of the PATH environment variable above to ensure that the necessary build utilities can be found.
Don't forget to source the profile-file so that the modifications take effect. For example:
| User Shell | Command |
|---|---|
Standard (e.g. sh, ksh, bash) |
. .bash_profile |
csh-like (e.g. csh, tcsh) |
source .login |