The Java SE 7 Runtime Environment (JRE) packages and agent bootstrap file must be configured for the Windows virtual machine to work properly in Application Services.

About this task

The agent bootstrap is a daemon that runs as an NT service on Windows after a virtual machine starts for the first time. The Application Services agent bootstrap uses the PowerShell script to run the bootstrap code.

Prerequisites

  • Verify that vCloud Director 5.1.2 or 5.5 is installed and configured.

  • Verify that at least one vApp is created in vCloud Director. See Create a vCloud Director vApp.

Procedure

  1. Log in to the Windows virtual machine as a user belonging to the local Administrators group.
  2. Download and install the supported Java SE 7 Runtime Environment from http://Application_Director_IP/agent/jre-1.7.0_51-win64.zip.
  3. Unzip the JRE file to the C:\opt\vmware-jre\ directory.
  4. In a PowerShell command window, navigate to the C:\opt\vmware-jre\bin directory and enter java -version to verify the installation.

    The installed version of Java appears.

  5. Download and install the Application Services agent bootstrap file from http://Application_Director_IP/agent/vmware-appdirector-agent-bootstrap-windows_6.0.0.0.zip.
  6. Unzip the vmware-appdirector-agent-bootstrap-windows_6.0.0.0.zip file to a new folder.
  7. Right-click to view the agent_bootstrap.ps1 file properties and click Unblock to disable the security on the file.
    Important:

    If you do not disable this Windows security feature, you cannot use the Application Services agent bootstrap file.

  8. Add the NTRights.exe utility to the newly created folder.

    The NTRights.exe utility is used in the install.bat command to configure the agent bootstrap service to run in the darwin user account. The utility is included in the Windows Server 2003 Resource Kit Tools (rktools.exe), which you can download from the Microsoft download Web site.

  9. (Optional) : If the NTRights.exe utility is not available, manually configure the agent bootstrap service to run in a specific user account after you run the install.bat command.

    The install.bat command creates a user account called darwin for the agent bootstrap service and uses the password you set. The Password must meet the Windows password requirements.

  10. To install the agent bootstrap service, open a Windows CMD console, navigate to the new folder, and enter install.bat password=Password cloudProvider=vcd.
  11. From the command-line, enter services.msc and open the Application Services agent bootstrap service.
  12. On the Log On tab, set the Log on as option to This account and enter the login credentials.

    The user name for this user account is .\darwin.

  13. In the PowerShell command window, complete the following service-related tasks.
    1. Enter net start AppDAgentBootstrap to verify that the service starts successfully.
    2. Enter net stop AppDAgentBootstrap to stop the service.
  14. Delete the runtime log files generated during the template creation.

    agent_reset.bat

  15. (Optional) : Enable Remote Desktop to remotely access future instances of this virtual machine.

    You can also use the remote access for troubleshooting purposes.

  16. Shut down the Windows virtual machine and stop the vApp in vCloud Director.
  17. Navigate to C:\opt\vmware-appdirector\agent-bootstrap\agent_bootstrap.ps1, change the $gcStatus value to $True, and add the Write-Host "Skipping guest customization check for vCD 5.1.2" command to the file.

What to do next

Before you save your vApp to a catalog in vCloud Director, you can select the Change SID and Join Domain features to allow the Windows template to become a member of a Windows Active Directory domain. See Enable SID Change and Domain Join for Windows Virtual Machine Templates.

Add the vApp template to the vCloud Director catalog so that you can register it for use in Application Services. See Add Windows Virtual Machine Templates to the vCloud Director Catalog.