SGI Techpubs Library

IRIX 6.2  »  Books  »  Administrative  »  
Network License System Administration Guide
(document number: 007-2115-002 / published: 1993-09-07)    table of contents  |  additional info  |  download
find in page

Chapter 8. Error Messages

This chapter lists error messages displayed by NetLS commands and by applications licensed with NetLS. Each section explains an error message and what to do about it. The sections are:

Error messages are displayed in shell windows and are sometimes written to /var/adm/SYSLOG (/usr/adm/SYSLOG on IRIX Release 5.0 and earlier). Be sure to check this file if you are experiencing problems; it may contain a NetLS or networking error message that you might otherwise not see.

License or Server Not Found

There is no standard error message when you attempt to start a licensed application and the application is unable to get a license. You might see phrases like these:

  • no license found

  • cannot locate a license server

Assuming that you have installed at least one license for the product, possible causes when an application can't find a license are:

  • The version of the product that the license is for doesn't match the version of the product.

  • The system date is set earlier than the start date listed on the license information sheet.

If the application uses a node-locked license, these additional causes are possible:

  • The nodelock file /var/netls/nodelock (/usr/netls/nodelock on IRIX Release 5.0 and earlier) contains an incorrect vendor ID or license password.

  • You have entered a license annotation when there is none or it was specified incorrectly. If the license annotation contains spaces, be sure to surround it with double quotes (").

  • On IRIX Release 5.0.1 and later, the file /usr/netls/nodelock is not a symbolic link to /var/netls/nodelock. Verify that /usr/netls/nodelock is a non-dangling symbolic link to /var/netls/nodelock using file(1).

If the application uses a concurrent license, these additional causes are possible:

  • You may have received a concurrent license but installed it as a node-locked license.

  • There are two or more Global Location Brokers on the network that do not “know about each other.” (See “Global Location Brokers That Don't Know About Each Other” in Chapter 9 for more information.)

  • Required daemons are not running. glbd(1M) and llbd(1M) should be running on the Global Location Broker, and netlsd(1M) and llbd should be running on the Network License Server.

  • The clock on the system running the applications differs from the clock on the Global Location Broker system by more than 12 hours.

  • The file /var/ncs/glb_site.txt (/usr/etc/ncs/glb_site.txt on IRIX Release 5.0 and earlier) lists systems that are not Global Location Brokers.

  • A /var/ncs/glb_obj.txt (/usr/etc/ncs/glb_obj.txt on IRIX Release 5.0 and earlier) file exists, but no Global Location Brokers are using the UUID in that file (there are no location brokers in that cell).

  • The daemons are in an inconsistent state. To fix this, try stopping all of the daemons on the network (see “Stopping Daemons” in Chapter 7) and restarting them (see “Restarting All Daemons on a Network” in Chapter 7).

  • The GLB database may be corrupt. Follow the instructions in “glbd Won't Run” in Chapter 9.

Unable to Locate Any Network License Servers

/usr/etc/ls_admin 
LS_ADMIN Version 2.01 BL04
(c) Copyright 1991, Hewlett-Packard Company, All Rights Reserved
?(ls_admin) Unable to locate any Network License Servers

ls_admin(1M) exits immediately with this message when it cannot find any operational Network License Servers. One or more Network License Servers may have been set up, but they are not running now and were successful in unregistering themselves in the GLB databases before going down.

See “License or Server Not Found” in this chapter for information about similar messages from applications.

License Will Expire in n Days

license will expire in n days

Some applications display expiration warning messages prior to the expiration date of a temporary license. What you should do depends upon your situation:

Communications Failure

?(command) Error at server special.wpd.sgi.com - communications failure (network computing system/RPC runtime)

This error message is generated by commands that broadcast on the network such as ls_admin, ls_stat(1M), drm_admin(1M), and lb_admin(1M). It occurs in a wide variety of situations. Some examples are:

  • lb_admin is doing a lookup on a system where a Global Location Broker is not running:

    lb_admin: set global ip:pele
    lb_admin: use global
    lb_admin: lookup 
    ?(lb_admin) communications failure (network computing system/RPC runtime)
    No entries match.
    

  • drm_admin cannot contact a Global Location Broker:

    drm_admin: set -o glb -h ip:pele 
    Default object: glb  default host: ip:pele  status: not communicating communications failure (network computing system/RPC runtime)
    

  • ls_admin or ls_stat detect that a Network License Server went down without unregistering itself:

    Connected to server: pele.wpd.sgi.com
    ?(command) communications failure (network computing system/RPC runtime)
    

    A Network License Server can appear to go down without unregistering itself when the system crashes, the network becomes unavailable, or daemons are not running.

Unable to Register with Locating Broker

Unable to register with locating broker communications failure (network computing system/RPC runtime)

This message can occur for a variety of reasons:

  • The network is unavailable.

  • A system is down.

  • Daemons are not able to locate other daemons; for example, glbd is unable to locate a llbd, or netlsd is unable to locate a llbd. To solve this problem, stop the daemons on the network and restart them using the instructions in “Stopping Daemons” in Chapter 7 and “Restarting Daemons” in Chapter 7.

  • A /var/ncs/glb_obj.txt or /var/ncs/glb_site.txt file (/usr/etc/ncs/glb_obj.txt or /usr/etc/ncs/glb_site.txt on IRIX Release 5.0 and earlier) is incorrect.

Unable to Obtain Any Sockets

LLBD: Unable to obtain any sockets

This error message can occur when:

  • You weren't superuser when you tried to start llbd. Become superuser to start llbd.

  • llbd is already running. Confirm that it is running using ps(1).

No Entries Match

No entries match.

This message is displayed by lb_admin. It occurs in these situations:

  • When you give the lb_admin subcommand lookup, lb_admin reports “No entries match” if the Global Location Broker you've specified has no Network License Server entries in its database and you haven't specified arguments to lookup; for example:

    /usr/etc/lb_admin 
    lb_admin: lookup 
    Data from GLB replica: ip:pele.wpd.sgi.com 
    No entries match.
    

    If you've given arguments to lookup and they don't match any entries, then the entire list of entries is displayed.

  • When you are modifying GLB database entries using the delete or unregister subcommand, this message appears when no entries are affected; for example:

    /usr/etc/lb_admin 
    lb_admin: delete sl slsl sl ip:pele 
    No entries match.
    

Cannot Create Replica

glbd: ?(GLB) cannot create replica - object already exists (network computing system/DRM)

You were trying to start a Global Location Broker with the command:

/usr/etc/glbd -create -from ip:hostname & 

The command failed because a GLB database (the files /var/ncs/glb.e and /var/ncs/glb.p on IRIX Release 5.0.1 and later, and /usr/etc/ncs/glb.e and /usr/etc/ncs/glb.p on IRIX Release 5.0 and earlier) already exists on this system. You have three choices:

  • Start up glbd using the existing database with this command:

    /etc/init.d/nck start 
    

  • Remove the existing database and give the same glbd command again. On IRIX Release 5.0.1 and later, the files are /var/ncs/glb.e and /var/ncs/glb.p. On IRIX Release 5.0 and earlier, the files are /usr/etc/ncs/glb.e and /usr/etc/ncs/glb.p.

  • Merge the existing database with hostname's database and start glbd using this sequence of commands:

    /usr/etc/drm_admin 
    drm_admin: set -o glb -h ip:hostname 
    drm_admin: addrep ip:thishost 
    drm_admin: merge_all 
    drm_admin: quit 
    /etc/init.d/nck start 
    

    thishost is the host name of your system.

Network License System Administration Guide
(document number: 007-2115-002 / published: 1993-09-07)    table of contents  |  additional info  |  download

    Front Matter
    About This Guide
    Chapter 1. NetLS Concepts
    Chapter 2. The Licensing Process
    Chapter 3. Installing Node-locked Licenses
    Chapter 4. Setting Up Global Location Brokers and Network License Servers
    Chapter 5. Installing Concurrent Licenses
    Chapter 6. License Administration Tasks
    Chapter 7. Global Location Broker and Network License Server Administration Tasks
    Chapter 8. Error Messages
    Chapter 9. Troubleshooting
    Appendix A. NetLS Files
    Glossary
    Index


home/search | what's new | help