Article: KB-iWTX

Module: SetupInet.exe

Build: 9.0.0.14 (And Later)

The WordTricks program SetupInet.exe installs the WordTricks Internet Update, which is a combination of files that routinely download the most current files from the WordTricks web site. This update is not processor intensive and takes less than 1 minute under normal circumstances.

Diagram: iWTX Diagram

How does it work?

Update on the server (WAN Update):

UpdateNow.exe, which does most of the work, is dependent on InetUpdate.exe and the Task Scheduler for running complete auto updates. You configure a new task using Windows Scheduled Tasks. The WordTricks Internet Update task should execute InetUpdate.exe which downloads and executes the latest version of UpdateNow.exe. UpdateNow.exe downloads a wtx_master.mft file which is a list of the most current files associated with the WordTricks product. After downloading wtx_master.mft UpdateNow.exe compares the wtx_master.mft to wtx_server.mft, which is a list of files currently on your system. If there are differences in file version during the comparison UpdateNow.exe will download the latest file from the WordTricks web site (WAN) and place them in the WTX_Updates directory. After all of the files are downloaded UpdateNow.exe rewrites wtx_server.mft to match wtx_master.mft. A log file Updates.log is kept in the same directory as UpdateNow.exe and logs the events of the update process. When the process is complete you will have the most current files (stored in the WTX_Update directory), a new wtx_server.mft identical to wtx_master.mft (stored in the WTX_Updates directory), and a log file Updates.log (stored in the same directory as UpdateNow.exe).

Update on the workstation (LAN Update):

A similar process to the update on the server takes place on the workstation. When a user logs on WTX_Start.exe is executed which in turn executes WTX_Update.exe. On each workstation in the local WordTricks directory resides a wtx_local.mft file. Wtx_local.mft contains a list of files and versions that are installed on the workstation. WTX_Update.exe downloads the wtx_server.mft file from the WordTricks network structure and does a compare between wtx_local.mft and wtx_server.mft. If there are differences in file version during the comparison WTX_Update.exe will download the latest file from the WordTricks network structure (LAN) and place them in the local directory. Downloading to local workstations takes place only after administrator approval. See KB-ADMNAPP. After all of the files are downloaded WTX_Update.exe rewrites wtx_local.mft to match wtx_server.mft. A log file wtx_wks_mft.log is kept in the local directory and logs the events of the local update process. When the process is complete you will have the most current files , a new wtx_local.mft identical to wtx_server.mft, and a log file wtx_wks_mft.log.

SetupInet.exe Installation Files

InetUpdate.exe - Downloads the latest version of UpdateNow.exe .
UpdateNow.exe - Performs the majority of the update.
winhttp.dll - WinSock wrapper; underlying technology that allows the WordTricks Update to send HTTP header requests.
UpdateNow.reg - Used to set the application settings in the registry

Before You Install

You will need the following to install WordTricks Internet Update:

SetupInet.exe (WordTricks Network location\Setup\SetupInet.exe.
A Windows server/workstation.
User account with Internet access and permissions to write to the WordTricks network structure.

Installation

A. Installing and Configuring

1. Run SetupInet.exe from the workstation that will be performing the update.

You will be prompted to install to a WTXInet directory, click OK

2. Browse to the WTXInet directory.

3. You should see a UpdateNow.reg. Right click on the file and select the Edit option.

UpdateNow.reg is used to set the registry settings for the WordTricks Internet Update.

Registry value definitions:

"Enable" - enable automatic updates (1 = enabled, 0 = disabled).
"ForceAdminOnAll" - force admin approval on all updates (1 = enabled, 0 = disabled).
"ProxyEnable" - enable proxy bypass (1 = enabled, 0 = disabled). If you have a proxy server you must enable ProxyEnable.
"ProxyID" - proxy user ID (Must be preceded by == if not encoded). If you pass an un-encoded user ID then the Updates.log will display the user ID in readable format. If it is encoded then it will be displayed encoded (ex. "ProxyID"="==Admin").
"ProxyPass" - proxy password (Must be preceded by == if not encoded). If you pass an un-encoded proxy password then the Updates.log will display the proxy password in readable format. If it is encoded then it will be displayed encoded ("ProxyPass"="==happy21").
"ProxyServer" - IP address op the proxy server.
"ProxyPort" - port number used for proxy services.
"WTXNetPath" - Location of the WordTricks network directory. You may use a UNC path. You must use double and quadruple backslashes because of the way .reg files are interpreted. (Ex. F:\\Apps\\WordTricks or \\\\Slim\\Apps\\WTX). Double backslashes are interpreted as single backslashes (2 to 1 ratio).
"UpdatesServer" - location on the web where UpdatesNow.exe should retrieve the latest files. This value should be set to http://www.wordtricks.com/wtx_updates.
"UpdateDir" - name of the updates directory. (Default: WTX_Updates).

4. Set the following values in the UpdateNow.reg file:

"Enable"="1"
"ForceAdminOnAll"="1"
"ProxyEnable"="0" Unless you have a proxy server
"ProxyID"=" " Unless you have a proxy server
"ProxyPass"=" " Unless you have a proxy server
"ProxyServer"="" Unless you have a proxy server
"ProxyPort"="" Unless you have a proxy server
"WTXNetPath"="WordTricks network path (\\\\Atlanta1\\WordTricks)."
"UpdatesServer"="http://www.wordtricks.com/wtx_updates"
"UpdateDir"="wtx_updates"

5. Save the changes to UpdateNow.reg, close the .reg file, and execute UpdateNow.reg. The values will be stored in the registry.

B. User Profile For Updates

1. Create or Identify a user.

2. Login as user and use Internet Explorer to browse to www.wordtricks.net. (set LAN connections and proxy server as necessary)

C. Setting Up Auto Update Using the Windows Task Scheduler

1. Open the Task Scheduler.

XP - From Windows explorer browse C:\WINDOWS\Tasks and double click the Add Scheduled Task icon.
2K - From Windows explorer browse C:\WINNT\Tasks and double click the Add Scheduled Task icon.
NT - Under the My Computer icon, Scheduled Tasks directory double click the Add Scheduled Task icon.

2. Click Next on the Scheduled Task Wizard box to start the wizard.

3. Click the Browse button and browse to the location where SetupInet.exe was installed.

Note: Make sure you use a UNC path to InetUpdate.exe in the following step.

4. Select InetUpdate.exe and click Open.

5. Type a name for the task (WordTricks Internet Update), select the Daily radio button, and click Next.

6. Select an appropriate start time (after backups), select the Every Day radio button, and click Next.

7. Enter a username and password that has permission to run the Update (the user account will need permissions to write to the WordTricks network directory and must be set as a local admin).

8. Click Finish.

9. Right click on the newly created task and select Run.

The update process will download any updates to the WTX_Updates directory and create a file Updates.log in the same directory as InetUpdate.exe.