Knowledgebase
Configuration Options For Report Runner Viewer In Citrix and/or Terminal Server Environments
Posted by Jeff-Net Fan Support on 16 January 2014 07:12 AM

We allow a lot of customization of Report Runner Viewer using simple INI settings. In a Citrix/Terminal Server environment, you have many users accessing the same Viewer. For those environments, we have three completely different options to choose from and configure.

  1. Default directory-based Viewer using one settings file for everybody
  2. Default directory-based Viewer using user-specific settings
  3. Use the Enterprise edition of the Viewer which allows for a non-directory-based Viewer (requires an Infinity license)

Let's discuss in more detail each of the above options and how to configure them. Note, this is a high-level overview of some basic recommended settings. The truth is, you can customize just about anything on the Viewer you can imagine. If after reviewing these options and settings you still have needs, just let us know!

NOTE: These options apply only to Report Runner Viewer, not Report Runner Batch.

---

Option #1 - Default directory-based Viewer using one settings file for everybody

Use this option to configure the Viewer the same way for all users. That means everyone sees the same thing when they start the software. It also means no user-specific settings get saved when they exit the software.

Here are the recommended settings in JNRRV.INI under [Options] group:

  1. SaveINISettingsOnExit=0 (this prevents user-specific settings from saving and also disables option #2 below)
  2. SaveMultipleIDs=0 (disables option #2 below)
  3. SaveMultipleDSNDatabaseAndPaths=0 (disables option #2 below)

Here are the recommended settings in JNRRV.INI under [Standard Viewer] group:

  1. LastPath=C:\The default path and directory to start Viewer for everyone
  2. DefaultPath=C:\The default path and directory to start Viewer for everyone
  3. ID (clear out if you don't want a default login ID)
  4. PW (clear out if you don't want a default login password)
  5. DSN (clear out if you don't want a default DSN override)
  6. Database (clear out if you don't want a default Database override)

Again, there are many variations to configuring the Viewer. These are simply some basic settings and options. 

---

Option #2 - Default directory-based Viewer using user-specific settings

Use this option to allow user-based settings to be configured and saved each time the user runs the software. This option will make the user feel like they are the only person using the Viewer. The last directory they were in can be saved when they exit. The last ID/password they used can be saved when they exit. Email settings can be configured specifically for them.

Here are the recommended settings in JNRRV.INI under [Options] group:

  1. SaveINISettingsOnExit=1 (allows user-specific settings to be saved when used with next two settings on, too)
  2. SaveMultipleIDs=1 
  3. SaveMultipleDSNDatabaseAndPaths=1 
  4. SaveMultipleConfigFileInUsersMyDocuments=1 (this setting forces settings to be saved in user's "My Documents" folder)

With the above options on, when users exit the software, all of their settings are saved to a user-specific profile file (machine name and Windows ID) .INI file in the same data directory that JNRRV.INI is stored or in the users "My Documents" folder (if #4 above enabled). So if it's SJONES using a machine named DELL101, the file name would be DELL101_SJONES.INI.

NOTE: You can create/edit a template file called "jnrrv-multiuser-template.ini" that will be used for users without an existing user-based settings file. This template exists in the JNRRV.INI folder and will be used to clone the user-based settings file.

Inside that file, it may look like this...

[Settings]

ID=0010070010150011
Password=0004820005

DSNChecked=N
DSN=SQL-DFW-Rackspace
DatabaseChecked=N
Database=SQLDatabase

LastPath=C:\Whatever Last Path Was
HighPath=C:\Lock A User To A Directory
DefaultPath=C:\Always Start User In This Directory

We do not show any mail settings in this example, but if you configure mail settings for the user, those settings are stored in this user-based file as well. We have one other option to show you that can be manually set for any user.

TempExportsOnly=1

The setting above will allow users with this setting on to only export and view temp files. They can not change the output file and it defaults to a different temp file everytime for each user. It's a pretty cool feature. It also opens the file automatically after the export. The temp files will be generated to the Jeff-Net data folder under Report Runner Viewer\Temp directory. This directory is automatically cleaned up by the Viewer when the user exits the application. This option is great for companies where data security is important (like HIPPA requirements).

NOTE: User-based mail settings and default export folders will be saved to this file, too, as of version 2013.132.

Again, there are many variations to this configuration. Let us know your needs if this isn't working for you or you're having trouble getting your configuration just right.

A technical note for long time customers... many of the above options became available as of 2013.131 and 2013.132.

---

Option #3 - Use the Enterprise edition of the Viewer (requires an Infinity license)

The Enterprise edition of the Viewer allows for a non-directory based setup of the Viewer. You configure login IDs and password for users and assign reports to users using tags. This option requires at least the Viewer Infinity license. See this KB article for how to configure the Enterprise edition.

---

One last time (and we've mentioned it about four times now)... there are MANY variations to the above configurations. The Viewer can be configured to meet most any need you can imagine. If you have any questions or problems, just let us know, and we are happy to help you get the Viewer configured to meet your company's needs.

---

For reference, all settings available for user-based INI file:

[Settings]
NoSecurityChecked=Y
 
ID=
Password=
 
DSNChecked=N
DSN=
DatabaseChecked=N
Database=
 
LastPath=
'HighPath=
'DefaultPath=
 
TempExportsOnly=0
 
MailDelivery=
Server=
MailAccount=
MailName=
AuthenticationID=
AuthenticationPassword=
CC=
BCC=
UseFreeServer=