Installing Right Click Tools with Recast Management Server with Recast Proxy
Management Server Requirements
- Windows Server 2012R2 or later
- ASP.net 4.7
- .Net Core Hosting Bundle (The Recast Management Server will install this if it is not present, this should be installed after IIS)
- SQL Server Express or Enterprise SQL
Right Click Tools Requirements
- Windows Operating System
- ASP.net 4.7 or higher
- Functional ConfigMgr Client
Download the newest version of Recast Management Server, Right Click Tools, and Recast Proxy
You can download the latest installers for the Recast Management Server, Right Click Tools, and Recast Proxy by logging into the Recast Portal site at: https://portal.recastsoftware.com/
Installing Recast Management Server
Existing Lab / Kiosk Manager profiles, RCT Builder actions, and users and roles will not be automatically migrated to 4.x when upgrading from 3.x. Please schedule time with our team if you need help migrating those features.
You can download the latest installers for the Recast Management Server and Right Click Tools by logging into the Recast Portal site at: https://portal.recastsoftware.com/
Before beginning you should have IIS and ASP.NET 4.7 Installed. The Recast Management Server will help you install the appropriate version of the .Net Core Hosting Bundle. If you manage to install the .Net Core Hosting Bundle before IIS, you will need to repair the .Net Core Hosting Bundle after IIS installation.
You may need to restart the Recast Management Server IIS site in order for the web UI to be fully operational after installation. If you are not able to log into the Recast Management Server configuration page, try stopping and starting the Recast Management Server IIS site.
The first page in the wizard after accepting the EULA walks you through the server name and IIS port. You should only change the server name if the client is going to use a DNS alias. The server port can be changed to any open TCP port – 444 is the default to prevent conflicts when installing on ConfigMgr servers, but it can be changed to port 443 if it’s preferred in your environment.
Recast Management Server requires a certificate for secure communication with the Right Click Tools and any Recast Proxies. You have the option to generate a self-signed certificate or use an existing one. You should either use a web server certificate issued by a trusted internal Certificate Authority, or generate a self-signed certificate. The certificate can be changed later by editing the binding in IIS Manager.
Things to Note:
- The subject name or one of the subject alternative names of the certificate should match the server name in the URL that the Right Click Tools and Recast Proxies are pointed towards.
- The public key of self-signed certificates will need to be added to the Trusted Root Certificate Authorities store on your Recast Proxies
- Right Click Tools will prompt for untrusted certificates and add them to an allowed list. To avoid this prompt, import the public key of the Recast Management Server certificate into the Trusted Root Certificate Authorities store on the devices where the Right Click Tools are installed.
- Certificates can be changed later from IIS Manager.
Recast Management Server requires a SQL Server in version 4.0 or higher. This can be the free SQL Server Express version, or enterprise SQL. If the SQL Server is installed on a remote device, the computer account of Recast Management Server will need permissions to create the database on the remote device. Alternatively, you can pre-create the RecastManagementServer database and give the computer account db_owner permissions. If the SQL Server is installed on the local device, the computer account of the Recast Management Server will need permissions to create the database on the local device. You can precreate the database and give the IIS AppPool\Recast Management Server account db_owner permissions to the database. This account will not exist until after the installation is finished, so the permissions will need to be given after installation. The Test SQL Connection button will verify connectivity to the SQL Server during installation if the account running the installation has permissions to remotely connect.
Things to Note:
- If using a remote SQL Server, the computer account of the Recast Management Server needs to be given the db_owner role for the RecastManagementServer database.
- If using a local SQL Server, the IIS AppPool\Recast Management Server account needs to be given the db_owner role for the RecastManagementServer database.
- The IIS AppPool\Recast Management Server account will not exist until after the installation completes.
- The default SQL Server Port Number is 1433
- For more information on SQL permissions, see Troubleshooting - SQL Server Configuration
Licenses can be downloaded during your Recast Management Server installation by entering your Recast Portal email address and password and clicking Download License. The license information should show up in the right pane if the retrieval was successful. If your server does not have interenet access you can use the Browse for License button to browse the filesystem for a license file that has been exported from Portal.
After clicking next the install will continue.
Install Recast Service Account Proxy
The installer will then bring you to the Service Account Proxy installation screen.
If you choose to install the Service Account proxy you should enter the Service account Domain, Username, and Password.
The Service Account must be a Local Administrator on the computer on which you are installing the Proxy for the Proxy to function correctly.
If you choose not to install the proxy, you can click the box that says "Do Not Install Recast Proxy"
The installation will continue and finish with this dialog box. For information on how to configure routes for the proxy check the configuration section below.
When the installation is complete, verify that you are able to open the Recast Management Server by navigating to https://ServerFQDN:Port in a web browser. Chrome, Edge, or Firefox are recommended. You will receive an authentication window asking you to sign in. Enter the username and password for the account that you were using to install the Recast management Server. A correctly configured Recast Management Server should look similar to the below screenshot.
If you do not see a screen like the one above, please check out the troubleshooting section of our documentation Troubleshooting
To make sure that authentication is working correctly, you should add a user at this time. Add the user name that you are currently logged in as by entering it in the name field and clicking search. The user names will appear below and can be checked to add. Click the add button and verify that the user is added correctly to the Management Server. After adding the user click Edit to the right and add the Administrator role to the user you just created.
Installing Right Click Tools
Now that you have the Management Server Installed Successfully, you should continue with the Right Click Tools installation on the ConfigMgr Console of your choice. Close all open ConfigMgr consoles on your chosen computer. Then double click on the installer .msi to install. The installer will open and you should click "Next" to continue.
In the screen that follows select the Recast RCT Enterprise with Recast Server version.
You can optionally select add RCT Builder to all console nodes. This will add RCT Builder to all the nodes in the ConfigMgr console. You can also select to Skip in console permissions checks all tools will appear as if they are available to you, even if you are not granted access in the Recast Management Server. If you try to access something that you do not have permission to, the action will fail with the error "Invalid Recast Permissions."
At the next screen you should enter the name of the computer that contains the Recast Management Server as well as the port that you specified earlier for communication (default is 444). Click on the "Test Connection" button and make sure that it returns success. If it is not successful you should troubleshoot the connection error before continuing with the installation, your Right Click Tools installation will not connect with your Recast Management Server correctly if the result is something other than success.
The install will continue, and when it is finished, this screen will appear.
Verify Right Click Tools
To verify that Right Click Tools is installed correctly and is connecting to the Recast Management Server successfully, you should open the ConfigMgr console on the device where you installed Right Click Tools.
Click the Recast Software node on the left hand side of the screen, and the "Welcome to Right Click Tools" screen should appear. On the right hand side of this window it will show the Server Installed Version which should match the version of the Recast Management Server that you installed. It will also show the Remote Server Status, which should show as "Connected" which means that your Right Click Tools and Recast Management Server are communicating with each other successfully.
The silent installation command for the Right Click Tools is as follows:
- msiexec /i "Recast Enterprise Desktop Tools.msi" /qn RCTENTERPRISESERVER=https://(servername)
- Replace (servername) with the Recast Enterprise Server name. Be sure to include the port if the IIS site is bound to something other than 443.
For example: msiexec /i "Recast Enterprise Desktop Tools.msi" /qn RCTENTERPRISESERVER=https://recast.demo.local:444
Installing Standalone Recast Proxy
The Recast Proxy installer should be run on the appropriate computer for your Proxy setup. Click here for more information about Recast Proxy.
Click Next to start the Proxy installation
On the following screen enter the information for your Recast Management Server including the server name and port that was configured earlier. Click the Test Connection box to make sure that the Proxy can communicate with the Management Server. If the test fails the issue blocking communication should be remediated before moving forward. If the error is not remediated your Proxy will be unable to connect to the server when the communication is complete.
In the next window you can select the settings for the proxy. You can select either Service Account Proxy or Device Proxy. If you choose Service Account Proxy, you will have the opportunity to add the user that you would like the proxy to use. You must click Test Login in order to continue.
If you choose Device proxy, you can continue by clicking install
The install will notify you that it has completed.
Authorize in Management Server
After your install is complete, you should return to the Recast Management Server to authorize the proxy. Click Proxies on the left hand side of the management page, and you will see your proxy has been added with its authorization state as "False."
Click on Edit to authorize your Proxy. In the box that opens click the box under Authorized and the click the Save button to save your changes.
When you save, the authorization for the proxy you added should be changed to "True."
Configure Service Account Proxy to Run All Actions in your Environment
In order to configure the Proxy to run all Right Click Tools actions in your environment, you need to create a route using the proxy and move it to the top of the routes in the Recast Management Server
You will first need to create the route by going to the routes tab and clicking create. Enter the proxy information in the resulting dialog box.
After clicking Create, you will need to drag the new route to the top of the list, so that actions will be run through this route by default. Be sure to click save before leaving this page.
Your Recast Management Server, Right Click Tools, and Recast Proxy should now be successfully configured for use. Click Here for more documentation specific to the Recast Management Server.