Won't Launch - Uninstall/Reinstall steps - ROES Server
Won’t Launch: Uninstall and Reinstall Steps - ROES Server
Use this article when ROES Server will not launch and a clean uninstall/reinstall is needed to remove damaged or leftover local installation files.
Overview
If ROES Server fails to launch, a clean uninstall and reinstall may be required. This process removes the installed ROES Server application and clears leftover ROES folders from ProgramData, Program Files, the user profile, and the Windows temporary folder before reinstalling from the lab’s ROES Server install link.
Symptoms
- ROES Server does not launch after installation or update.
- The ROES Server MSI installer prompts to modify or remove the existing installation.
- Windows may report that it cannot remove the current ROES Server installation.
- A reinstall does not resolve the launch issue until old ROES files are removed.
Before You Begin
- These steps are intended for Windows workstations unless otherwise noted.
- Use an account with permission to uninstall software and delete files from ProgramData, Program Files, and the user profile.
- Replace USERNAME with the affected Windows user account name.
- Replace <SERVERNAME> with what is usually the lab name and used in the ROES Server launch URL.
Solution
Uninstall ROES Server
Use the ROES Server MSI installer dialog to remove the application, or uninstall it from Windows Programs and Features.
Show hidden and protected files
Open Windows Explorer, then enable the folder options needed to see all ROES files that may need to be removed.
- Right-click the Windows logo button and choose Open Windows Explorer.
- Select Organize or View, then open Options.
- Choose Folder and Search Options or Change Folder and Search Options.
- Open the View tab.
- Select Show hidden files, folders and drives.
- Uncheck Hide protected operating system files.
- Uncheck Hide extensions for known file types.
Delete ROES files from ProgramData
Go to the following folder and delete its contents:
Delete ROES files from Program Files
Go to the ROES application folder and delete its contents. Depending on the workstation, the folder may be in either location:
C:\Program Files (x86)\ROES
Delete ROES files from the user profile
Go to the affected user’s roaming application data folder and delete the ROES contents:
Remove RWSCleanup temporary files
Open the user’s Windows Temp folder and delete any files that start with RWSCleanup, including RWSCleanup.dll, RWSCleanup.InstallState, and related RWSCleanup files.
Reinstall ROES Server
Reinstall ROES Server using the lab’s install link. The launch URL will be similar to one of the following and could be the lab name followed by _RS or SA or SAS:
MAC: http://www.roeslaunch.com/ROES/SAServer/labs/<SERVERNAME>/launch.dmg
Important Cleanup Note
Only delete the ROES-related files and folders listed in this article. If the workstation contains other lab-specific files or custom configuration data, confirm with support before removing additional folders.
Expected Result
After the old installation files are removed and ROES Server is reinstalled from the lab’s launch link, ROES Server should launch normally.
Escalation Notes
If ROES Server still does not launch after the clean reinstall, continue with the additional troubleshooting steps in Article 38.
- Confirm the exact ROES Server install link used.
- Confirm whether the workstation is Windows or macOS.
- Record any Windows uninstall, installer, or launch error messages.
- Confirm whether the folders listed above were present and removed.
- Collect screenshots of any error dialog that appears during uninstall, reinstall, or launch.