How to install the OpenGL Software Accelerator for XenApp/XenDesktop 7.x

How to install the OpenGL Software Accelerator for XenApp/XenDesktop 7.x

book

Article ID: CTX201359

calendar_today

Updated On:

Description

To show Citrix administrator how to install the OpenGL Software Accelerator discussed in our edocs


 


Instructions

Important: The OpenGL Software Accelerator is provided "as is" and must be tested with all applications. It might not work with some applications and is intended as a solution to try if the Windows OpenGL rasterizer does not provide adequate performance. If the OpenGL Software Accelerator works with your applications, it can be used as a way to avoid the cost of GPU hardware.

The following steps need to be done on machine you wish to enable OpenGL Software Acceleration on.

WARNING: The steps requires required to enable OpenGLSoftware Acceleration require replacing existing Windows System files. So please remeber to backup any of the files before renaming or replacing them.

1. From the root of the XenApp/XenDesktop 7.x install media browse to the Support folder.
2. From here open the OpenGL_Software_Accelerator folder.
3.Copy the OpenGLAccelerator.zip file to the machines desktop you wish to install OpenGL Software Acceleration on.
4. Extract the contents of the OpenGLAccelerator.zip file to a folder on the machines desktop.
the OpenGLAcclerator.zip which contains the following:
  • Install.pdf
  • 32 folder (includes opengl32.dll for 32-bit machines)
  • 64 folder (includes opengl32.dll for 64-bit machines)
gl

The next steps depend on whether this is being done on a 32-bit machine or a 64-bit machine.

On 32-bit systems:

1. Backup the OpenGL binary opengl32.dll in the Windows\System32 folder.
2. Copy the Citrix OpenGL binary (opengl32.dll)  from the 32 folder (32-bit) into the Windows\System32 folder.
3. Restart the machine.

On 64-bit systems:

1. Backup the OpenGL binary opengl32.dll in the Windows\System32 folder.
2. Copy the Citrix OpenGL binary (opengl32.dll) from the 64 folder (64-bit) into the Windows\System32 folder.
3. Backup the OpenGl binary opengl32.dll in the windows\SysWow64 folder.
4. Copy the Citrix OpenGL binary (opengl32.dll) from the 32 folder (32-bit) into the Windows\SysWow64 folder.
5. Restart the machine.

Citrix will now use OpenGL Software Acceleration.

If you are unable to rename the Windows opengl32.dll file you may need to do the following:

You may need to do the following in the Windows OS in order to replace these files.

1. Log on to the machine with the windows default Administrator account. If this is the first time, it may take a few minutes for the Operating system to rearrange your desktop.

2. Open Windows Explorer, go to the Windows\System32 folder, and browse to the opengl32.dll file.
 a. Go to the PROPERTIES of the file, then the SECURITY tab, then click the ADVANCED button.
 b. Click on the OWNER tab, then the EDIT button, under "Change Owner to" section click the OTHER USERS OR GROUPS button.
 c. Type the name Administrator , then click the FIND NOW button. Select the Administrator the account (be careful to select administrator and not administrators), Click APPLY, then the OK button.
 
 gl2

gl5


3. Now close the File Properties window and reopen it for the opengl32.dll file, then go to the SECURITY tab , and click the EDIT button, then the ADD button and again enter Administrator as the name you want to add then click OK button.

4. Set the permissions for the Administrator account to FULL CONTROL , click the APPLY button then click the OK button.

gl4

Now you can rename the files. (it is recommended to back them up instead of renaming or deleting the files)

NOTE: These steps are also included in the install.pdf file included in the OpenGLAccelerator.zip file. The install.pdf mentions an activate administrator account command that is not necessary.

Citrix Documentation
OpenGL Software Acclerator

Environment

This software application is provided to you as is with no representations, warranties or conditions of any kind. You may use and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that: (a) the software application may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software application fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software application. In no event should the software application be used to support ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SOFTWARE APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the software application.