Chapter 2: Configuring UMLServer


When you run UMLServer, the following Startup dialog will first appear.

If you intend to run UMLServer as a normal Windows application, press the Start UMLServer as an Application button (or just press the enter key). This will bring up the application's main window.

The rest of this dialog allows you to setup UMLServer as a service. The advantage of a service is that you do not need have a logged-in user to run it. The service can be configured to start automatically as soon as the machine on which it is installed is booted.

Important Note: On Windows NT and 2000, for UMLServer to operate correctly as a service, it is imperative that UMLServer is installed by a user who has administrator rights. Otherwise, the registry entries will not be accessible by the service and hence any configuration changes you make to UMLServer will not be visible to the service.

To install UMLServer as a service, press the Install Service button.

To uninstall the service, press the Uninstall Service button.

Once the service is installed, you can start it by pressing the Start Service button. You only need to start the service once. Afterwards, it will automatically start when the machine is rebooted.

To stop the service, press the Stop Service button.

Finally press the Exit button. This will terminate UMLServer.

License Key

If you have a valid UMLStudio license with a quantity of 4 or higher, then you can use it to setup UMLServer as a floating license server for UMLStudio.

To do this, run UMLServer and then press the License Key button. The following dialog will appear.

Enter the license details exactly as sent to you by PragSoft Corporation, and press the OK button. After successfully entering the license details, you'll notice that the Not Registered phrase will disappear from the UMLServer window title.

If you do not have a UMLStudio license, or if its quantity is less than 4, you can still use UMLServer, so that you can evaluate its functionality. Two restrictions will apply in this case:


After installing and registering UMLServer, you should press the Options button to setup user options. The following dialog will appear.

UMLServer is a multi-threaded server. Two server threads are used to implement the license server and the repository server. The two port numbers appearing in this dialog are the ports on which these servers listen for client connections. These ports default to 705 (for license server) and 706 (for repository server).

In the unlikely event that these port numbers clash with those used by other applications in your network, you should change them. To change the port numbers, change the license server port number, and the repository server port number will be automatically set to the same number plus 1.

Pressing the Default Port Number will result in the default port numbers (i.e., 705 and 706) being restored.

Unless the Allow Multiple Logins by the Same User option is selected, a user is not allowed to have multiple simultaneous connections to UMLServer.

The path appearing next to the Base button, points to the folder in which the repository file hierarchy should appear. This is called the repository base path. To set this path, press the Base button, browse to the desired folder, and then press OK.

Finally, the Client-Server Timeout box allows you to alter the default timeout period. This timeout period is used to determine when to abort a request/reply cycle between UMLStudio and UMLServer.

User Access

Finally, you need to specify user access setting that will allow authorized users to connect to UMLServer. Press the User Access button. The following dialog will appear.

The list at the bottom of the dialog contains zero or more access profiles. This list is initially empty (meaning that nobody can login to UMLServer). To add an access profile:

Now press the Add button to add the user profile to the list of profiles.

Each user profile appears in the list in this format:

user@host = rights
where rights consist of the letters that denote the granted access rights (or underscore for rights not granted).

For your convenience, when UMLServer is installed, a default user entry of the form: User ID=*@*, Password=any, User Rights=check in/out is created. This grants every user access with any password. If this is not what you want, you should change it immediately.

Because the Check Out right is harmless, it is always granted by default to all users who are given access to UMLServer.

You should be careful with granting Create and Delete access rights. These rights should generally be limited to individuals who will setup and maintain the structure of the repository. The Delete right is especially riskly as an individual with this right can completely and permanently erase the repository.

Table of Contents | Chapter 3

Copyright 1996-2010 PragSoft Corporation (