Installation¶
The Scyld Cloud Workstation server can be installed on the following operating systems:
CentOS 7 and 8
Ubuntu 16 and 18
Windows 7, 8, and 10
MacOS 10.13 (High Sierra), 10.14 (Mojave), and 10.15 (Catalina)
Required Files¶
Installation packages and documentation can be downloaded from: https://updates.penguincomputing.com/scw/download/. CentOS and RHEL users should add the repository as a YUM repo using the OS-specific instructions that follow.
Installation of the Scyld Cloud Workstation server requires the following files:
The Scyld Cloud Workstation server installation package for your operating system:
CentOS 7:
scyld-cloud-workstation-11.1.0-1.el7.x86_64.rpm
CentOS 8:
scyld-cloud-workstation-11.1.0-1.el8.x86_64.rpm
Ubuntu 16 and 18:
scyld-cloud-workstation_11.1.0-1_amd64.deb
Windows 7, 8 and 10:
Scyld Cloud Workstation-11.1.0.1.msi
MacOS 10.13, 10.14, and 10.15:
scyld-cloud-workstation-11.1.0.1.pkg
One of the following:
A trial license file (
scyld-cloud-workstation.lic
)A floating license file (
scyld-flexlm.lic
) and the license server (Scyld FlexLM).
Note
CentOS 7 and CentOS 8 customers who have a
scw-usb
feature in their license file will
also want to install kmod-usbip
and usbip-utils
packages.
Note
If you have an NVIDIA graphics card, download and install the appropriate NVIDIA drivers from http://www.nvidia.com/download/index.aspx
Installing the Server on CentOS 7¶
Follow the steps below to install Scyld Cloud Workstation, replace the default SSL key and certificate files, and install the license file. After a service restart, you should be able to sign in with standard OS credentials.
Use the
wget
command to install the Scyld Cloud Workstation YUM repository for CentOS 7.% sudo wget https://updates.penguincomputing.com/scw/scw-el7.repo -P /etc/yum.repos.d
Use the
yum install
command to installscyld-cloud-workstation
.% sudo yum install -y scyld-cloud-workstation
The installer does the following:
Installs Scyld Cloud Workstation files to
/opt/scyld-cloud-workstation
Installs scyld-cloud-workstation.service to
/lib/systemd/system/
Reloads the systemd manager configuration using
systemctl daemon-reload
Enables the unit file with
systemctl enable scyld-cloud-workstation.service
If your server has an SSL certificate file, open the configuration file (
/opt/scyld-cloud-workstation/bin/scyld-cloud-workstation.xml
) and set the value ofopenssl.server.privateKeyFile
andopenssl.server.certificateFile
to its path.Install the license.
If you have a trial license (
scyld-cloud-workstation.lic
), copy it into/opt/scyld-cloud-workstation/bin
.If you have a floating license (
scyld-flexlm.lic
), proceed to Flexera License Management for instructions on installing Scyld FlexLM.
Verify that your firewall rules allow traffic over HTTPS (port 443).
ONLY IF you have a
scw-usb
feature in your license file: use theyum
command to installkmod-usbip
andusbip-utils
. These packages are needed to enable USB forwarding.% sudo yum install -y kmod-usbip usbip-utils
Use the
systemctl restart
command to restart the service:% sudo systemctl restart scyld-cloud-workstation.service
Scyld Cloud Workstation should now be reachable over HTTPS at your server’s hostname or IP address. For advanced configuration options, please see Setup.
Updating the Server on CentOS 7¶
Use the
yum update
command to update an existing installation:% sudo yum update -y scyld-cloud-workstation
Use the
systemctl restart
command to restart the service:% sudo systemctl restart scyld-cloud-workstation.service
Installing the Server on CentOS 8¶
Follow the steps below to install Scyld Cloud Workstation, replace the default SSL key and certificate files, install the license file, and change your X server from XWayland to Xorg. After a service restart, you should be able to sign in with standard OS credentials.
Use the
wget
command to install the Scyld Cloud Workstation YUM repository for CentOS 8.% sudo wget https://updates.penguincomputing.com/scw/scw-el8.repo -P /etc/yum.repos.d
Use the
yum install
command to installscyld-cloud-workstation
.% sudo yum install -y scyld-cloud-workstation
The installer does the following:
Installs Scyld Cloud Workstation files to
/opt/scyld-cloud-workstation
Installs scyld-cloud-workstation.service to
/lib/systemd/system/
Reloads the systemd manager configuration using
systemctl daemon-reload
Enables the unit file with
systemctl enable scyld-cloud-workstation.service
If your server has an SSL certificate file, open the configuration file (
/opt/scyld-cloud-workstation/bin/scyld-cloud-workstation.xml
) and set the value ofopenssl.server.privateKeyFile
andopenssl.server.certificateFile
to its path.Install the license.
If you have a trial license (
scyld-cloud-workstation.lic
), copy it into/opt/scyld-cloud-workstation/bin
.If you have a floating license (
scyld-flexlm.lic
), proceed to Flexera License Management for instructions on installing Scyld FlexLM.
Verify that your firewall rules allow traffic over HTTPS (port 443).
ONLY IF you have a
scw-usb
feature in your license file: use theyum
command to installkmod-usbip
andusbip-utils
. These packages are needed to enable USB forwarding.% sudo yum install -y kmod-usbip usbip-utils
ONLY IF you are using XWayland as your X server (enabled by default in CentOS 8), enable Xorg by following these steps:
Open editor to open:
/etc/gdm/custom.conf
Look for the lines below:
[daemon] # Uncoment the line below to force the login screen to use Xorg #WaylandEnable=false
Uncomment (remove the ‘#’) preceeding the ‘WayLandEnable’ variable.
Save the file and reboot the system. The service will start after the reboot.
Use the
systemctl restart
command to restart the service:% sudo systemctl restart scyld-cloud-workstation.service
Scyld Cloud Workstation should now be reachable over HTTPS at your server’s hostname or IP address. For advanced configuration options, please see Setup.
Updating the Server on CentOS 8¶
Use the
yum update
command to update an existing installation:% sudo yum update -y scyld-cloud-workstation
Use the
systemctl restart
command to restart the service:% sudo systemctl restart scyld-cloud-workstation.service
Installing the Server on Windows¶
Note
For virt-manager users: virt-manager’s graphical console will no longer work after installing the NVIDIA GRID driver and restarting Windows.
To get the virt-manager graphical console to work again, start the Windows VM in ‘Safe Mode’ by restarting the VM, commanding it to “Force Off”, and restarting the VM again. Select “Safe Mode with Networking” from the menu that appears.
Download Scyld Cloud Workstation-11.1.0.1.msi from https://updates.penguincomputing.com/scw/download/
Double-click on the Scyld Cloud Workstation-11.1.0.1.msi installer.
Follow the instructions in the GUI. Confirm that you’d like to start Scyld Cloud Workstation as a service to have Scyld Cloud Workstation start automatically.
If your server has an SSL certificate file, open the configuration file (
C:\Program Files\Penguin Computing\Scyld Cloud Workstation\scyld-cloud-workstation.xml
) and set the value ofopenssl.server.privateKeyFile
andopenssl.server.certificateFile
to its path.Install the license.
If you have a trial license (
scyld-cloud-workstation.lic
), copy it intoC:\Program Files\Penguin Computing\Scyld Cloud Workstation
.If you have a floating license (
scyld-flexlm.lic
), proceed to Flexera License Management for instructions on installing Scyld FlexLM.
On some systems (such as those using virt-manager’s graphical console), a reboot may be required after installation to ensure that the NVIDIA GRID card is activated.
Scyld Cloud Workstation is intended to run automatically as a service in Windows. While it is possible to start it up as a normal application, Scyld Cloud Workstation must be run as a service in order to support:
Windows sign out and sign in
screensavers with passwords
Windows User Access Control
If Scyld Cloud Workstation is installed on a Windows VM, you may need to install Screen Capture Recorder to enable audio support. Screen Capture Recorder has been tested in Windows 10 and can be downloaded from the URL below:
Scyld Cloud Workstation should now be reachable over HTTPS at your server’s hostname or IP address. For advanced configuration options, please see Setup.
Updating the Server on Windows¶
Download Scyld Cloud Workstation-11.1.0.1.msi from https://updates.penguincomputing.com/scw/download/
Double-click on the Scyld Cloud Workstation-11.1.0.1.msi installer.
Follow the instructions in the GUI. Confirm that you’d like to start Scyld Cloud Workstation as a service to have Scyld Cloud Workstation start automatically.
Attention
We recommend using the latest config file as a starting point and moving changes from your old config file into the new one.
Important
If you are updating over an existing Scyld Cloud Workstation installation, your old config file will be preserved. The new package may include an XML config file with newer / updated settings. Merge the new settings found in
C:\Program Files\Penguin Computing\Scyld Cloud Workstation\Defaults\scyld-cloud-workstation.xml
with the existingC:\Program Files\Penguin Computing\Scyld Cloud Workstation\scyld-cloud-workstation.xml
file.
Installing the Server on Ubuntu 16 and 18¶
Follow the steps below to install Scyld Cloud Workstation, replace the default SSL key and certificate files, and install the license file. After a service restart, you should be able to sign in with standard OS credentials.
Download scyld-cloud-workstation_11.1.0-1_amd64.deb from https://updates.penguincomputing.com/scw/download/
Use the
dpkg -i
command to install the DEB:% sudo dpkg -i scyld-cloud-workstation_11.1.0-1_amd64.deb
The installer does the following:
Installs Scyld Cloud Workstation files to
/opt/scyld-cloud-workstation
.Installs scyld-cloud-workstation.service to
/lib/systemd/system/
.Reloads systemd manager configuration using
systemctl daemon-reload
Enables the unit file with
systemctl enable scyld-cloud-workstation.service
If your server has an SSL certificate file, open the configuration file (
/opt/scyld-cloud-workstation/bin/scyld-cloud-workstation.xml
) and set the value ofopenssl.server.privateKeyFile
andopenssl.server.certificateFile
to its path.Install the license.
If you have a trial license (
scyld-cloud-workstation.lic
), copy it into/opt/scyld-cloud-workstation/bin
.If you have a floating license (
scyld-flexlm.lic
), proceed to Flexera License Management for instructions on installing Scyld FlexLM.
Verify that your firewall rules allow traffic over HTTPS (port 443).
Use the
systemctl restart
command to restart the service:% sudo systemctl restart scyld-cloud-workstation.service
Important
Ubuntu 18 only: the lightdm desktop manager is
required in Ubuntu 18. Change the default gdm to lightdm by opening
a terminal and installing slick-greeter with sudo apt -y
install slick-greeter
. Finally, select lightdm
at the prompt.
Scyld Cloud Workstation should now be reachable over HTTPS at your server’s hostname or IP address. For advanced configuration options, please see Setup.
Updating the Server on Ubuntu 16 and 18¶
Download scyld-cloud-workstation_11.1.0-1_amd64.deb from https://updates.penguincomputing.com/scw/download/
Use the
dpkg -i
command to update the DEB:% sudo dpkg -i scyld-cloud-workstation_11.1.0-1_amd64.deb
The installer does the following:
Installs Scyld Cloud Workstation files to
/opt/scyld-cloud-workstation
.Installs scyld-cloud-workstation.service to
/lib/systemd/system/
.Reloads systemd manager configuration using
systemctl daemon-reload
Enables the unit file with
systemctl enable scyld-cloud-workstation.service
Use the
systemctl restart
command to restart the service:% sudo systemctl restart scyld-cloud-workstation.service
Installing the Server on MacOS¶
To install Scyld Cloud Workstation on your MacOS server:
Download and install scyld-cloud-workstation-11.1.0.1.pkg from https://updates.penguincomputing.com/scw/download/
MacOS Mojave and Catalina only: during installation, grant
Security and Privacy
permissions.Install the license file or the license server.
Install BlackHole for MacOS audio (Optional).
Start by double-clicking on the scyld-cloud-workstation-11.1.0.1.pkg
installer
and follow the GUI instructions.
MacOS Mojave and Catalina users will be shown several windows for granting “Security and Privacy” permissions. At each window, click on the Lock icon to allow changes, click on the checkbox next to the Scyld Cloud Workstation application, and then close the window.
In MacOS Mojave,
Microphone
andAccessibility
permissions must be granted.In MacOS Catalina,
Microphone
,Screen Recording
, andAccessibility
permissions must be granted.
Once installation and permissions setup is complete, install the license file or the license server.
If you’ve received a trial license file (named
scyld-cloud-workstation.lic
), copy that to/Applications/scyld-cloud-workstation.app/Contents/MacOS
.If you’ve received a floating license file (named
scyld-flexlm.lic
), you will need to install the Scyld FlexLM license server. For more information, see the license management guide: Flexera License Management.
Once the license file has been installed, the server will start automatically and be accessible with a web browser or our native client.
Important
Putting your remote MacOS server to sleep (for example:
by closing the lid of the laptop, selecting Sleep
from the
Apple menu, or scheduling sleeps through System Preferences >
Energy Saver
) will make Scyld Cloud Workstation inaccessible.
Important
Scyld Cloud Workstation prevents Display Sleep from happening in MacOS using an application called caffeinate. This is to prevent the server from going to sleep.
Next, proceed to Install BlackHole for MacOS Audio for information on adding audio support.
Install BlackHole for MacOS Audio¶
To add remote audio capture, perform the following steps on your Scyld Cloud Workstation MacOS server:
Download and install
BlackHole 0.2.9
from https://existential.audio/blackhole/.Open the
System Preferences > Sound > Output
window to makeBlackHole 16ch
the Sound Output device.MacOS Mojave and Catalina servers only: Add Scyld Cloud Workstation to the
Login Items
list for each MacOS user.Logout of MacOS and log back in.
Start by downloading BlackHole 0.2.9 from https://existential.audio/blackhole/ (note: you may be required to subscribe to their mail list) to your MacOS server. Double-click the installer and follow the GUI instructions.
Next, go to System Preferences > Sound > Output
and select
BlackHole 16ch
as the Sound Output device.
Note
Selecting BlackHole 16ch
will disable audio playback on
Internal Speakers
, but this can be changed back when necessary.
To change devices more easily, check the Show volume in menu bar
box. You can now click on the volume control and select one from
the Output Device list.
MacOS Mojave and Catalina servers only: Add Scyld Cloud Workstation to
the Login Items
list for each user by doing the following:
Go to
System Preferences > Users & Groups
.Click on your username in the list of accounts.
Select the
Login Items
tab.Click the Lock icon to make changes.
Click the
+
button to open a Finder window.Use the Finder window to go to
Applications
and addscyld-cloud-workstation
.When you are finished repeating the steps above for each remote user, log out of MacOS and log back in.
The steps above will make audio accessible to clients that connect to your Scyld Cloud Workstation MacOS server and click on the audio icon.
Note
More information about BlackHole can be found at: https://github.com/ExistentialAudio/BlackHole
Updating the Server on MacOS¶
Update instructions are slightly different between each version of MacOS due to differences in Apple Privacy Protection. Follow the instructions below for your version of MacOS.
Note
Updating Scyld Cloud Workstation on the server can’t be done over an ssh connection. As part of the installation the user must use “Security & Privacy” dialogs to confirm permissions for Audio access (‘Microphone’), Screen Recording access, and Keyboard/Mouse access (‘Accessibility’). Only some of these permissions will be required depending on your MacOS version. These need to be confirmed by the user and are only visible when the user has physical access or remote desktop access to the server using Apple Remote Desktop.
Updating on MacOS 10.13 High Sierra¶
Double-click the Scyld Cloud Workstation installer and follow the GUI instructions. The Scyld Cloud Workstation service will automatically restart with the updated server.
Updating on MacOS 10.14 Mojave¶
Accessibility permissions need to be granted again after installing a Scyld Cloud Workstation update on the server.
Open a terminal.
Reset Accessibility permissions by using the
tccutil
command:tccutil reset Accessibility
Double-click the Scyld Cloud Workstation installer and follow the GUI instructions.
The Scyld Cloud Workstation service will automatically restart with the updated software.
Updating on MacOS 10.15 Catalina¶
Accessibility permissions need to be granted again after installing a Scyld Cloud Workstation update on the server.
Open a terminal.
Reset the permissions for Scyld Cloud Workstation by using the
tccutil
command:tccutil reset com.penguincomputing.scyld-cloud-workstation
Double-click the Scyld Cloud Workstation installer and follow the GUI instructions
The Scyld Cloud Workstation service will automatically restart with the updated server.
Installing the Client¶
You can connect to Scyld Cloud Workstation by installing the native client, Scyld Cloud Workstation Client, or using any of these web browsers:
Chrome 59+
FireFox 56+
Internet Explorer 11+
Microsoft Edge Legacy 44.17763.1.0+
Microsoft Edge 79+
Safari 7+
The native client enables more features and enhanced performance. Native client installation packages for each OS can be downloaded from
Note
Chrome provides the best performance of all the web browsers.