Description
The FarmAppUtil tool saves all the application properties with users and servers assigned to those applications in an XML file. The tool also creates a text file with a folder structure. The XML file created from the application can be modified and used for republishing all the applications and also recreate the folder structure in the new farm.
This tool can be used as migration tool to migrating all applications from a MetaFrame XP Feature Release 3 to a later version of Presentation Server.
Script Version
1.0
Supported Version
MetaFrame XP Feature Release 3 and later
How to Use
On your client machine register the remote Presentation Server.
1. To save all the application properties and folder structure, type:
> FarmAppUtil S
This will create two files, a MFFolder.txt file containing folder structure and a FarmName.xml file containing all the application properties. An Icon folder is also created which contains all the icons for the published applications.
2. To restore applications from the XML file and Folder structure file, type:
>FarmAppUtil <folderstructure.txt> <FarmName.xml>
This will publish all the applications present in the XML file and create folders not present in the Management Console.
Make sure you have MFCOM.dll present in the same directory as the FarmAppUtil.exe.
The FarmAppUtil exe can be found under the /bin/Debug folder.
The source code is written in C#.net and is included so that enthusiastic developers can extend the code.
Disclaimer
These software applications are provided to you as is with no representations, warranties or conditions of any kind. You may use 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 application 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 application 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 application. In no event should the 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 APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.
| Comment | Posted |
|---|---|
| Hello all I managed to get this tool working fine by following caburk1a's tips, but once I imoprt the applications they are always disabled. I have tried the following changes in the xml script to enable them; changing the -EnableApp-1-/EnableApp- value to 0, and removing the entry completely. changing the -ReadOnly-0-/ReadOnly- value to 1, and changing the -PNAttributes-MFWinAppDisabled-/PNAttributes- to MFWinAppEnabled, and removing the entry completely. None of this works. I should add that I am not importing to a new farm, I am using this tool to copy some apps from one area to another within the same PS4 farm, I am however changing certain attributes such as server names and neighbourhood locations etc. etc. Has anyone else seen and resolved this? My thanks in advance to anyone who could help me. Mark. PS I had to replace the less/greater than symbols with dashes in this post. | Oct 1, 2007 by mstangr0 |
| I used this tool to migrate about 200 published apps from an XPFR3 Farm to a PS4 Farm. 2 Issues to note. 1) I got an exception error when doing the import on PS4 because it did not like the Users list containing NDS/Edir user accounts/groups - only likes Active Directory accounts. When I took those out of the XML file it worked fine. 2) If you run the tool once and it creates the folder structure from the .txt file but fails for some reason on the XML, after you correct your XML you have to delete the folder structure it created for your applications before you run it again or else it will fail with a permissions issue because it tries to create those folders again. Otherwise it worked great. | Aug 23, 2007 by cleik59 |
| I found the 'problem'. Because i dont have any folders. thats why it didnt create folderstructure text file. | Apr 4, 2007 by basheer4b |
| Hi I get only the XML file as output. it didnt create the FolderStructure txt file as against mentioned in help. Is the XML file enough to restore? Please help | Apr 4, 2007 by basheer4b |
| Two things I noticed with app. Place the exe and the PDB file in the mfcom subdirectory with the dll, not by itself, and the S is case senstitive | Mar 28, 2007 by smcclos |
| the tool works, but verify that all users and servers for published applications are valid, otherwise the utility will throw up the debug error | Mar 20, 2007 by FbbRocks134 |
| I can export the apps from an FR3 farm, but when I try to import to a PS4 farm the folders are created, but the apps are not. No errors on the screen or in the log... | Feb 27, 2007 by gliving864 |
| If you don't get any files created after executing farmapputil s, that's because you need to used farmapputil S (with capital S) | Feb 20, 2007 by Anonymous |
| Is it possible for this tool to pick up the local server name to add to the published app instead of a hard-coded server name? I have 31 single server farms that will each have only one application published. I would like to use this tool to publish the app in each farm using the local server on which this utility is run. Is that possible? | Oct 19, 2006 by mfoster |
| I am also getting problems with this tool. It promises so much. :(
Env is W2K3 PS4.0 Rollup2.
I am able to create the xml file. I did note the "S" qualifier is case sensitive. I cannot import the XML file to create the applications again. Error I get is "Access to Path |
Sep 15, 2006 by StuckeyA |
