Citrix App Orchestration provides a completely new way to manage complex multi-tenant, multi-farm deployments. Let’s face it; App Orchestration does lots of neat stuff. As with any product that provides this amount of functionality, customers can run into problems. Some problems have obvious solutions, while others are more elusive. This post will cover some of the problems reported by users and some issues that we have seen internally that may cause customers some confusion. For all of the issues, we offer tips on how to troubleshoot the problems and ultimately solve them.

Before starting, ensure that you have consulted the Citrix App Studio Quick Deployment Guide and performed all of the prerequisite steps. Here is a link to the Quick Deployment Guide:

/blogs/2012/03/29/citrix-app-studio-quick-deployment-guide/

Installation

Here are some things to check if you have any problems installing Citrix App Studio:

  • Ensure that you are running on a supported operating system. The App Orchestration components support Windows 2008 R2.
  • Ensure that you are installing the product using an account that has administrator privileges on the local machine. To ensure that you can access the App Orchestration components from any machine in your domain, the account should be a domain administrator account.
  • Before installing, ensure the media is in a directory located on the local machine.
  • If any components fail to install, you can try running the package manually from the Packages folder on the media. If the install fails, you can get a log file by running the following command from a command prompt:
    • PACKAGENAME.msi /l*v install.log

Server Configuration

Troubleshooting Server Configuration tool issues is sometimes a tricky endeavor. Here are some things to check if you are having trouble:

  • Ensure that you using an account that has administrator privileges on the local machine. To ensure that you can access the App Orchestration components from any machine in your domain, the account should be a domain administrator account.
  • If the database server cannot be accessed, ensure that the firewall on the SQL Server machine is configured to allow SQL communication. Also, ensure that SQL Native Authentication is enabled and that the SQL logon account is enabled.
  • If server configuration cannot access the XenApp DVD image, ensure that it is located on a share with write permission granted to the logged on user.

Getting Detailed Information

There is currently no way to see failure details within the Server Configuration tool user interface. If you run into a problem, you can run DebugView from the SysInternals Suite to see what is going on. The SysInternals Suite can be found here:

http://technet.microsoft.com/en-us/sysinternals/bb842062

Perform the following steps to get DebugView configured:

  1. Run DebugView (dbgview.exe) as an administrator (DebugView must run elevated to allow capturing of all system events).
  2. Ensure the following items are enabled in the Capture menu:
    1. Capture Win32
    2. Capture Global Win32
    3. Pass-Through
    4. Capture Events

When you click the “Configure” button in server configuration, you will now see all sorts of messages displaying in DebugView. If server configuration fails, you turn off capturing in DebugView and scroll back and see the failure. If the reason for the failure is not obvious, you can submit this info to the App Orchestration forum to get help.

Preparing for Re-Install

Because server configuration is a multi-step process, some failures may put the machine into a state that disallows running the server configuration a second time. Here is a list of steps you can perform to restore the machine to a clean state:

  1. Close all running apps.
  2. Uninstall all Citrix App Studio and Citrix App Orchestration components using Programs and Features in Control Panel.
  3. From the command line, run iisreset.exe.
  4. Open Internet Information Services (IIS) Manager and perform the following steps:
    • Delete the “cam” folder located under the “Sites->Default Web Site” folder.
    • Navigate to “Sites->Default Web Site” and click “View Applications” in the Actions Pane.
    • Delete the following applications:
    • /cam/console
    • /cam/v1
  5. Navigate to “Sites->Default Web Site” and click “View Virtual Directories”.
  6. Delete the virtual directory “Root Application” that has the virtual path of “/cam”.
  7. Navigate to “Application Pools”.
  8. Delete the “CitrixCAMAppPool” application pool.
  9. Open Registry Editor and perform the following steps:
    • Navigate to “HKEY_LOCAL_MACHINE->SOFTWARE->Citrix.
    • Delete the CloudAppManagement key.
  10. From the command line, run iisreset.exe.

At this point you will be able to re-install and configure Citrix App Studio on the machine.

Problems with Self-Signed SSL Certificates

