Imagix 4D User Guide


Installing a License

Detailed license installation instructions are available with your distribution of Imagix 4D. When you download from the Imagix website, links to the installation instructions are on the same web page as links to the Imagix 4D software itself. An additional copy of the instructions is included as a readme file in the root imagix directory, once you've run the self-installing Windows executable or untarred the Linux/Unix tarfile. What follows below is an overview of the license installation process; refer to the installation instructions for details.

Once you have received a license file from Imagix or your distributor, copy it to a permanent location on your file system. Choose a location that is visible from the machine you're installing Imagix 4D on.

You can start the Imagix License Installer through Help > License > Install menu in Imagix 4D. If you don't currently have a valid license installed, the License Installer will start automatically when you try to start Imagix 4D.

Node-Locked License

Typically, the evaluation licenses provided for Windows are node-locked licenses. The node-locked method is relatively straightforward to administer. On the machine for which the license has been issued, start the License Installer. Proceed through the dialogs of the License Installer; where appropriate, enter the full path name of the copied license file. Once the License Installer indicates that the license has been successfully installed, you can simply restart Imagix 4D and proceed to use the tool.

Floating, File-Based License

The floating, file-based method is also relatively straightforward to administer. Install the Imagix software, for all required variants of Linux/Unix, on the same machine that the license file is issued for. Make sure that you're logged into that machine; you can do this via remote login as long as the resulting X window of the Imagix License Installer can be displayed back on the monitor you're running from. You'll need to have write permissions to the directory ../imagix/data. Proceed through the dialogs of the License Installer; where appropriate, enter the full path name of copied license file.

Once the License Installer indicates that the license has been successfully installed, you can simply restart Imagix 4D and proceed to use the tool. You can run Imagix 4D on any Linux/Unix machine, as long as a) that machine can read and write to the file location where the Imagix software is installed, b) that machine is running one of the variants of Linux/Unix for which Imagix software has been installed, and c) a concurrent seat of the license is available.

Under floating, file-based licensing, a concurrent seat is released when a user does a normal exit from Imagix 4D. If an irregular exit, such as a segfault, occurs, the seat is not released, and the user is considered to still be logged in. To free the seat, have the same user, on the same machine, invoke Imagix 4D and then perform a normal exit.

Floating, Server-Based License

Installing the license in the floating, server-based configuration is somewhat complex. At the time you install the license, you need to specify the communication channel. You also ought to configure your system so that the Imagix license server is automatically restarted when the machine running the license server reboots.

The Imagix license server communicates with the actual Imagix 4D client application via tcp/ip sockets. In the License Installer, you need to specify the IP address (or equivalent machine name) of the machine where the license server is to run. You also need to specify which port, or socket, to reserve for the communication. This is an integer between 1 and 9999; typically values in the range 8000-9999 ought to be used. Check with your system administrator about what ports are available on your system.

If the Imagix 4D client application is going to run from a different copy of the Imagix software than the Imagix license server does (i.e., the Imagix 4D application software is installed on a client machine, or one or more of the Imagix file servers is a different machine than the Imagix license server), then you also need to install the client machine portion of the server-based licensing. This is also done through the Imagix License Installer. It involves specifying the same IP address for the license server and the same port /socket that was installed on the license server machine. This needs to be repeated for each file server that is not also the license server.

For example, you might have one Unix machine (PaloAlto1) and one Windows machine (Redmond1) acting as Imagix 4D file servers. This means that when a user on a second Unix machine (PaloAlto2) starts Imagix 4D, PaloAlto2 reads the Imagix client application software from PaloAlto1, and then runs it. The same is true on the Windows side, with Redmond2 reading and running the Imagix software on Redmond1. Assuming that the license server is also PaloAlto1, you'd need to run the Imagix License Installer on PaloAlto1 and install as `server-based floating license -- server machine'. You'd also need to run the Imagix License Installer on Redmond1 and install as `server-based floating license -- client machine'.

In another example, you might have a Windows-only network, but have the license server running on one machine, and have the Imagix 4D software installed locally on each of 7 user machines. Here, you'd need to run the license install process on Redmond1 as `server-based floating license -- server machine', and on each of Redmond2 - Redmond8 as `server-based floating license -- client machine'.