API tools faq
paste
henrydenhengst

installation of Citrix XenApp 6.5 Part 2

henrydenhengst
May 6th, 2015
617
0
Never
Add comment
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
PowerShell 9.29 KB | None | 0 0
raw download clone embed print report
  1. <# The configuration is performed using an executable that is installed in the first phase called XenAppConfigConsole.exe, which can be found at (default) C:\Program Files (x86)\XenApp\ServerConfig.
  2.  
  3. Also new is that you can specify some commands which are mostly useful when testing the configuration of the parameter lines like /NoStrict (excuting will continue while the options do not apply to the environment) and /Confirm (displays a message before modifying the server).
  4.  
  5. It’s a bit odd that the parameter for specifying the log file is different with the installation part. Specify the logfile is based on the parameter /LogFilename:file.
  6.  
  7. Let’s take a look at the available parameters and their dependencies.
  8.  
  9. /Executionmode:
  10.  
  11. This is a required and most important parameter. This specifies what needs to happen with the XenApp server. In total there are four items available: Create (the first server you install will need to create the farm, which will be done with command), Join (the second and following servers will join the Farm with this command), ImagePrep (can be used for preparing the server for images, useful for Provisioning Services) and Leave (Removes the server from the farm).
  12.  
  13. /FarmName:name
  14.  
  15. Required and actually only needed when /Executionmode:Create (so configuring the first server) is being used. The farm will be named with the value defined in this parameter.
  16.  
  17. /CitrixAdministratorAccount:domain\user
  18.  
  19. Also required and only valid in combination with /Executionmode:Create specified. The account specified will be added as the first Citrix Administrator (the account where you can log on the console with after this unattended configuration).
  20.  
  21. /ZoneName:name
  22.  
  23. The name of the zone the server will be added to. Can be used both with Create as Join.
  24.  
  25. /AddLocalAdmin:True|False
  26.  
  27. When setting this parameter to True local administrator account (accounts in the local administrator group) will be added as Citrix Administrator. When not specified this action will not be performed.
  28.  
  29. /ImaWorkerMode:True|False
  30.  
  31. With XenApp 6.5 Citrix introduced a new feature that server can be configured as an application server only and cannot perform the Data Collector or XML broker Role. When specifying True the server cannot act as Data Collector or XML Broker. Default is False (so both application hosting as data collector/broker role can be done by het server). Can only be used when ExecutionMode is set to Join.
  32.  
  33. Dependent of the type of database you are using there are several parameters available. When using SQL Express you can use parameters like /SimpleDB, /SqlExpressRootDir:<location> and /ServerName. I will specify a bit more on a dedicated SQL server, which is more obvious to use when you create an unattended installation of Citrix XenApp.
  34.  
  35. /DsnFIle:file
  36.  
  37. Which this command you specify the location of the DSN file, which mentions the SQL database information to connect to create or join the database (datastore). Required for both Create as Join,
  38.  
  39. /OdbcUserName:name
  40.  
  41. Add this parameter the name of the useraccount need to be specified, which will be used to access the database. When using a Windows account the name should be specified DOMAIN\Username while using SQL only the username need to be specified. Required for Join or Create at the ExecutionMode parameter.
  42.  
  43. /OdbsPassword
  44.  
  45. The corresponding password of the user specified at /OdbcUserName. Logically also required like OdbcUserName
  46.  
  47. /AuthenticationType:Windows|Sql
  48.  
  49. You specify if the provided ODBUserName is based on Windows or SQL authentication.
  50.  
  51. /LicenseServerName:name
  52.  
  53. Specifies the name of the existing Citrix License Server, not required you can specify the server also using Citrix policies.
  54.  
  55. /LicenseServerPort:port
  56.  
  57. When specifying the Citrix License Server you can also specify the port number the license server is using. Default is port 27000. Not required, this can also been set with Citrix Policies.
  58.  
  59. /LicenseModel:model
  60.  
  61. Here you can specify the license mode options are XA (XenApp Only), XDC (XenDesktop concurrent user licenses) or XDUD (Xendekstop user or device licenses). Not required.
  62.  
  63. /CustomXMLServicePort:port
  64.  
  65. With this setting you can specify the port number the Citrix XML services uses (by default port 8080, when this parameter is not set).
  66.  
  67. /CreateAnonymousUserAccounts=True|False
  68.  
  69. Here you can specify if the anonymous local user accounts should be created or not.
  70.  
  71. Remote Desktop User Group options
  72.  
  73. However I recommend to add users to the Remote Desktop Group via other methods for example GPO there are scenarios where this part should be accomplished via this setup-up . The options available are /AddAnonymousUsersToRemoteDesktopUserGroup:True|False (adding the anonymous accounts to the Remote Desktop User Group), /AddAuthenticatedUserstoRemoteDesktopUserGroup (enables current and future domain accounts in the Windows Users Group to the Remote Desktop User Group) and /AddUsersGroupToRemoteDesktopUserGroup:True|False (add current users forom the local Users Group to the RemoteDesktop Users group).
  74.  
  75. The /AddUsesrGroupToRemoteDesktopUserGroup is the default s is default when you don’t specify anything during the unattended parameter line. So if you will completely manage the users in the Remote Desktop Users group specify this parameter with the value False.
  76.  
  77. Session Shadowing Options
  78.  
  79. For a long time the Session Shadowing configuration was configured on machine level during the installation and could not be changed. This finally can be configured within Citrix Policies, so you don’t need to configure this during the initial setup. However it is still possible and these settings are overwriting settings configured within the GPO. So the advice is not to configure those with the unattended setup, only when regulations require this. The possible parameters are /ProhibitShadowing:True|False, ProhibitRemoteControl:True|False, /ForceShadowPopup:True|False and ForceShadowLogging:True|False.
  80.  
  81. Other options
  82.  
  83. The executable offers some more commands, but those are based for using the ExecutationMode:ImagePrep or ExecutationMode:Leave. I’m not going to describe those, because that part does not fell into scope of this article.
  84.  
  85. Features and Component options
  86.  
  87. When additional agents are installed during phase one you can configure those agent also with this executable. Available paramters are /SmartAuditorServerName:name, /SsoPluginUncPath:path, /OnlinePluginServerUrl:name_url (Web Interface Server Url), /PcmFarmName:farm (Power and Capacity Management), PcmWorkLoadName:name (Power and Capacity Management), EdgeSightCompanyName:name, EdgeSightServerName:name and /EdgeSightServerPort:port.
  88.  
  89. Examples
  90.  
  91. Now we have seen all possible commands it’s time to show some examples of using the command line.
  92.  
  93. The first example is the creating of farm including specifying the license server, license server port, zone name and adding the Users group to the Remote Desktop User Group and log the action in a log file in the directory C: and port. #>
  94.  
  95. "C:\Program Files (x86)\Citrix\XenApp\ServerConfig\XenAppConfigConsole.exe" /ExecutionMode:Create
  96. /FarmName:VANBRAGT /LicenseServerName:LSSRV.vanbragt.local /LicenseServerPort:27000
  97. /ZoneName:Zone01_VanBragt /AddUsersGroupToRemoteDesktopUserGroup:True /AuthenticationType:sql
  98. /DsnFile:<loc>\xenapp65.dsn /OdbcUsername:xenapp65 /odbcPassword:*******
  99. /LogFilename:c:\log\JoinXenApp6.log
  100.  
  101. <# The second example is joining a farm with minimum parameters, only the Zone Name is specified #>
  102.  
  103. # C:\Program Files (x86)\Citrix\XenApp\ServerConfig\XenAppConfigConsole.exe" /ExecutionMode:Join  /ZoneName:Zone01_VanBragt  /AuthenticationType:sql /DsnFile:<loc>\xenapp65.dsn /OdbcUsername:xenapp65 /odbcPassword:*******
  104.  
  105. <# This software / sample code is provided to you “AS IS” with no representations, warranties or conditions of any kind. You may use, modify and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the software / sample code may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software / sample code fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software / sample code. In no event should the software / code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE software / SAMPLE CODE, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Although the copyright in the software / code belongs to Citrix, any distribution of the code should include only your own standard copyright attribution, and not that of Citrix. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code. #>
Advertisement
Add Comment
Please, Sign In to add comment
Public Pastes
We use cookies for various purposes including analytics. By continuing to use Pastebin, you agree to our use of cookies as described in the Cookies Policy.  OK, I Understand
Not a member of Pastebin yet?
Sign Up, it unlocks many cool features!