File Name: Bluebeam-Revu-in-Citrix-Environment-2018.pdf
File Size: 248.87 KB
File Type: Application/pdf
Last Modified: 6 months
Status: Available
Last checked: 7 days ago!
This Document Has Been Certified by a Professional
100% customizable
Language: English
We recommend downloading this file onto your computer
Bluebeam Revu in aCitrix EnvironmentVersion 2018 Table of ContentsIntroduction .............................................................................................................................. 3Compatibility............................................................................................................................ 3Installation & Licensing ............................................................................................................ 3 Managing your Open and Enterprise Licenses ................................................................. 3 Persistent virtual desktops ................................................................................................... 4 Persistent virtual desktops created from a master image or template ......................... 4 Non-persistent virtual desktops ........................................................................................... 4 Published Applications ........................................................................................................ 5 Using Multiple Servers .......................................................................................................... 5 Frequent Server Reimaging ................................................................................................. 5 Restricting Access to View Mode Only .............................................................................. 5Files and Folders used by Revu .............................................................................................. 6 User Settings & Preferences (Reset Settings) ...................................................................... 6 Resetting the Revu settings .................................................................................................. 7 Log and Temporary Files...................................................................................................... 7 Recovery Files....................................................................................................................... 7 Sets Cached Files ................................................................................................................. 7 Bluebeam Studio™ File Caching ......................................................................................... 7Using the Bluebeam PDF printer and plugins......................................................................... 8 Published Desktop................................................................................................................ 8 Published Application .......................................................................................................... 8 Plugins for Microsoft Office .................................................................................................. 9 Enabling the PDF Printer ....................................................................................................... 9 Restricting Access to Markup Mode................................................................................... 9 Disabling Plugins for Microsoft Office for Non-Bluebeam Users ..................................... 10 1 Bluebeam® Revu (“Software”)© 2019 Bluebeam, Inc. All Rights Reserved
Patents Pending in the U.S. and/or other countries
Bluebeam® and Revu® are trademarks or registered trademarks of Bluebeam, Inc
All other trademarks or registered trademarks are the property of their respectiveowners
2 IntroductionThis guide contains information for IT Administrators, and assumes that the reader has afirm understanding of fundamental concepts, such as software installation, and Citrix®Administration. Its purpose is to provide guidance when configuring, using and licensingBluebeam® Revu® in different Citrix virtual environments
Further details about Revu installation, configuration and licensing can be found on theBluebeam Technical Support site
CompatibilityRevu 2018 is certified Citrix Ready® for XenApp 7.6 and XenDesktop® 7.15 LTSR, as well asXenDesktop 7.14, 7.16, 7.17, and 7.18, on Windows Server 2012 R2
The Revu.exe application is the only part of the Revu suite that is certified for installationin a Citrix environment. Other parts of the Revu suite can be used but are not officiallysupported
When Revu is used as part of a published desktop, all features – such as PDF creationusing the Bluebeam PDF printer and application plugins – operate and perform as theywould when installed on a physical system. In a published application environment,additional steps must be taken to enable and manage processes outside of the Revuapplication, such as PDF creation via the PDF printer and Office plugins
Note: Although some customers have successfully deployed and used Bluebeam Revu in other virtual environments – such as terminal services, VMware®, or Microsoft® App-V – these use cases are not officially supported
Please refer to the Revu Compatibility page for additional hardware and softwarerequirements
Installation & LicensingBecause Perpetual and Enterprise licenses are per-user and not concurrent licenses,Open Licensing is the recommended method for licensing in any virtual environment. Inorder to maintain compliance with the End User License Agreement (EULA), licensesneed to be purchased for all users who might have access to Revu
Note: The Enterprise and Open licenses require an active internet connection to allow communication with the Bluebeam license server
For more information on licensing, see our Licensing & Registration page
Managing your Open and Enterprise LicensesIn a Citrix environment, the Citrix administrator will install Revu on the server like anyother desktop, and then through Citrix tools, publish Revu as a shared application. Then,using Citrix tools, the administrator publishes Revu as a shared application. When a useraccesses Revu, mouse, keyboard, and graphics information is sent back and forth 3 between the virtual machine and the Citrix server. Because Revu is registered on theserver rather than on the individual environments, each installation uses one licenseseat. This means that all users who launch the application will be using the sameregistered copy of Revu
With an Enterprise License, Revu takes up one seat for each server it is installed on. If aserver with an Enterprise License is inactive for 15 days, the seat will automatically bereleased from the Citrix environment and made available once again
With an Open License, Revu is not actually registered on the server; it activates for theuser each time the application is launched. This means that the administrator doesn’tneed to audit, restrict number of authorized users, or manage the registration and un-registration process
Note: Open Licenses are only available in Revu eXtreme
In the cases of both Open and Enterprise licenses, only one seat of Revu is registered, socustomers should ensure there are as many seats on the license as users who accessthe shared copy of Revu
Persistent virtual desktopsIf you're planning to install Revu in a persistent virtual desktop environment, you'll beable to use any of the licensing models and manage the license like you would on aphysical machine. A Perpetual license will need to be manually released when thedesktop is de-commissioned
Persistent virtual desktops created from a master image or templateWhen the persistent virtual desktops are created from a master image or templatewhere Revu is already installed, the registration can be completed on the master usingthe Delayed Authorization option. This allows you to enter the serial number andproduct key when Revu is installed on the master, but the registration isn’t completeduntil Revu is run for the first time on a newly created desktop
Non-persistent virtual desktopsThe Open or Perpetual licenses are ideal for non-persistent set-ups. In theseenvironments, Revu is not registered on the virtual desktop’s master image. TheEnterprise license is usually not a good fit for these environments because a license willonly be released once it has been left inactive for 15 days
With an Open license, Revu will register its license automatically when it is launched
With a Perpetual license, the license will register when the user saves a document oruses a plugin. In the cases of both Open and Perpetual licenses, only one seat of Revuis registered, so customers must have as many seats on the license as users who will beaccessing the shared copy of Revu
4 Published ApplicationsPerpetual and Open licenses are supported in this environment
The Perpetual node-lock license is registered on the server and Revu is only registeredonce. All users are essentially using the same seat of Revu, so customers must ensurethere are as many seats on the license as users who will be accessing the shared copyof Revu
The Open license is recommended for this environment because licenses are checkedout when Revu is opened, then automatically released after the user closes Revu
Using Multiple ServersWhen Revu is installed on multiple servers, it must be registered separately on eachserver. Cloning a registered server links the licenses of the master with its clones;therefore, if one server is unregistered or revoked, that change is applied to all servers
There are two ways to avoid this:Install Revu as a trial by clicking the “Use as Trial” button in the “Bluebeam Registration”window at the end of the installation. If you are deploying using the MSI, omit the serialnumber and product key. Register Revu after cloning with a Bluebeam Administratorcommand line option. For details, see Migrating Multiple Revu Installations to a NewLicense, which describes the process
If you are installing using the MSI, include the “NoAuth” delayed authorization option
This lets you include the serial number and product key during the installation. However,the registration process is deferred until the first time Revu requires a license
Note: Open licensing is recommended for multiple-server environments as it eliminates the need to register each server, install Revu as a trial, and to use Delayed Authorization
Frequent Server ReimagingIf the Citrix server is frequently reimaged, register Revu on the master image and thenpush out the registered server image. The license won’t be affected (as in cloning),because the machine’s name remains the same
Restricting Access to View Mode OnlyThis setting is intended to allow administrators to restrict access to View Mode for someusers. The below registry key is not part of the Revu deployment process, but you canwrite a separate script or Group Policy to push this key per-user
5 Create a new registry key of type DWORD in "HKEY_CURRENT_USER\Software\BluebeamSoftware\
Set the value to an integer value of 1 and Revu will start in View mode. The option toswitch to markup mode is hidden, as well as the option to register/unregister. To allowthe user to switch to Markup Mode, either delete the registry key or set the value to 0
Files and Folders used by RevuAll the folders where Revu installs files are fixed; the Suite installer does not allow theinstall destination to change. Revu installs to these folders: Program Files\Bluebeam Software\Bluebeam Revu\2018\ Program Files (x86) \Bluebeam Software\Bluebeam Revu\2018\ Program Files\Common Files\Bluebeam Software\2018\ Program Files (x86)\Bluebeam Software\Bluebeam Revu\2018\ ProgramData\Bluebeam Software\Bluebeam Revu\2018\On a physical machine, Revu saves files in several locations that store customizations tothe Revu interface, custom tools, and cached files to improve performance andreduce internet bandwidth. Studio Projects stores the work-in-progress of checked outfiles
In a Citrix environment, these settings should be stored in a user's folder on the server toprovide a persistent environment for the user and so work will not be lost
User Settings & Preferences (Reset Settings)Profiles provide an easy way to store a user’s favorite toolbars, menus and other displaysettings within Revu. The Revu and user created tools sets store tools and symbols thatcan be used quickly
Profiles, configuration files, and the “Recents” list are stored in the following folder: %AppData%\Bluebeam Software\Revu\2018 or C:\Users\
Resetting the Revu settingsThe Revu settings can be reset back to the defaults. Revu will restore the original profilesand tool sets the next time it starts
• In a virtual desktop, users’ settings can be returned to the default using the Revu tab in the Bluebeam Administrator
• This can be done with in a virtual app environment by deleting or renaming the folder %AppData%\ Bluebeam Software\Revu. Custom tool sets and profiles can be backed up by copying them before they are deleted
Log and Temporary FilesRevu log and temporary files are written to a folder in the TEMP folder: %TEMP%\Bluebeam Software\ or C:\Users\
Sets Cached FilesRevu creates cached files for Sets thumbnails in the folder %TEMP%\BluebeamSoftware\Revu\. These files help improve performance and reduce network trafficwhen working with sets that include many files
Bluebeam Studio™ File CachingRevu saves network bandwidth and lets users work offline by storing copies of Projectand Session files in a persistent location within the user’s environment. These files needto be stored in a persistent location in the user’s environment so that they remainaccessible between Revu sessions
7 Sessions stores pending updates for offline files, and the markup information is uploadedto Studio the next time the user connects to Studio. Projects stores locally-savedchanges for checked-out files, which are uploaded to Studio when the server copy isupdated
Note: These cached files should not be removed until confirming that the user doesn’t have any Sessions with pending offline changes or checked-out Project files
Studio Sessions and Projects store files in the following location: %LocalAppData%\Bluebeam\ Example: C:\Users\
Note: Neither the Bluebeam PDF printer or the Bluebeam plugins for Microsoft Office are certified or officially supported; however, there are some users who are successfully using them in these environments
The Bluebeam PDF printer and plugins create temporary files during the creationprocess. The user must have permissions to these locations so PDFs can be created
Bluebeam PDF printer: %AllUsersProfile%\ Bluebeam Software\Print Jobs\ or C:\Users\All Users\Bluebeam Software\Print Jobs\Office plugins create files in the above folder and: %TEMP%\Bluebeam Software\Published DesktopWhen running Revu as part of a published desktop, all features – such as PDF creationand application plugins – operate and behave in the same way as when installed on aphysical system
Published ApplicationWhen running in a Citrix-published application environment, the Revu application(Revu.exe) is the only application in the Revu suite that is certified. Additional stepsneed to be taken to enable and manage processes outside of the Revu application,such as PDF creation via the Bluebeam PDF printer and plugins for Microsoft Office
8 Note: The CAD plugins are not supported in a published application environment
Plugins for Microsoft OfficeThe plugins for Word, Excel, PowerPoint and Outlook can be used in a published appenvironment if Office and Revu are both installed on the same server; however, theyare not officially supported
Enabling the PDF PrinterThe Bluebeam PDF printer and some versions of the plugins for Microsoft Office (seeabove) rely on the Print Monitor (BBPrint.exe), which is a separate application that’salways running in the background when Revu is installed on a desktop system. In apublished app environment, the BBPrint.exe application must be running as the userand available to the application using the printer or plugin
An instance of BBPrint can be started with the application by using a script to launchBBPrint and the application together, or BBPrint can be started using a login script
Starting BBPrint with the published applicationOne way is to start this process with a script when a user launches a publishedapplication. For example, point the command line for the published application (in thisexample, PowerPoint) to a .bat file containing commands to launch BBPrint.exe andthe application. Below are examples that show starting different versions PowerPointwith BBPrint.exe:Revu 2018 and PowerPoint 2016:start "PrintMon" "C:\Program Files\Bluebeam Software\Bluebeam Revu\2018\Revu\BBPrint.exe"start "PowerPoint" "C:\Program Files\Microsoft Office\Office16\PowerPnt.exe"Starting BBPrint in a Login ScriptAnother option is to start BBPrint.exe as part of a user's login script so that BBPrint,Bluebeam PDF printer and plugins are always available
Because there are numerous ways to configure and manage a server, there is no singleway that will work for every use case. These suggestions are meant to educate serveradministrators about how the printer and plugins work so you can implement the bestsolution for your environment
Note: In a published application environment, there will be instances of BBPrint.exe running for each logged in user
Restricting Access to Markup ModeTo set any or all of your users’ Revu installations to only enable View Mode (Revu 2018.1and above), create a new DWORD registry key called ViewModeOnly in"HKEY_CURRENT_USER\Software\Bluebeam Software\2018” and set the value to 1
9 When Revu launches in this state, the Markup Mode and Register/Unregister options inthe Revu menu will be hidden
Note: Setting the key Value to 0 or deleting it altogether enables the option for the user to enter Markup mode
Disabling Plugins for Microsoft Office for Non-Bluebeam UsersIf there are some Citrix users that should not have access to these plugins, they can bedisabled globally for those users to prevent them from loading the plugins. Blocking auser’s read access to the following registry keys will stop the plugins from loading
Revu 2018Office 32-bit Word: HKEY_LOCAL_MACHINE\SOFTWARE\Classes\WOW6432Node\CLSID\{A60EF190-192B-42CE- A5B3-40935DD42018}\ InprocServer32 Excel: HKEY_LOCAL_MACHINE\SOFTWARE\Classes\WOW6432Node\CLSID\{B5352C6B-5F84-4A81- A7F5-C63A83692018}\InprocServer32 PowerPoint: HKEY_LOCAL_MACHINE\SOFTWARE\Classes\WOW6432Node\CLSID\{26CE225D-AA52- 4337-B8D4-3089C0312018}\InprocServer32 Outlook: HKEY_LOCAL_MACHINE\SOFTWARE\Classes\WOW6432Node\CLSID\{D00818B2-EB9F-4D2C- 8F53-75413C9B2018}\InprocServer32Office 64-bit Word: HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{A60EF190-192B-42CE-A5B3- 40935DD42018}\ InprocServer32 Excel: HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{B5352C6B-5F84-4A81-A7F5- C63A83692018}\InprocServer32 PowerPoint: HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{26CE225D-AA52-4337-B8D4- 3089C0312018}\InprocServer32 Outlook: HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{D00818B2-EB9F-4D2C-8F53- 75413C9B2018}\InprocServer32 10
Server. Cloning a registered server links the licenses of the master with its clones; therefore, if one server is unregistered or revoked, that change is applied to all servers. There are two …
Its purpose is to provide guidance when configuring, using, and licensing Bluebeam Revu in a Citrix virtual environment. Further details about Revu installation, configuration, and licensing can be found on the Bluebeam Technical Support site. Revu 20 is certified Citrix Ready on Server 2016 R2.
Open and Enterprise licenses require an active internet connection to allow communication with the Bluebeam license server. For more information, see the Revu Licensing Guide. When deploying an Open License to your VDI environment, golden images do not need to be registered, but the licensing information still needs to be deployed.
The Revu.exe application is the only part of the Revu suite that is certified for installation in a Citrix environment. Other parts of the Revu suite can be used but aren’t officially supported.
In order to stay compliant with our EULA (End User License Agreement), each organization must purchase as many seats as there are Revu users in your organization. While it’s possible to deploy and use Revu in other virtual environments such as terminal services, VMWare, Windows RDS or Microsoft® App-V, these use cases are not officially supported.