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 4. Setting Up Global Location Brokers and Network License Servers

This chapter explains how to set up and start the Global Location Brokers and Network License Servers that are required when using concurrent licenses.

On systems running IRIX Release 5.0.1 or later, use these sections:

On systems running IRIX Release 5.0 or earlier, use these sections:

Creating a License Group

License groups, explained in “License Groups for Concurrent Licensing” in Chapter 1 are used to restrict the use of concurrent licenses to a particular set of systems, rather than all systems on the network. Creating license groups is simplest when it is done before systems are set up as Network License Servers and Global Location Brokers. (Creating a license group later is explained in “Creating a New License Group” in Chapter 7.)

Follow these steps to specify a license group before you set up a Network License Server and a Global Location Broker:

  1. Identify all systems to be included in the license group. This list should include all systems that are Global Location Brokers and/or Network License Servers, and all systems on which you intend to run licensed applications.

  2. On a system running IRIX Release 5.0.1 or later that has netls_eoe.sw.netls_eoe installed, or on a system running IRIX Release 5.0 or earlier that has nck.sw.nck installed, create a glb_obj.txt file by giving this command:

    /usr/etc/uuid_gen > /usr/tmp/glb_obj.txt 
    

  3. On each system that is to be part of the license group and is running IRIX 5.0.1 or later, give these commands to create the directory /var/ncs, in case it doesn't already exist, and make a copy of the glb_obj.txt file you created in step 2:

    /bin/su - 
    Password: 
    mkdir /var/ncs 
    rcp guest@hostname:/usr/tmp/glb_obj.txt /var/ncs/glb_obj.txt 
    

    hostname is the name of the system where you performed step 2.

  4. On each system that is to be part of the license group and is running IRIX 5.0 or earlier, give these commands to create the directory /usr/etc/ncs, in case it doesn't already exist, and make a copy of the glb_obj.txt file you created in step 2:

    /bin/su - 
    Password: 
    mkdir /usr/etc/ncs 
    rcp guest@hostname:/usr/tmp/glb_obj.txt \ /usr/etc/ncs/glb_obj.txt 
    

    hostname is the name of the system where you performed step 2.

Setting Up a Network License Server and Global Location Broker with sgiauto

On IRIX Release 5.0.1 and later, you can use the following procedure to set up a Network License Server. This procedure automatically starts a Global Location Broker on the same system if there are no Global Location Brokers or there is just one on the network. Alternatively, “Setting Up a Global Location Broker Manually” and “Setting Up a Network License Server Manually” in this chapter can be used when you want to start a Global Location Broker on a different system, or you want to make a Global Location Broker that is a replica of a Global Location Broker on a different network segment in a multi-segment network.

To start a Network License Server and, if necessary, a Global Location Broker on this system, follow this procedure:

  1. If the sysinfo number on the license information sheet is a number rather than the word “Any”, verify that the license information sheet is for the system you plan to install the license on. Compare the sysinfo number on the license information sheet with the output of this sysinfo(1) command:

    /etc/sysinfo -s 
    

    If the numbers are different, the information on the license information sheet wasn't generated for this system. The license won't work on this system, so you should not make this system a Network License Server.

  2. Become superuser:

    /bin/su - 
    Password: 
    

  3. Install the subsystem netls_eoe.sw.netls_eoe if it isn't already installed.

  4. If you are using a standalone system (one not connected to a network at all), some special setup is required. Give these commands:

    /etc/chkconfig network on 
    echo "ip:localhost" > /var/ncs/glb_site.txt 
    

  5. Perform the setup for a Network License Server and possibly a Global Location Broker, and start their daemons (llbd, glbd, and netlsd) with this command:

    /usr/etc/netlsd -sgiauto & 
    

  6. Confirm that the llbd(1M) and netlsd(1M) daemons were started using ps(1); for example:

    ps -e | grep llbd 
    12304 ttyq1     0:00 llbd
    ps -e | grep netlsd 
    12310 ttyq1     0:00 netlsd
    

  7. If the output of the netlsd command indicated that it started glbd(1M), confirm that it is running; for example:

    ps -e | grep glbd 
    12287 ttyq1     0:00 glbd
    

