Server Installation¶
The Scyld Cloud Workstation server can be installed on the following operating systems:
CentOS 7 and Rocky Linux 8
Windows 10, 11, and Windows Server 2019
MacOS Catalina 10.15 to Monterey 12
Ubuntu 20
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-12.1.0-1.el7.x86_64.rpm
Rocky Linux 8:
scyld-cloud-workstation-12.1.0-1.el8.x86_64.rpm
Ubuntu 20:
scyld-cloud-workstation_12.1.0.1-0ubuntu1.20_amd64.deb
Windows 10, 11, and Windows Server 2019:
Scyld Cloud Workstation-12.1.0.1.msi
MacOS Catalina 10.15 to Monterey 12:
scyld-cloud-workstation-12.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).
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’s domain has a trusted SSL certificate, 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. Using a trusted SSL certificate is recommended for maximum security.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
OPTIONAL: To enable USB Forwarding features, see Installing Server-USB Module on CentOS 7.
Scyld Cloud Workstation should now be reachable over HTTPS at your server’s hostname or IP address. For advanced configuration options, please see Setup.
Installing Server-USB Module on CentOS 7¶
USB devices can be forwarded between native clients and remote servers that meet the following requirements:
The server’s license file must have a valid ‘scw-usb’ entitlement. If you do not see this entitlement in your license file, please contact Penguin Computing sales for more information.
The Server-USB module must be installed on the remote server.
The Client-USB module must be installed on the client side. See Installing Client-USB Module on the Client for more information on this step.
To install the Server-USB modules on the remote server:
Use the
yum
command to installscyld-cloud-workstation-server-usb-module
.% sudo yum install -y scyld-cloud-workstation-server-usb-module
Use the
systemctl restart
command to restart the service:% sudo systemctl restart scyld-cloud-workstation.service
Installing the Server on Rocky Linux 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 Rocky Linux 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 you have a trusted SSL certificate for your server’s domain, 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. Using a trusted SSL certificate is recommended for maximum security.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 are using XWayland as your X server (enabled by default in Rocky Linux 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
OPTIONAL: To enable USB Forwarding features, see Installing Server-USB Module on Rocky Linux 8.
Scyld Cloud Workstation should now be reachable over HTTPS at your server’s hostname or IP address. For advanced configuration options, please see Setup.
Installing Server-USB Module on Rocky Linux 8¶
USB devices can be forwarded between native clients and remote servers that meet the following requirements:
The server’s license file must have a valid ‘scw-usb’ entitlement. If you do not see this entitlement in your license file, please contact Penguin Computing sales for more information.
The Server-USB module must be installed on the remote server.
The Client-USB module must be installed on the client side. See Installing Client-USB Module on the Client for more information on this step.
To install the Server-USB modules:
Use the
yum
command to installscyld-cloud-workstation-server-usb-module
.% sudo yum install -y scyld-cloud-workstation-server-usb-module
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-12.1.0.1.msi
from https://updates.penguincomputing.com/scw/download/Double-click on the
Scyld Cloud Workstation-12.1.0.1.msi
installer.Follow the instructions in the GUI.
If your server’s domain has a trusted SSL certificate, 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. Using a trusted SSL certificate is recommended for maximum security.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.
OPTIONAL: To enable USB Forwarding features, see Installing Server-USB Module on Windows.
Scyld Cloud Workstation should now be reachable over HTTPS at your server’s hostname or IP address. For advanced configuration options, please see Setup.
Installing Server-USB Module on Windows¶
USB devices can be forwarded between native clients and remote servers that meet the following requirements:
The server’s license file must have a valid ‘scw-usb’ entitlement. If you do not see this entitlement in your license file, please contact Penguin Computing sales for more information.
The Server-USB module must be installed on the remote server.
The Client-USB module must be installed on the client side. See Installing Client-USB Module on the Client for more information on this step.
To install the Server-USB modules on the remote server:
Download
Scyld Cloud Workstation Server USB Module-12.1.0.1.msi
from https://updates.penguincomputing.com/scw/download/Double-click on the
Scyld Cloud Workstation Server USB Module-12.1.0.1.msi
installer.Follow the instructions in the GUI.
Installing the Server on Ubuntu¶
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 the debian installer for your Ubuntu version from https://updates.penguincomputing.com/scw/download/
- Ubuntu 20:
scyld-cloud-workstation_12.1.0.1-0ubuntu1.20_amd64.deb
Use the
apt install
command to install the DEB file (adjust the file path if necessary):% ## Ubuntu 20 % sudo apt install ./scyld-cloud-workstation_12.1.0.1-0ubuntu1.20_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’s domain has a trusted SSL certificate, 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. Using a trusted SSL certificate is recommended for maximum security.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
OPTIONAL: To enable USB Forwarding features, see Installing Server-USB Module on Ubuntu.
Scyld Cloud Workstation should now be reachable over HTTPS at your server’s hostname or IP address. For advanced configuration options, please see Setup.
Installing Server-USB Module on Ubuntu¶
USB devices can be forwarded between native clients and remote servers that meet the following requirements:
The server’s license file must have a valid ‘scw-usb’ entitlement. If you do not see this entitlement in your license file, please contact Penguin Computing sales for more information.
The Server-USB module must be installed on the remote server.
The Client-USB module must be installed on the client side. See Installing Client-USB Module on the Client for more information on this step.
To install the Server-USB modules on the remote server:
Download the debian installer for your Ubuntu version from https://updates.penguincomputing.com/scw/download/
- Ubuntu 20:
scyld-cloud-workstation-server-usb-module_12.1.0.1-0ubuntu1.20_amd64.deb
Use the
apt install
command to update the DEB file (adjust the file path if necessary):% ## Ubuntu 20 % sudo apt install ./scyld-cloud-workstation-server-usb-module_12.1.0.1-0ubuntu1.20_amd64.deb
Use the
systemctl restart
command to restart the service:% sudo systemctl restart scyld-cloud-workstation.service
Installing the Server on MacOS¶
Download the
scyld-cloud-workstation-12.1.0.1.pkg
from https://updates.penguincomputing.com/scw/download/Double-click on
scyld-cloud-workstation-12.1.0.1.pkg
to launch the installer and follow the GUI instructions.MacOS Catalina and later: a series of “Security and Privacy” windows will appear for granting permissions to “Microphone”, “Accessibility”, and “Screen Recording”.
Perform the following for each “Security and Privacy” window:
Click on the Lock icon to allow changes
Click on the checkbox next to the Scyld Cloud Workstation application
Close the window
If your server’s domain has a trusted SSL certificate, open the configuration file (
/Applications/scyld-cloud-workstation.app/Contents/Resources/scyld-cloud-workstation.xml
) and set the value ofopenssl.server.privateKeyFile
andopenssl.server.certificateFile
to its path. Using a trusted SSL certificate is recommended for maximum security.Install the license.
If you have a trial license (
scyld-cloud-workstation.lic
), copy it into/Applications/scyld-cloud-workstation.app/Contents/Resources
.If you have a floating license (
scyld-flexlm.lic
), proceed to Flexera License Management for instructions on installing Scyld FlexLM.
Once the license file has been installed, the server will start automatically and be accessible with a web browser or our native client.
OPTIONAL: Proceed to Install BlackHole for MacOS Audio for information on adding audio support.
OPTIONAL: To enable USB Forwarding features, see Installing Server-USB Module on MacOS.
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.
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 Catalina and later: 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 Catalina and later: 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
Installing Server-USB Module on MacOS¶
USB devices can be forwarded between native clients and remote servers that meet the following requirements:
The server’s license file must have a valid ‘scw-usb’ entitlement. If you do not see this entitlement in your license file, please contact Penguin Computing sales for more information.
The Server-USB module must be installed on the remote server.
The Client-USB module must be installed on the client side. See Installing Client-USB Module on the Client for more information on this step.
To install the Server-USB modules on the remote server:
Download
scyld-cloud-workstation-server-usb-module-12.1.0.1.pkg
from https://updates.penguincomputing.com/scw/download/Double-click on the
scyld-cloud-workstation-server-usb-module-12.1.0.1.pkg
installer.Follow the instructions in the GUI.
Client Installation¶
Users can connect to the Scyld Cloud Workstation server using commonly available web browsers or the native client, Scyld Cloud Workstation Client. The native client is similar to the web browser in many ways, but it is also capable of faster video frame rates and additional features, such as:
USB Forwarding
Lossless and Visually Lossless Video
Scyld Cloud Workstation Client can be installed on the following operating systems:
CentOS 7 and Rocky Linux 8
Windows 10, 11, and Windows Server 2019
MacOS Catalina 10.15 to Monterey 12
Ubuntu 20
Web Browser Support¶
The following commonly available web browsers can be used to get fast access to Scyld Cloud Workstation servers:
Chrome 59+
FireFox 56+
Microsoft Edge Legacy 44.17763.1.0+
Microsoft Edge 79+
Safari 7+
Note
Chrome provides the best performance of all the web browsers.
Installing the Client¶
The native client is capable of additional features and faster video frame rates.
CentOS 7 users:
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-client
.% sudo yum install -y scyld-cloud-workstation-client
Rocky Linux 8 users:
Use the
wget
command to install the Scyld Cloud Workstation YUM repository for Rocky Linux 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-client
.% sudo yum install -y scyld-cloud-workstation-client
Windows, MacOS, and Ubuntu users: Download and install the Client installer for your OS from
Installing Client-USB Module on the Client¶
USB devices can be forwarded between native clients and remote servers that meet the following requirements:
The server’s license file must have a valid ‘scw-usb’ entitlement. If you do not see this entitlement in your license file, please contact Penguin Computing sales for more information.
The Server-USB module must be installed on the remote server.
The Client-USB module must be installed on the client side.
CentOS 7 users:
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-client-usb-module
.% sudo yum install -y scyld-cloud-workstation-client-usb-module
Rocky Linux 8 users:
Use the
wget
command to install the Scyld Cloud Workstation YUM repository for Rocky Linux 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-client-usb-module
.% sudo yum install -y scyld-cloud-workstation-client-usb-module
Windows, MacOS, and Ubuntu users: Download and install the Client-USB module installer for your OS from