Network Installation using the Activation Wizard (Manual)

A network-based installation of DBT is simply an installation in which all the instances of DBT, on as many machines as they are installed, are all activated through a single server machine on your network. Only the server computer needs to be officially activated; all other DBT’s on the network become activated as its clients. Naturally, in this set-up the server must be activated for multiple users.

Overview

This topic is fairly dense technically. Here is an outline of the steps:

  1. Assemble the tools for the tasks listed below.
  2. Install DBT on the server or master workstation.
  3. Activate DBT for multiple users on that server or master workstation.
  4. Install the Shared License Service product on the server or master workstation. This service launches automatically on installation.
  5. Install DBT on the client workstations, and connect each one to the server using the DBT Activation Wizard.

Now we will go through these steps in detail.

(1) Assemble the Tools
  1. You need to know the location of the standard DBT installer. If you have the DBT distribution CD in your computer, this might be D:\dbt-1102.msi. But it is up to you to know the exact volume letter and path. You also need to know the location of the Shared License Service Installer, which is a separate installer.
  2. You should know your license text and the maximum number of DBT users you are licensed for. The license text can usually be found on a print-and-braille card that came with your original purchase of DBT. It may also be found in a file called gjgmw.dxr or hjgmw.dxr that came with your original purchase of DBT if your first purchase was of version 10.4 or earlier. The number of users should be found on your purchase paperwork or other key documents relating to your installation.
  3. You will install and activate DBT on your server or master workstation as your first tasks. The next section is dedicated to the server installation task.
  4. You should verify that TCP/IP port 8080 is not already in use on your network, and will not be blocked by internal firewalls between all the machines where DBT will be installed. This is the default port number that the “Shared License Service” uses. If port 8080 is not available or not suitable, then choose another port and play close attention to the instructions about customizing the port number.
  5. Know the server’s DNS name in order to call it from the client machines. If you do not have a DNS name, you can use the server’s IP address instead as long as it is a static IP number.
  6. Note: Do not use a dynamic IP number or things will only work for a short time. On the server, use ipconfig /all <Enter> to obtain its DNS name.
  7. Use ping (name) <Enter> on the client machine to verify that the client machine can "find" the server with that name
(2) Install DBT on the server or master workstation

We say, “server" or "master workstation,” because the computer you choose as the master for DBT activation need not be running a server operating system. This gives you a wider choice of which computer to use as your master for activation. If the computer you choose is not a Windows Server machine, then it must be at least a Windows XP computer or later, and you need to be willing to leave it powered on whenever DBT is needed by any user on the network

Once you have chosen a server machine, install DBT onto it by following the Simple Installation instructions.

(3) Activate DBT on the server

The next step is to activate DBT on the server machine. When you launch DBT, you will see the “Activate” button on the splash screen. When you click that (or the like button in the “About” box), it invokes the Activation Wizard. Or the Activation Wizard can be invoked directly from the DBT home folder (actwiz.exe).

On the Wizard’s main page is a radio button labeled, “Set up this server to host the network license.” Select that choice and click the “Next” button. From there you can simply follow the instructions in the Activation Wizard, but here are some helpful tips.

Activating by Internet, if possible, is by far the quickest and most convenient method.

If you are not using port 8080, the Wizard will direct you where to enter your selected port number.

On one page you will need your license text, computer name, and user name. The license may be pre-populated for you. To avoid confusion, we suggest you enter the same computer name as the DNS name that client machines will use to address this server (but this is not a requirement). In the User Name field, you may want to enter the name of the organization instead of an individual. Whatever name you use here, keep track of it to enter it again from the DBT client machines.

To see page-by-page instructions for using the Activation Wizard see Registration and Activation .

Note: This is the only activation you need to do. Do not attempt to activate the client machines separately, instead they will be “connected” your server.

(4) Install the Shared License Service

Just the same way DBT is installed from an installer package (an .msi file), you need to install the Shared License Service from its .msi file, duxsls-0100.msi. The completion of installation automatically initiates the network license service that is needed for sharing your server activation. This service allows other machines on the network to obtain their DBT activations from your server. The duxsls-0100.msi file is available from http://www.duxburysystems.com/downloads/duxsls-0100.msi or from the root directory of your DBT 11.2 (SR4) CD-ROM.

The installer guides you through each step, beginning with the End User License Agreement, which you must accept to enable the Next button, and that we recommend you read at least once. By default it places the service files in the “Duxbury\Shared License Server” folder. We recommend you accept the default location.

Finally, on the last page it pre-checks a box prompting you to configure and start the service. This opens the Duxbury SLS Editor. If your installation includes multiple versions of DBT, or includes other Duxbury products like NimPro, or uses third-party software that is activated using “Sheriff,” you need to configure them using the Editor. Even if you have no complications, you must invoke the Editor to build the required initialization files and start the service. If you uncheck this box, you will have to start the Editor manually to complete your installation.

In the the Duxbury SLS Editor, you are prompted for the port number you wish to use for the Shared License Service. As previously noted the default is port 8080, and you can use that if it is not already in use or unsuitable for some reason local to your own network. If you chose a different port number in the Activation Wizard, enter that same port number here.

On this same screen, the editor builds a list of checkboxes that allows you to indicate which Duxbury products are to be shared from this server. In the most common case, that list contains only the single version of DBT that you have just activated. In the most complicated case, the list may include a range of Duxbury products and even third-party software.

Unless necessary, we do not recommend running third-party products (should any be listed) under the same port number as your Duxbury applications. In the most complex case, conflicts between Duxbury and third-party software may possibly be resolved by editing the content of the .ini files per the next screen in the Editor. Consult your local IT personnel if you need to do this. Normally no editing of these settings is needed.

Finally, you click the “Start Service” button to launch the Duxbury Shared License Service. You can confirm this service is running by finding it under this name in your Administrative Tools: Services screen.

Concerning Your Firewall

The Duxbury Shared License Service is not added to the list of rules (or programs) in your firewall automatically. You must edit the Inbound Rules of the Windows Firewall (or similar program list on your third-party firewall) to add this service.

Using Windows 7 as an example:

In the Windows Firewall, you need to access the “Advanced settings” (administrative level) functions.

To avoid confusion, we suggest you name the new entry, “Duxbury Shared License Service.”

Assuming you have installed the Shared License Service in the normal default location, the program you need to allow is under the “Duxbury\ Shared License Server” folder. The program you need to allow is named slsServer.exe.

Once you make the new entry, you can open the specific port number that this service communicates on. In the Windows Firewall this setting is found under the Properties of the Duxbury Shared License Service.

Consult your specific firewall documentation for additional guidance.

(5) Install DBT on the client workstations and connect them using the DBT Activation Wizard

For each client computer, install DBT by following the Simple Installation instructions.

Then you need to connect the client machine to the server. To do this, launch the DBT Activation Wizard. You can do this by running DBT and then clicking the “Activate” button on the splash screen or in the DBT “About” box, or by invoking the Activation Wizard (actwiz.exe) directly in the DBT home folder.

On the Wizard’s main page is a radio button labeled, “Connect to the network license server on your LAN.” Select that choice and click the “Next” button.

To complete your connection on each client machine, you need to fill in:

  1. The DNS name or IP address of the server.
  2. The port number used to communicate with the server (again, the default is 8080).
  3. Your DBT license text.
  4. The User Name as entered on the server.
  5. The local computer name.

Once you have entered this data, click the Test button. Test attempts to complete the connection. This lets you know the data you entered are valid. Then click Next.