Overview
The installation of RightLink 10 consists of a statically compiled Go binary with supporting binaries, scripts, and configuration files. System configuration files are also updated to allow RightLink to function within the operating system. Details of the installation is below.
Linux
- Starting with 10.1.rc0, RightLink runs as the
rightlink
user.useraddis used to create therightlink
user and group. - Installing RightLink 10 for RCA-V includes additional networking scripts and configuration files. View the Advanced Networking for vSphere (Files/Linux section) document for details.
- Enabling
Managed Login
includes other files specific to that feature. View the Managed SSH Login document to see that list.
The following items are created or updated upon the installation of RightLink 10 on Linux:
| Filepath | Format | Purpose |
|---|---|---|
| /var/lib/rightscale-identity | bash-style VAR=value assignments | Provide information for RightLink to connect to the RightScale platform. This file is created through cloud-init or the rightlink.enable.sh script with root only permissions. |
| /var/lib/rightlink | directory | Directory to store data files. Created with rightlink write-only permissions. |
| /var/run/rightlink | directory | Run-time variable data directory. Created with rightlink only permissions. |
| /var/run/rightlink/secret | bash-style VAR=value assignments | Provide local/proxy secrets to other scripts/programs running on the instance, such as rsc. This file is created with rightlink only permissions. |
| /var/run/rightlink/state | JSON | Stores state information about RightLink. |
| /var/spool/rightlink | directory | Directory to store attachments, cookbooks, scripts (code). Created with rightlink only permissions. |
| /usr/local/bin/rightlink | Binary | RightLink executable |
| /usr/local/bin/rsc | Binary | RightScale API client executable |
| /var/log/rightlink.log | Log file | RightLink installation log. Created with root-only permissions. |
| /var/log/upstart/rightlink.log journalctl -u rightlink |
Log file | The rightlinkprocess logs to standard output. This log is also duplicated in the Server's audit entries as an entry named named RightLink 10 <version> log pid <process pid>. Each init system captures standard out differently. For Upstart, see /var/log/upstart/rightlink.log. For Systemd, use journalctl -u rightlink. |
| /etc/init/rightlink.conf /etc/init.d/rightlink /etc/systemd/system/rightlink.service |
Service config files | Service config files |
| /etc/cron.d/rightlink-upgrade | crontab | Created by RL10 Linux Upgrade base ServerTemplate script to periodically upgrade RightLink |
| /home/rightlink | Home directory | Default $HOME dir for RightScript executions. |
| /etc/sudoers | Sudo config | Update to include configuration files in /etc/sudoers.d/ directory, 90-rightscale is located. |
| /etc/sudoers.d/90-rightscale | Sudo config | Sudo configuration for the rightlink (rightlink service) user. Default configuration provides unrestricted sudo permission. |
Windows
- Starting with 10.2.1, user runs under a configurable account which defaults to an Administrative account named
RightLink
. - Installing RightLink 10 for RCA-V includes additional networking scripts and configuration files. View the Advanced Networking for vSphere (Files/Windows section) document for details.
The following items are installed upon the installation of RightLink 10 on Windows:
| Filepath | Format | Purpose |
|---|---|---|
| C:\ProgramData\RightScale\RightLink | directory | Run-time variable data directory |
| C:\ProgramData\RightScale\RightLink\rightscale-identity | VAR=value assignments | Provide information for RightLink to connect to the RightScale platform. This file is created through the Ec2ConfigService or rightlink.enable.ps1 script. The values are fed into the NSSM service. |
| C:\ProgramData\RightScale\RightLink\secret | VAR=value assignments | Provide local/proxy secrets to other scripts/programs running on the instance, such as rsc.exe. This file is created with rightlink only permissions. |
| C:\ProgramData\RightScale\RightLink\state | JSON | Stores state information about RightLink. |
Temp dir for RightLinkuser |
directory | Directory to store attachments, cookbooks, scripts (code). |
| C:\Program Files\RightScale\RightLink | directory | Install directory for binaries, Powershell scripts, and logs |
| C:\Program Files\RightScale\RightLink\nssm.exe | Binary | Non-Sucking Service Manager, used to manage the RightLink service. |
| C:\Program Files\RightScale\RightLink\rightlink.exe | Binary | RightLink executable |
| C:\Program Files\RightScale\RightLink\rsc.exe | Binary | RightScale API client executable |
| C:\Program Files\RightScale\RightLink\userdata-fetcher.ps1 | Powershell script | The equivalent of cloud-init for windows. Runs at startup to fetch userdata containing RightScale instance credentials from the cloud |
| C:\Program Files\RightScale\RightLink\Logs\install.log | Log file | RightLink install log. |
| C:\Program Files\RightScale\RightLink\Logs\userdata-fetcher.log | Log file | Userdata fetcher script logs to here. |
| C:\Program Files\RightScale\RightLink\Logs\rightlink.log | Log file | RightLink program log. |
| Scheduled task | Scheduled task | Created by RL10 Windows Upgrade base ServerTemplate script to periodically upgrade RightLink |
| C:\Users\Rightlink | Home directory | Home dir for the RightLinkuser, selected or created at installation time |
| RightLink | Windows service | Runs rightlink executable (rightlink.exe) |
| RightLinkUserData | Windows service | Fetches userdata by calling userdata-fetcher.ps1, then start RightLink service |