Enabling Configuration Logging in Citrix XenApp 6.5

In most any enterprise environment there will be more than one administrator who will perform configuration changes in a XenApp 6.5 farm. Whenever issues arise due to changes being made in a farm, it can be beneficial to know what administrator made which specific change, and when that change was made. By identifying the modification that was made, you can perform a rollback, by undoing that change. In XenApp 6.5 there is a feature called Configuration Logging, which will help track changes that each administrator has made. In this blog post we will look at how to enable, configure and manage this feature.


1. Creating the Configuration Logging Database


Before you can enable Configuration Logging, you will have to create the Configuration Logging Database. Below is the procedure on how to create this Database in SQL Server 2008 R2 and SQL Server 2012. Oracle databases are also supported, if you prefer to use Oracle.

1.1 Open SQL Server Management Studio console. Click Start → All Programs → Microsoft SQL Server 2008 R2 → SQL Server Management Studio

1.2 Provide credentials for a Database Engine Services Administrator, choose the correct server, and click connect.

Right-click Databases, and select New Database

1.4 Enter a database name. You can also set the Initial Size and Autogrowth for both Primary Filegroup and the log file, if you like. I’m just keeping the default settings.

1.5 Click Ok, and the database will be created.

1.6 Expand Security, then right-click Logins and choose New Login

1.7 Click on Search, then choose the user account you want to use for authentication to the database. Remember to choose a domain account.

1.8 The designated user only needs to be a member of the Domain Users group. Its the database permissions the user has, that are important. We will set the database permissions in the next step. Also, make sure the Default database for this user is the database you created in step 1.4

1.9 Next click on User Mapping, and make the selections I have made. Make the chosen user account db_owner of the XenAppCL database, then change Default Schema to dbo by using the browse button(s).

1.10 Finally click on OK.


2. Configuring and Enabling Configuration Logging

Once you have created the database, you need to enable the Configuration Logging feature in AppCenter.

2.1 Right-click the Farm name → Farm Properties

2.2 Select the Configuration Logging node, then click Configure Database

2.3 Specify the name of the SQL Server, then enter credentials for the user you defined in step 1.7. Finally, click Next.

2.4 Specify the appropriate database, click Next

2.5 Disable the Use encryption option, since we are not using encryption. Click Next

2.6 Test Database Connection

2.7 If the test is successful, click Finish.

After clicking finish, you will be back at the Farm Properties page. Here you can set different properties for Configuration Logging

Log administrative tasks to Configuration Logging database – This will enable Configuration Logging for the farm.

Allow changes to the farm when logging database is disconnected – If there is no connection to the logging database, administrators are still able to make changes. Obviously, these changes will not be logged.

Require administrators to enter database credentials before clearing the log – For security purposes, you can enable this option, in which case, no one can clear the log, unless they provide database credentials first.


3. Managing reports generated by Configuration Logging

Everything related to reports will be administered on the History node in AppCenter.

3.1 To specify certain criteria for the report, you can filter by different item types, date, user accounts and so on. Click on Set filter, and then define a filter if you like.

3.2 To run a report, right-click History → Get log

3.3 To save an existing configuration log in to a XML file, right-click History → Save log

3.4 To clear the log, right-click History → Clear history

Additional Resources
Logging Administrative Changes to a XenApp Farm

1 Comment

  1. Yogesh Dandwate

    Very good and helpful document.

    Thanks a Lot….

Comments are closed.