App Orchestration Troubleshooting Tips

App Orchestration Troubleshooting Tips -

Orchestration Citrix App offers a whole new way to manage multi-tenant deployments, complex multi-farm. Let's face it; App Orchestration makes a lot of nice stuff. As with any product that provides this amount of functionality, customers can encounter problems. Some problems have obvious solutions, while others are more elusive. This post will cover some of the problems reported by users and some problems we've seen internally which can cause some confusion clients. In all matters, we offer advice on how to solve problems and ultimately resolve.

Before you start, make sure you have consulted the Quick Deployment Guide Citrix App Studio and performed all the preliminary steps. Here is a link to the Rapid Deployment Guide:

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

Installation

Here are some things to check if you have problems installing Citrix App studio

• Make sure you are running on a supported operating system. Support components App Orchestration Windows 08 R2.
• Make sure that you install the product using an account with administrative privileges on the local machine. To ensure that you can access the App Orchestration components of any machine in your domain, the account must be a domain administrator account.
• Before installing, ensure the support is in a directory on the local machine.
• If components fail to install, you can try to run the package manually from the Packages folder on the media. If the installation fails, you can obtain a log file by running the following command from a command prompt:
  • PackageName.msi / l * v install.log

server Configuration

Configuration server Troubleshooting tool problems is sometimes a tricky business. Here are some things to check if you have problems:

• sure on using an account with administrator privileges on the local machine. To ensure that you can access the App Orchestration components of any machine in your domain, the account must be a domain administrator account.
• If the database server is not available, ensure that the firewall on the SQL Server machine is configured to allow SQL data communication. Also, make sure that SQL native authentication is enabled and the SQL login account is activated.
• If the configuration of the server can not access the image XenApp DVD, make sure it is on sharing with write permission granted to the user session.

Get detailed information

There are currently no way to see the details of failure within the tool user interface server configuration. If you encounter a problem, you can run DebugView from SysInternals Suite to see what happens. The SysInternals Suite can be found here:

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

Complete the following steps to obtain DebugView configured:

1. run DebugView (Dbgview.exe) as administrator (must run DebugView high to enable the capture of all system events)
2. Make sure the following items are enabled in the capture menu :.
   1. Capture Win32
   2. Global Capture Win32
   3. Pass Through
   4. Capture Events

When you click the "Configure" in the server configuration, you will now see all kinds of display messages in DebugView. If the server configuration fails, you turn off the capture DebugView and scroll back and see the failure. If the reason for the failure is not obvious, you can post this info on the App Orchestration forum to get help.

server configuration

Preparation for Re-Install

Because is a multistep process, some failures can put the machine in a state that prohibits the execution of server configuration again. Here is a list of steps you can take to restore the machine to a clean state :.

1. Close all applications running
2. Uninstall all Citrix and Citrix App Studio App Orchestration components using programs .. and Features in Control Panel
3. from the command line, run iisreset.exe
4. Open Internet information services (IIS) and do the following:
   • Clear the "cam" folder under the "Sites -> default Web Site "folder.
   • Navigate to "SITES-> Default Web Site" and click on "View Applications" in the Actions pane.
   • Delete the following applications:
   • / cam / console
   • / cam / v1
5. Go to "SITES-> default Web Site" and click on "View Virtual directories."
6. Delete the virtual directory "root application" that has the virtual path "/cam".
7. Access "application pools." [
8. Delete "CitrixCAMAppPool" application pool
9. Open the Registry Editor and perform the following steps :.
• Navigate to "HKEY_LOCAL_MACHINE-> SOFTWARE-> Citrix
• Delete CloudAppManagement key.
10. from the command line, run iisreset.exe.

at this point, you'll be able to re-install and configure Citrix App studio on the machine.

problems with self-signed SSL

certificates

If you use SSL, you may discover that App Orchestration will not let you select a wildcard certificate for the server configuration. This is a known problem in the server configuration tool. you might be tempted to use a self certificate -Signed, but it will not work unless you manually link the certificate to the IIS site and add it to the "Trusted Publishers" certificate store on all machines of the agent.

the approach recommended is to use a normal certificate from 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 may notice that Internet Explorer is missing from the list, using Windows Explorer, Notepad, and a couple other applications. This is due to a known issue where App Orchestration can not find shortcuts that are in the "All Users" Start menu.

To solve this problem, just make sure that all the applications you want to advertise are in the "All Users" section of the Start menu on all machines of the workload before the import a catalog of the workload. If you already have workload of machines in a catalog of the workload, you can update existing machines and use the "Create a new version of"

Here is a link to a problem customer that describes the problem.

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

workflow Problems

Workflows is the method by which App Orchestration brings changes to your deployment. If your deployment does not work as you wish, it is possible that failed workflow or a workflow are not being processed. Here are some things to check first if you have any that fail workflow:

• Make sure you have Microsoft .NET Framework 4.0 installed on all servers
• Make you have followed the instructions. in deploying Citrix App Quick studio regarding the creation of the GPO that allows PowerShell remoting carrier on all servers.

the status of all workflows are displayed in the Citrix App Studio workflows page. Workflows that do not have more details about what caused the failure. There are two ways to remedy shortcomings:

• correct the problem if possible, and run the workflow. It is safe to try again a workflow repeatedly. An example of where this approach could be effective is if a workflow fails because of an authorization problem. You can configure the appropriate permissions and start the workflow, and then it should succeed.
• Change configuration within Citrix App Studio so that the workflow should no longer run. An example of where this approach could be effective is if a workflow fails because a machine has experienced a hardware failure. You can fix this by removing the machine from Citrix App Studio. Another machine will be used in its place, and new workflows will run to set appropriate new machine. The original workflow will be replaced and will disappear from the workflow page.

Workflows that take too long or can not complete will be displayed as warnings on the page workflows. There are two ways to approach this:

• You can cancel the workflow. canceled workflows cease running. However, since the canceled workflow is left in an incomplete state, other workflows can be blocked from running until the problem is corrected. You can correct the problem by using the same methods for workflows that have failed.
• Restart the App Orchestration Agent service on all controllers, restart the workload of machines, and restart the App Orchestration Agent service on your App Orchestration configuration servers.

problems with the App Delivery scripts configuration tools

many problems with the App Delivery scripts configuration tools can be solved simply by 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 have followed the instructions of Citrix. App Studio Quick guide deployment in creating the GPO that allows PowerShell remoting carrier on all servers.
• Make sure the firewall on all SQL Server machines are configured to allow the SQL data communication.
• Have you specified the XenApp DVD image directory when running server configuration? This is necessary to achieve the orchestration Agent application on the support so that it can be access when XenApp controllers and workload machines are prepared.
• If the preparation of the machines of the web interface, controllers, or workload of machines, you enter all the correct information on the instruction page? A common problem is that the database account information XenApp is typed incorrectly.
• Do not join the workload of machinery on the farm after running New CamSessionHost. These machines will be attached to the appropriate operations automatically App Orchestration.
• When running New CamFarm, make sure to provide the same database credentials you entered for the catalog of the firm during the wizard "Configuring Citrix App Studio. "

When All else Fails

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

You can find the forum here :.

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

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

• Concepts
• architecture
• Provisioning machines Part 1 & Part 2
• tenant Management
• Advertisements Management
• Managing subscriptions
• Patcher workload machines
• Understanding workflows Part 1, Part 2, Part 3

Enjoy!

Tweet