Setting Up a Global Location Broker Manually

This section explains how to set up a Global Location Broker and start its daemons running for the first time. Once you set up a Global Location Broker, its daemons are automatically started each time the system is rebooted. This procedure can be used on all IRIX releases.

Follow these steps to set up a Global Location Broker:

  1. Become superuser on the system that is to become a Global Location Broker:

    /bin/su - 
    Password: 
    

  2. If the system is running IRIX Release 5.0.1 or later, install netls_eoe.sw.netls_eoe if it isn't already installed.

  3. If the system is running IRIX Release 5.0 or earlier, install nck.sw.nck if it isn't already installed.

  4. If you are using a standalone system (one not connected to a network at all), some special setup is required. On IRIX Release 5.0.1 or later, give these commands:

    /etc/chkconfig network on 
    echo "ip:localhost" > /var/ncs/glb_site.txt 
    

    On IRIX Release 5.0 or earlier, give these commands:

    /etc/chkconfig network on 
    echo "ip:localhost" > /usr/ncs/glb_site.txt 
    

  5. Set the llb and glb chkconfig(1M) flags to “on”:

    /etc/chkconfig llb on 
    /etc/chkconfig glb on 
    

  6. Give these commands to kill llbd, glbd, and netlsd in case they happen to be running:

    /etc/init.d/netls stop 
    /etc/init.d/nck stop 
    

  7. If this is the first Global Location Broker on the network (see “Checking Global Location Brokers” in Chapter 7), start the llbd and glbd daemons with this command:

    /etc/init.d/nck start 
    

  8. If there is already at least one Global Location Broker on the network (or on another network segment if it is a multi-segment network), start the daemons llbd and glbd with these commands so that all Global Location Brokers know about each other:

    /usr/etc/llbd 
    /usr/etc/glbd -create -from ip:other_GLB_hostname & 
    

    other_GLB_hostname is the host name of another Global Location Broker. These commands start this Global Location Broker as a replica of the Global Location Broker on other_GLB_hostname.

  9. Confirm that llbd and glbd are running; for example:

    ps -e | grep lbd 
    12293 ttyq1     0:00 llbd
    12287 ttyq1     0:00 glbd
    

  10. If there are now two or more Global Location Brokers on the network, verify that their clocks are within two minutes of each other, using the drm_admin(1M) command as described in “Routine Maintenance of Global Location Brokers” in Chapter 7.

Setting Up a Network License Server Manually

This section explains how to configure a Network License Server and start its daemons running for the first time. Once you set up a Network License Server, its daemons are automatically started each time the system is rebooted. This procedure can be used on all IRIX releases.

Follow these steps to set up a Network License Server:

  1. If the sysinfo number on the license information sheet is a number rather than the word “Any”, verify that the license information sheet is for the system you plan to install the license on. Compare the sysinfo number on the license information sheet with the output of this sysinfo(1) command:

    /etc/sysinfo -s 
    

    If the numbers are different, the information on the license information sheet wasn't generated for this system. The license won't work on this system, so you should not make this system a Network License Server.

  2. Become superuser:

    /bin/su - 
    Password: 
    

  3. Install the subsystem netls_eoe.sw.netls_eoe if it isn't already installed.

  4. If the system is running IRIX Release 5.0 or earlier, install nck.sw.nck if it isn't already installed.

  5. Set the llb and netls chkconfig flags to “on”:

    chkconfig llb on 
    chkconfig netls on 
    

  6. If this system is not a Global Location Broker, give the command:

    chkconfig glb off 
    

  7. Give this command to kill netlsd in case it happens to be running:

    /etc/init.d/netls stop 
    

  8. Start llbd and netlsd:

    /usr/init.d/nck start 
    /etc/init.d/netls start 
    

  9. Confirm that the Network License Server is now set up by verifying that llbd and netlsd are running; for example:

    ps -e | grep llbd 
    12304 ttyq1     0:00 llbd
    ps -e | grep netlsd 
    12310 ttyq1     0:00 netlsd
    

  10. Save the license information sheet; you may need it again later if you need to reinstall this license.

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