These are the step by step instructions for installing the ThinApp Factory Appliance in a vSphere environment using the Setup Executable.
- Internal Static IP address (DHCP is not supported)
- Internal DNS / FQDN name specified (DNS is required if names are used instead of IPs).
- Administrator login to vCenter.
- Win XP Pro Volume License CD
- Win XP Pro Volume License Key
- ThinApp License Key
NOTE: If you don’t have one available for use, you can request a demo license from the ThinApp Product Home Page.
- SysPrep Files:
- SysPrep file locations and versions (KB 1005593)
- Installing the Microsoft SysPrep Tools to the vCenter Server Virtual Appliance (KB 2004013)
NOTE: You can also use Win 7 as well (in conjunction with Win XP or in place of).
If deploying to a a vCenter environment, ensure your vCenter Server has the appropriate SysPrep files for XP. See the following VMware KB’s for information on how to do this.
AppFactory Appliance Install Instructions:
- Download the ThinApp Factory Appliance from the VMware Flings site.
- Execute the ThinApp Factory Appliance install EXE (it’s a ThinApp Package) on a Windows OS which has network access to login to the vCenter environment.
NOTE: Use of the VMware vCenter Server Virtual Appliance (often called the VCVA or VSVA) is also supported.
- Upon execution, select “Deploy a new ThinApp Factory virtual appliance” and click NEXT.
- Select “VMware vSphere 4.1 or higher” and click NEXT.
- Type in the IP Address or FQDN of the vCenter server, the user name, and password and click NEXT.
NOTE: When typing in the User name, one must use a vCenter Administrator. If vCenter is tied to Active Directory, DO NOT type in the domain (e.g. “DOMAIN\USER”), just type in the user name. Local user accounts in the Win 2008 vCenter server or accounts in the vCenter Server Virtual Appliance may also be used.
- Select your vSphere server or vCenter Cluster from your data center which you wish to deploy the virtual appliance to.
- Select any desired resource pools for the ThinApp Factory appliance to reside within. This will also be the resource pool which Work Pool VMs and Instance VMs will be created.
- Select the desired ESX Datastore from the list.
- Type in a Virtual Machine name for the appliance. This will also be used as the HOSTNAME.
- Select the virtual network the virtual appliance is to attach to.
NOTE: Use of virtual distributed switches is NOT recommended with ThinApp Factory!
- Define the static IP address, DNS, Gateway, and domain suffix.
- Define the network proxy if needed for access to the Internet (NOTE: Outbound Internet access is necessary if pulling from public feeds).
- Enter your THINAPP license and ThinApp License Display Name (i.e. ThinApp Popup).
- After approving the final details, click NEXT. The deployment will begin.
- Once the deployment is complete, click FINISH.
- If the browser window doesn’t open, open your browser of choice and go to the address entered for the ThinApp Factory Appliance.
When the EULA appears, scroll to the end, check “I have read and accept this agreement” and then click the “I Accept” button – assuming you do agree to the End User License Agreement.
- On the initial login, the admin password is blank (no password). Click LOG IN to login.
- At this point you will see the ThinApp Factory Dashboard. While the entire dashboard is selectable, at this point we want to go to settings (in the upper right hand corner).
- Click on WORKPOOL then under VIEW WORKPOOLS, click the ADD button.
- When adding a Workpool, you must specify the Name, Number of instances (this is the number of simultaneous VMs to be run), and a Creation Mode (VM or ISO).
- Click on the Administration tab and reset the admin password. Remember, the default password is blank.
- If Feeds are desired, click on FEEDS then click on ADD FEED to create a new feed for downloading applications.
- If a file share is desired, select FILE SHARES then select ADD FILE SHARE.
NOTE: At this point you may be prompted for a vCenter Cluster selection if you have a vCenter cluster.
Within Settings, at minimum we must configure WORKPOOLS, ADMINISTRATION, and FILE SHARES or FEEDS in order for ThinApp Factory to work properly.
NOTE 1: If you DO NOT have a clean VM, it is highly recommended you let the ThinApp Factory Appliance build a clean VM for you!! Select “Use ISO to create a new VM“.
NOTE 2: If you are UNSURE if your VM is absolutely clean, it is highly recommended you let the ThinApp Factory Appliance build a clean VM for you!! Select “Use ISO to create a new VM“.
Here we show using an existing VM. When selecting “Use ISO to create a new VM”, the only difference from the below screenshot is we type in a OS Install License Key instead of selecting a virtual machine.
If additional work pools are desired, you can enter them now.
A feed only requires a name and a JSON source.
A file share requires a name, the share location, and potentially credentials. Click SCAN when ready.
NOTE: If you click OK TO CONVERT, all installable applications found will immediately be scanned and the ThinApp Factory Appliance will start working to create ThinApp packaged applications of all found installers.
Capturing an application:
You should now be ready to create a ThinApp package!
- Go to the dashboard
- Click SELECT AN APPLICATION
- Select a single simple application for initial testing such as “Audacity” if using a Ninite feed.
- Click the CAPTURE button.
- Click AUTO CAPTURE after verifying the settings in yellow.
- To view the progress, click VIEW in the popup window.
Additionally, within the vSphere Infrastructure Client, you should see a VM instance with a name starting with your work pool name.
Deploying an application:
- Once the package has been built, it will show under the PROJECTS tab. From there, the application can be deployed as desired.
- Selecting a project, one can publish, unpublished, rebuild, or delete. Selecting Publish will present the application to the ThinApp Factory Store.
- Browsing to the ThinApp Factory Store, one can select the applications they wish to deploy, then select Get Applications.
You have now concluded the initial setup and first capture and deployment of a ThinApp packaged application! From here you can explore creating Recipes and fine tuning your ThinApp Factory for optimal use.