sign in sign up
<<
Home , Windows Installer

Deployment Tool Quick Guide

The Proxy Deployment Tool is a very powerful mechanism that allows you to install, uninstall and update Proxy Host from a centralized console. This step-by-step guide details each of the necessary steps required perform the aforementioned actions. For information, please review the official Deployment Tool Manual PDF included with your download.

Part 1: Creating a Transform File 1) Locate the Host installation file that will be installed a. Right-click “Installation Files” b. Click “New” c. Click “Installation File” d. Browse to the Host.msi on your

2) Now create a “Product Configuration” that will contain all of the Host modifications. a. Expand “Product Configurations” b. Right-click “Host” c. Click “New” d. Click “Configuration” e. Give the configuration a name and click “OK”

3) You now have a blank template to configure with each of the Host’s configuration values. The pane on the right will list each configurable Host setting. To add in a customized value: a. Double-click a parameter and input the requested values b. Example 1: Gateways i. Click “Add” and then provide your Gateway information and click “OK” when finished c. Example 2: License i. Select the radio button for “Use this value” and input your Proxy Host license key

4) When you have added all of the desired configuration parameters for your Host: a. Right-click the configuration name in the left pane b. Click “New” c. Click “Transform File” d. Input the desired file name and click “OK”. The “.mst” file extension will be automatically added. e. Be sure to save the file in the same as the Host.msi to keep the files together.

5) Congratulations! You have successfully created a transform file that will allow your Hosts to be configured with your settings upon installation.

Part 2: Deploying the PROXY Pro Host 1) Assuming you are operating in a domain environment: a. Right-click “ Domains” b. Click “Refresh” c. Now you can expand your organizational units that contain each of your future Host machines

2) If the Deployment Tool does not discover your domain(s): a. Right-click “Active Directory Domains” b. Click “Add Foreign Domain” c. Provide the domain information

3) To install the Proxy Host to a single computer: a. Right-click the computer name b. Click “Install Software” c. Select the Installation File Name from the drop-down list (the to the Host.msi)

Proxy Networks, Inc. | 320 Congress Street | Boston, MA 02210 | 877-PROXY-US or 617-453-2700 | 1

Deployment Tool Quick Start Guide

d. Click the radio button for “Transform File Name” and select the transform file from the drop-down list e. Select the appropriate radio button for the “Computer Restart Options” (a reboot is required to complete the installation) f. Click “OK” to begin the installation process

4) To install the Proxy Host to multiple computers: a. Left-click an organizational unit in the left pane to populate the right pane with the computers b. Press “Ctrl+A” within the right pane to select all of the computers c. Right-click any of the highlighted machines and click “Install Software” d. Follow steps “c” through “f” noted above to proceed with the installation

5) Within the right pane, the Proxy Deployment Tool begins installing the Proxy Host software from the first machine to the last and up to 5 installations will occur once, but each of the computers you have selected will be equipped with the Proxy Host software shortly. When the first installation finishes, the 6th machine will then be installed, and when installation finishes on the 2nd machine, the Proxy Deployment Tool will install to the 7th computer and so on. Each installation can take anywhere between 15 to 30 seconds per computer; specific times may vary. If you encounter any errors, see Part 3 within this document for details on how to resolve.

6) Congratulations! The Proxy Deployment Tool will indicate that the software has been successfully installed and whether or not each computer needs to be rebooted to complete the installation. Also note that within the left pane of the Deployment Tool, you will a “Reports” section that will detail which machines had successful installations and which machines failed to install along with an error code describing why. See Part 4 for Troubleshooting.

Part 3: Updating Existing Proxy Host Settings If Proxy Hosts are already deployed throughout your environment, the Proxy Deployment Tool allows you to update and change existing Host settings on the fly. For example, if your Proxy Gateway IP has changed, you will need to configure your Hosts to report into its new IP and this section describes how to do this.

1) Create a Host configuration as described in Part 1, Step 2 and 3

2) Make the necessary changes to the configuration, such as editing the Gateway information

3) Follow the same steps as described in Part 2, Steps 1 and 2

4) Once you have located the machine(s) whose settings you wish to update: a. Right-click the target Host b. Click “Update Host Settings” c. Select the “Configuration Name” from the drop-down menu d. Select the appropriate protocol e. Click “OK” to apply the updated Host settings

5) Congratulations! The Proxy Deployment Tool has successfully updated the Host settings. If you encountered any errors, it is likely that the Target Computer Requirements have not been met. Please review Part 3 for details.

Proxy Networks, Inc. | 320 Congress Street | Boston, MA 02210 | 877-PROXY-US or 617-453-2700 | 2

Deployment Tool Quick Start Guide

Part 4: Troubleshooting The Proxy Pro Deployment Tool is dependent on a few underlying Windows technologies and concepts in order to make software deployment possible. The following pre-requisites must be met by each of the target computers you wish to deploy to and below you will find each pre-requisite and the steps necessary to ensure each is met.

1) Windows Management Instrumentation (WMI) must be installed and the service must be running. a. To ensure that this is installed, open a command prompt on the future Host computer and “wmic”. If this was not installed, the output will be “Please wait while WMI is being installed…”. If this had already been installed, the output will read: “wmic:root\cli>” and you can close out of the command window. b. To ensure the Windows Management Instrumentation (WMI) services is running, you can verify this by bringing up the (Start -> Run -> Services.msc) and locating it on the list. c. For Windows 2003, you must also have WMI Windows Installer Provider installed, which is an optional Windows component and is not installed by default on this .

2) Windows Networking must be installed and enabled.

2) Standard administrative shares must be accessible (IPC$ and ADMIN$) a. Confirm that these are accessible by opening a command prompt and typing: share

3) Target computers must support authentication of remote users. To enable this: a. From the Windows , open “Administrative Tools” b. Open “Local Security Policy” c. Highlight “Security Options” d. “Network Access: Sharing and security model for local accounts” must be set to “Classic – Local users authenticate as themselves”.

4) If you receive an error stating “RPC Server Unavailable Error 0x800706ba”, a exception must be made on the target computer allowing it to listen on TCP port 135. The Deployment Tool is capable of sending a remote call using WMI and some systems may not be configured to allow this by default. To resolve: a. Windows XP Command Prompt: i. firewall set service RemoteAdmin b. Windows XP Control Panel: i. Open the Firewall settings and create an exception for TCP port 135 c. Command Prompt (must be run as Administrator) navigate to “C:\Windows\System32” and type: i. netsh advfirewall firewall set rule group="windows management instrumentation (wmi)" new enable=yes ii. netsh advfirewall firewall set rule group="remote administration" new enable=yes d. Windows 7 Control Panel: i. Open the Firewall settings ii. Click “Advanced Settings” iii. Highlight “Inbound Rules” iv. Visit the properties of both “Remote Administration (NP-in)” and “Remote Administration (RPC)” v. Ensure the box for “Domain” is checked on the “Scope” tab

Need More ? You are welcome to reach out to the Proxy Networks Support Team by submitting a ticket on our website at http://www.proxynetworks.com/support/open-support-ticket.html or you can email [email protected]. If you are an existing customer with an active Maintenance and Support contract or if you are currently evaluating Proxy you will be entitled to immediate phone support at 617-453-2718 Monday through Friday between the hours of 9:00AM and 5:00PM EST.

Proxy Networks, Inc. | 320 Congress Street | Boston, MA 02210 | 877-PROXY-US or 617-453-2700 | 3