If you are using SSL, you may discover that App Orchestration will not let you select a wildcard certificate during server configuration. This is a known issue in the server configuration tool. You may be tempted to use a self-signed certificate, but this won’t work unless you manually bind the certificate to the IIS site and add it to the “Trusted Publishers” certificate store on all agent machines.

The recommended approach is to use a normal certificate issued by your certificate server or a trusted provider such as VeriSign.

Here is a link to a customer problem that describes this issue:

http://forums.citrix.com/thread.jspa?threadID=307531&tstart=0

Where is Internet Explorer?

When you go to advertise applications, you might notice that Internet Explorer is missing from the list, along with Windows Explorer, Notepad, and a couple of other applications. This is due to a known issue where App Orchestration only finds shortcuts that are in the “All Users” part of the Start Menu.

To fix this, simply ensure that any applications you want to advertise are in the “All Users” part of the Start Menu on all workload machines before you import them into a workload catalog. If you already have workload machines in a workload catalog, you can update the existing machines and use the “Create New Version” feature.

Here is a link to a customer problem that describes the issue:

http://forums.citrix.com/thread.jspa?threadID=308478&tstart=0

Workflow Issues

Workflows is the method by which App Orchestration makes changes to your deployment. If your deployment is not working the way you want, it is possible that a workflow failed or that a workflow is not being processed. Here are some initial things to check if you have workflows that are failing:

  • Make sure you have Microsoft .NET Framework 4.0 installed on all servers.
  • Make sure you followed the instructions in the Citrix App Studio Quick Deployment Guide regarding creation of the GPO that enables PowerShell remoting support on all servers.
The status of all workflows are displayed in the Citrix App Studio workflows page. Workflows that fail have details about what caused the failure. There are two ways to correct failures:
  • Correct the problem if possible, and Retry the workflow. It is safe to retry a workflow multiple times. An example of when this approach might be effective is if a workflow fails due to a permission problem. You can configure the correct permissions and retry the workflow, and it should then succeed.
  • Change the configuration within Citrix App Studio so that the workflow no longer needs to execute. An example of when this approach might be effective is if a workflow fails because a machine has experienced a hardware failure. You can correct this by deleting the machine from Citrix App Studio. Another machine will be allocated in its place, and new workflows will execute to configure the new machine appropriately. The original workflows will be superseded and will disappear from the workflows page.
Workflows that take too long or that cannot complete will be displayed as warnings on the workflows page. There are two ways to address this:
  • You can cancel the workflow. Cancelled workflows will stop executing.  However, since the cancelled workflow is left in an incomplete state, other workflows may be blocked from executing until the problem is corrected. You can correct the problem using the same methods that apply to failed workflows.
  • Restart the App Orchestration Agent service on all controllers, restart workload machines, and restart the App Orchestration Agent service on your App Orchestration configuration servers.

Problems with App Delivery Setup Tools Scripts

Many problems with App Delivery Setup Tools scripts can be solved by simply running the script again. If this does not solve the problem, check the following:

  • Make sure you have Microsoft .NET Framework 4.0 installed on all servers.
  • Make sure you followed the instructions in the Citrix App Studio Quick Deployment Guide regarding creation of the GPO that enables PowerShell remoting support on all servers.
  • Ensure that the firewalls on all SQL Server machines are configured to allow SQL communication.
  • Did you specify the XenApp DVD Image directory when running server configuration? This is required to get the App Orchestration Agent on the media so it can be access when XenApp controllers and workload machines are prepared.
  • If preparing Web Interface machines, controllers, or workload machines, did you correctly enter all of the information on the instructions page? A common problem is that the XenApp database account information is typed incorrectly.
  • Do not join the workload machines to the farm after you run New-CamSessionHost. These machines will be joined to the appropriate farms automatically by App Orchestration.
  • When running New-CamFarm, make sure you provide the same database credentials that you entered for the farm catalog during the “Configure Citrix App Studio” wizard.

When All Else Fails

If you have a problem you cannot get around, the best thing to do is post a question on the App Orchestration Technology forum. The forum is monitored by many people who know the inner workings of App Orchestration and can get your questions answered.

You can find the forum here:

http://forums.citrix.com/forum.jspa?forumID=1425

There are also some other great articles about App Orchestration available:

Enjoy!