Authored ByAlison Yates
This article explains what to do if you have problems launching OpticStudio, and will help you get your OpticStudio installation running smoothly.
- OpticStudio requests a license code
- Nothing happens when launching OpticStudio
- OpticStudio hangs at splash screen on startup
- OpticStudio is unable to find a license key
- OpticStudio requires the .NET Framework
- OpticStudio has stopped working or immediately launches the Zemax File Collector
- Getting help
This article is organized by error message or issue that may arise in an OpticStudio installation. Please navigate to the section relevant to the issue you are experiencing to find steps to resolve the issue. If the issue persists, the Getting Help section covers support contact.
The first time you run OpticStudio, you may be prompted for a license code as shown below.
If you see this dialog box, your copy of OpticStudio is correctly installed, and the USB key is working properly. You just need a license code to allow this version of OpticStudio to run with your key. To request a license code, refer to How to request an Opticstudio license code.
If you have no error and nothing is displayed when launching Opticstudio, this is normally due to missing Windows components that OpticStudio requires to run. In order to correct this, you will need to check your Windows version and Windows updates. To do this:
- Ensure that your Windows version is supported, as per the OpticStudio system requirements page. Note that Windows XP and Vista are not supported for any OpticStudio version.
- Check for Windows Updates on your PC.
- Install all available updates, including optional updates. Optional hardware device driver updates and updates to Microsoft software applications (such as Bing and Skype) are not necessary.
If you do not want to install all Windows updates, you can manually install the minimum updates OpticStudio requires from the list below.
|Windows version||Update instructions|
Windows Server 2008 R2
Windows Server 2012 R2
Note: Windows 8.0 is not supported by OpticStudio 16.5 Sp1 or higher. All users of 8.0 can get a free update to 8.1.
Once your system has all the required updates above, try and open OpticStudio again. If it still fails to launch, Move to Reinstalling the Visual C redistributables.
|Windows 10||Windows 10 already contains all required updates, though the Anniversary Update or later (also known as version 1607 or build 14393) is recommended. This link tells how to verify if you have the Anniversary Update installed. Move to Reinstalling the Visual C redistributables.|
This is usually easily resolved by going into Control Panel...Programs and Features (Windows 7) or Settings....Apps (Windows 10). <Right-click> on each of the redistributable packages, select Change then Repair.
- For OpticStudio 16 through 17, you only need to verify the 2010, 2012 and 2015 redistributables.
- For Opticstudio 17.5 and higher, check and repair the 2010, 2012 and 2017 Redistributables.
If you don't see the appropriate Redistributable versions, they can be downloaded from the links below.
- Visual C++ 2010 redistributable package for either 32-bit OS or Visual C++ 2010 redistributable package for 64-bit OS
- Visual C++ 2012 redistributable package for 32-bit and 64-bit
- Visual C++ 2015 redistributable package for 64-bit
- Visual C++ 2017 redistributable package for 64-bit
If you are still unable to launch OpticStudio, skip to the "Getting help" section.
If you get an error saying "Cannot find Zemax Key" there are some steps you can take, depending on the type of license you have. If you are unsure of your license type, see "Identify your OpticStudio license." Use the below table to identify reference resources for Single User licenses, hosted on your machine.
|Single User license type||Resource|
Black USB License
|Troubleshooting license issues with a Black USB license|
Single User Softkey License
|How to troubleshoot Softkey license issues|
Red USB License & Green USB License
|How to troubleshoot red or green USB license issues|
If you are trying to reach a network server that uses a Black USB network key, refer to the "Client troubleshooting" section of "Installing OpticStudio with a Black USB network hardkey."
If you are trying to reach a network server that uses a network softkey license or Red USB network license, refer to "How to install the network license version of OpticStudio."
OpticStudio requires that the Windows .NET Framework be properly installed. Normally, OpticStudio automatically downloads the required version of the .NET Framework from Microsoft during installation, but errors can occur during the installation. If the .NET Framework has not been proply installed or needs to be repaired, you will receive the following error. As of OpticStudio 16.5 SP1, a minimum of .NET 4.6.2 is required.
To correct this error, first ensure that your computer meets the minimum requirements for .NET installation. To summarize them:
- Windows 7: .NET 4.6.2 requires Service Pack 1 to be installed. Note that the install of OpticStudio 16.5 and higher will fail before beginning without SP1 installed.
- Windows 8.0: .NET 4.6.2 and higher is not supported on Windows 8.0. You must upgrade to Windows 8.1. This also means 8.1 is required for OpticStudio 16.5 SP1 or higher.
- Windows 10: is recommended to have the Anniversary Update or later installed (also known as version 1607 or build 14393) This link tells how to verify you have the Anniversary Update installed. Microsoft .NET 4.6.2 comes with the Anniversary Update. If you have an older Windows 10 release, you can install the .NET frame work separately from the link below.
Next, once you have verified your system has the minimum requirements, install the .NET 4.6.2 version that does not require Internet access here.
If you are still unable to launch OpticStudio, or get .NET to install, skip to the "Getting help" section.
If you encounter an error message when launching OpticStudio that contains "stopped working" or a similar error, this is usually due to missing or corrupt Windows components required to run OpticStudio. In 18.7 and higher, a crash will automatically open the Zemax File Collector utility to allow you to report the crash to us for assistance. Before submitting a crash report, there are some steps to take.
The first step in resolving the above error is to reinstall and verify the OpticStudio Prerequisites Package. To do this:
- If you have internet access, proceed to Step 2. If you do not have internet access, download the appropriate Microsoft .NET framework, as described above. You can obtain Microsoft .NET 4.6.2 here.
- Launch the OpticStudio_Prerequisites.exe file that is located in your OpticStudio installation folder. The default install folder is C:\Program Files\Zemax OpticStudio.
- After clicking on this executable, you will see a progress box as it installs. The prerequisite installer will perform a reinstall of most components. It will skip any that it finds already exist on the machine and close automatically when done.
- Once the installation has completed, try to launch OpticStudio again.
- If OpticStudio does not launch properly, you can verify that all the most important components have been installed. One of the most common errors is with the Microsoft Visual C++ Redistributable packages not properly installing, even though they show up in the list of installed programs. To fix this, follow the instructions outlined in the "Reinstalling the Visual C redistributables" section.
- Try and Launch OpticStudio again. If you still have troubles, move to the "Getting help" section.
This section applies if, after launching OpticStudio, the application hangs at the below picture and it never moves past it. Normally once OpticStudio has located a license, you will see your OpticStudio edition (Standard, Professional, or Premium) appear at the bottom right. This is a good indicator that OpticStudio is launching properly.
If you do not see the edition appear on the splash screen, something is likely blocking OpticStudio from launching properly. This issue has been known to happen due to antivirus software blocking the licensing process OpticStudio needs to run.
If you have something other than Mcafee Enterprise antivirus/security software, check to see if it has blocked any files at the time you launched OpticStudio. The most common files are anything with "HASP" in the name (e.g. "hasp_RT.exe or hasplms.exe") or files in the OpticStudio installation folder (by default: C:\Program Files\Zemax OpticStudio). If you are unable to find any blocks in the antivirus move to the "Getting help" section.
If your organization uses Mcafee Enterprise, the "Host Intrusion Prevention System" feature may be the cause. To verify if this is the case and work around the issue, you can temporarily turn off HIPS. Note that HIPS is re-enabled upon restart of the computer, so this is not a permanent fix. To perform this action:
- <Right-click> the Mcafee icon in the system tray (normally a red shield with an M in the center)
- Under Disable, select Disable HIPS Protection.
- Try and launch OpticStudio.
- If it launches properly, ask your IT department to whitelist (mark as safe) the "C:\Program Files\Zemax OpticStudio\hasp_rt.exe" process in Mcafee's administrator console.
If this does not fix the issue, proceed to the "Getting help" section.
If your installation issue is not resolved, please email firstname.lastname@example.org. If you have OpticStudio 18.7 or higher, you will have the Zemax File Collector come up if Opticstudio crashes. This tool gathers most of the relevant information needed to help with your issue. For help using it, see How to report a problem or possible bug to Zemax Support.
Otherwise, please send us the following:
- Screen shots or description of any error messages or the behavior you encounter.
- A summary of any troubleshooting steps you have already taken
- If using a USB key, let us know if the key lights up.
- Your license key number (red and green USB licenses and softkeys are in the format L100000. Black USB licenses have a 5 digit number like 22000 engraved on them.)
This will provide us with all the information we'll need to quickly diagnose the problem, or escalate as needed.
The above article described troubleshooting steps for several common issues that can arise in OpticStudio installations. For more assistance, please refer to the reference articles, or contact Zemax Support.
If you can launch OpticStudio but need to report a crash or bug, see "How to report a problem or possible bug to Zemax Support."
If you experience slow response in graphics windows while running OpticStudio, see "Troubleshooting UI issues in OpticStudio."
If you experience black (or blank) windows within OpticStudio, see "What to do if the graphics windows in OpticStudio are black or blank."