Useful Reading

Useful Reading

This section describes in more detail the operation of the NavisWorks License Manager.

The License Manager tabs explained

The License Manager tabs explained

The five tabs on the License Manager allow you to view and manage your licenses.

Current Licenses

Current Licenses

This tab shows all the products that are installed on the PC by serial number and product description.

To the left of each serial number is an icon, signifying the current status of the license:

  • A Green tick signifies that the license is valid and working correctly.

  • An Exclamation mark signifies that a module within the license has expired. For full licenses this is most likely to be Bond , in which case the license is still valid, (however you will need to renew your Bond subscription to continue to receive support and upgrades. See the JetStream website, http://www.navisworks.com/bond.htm). See >License Properties for more information on finding out which module has expired.

  • A Red cross signifies that the license is invalid and not working. If this license has been valid and working on this machine previously, it may have been invalidated by a change to the machine. See >License Properties for more information on invalid licenses.

If you click on a serial number in the Current Licenses tab and then click on the Properties button, the License Details dialog will be displayed:

The License Details dialog shows all of the internal modules that come with the selected product license. This provides a description of the module; the version number; the Module name; the count (number of licenses); the expiry date (when the module expires); and the license type. The license type will either be Local , if it is a fixed license, or Float , if it's a floating license. Evaluation licenses are time limited and they will have an expiry date, shown in this dialog. Full JetStream licenses do not expire and will therefore be identified as Perpetual

Note

JetStream Bond is an annual subscription and therefore has an expiry date. The Bond module in the License Details dialog displays this expiry date. This is read by the NavisWorks License Manager and you will be prompted from 30 days prior to expiry, that your subscription needs renewing. If you choose not to renew your Bond subscription, your license will continue to work as normal , though you will no longer be eligible for support and upgrades. See the JetStream website, http://www.navisworks.com/bond.htm for more information on the JetStream Bond.

If you have renewed your Bond subscription, the NavisWorks Ltd. system will be updated accordingly. You will then need to Request your licenses again in order to update them on your machine, with this new information. As you are already using the licenses, you should not need to enter any of your details or serial numbers again, simply go to License Wizard, Request License , (provided your details are listed) click Next three times to get to the connection screen. Connect to NavisWorks Ltd. via your chosen method (see the section called >license connection methods for more information).

The User machine locking text box on the License Details dialog is enabled if the product is a networked or floating product. It shows a semi-colon (;) separated list of machines that are allowed to use these licenses. If the product is networked, new machines are automatically added to the list on first connection, up to the maximum number of licenses available. It can also be used to restrict the use of floating licenses

Finally, at the bottom of the License Details dialog there is a status for the selected license. If your license is invalid, there will be a reason for this stated here, which may provide an idea as to what is causing the problem. For example, Invalid Block Machine ID : ID:123ABC+ET123456ABCDEF . The ID: value is the CrypKey ID in the license file and the ET: value is the Ethernet ID in the license file (Note: CrypKey is the security software used by the NavisWorks License Manager). Both of these values (from the license file) must correspond to the Machine ID on the Advanced tab. If the CrypKey ID has changed on your machine (possibly due to reinstalling JetStream), then you may be able to Recover your license. If the Ethernet ID has changed, then the network card being used/detected now is different from that when first licensed. If you can use the original card again, the license should be validated. Once valid, you will then be able to Return your license, then Request it again with the new network card (or, if using multiple cards, disable Ethernet ID Locking before requesting the license. See License Manager Options

Local Modules

Local Modules

Displays a list of modules that are installed and available locally on the PC, along with their version number, and expiry date (if any). Note that JetStream Bond is treated as a module and will have the Bond renewal date as the expiry date (see >JetStream Bond

Each module has an icon to the left, signifying the status of that module. These statuses are the same as those on the >Current Licenses tab.

Network Modules

Network Modules

Similar to Local Modules, this tab displays a list of modules that are being served from the server that the PC is pointing to (see the section called Client set up). The Description column advises which modules are being served; the Version column advises which version the licenses are; the Total column shows the total number of licenses that are installed on the server; the Accessible Total shows the total number of licenses that are available to you from your PC (this is not necessarilly the number of licenses available to you now); The Used Elsewhere column shows the number of licenses that are currently in use by other users; and the Used Here column shows the number of licenses that are currently in use on your PC. The number of licenses currently available for you to use is the Accessible Total less the Used Elsewhere total.

Each network module has an icon to the left, signifying the status of that module. These statuses are the same as those on the >Current Licenses tab.

If you click on a network module and then click the Usage button, the Module Usage dialog is displayed:

This shows which PCs and users are currently using the selected module. This information can be seen from any PC that is connected to the License Server (see the section called Client set up). This is useful if you have run out of licenses and wish to tell somebody that you wish to take their license to use.

    Killing a user's session

    Administrators on the Server machine can use the Module Usage dialog to kill a users session and take back the licenses they were using.

    To Kill a user's session:

  1. As an Administrator on the server machine, go to the Network Modules tab of the License Manager.

  2. Click on the Description of the license you require, then click the Usage button.

  3. Click on the Computer whose licenses you wish to kill, then click the Kill button.

  4. You will receive a warning message, advising that this will kill all licenses for this computer/user. Click OK to kill the licenses or Cancel to return to the License Manager

    Note

    If the user (whose session has just been killed) is still using JetStream at the time the licenses were killed, they will be advised that their connection to the server has been lost. See Lost connection with License Server for more information.

Advanced

Advanced

This tab provides Advanced details an options, which should not be necessary for most users. Please see for more details on this.

Startup Preferences

Startup Preferences

This tab shows which licenses will be collected when JetStream starts. For each module that is checked, JetStream will attempt to collect a license, looking first on the local machine for the license and then to any server that the PC is pointed to. If JetStream can't find a Roamer license either locally or from a server, then it will warn you of this when the program starts. You will not be advised if any of the plugin licenses cannot be collected.

This tab is most useful when collecting licenses from the server. If you want to use JetStream but not take a specific plugin license from the server, simply uncheck the modules you wish to leave for other users. For example, uncheck the Clash Detective module if you wish to leave this for others. The results of unchecking boxes in the startup tab don't become apparent until the JetStream application itself is restarted.

Alternatively, you can create desktop shortcuts that define your startup preferences, thereby enabling you to collect any combination of JetStream licenses.

If you look at the Properties of the standard JetStream desktop shortcut, the Target by default is pointing to "C:\'Program Files\'NavisWorks 5\'roamer.exe".

The startup preferences are defined in the shortcut target as a combination of exclusion arguments. For example, the default (above) has no arguments and therefore excludes no license modules. To exclude a Clash Detective license (i.e. start JetStream, trying to collect all licenses except Clash Detective), the shortcut target would be "C:\'Program Files\'NavisWorks 5\'roamer.exe" -nomodule lcodpclash.

The exclusion arguments for each license module are as follows:

  • No Publisher license, -nomodule nw_publish

  • No Presenter license, -nomodule lcodplw

  • No Clash Detective license, -nomodule lcodpclash

  • No TimeLiner license, -nomodule lcodptimeliner

Note

Roamer cannot be excluded as this is the base license required to start JetStream and any combination of its plugins.

Any combination of the above can be added as arguments to the default JetStream shortcut target. You can copy the default shortcut on your desktop (as many times as necessary), rename it and add arguments accordingly.

Below is an example of the shortcut for only Roamer:

Target = "C:\'Program Files\'NavisWorks 5\'roamer.exe" -nomodule lcodpclash -nomodule nw_publish -nomodule lcodplw -nomodule lcodptimeliner

Reassigning networked licenses to other clients

Reassigning networked licenses to other clients

If you have run out of networked licenses for all the client PCs that want to claim them from the server, then you need to delete one or more PC names from the list. To do this:

  1. First, as the NavisWorks License server will need to be restarted, get everybody who is accessing the server to close JetStream and go to the Services dialog (from Administration Tools) and stop the NavisWorks Licensing service.

  2. In the License Manager, go to the Current Licenses tab, click on the serial number of the networked product and click Properties

  3. There should be a semi-colon (;) seperated list of all the PCs that have access to the networked licenses in the text box called User machine locking . Delete the PC name that you want to prevent from accessing networked license.

  4. Click OK on the dialog to close it and close the License Manager.

  5. Restart the NavisWorks Licensing service in the Windows Services panel, on the server.

  6. Before any other JetStream client requests licenses from the server, set up the client that couldn't previously access a license from the server, as described in Setting up a client

Restricting use of floating licenses

Restricting use of floating licenses

If you have a small number of floating licenses for a particular product and a large number of JetStream users, you may want to restrict use of these floating licenses to a small group of users. To do this:

  1. First, as the NavisWorks License server will need to be restarted, get everybody who is accessing the server to close JetStream and go to the Services dialog (from Administration Tools) and stop the NavisWorks Licensing service.

  2. In the License Manager, go to the Current Licenses tab, click on the serial number of the floating product and click Properties

  3. There should be a a semi-colon (;) seperated list of all the PCs that have access to the floating licenses in the text box called User machine locking . If no names are listed, then the floating licenses are available to all users. If any names are listed, the floating licenses are only available to the listed PCs. You can list more PC names than you have floating licenses.

  4. Click OK on the dialog to close it and close the License Manager.

  5. Restart the NavisWorks Licensing service in the Windows Services panel, on the server.

Combining fixed and networked licenses

Combining fixed and networked licenses

It is possible to combine fixed licenses and networked licenses if, for example, you have a docked laptop that needs to be taken on-site and still have access to your JetStream Roamer license. To achieve this, simply install and license those JetStream products that you need to be accessible at all times as fixed licenses. Then, to get access to any plugins from the server when the laptop is docked on the network, simply point the laptop to the server as described in Setting up a client. NavisWorks License Manager will collect the local fixed licenses first and try to collact any other licenses available from the server, as shown in the Network Modules tab and based on your Startup Preferences

Refreshing the license manager

Refreshing the license manager

Most useful if working in a networked and floating license environment. Occasionally, the License Manager needs to be refreshed in order to get a snapshot of current license usage. To achieve the latest view of the licenses, simply click on Refresh from the View menu.