Remote Admin is an AppDNA agent that runs within the virtual machine during Install Capture. Remote Admin is automatically installed within the virtual machine when you install the Citrix AppDNA VM Configuration MSI. The MSI configures Remote Admin to start automatically when the virtual machine powers up and to listen for connections from the AppDNA client on port 54593.
The port can be changed by launching RemoteAdmin.exe from the command line in the virtual machine and including the following parameter:
Where port is the new port.
This needs to be done each time Remote Admin is launched. What this means in practice depends on the state of the virtual machine to which Install Capture reverts the virtual machine at the start of each Install Capture. This state is determined by the state of the virtual machine when you create the snapshot that Install Capture uses. To help you understand how this works, some background information follows.
For each Install Capture, AppDNA does the following:
How Remote Admin is launched depends on the state of the virtual machine when AppDNA reverts to it in step 1:
Therefore how you configure Remote Admin to use a different port depends on the state of the virtual machine when the Install Capture snapshot is taken. Step-by-step instructions are provided below for each option.
How you create a snapshot depends on the virtualization technology you are using. However, for all of the technologies, the final step in the Virtual Machine Configuration Wizard provides options to create a snapshot in either a suspended or powered off state. You can therefore perform the following steps in the virtual machine as you work through the wizard.
Follow these instructions before you suspend the virtual machine and create the snapshot to which Install Capture will revert the virtual machine.
Where location is the location of RemoteAdmin.exe. By default this is C:\Program Files\Citrix\AppDNA\VM Configuration on a 32-bit virtual machine (C:\Program Files (x86)\Citrix\AppDNA\VM Configuration on a 64-bit virtual machine) and port is the new port number.
This starts Remote Admin and configures it to use the new port number. You can now suspend the virtual machine and create the snapshot.
Follow these instructions before you power off the virtual machine and create the snapshot to which Install Capture will revert the virtual machine.
Where port is the new port number. (Ensure there is a space before -tcp_port.)
This configures the virtual machine to use the new port number when Remote Admin starts up. You can now power off the virtual machine and create the snapshot.