Network license configuration

Installing license server software

If you are setting up a network license server for Mudbox licenses, you do not need to install Mudbox on the license sever machine. You only need to install the current version of the licensing server software on that machine and restart the license service. If a server or client does not have a C: drive (for Windows), you can set the environment variable SGIAWD_LICENSE_FILE to point to the full path where the license file is. This requires that the computers can access each other by TCP/IP. The same environment variables are also available for Mac OS X.

You can find license server tools on the Mudbox DVD in a folder called LicenseServerTools. You can choose if you want to use IPv4 or IPv6 compliant license tools. You can also find license server tools online:

http://www.autodesk.com/licensetools

To configure your machines to serve and receive licenses across the network, you must set up the license server machine (see Obtaining a license using a serial number and Install a license), then set up each client computer that obtains a license from the server (Servers can serve a license to themselves.) For information on setting up client machines, see Client Setup.

For specific hardware platforms:

(Windows) Install the Autodesk License Server package, available as a Custom install. For additional information, see (Windows) License server management options and license server confirmation.
(Mac OS X) Install the Autodesk License Server package, available in the LicenseServerTools folder on the Mudbox DVD. For additional information, see (Mac OS X) License server management options and license server confirmation.
(Linux) Install the AWCommon packages. For additional information, see (Linux) License server management options and license server confirmation.

(Windows) License server management options and license server confirmation

To set options and start the license server

Select Start > Programs > Autodesk > Common Utilities > FlexLM License Utilities.
In the LMTOOLS window, click the Service/License File tab and select the Configuration using Services option.
Click the Config Services tab and set the following options:
- Turn on Use Services.
- Turn on Start Server at Power Up.
Check that the values are set:
- Path to the lmgrd.exe file is C:\Program Files\Common Files\Alias Shared\Licensing\etc\lmgrd.exe
- Path to the license file is: C:\FLEXLM\aw_servername.dat, where servername is the name of the license server machine.
Click Save Service.
Click the Start/Stop/Reread tab and click Start Server.

To confirm the license server operation

Click the Server Status tab.
Click Perform Status Enquiry.
If the license server is up, the window displays:
```
<servername>:license server UP(MASTER)
```
where servername is the license server computer name. The text area also lists the products/features and the number of logins you have.
Close LMTOOLS.

To stop and start the license server

In the LMTOOLS window, Service/License File tab, make sure Configuration using Services is turned on.
Click the Start/Stop/Reread tab, click Stop Server, and then Start Server.

(Windows) Checking whether the license server is running

You can use the Windows Task Manager to tell whether the license server is running. Do the following steps on the license server computer.

To check license server status

Press Ctrl+Shift+Esc. The Windows Task Manager appears.
Click the Processes tab.
If lmgrd.exe and sgiawd.exe are in the list of processes, the license server is up. If neither are in the list, the license server is down. If only one is in the list, the license server is partially up. In this case, restart the computer.

(Mac OS X) License server management options and license server confirmation

In the following steps, you use sudo—the special Mac OS X command that executes other commands with the highest level of user permissions—to start the license server. You must authenticate sudo each time you use it. The following commands must be run by someone who has administrator privileges on the machine.

Type the following using the Terminal utility. (You may be prompted for your administrator password.)
```
sudo /usr/aw/COM/bin/aw_flexlm start
```
To confirm the server has started, type the following in Terminal:
```
sudo /usr/aw/COM/bin/lmstat -a -c /var/flexlm/aw_server.dat
```
If the server has started successfully, you will see output that contains the line License server UP (MASTER) v11.5.
Launch Mudbox to confirm that the installation and licensing was successful.
If Mudbox starts, the installation and licensing is successful.

If an error message or the Product Configuration Wizard appears, it indicates you have a licensing problem. See Install a license or Troubleshooting.

(Linux) License server management options and license server confirmation

To start the license server

Log in as root.
Check to see that the aw_flexlm script is installed in the following directory:
```
/etc/rc.d/init.d/
```
Stop then start the lmgrd daemon by entering the following commands:
```
/etc/rc.d/init.d/aw_flexlm stop
```
```
/etc/rc.d/init.d/aw_flexlm start
```
- If the server was on previously, the command issues some status information. An example of this status information is:
```
lmdown - Copyright (C) 1989-2004 Macrovision Corporation. All rights reserved. Shut down FLEXlm server on node servername 1 FLEXlm License Server shut down
```
- If the server is off, the command issues an error message similar to:
```
lmdown - Copyright (C)2004 Macrovision Corporation. All rights reserved. Connection to "servername" failed: Cannot connect to license server(-15,12:146) Connection refused
```
  where servername is the name of the server machine. You can ignore this error message.
- If the server starts successfully, the status message will appear similar to:
```
License file = /var/flexlm/aw_servername.dat
```
```
FLEXlm Licensing daemon for Alias software: /usr/etc/lmgrd
```
Log out of root.

(Linux) Additional troubleshooting steps

If you have difficulty starting your license server, and stopping and then restarting your service does not solve the problem:

Type the following to kill the process, then press Return.
```
killall lmgrd
```

Type the following, then press Return.

/usr/aw/COM/etc/lmgrd -c <path to license file>

View the log file at the following location:
```
/usr/tmp/aw_flexlm.log
```
Type the following, then press Return to see if the license manager is running in the process list. For example:
```
ps -aef | grep lmgrd
```
(The ps command may have different options in your shell.) This confirms that the daemon is now running.

For further information on troubleshooting network license issues see Troubleshooting.

Verifying license server installation

If you are installing network licenses, you must verify that you have the correct version of the license server software.

Ensure that you installed the Licensing component when you installed Mudbox 2009. On Windows, this component is installed by default. On Mac OS X and Linux, you need to explicitly install this component.

To verify the license server software version

Do one of the following, depending on your platform:

(Windows) Select Start > Programs > Autodesk > Common Utilities > FlexLM License Utilities, and in the LMTOOLS window, select Help > About.
(Mac OS X, Linux) Open a Terminal window or shell and type:
```
/usr/aw/COM/etc/lmgrd -v
```

You need version 11.5 of the FlexLM software. If you have an older version, update the license software on the license server from the Mudbox DVD or from: http://www.autodesk.com/licensetools.