NetLS - Installing Nodelock and Floating Licenses in AIX 3.2-4.2

1. Run the shell script /usr/lib/netls/conf/netls_config.

2. When prompted by the following questions, give the following answers:

   Question 1:  Do you want the llbd started automatically when the machine boots?

   Answer:  y

   Question 2:  Do you want netlsd started automatically when the machine boots?

   Answer:  y

   Question 3:  (You might be asked this question)

   There exists an initialized database already for the glbd. Do you wish to use that database when starting the glbd daemon?

   Answer:  n

   You will be shown a listing of all the cells that your machine can identify. If you are setting up your machine in a new alternate cell, none of this information is relevant to you. If you intend to join an alternate cell that has already been established, note the cell number when it is displayed on the screen. Please note that the cell numbers may be assigned differently each time netls_config is run.

   Question 4:  (This option will not be displayed if no alternate cells were detected).

   You have three or four options

       1) Continue with installation without choosing a Cell Name. 
       2) Use the default for the system Cell Name. 
       3) Create a new alternate cell for the system Cell Name. 
       4) Choose an existing alternate cell for the system Cell Name. 
   

   Answer:  

   Choose 1 if you do not know what configuration you want and just want to quit. You will have to re-run netls_config later.

   Choose 2 if you are on a stand-alone machine or all systems in your network should have access to the same set of licenses.

   Choose 3 if you are going to run your server in a new alternate cell.

   Choose 4 if you are going to join your server to a cell that has already been established. You will then be prompted for the number of the alternate cell you want to join. Enter that number now.

   You are done with the netls_config script. It has created a second shell script called:

       /usr/lib/netls/conf/netls_first_time 
   

   1. Run the netls_first_time script. This will start the daemons needed for serving license requests. This script only needs to be run once.

      After the first time, the daemons can simply be started with the startsrc command. They must be started in the correct order (llbd, then glbd, and then netlsd). The exact commands are:

         startsrc -s llbd 
         startsrc -s glbd 
         startsrc -s netlsd -a '-no lcwvptms' 
      

   2. If at some point you have to reconfigure your server for a different cell or different IP address or netword adapter, stop the llbd, glbd, and netlsd daemons and then re-run the netls_config and netls_first_time scripts.

      To stop the daemons manually, use the stopsrc command. The daemons must be stopped in the reverse order that they were started. The exact commands are:

         stopsrc -s netlsd 
         stopsrc -s glbd 
         stopsrc -s llbd 
      

3. Now that your license server is up and running, install your floating licenses. You can do this with either the command line or the graphical user interface provided by the ls_admin command, or (on AIX 4.1 or later) using SMIT. In all cases, the data entered must be EXACTLY the same as it appears on the printout/fax/e-mail on which the license was delivered.

   EXCEPTION: When adding a new product to an existing vendor, or a new license to an existing product, use the vendor name and product name as they already exist in the license database, rather than as they are shown in the information provided by the key generation center. Either ls_stat or ls_admin can be used to show existing vendors and products.

   Cutting and pasting in X-Windows is the easiest way to avoid problems.

   The floating license that you receive should look similar to the following:

   -------------------------------------------------------------------- 
   Product name . . . . . . : AIX XL Fortran/6000 
   Product number . . . . . : 5765176 
   Target type. . . . . . . : aix        Target id. . . . . .: 1500910 
   No. of Concurrent users. : 1 
   Password type. . . . . . : LICENSE    License type . . . .: CONCURRENT 
   Passwords are valid From : 1996-04-09 To . . . . . . . . .: 2046-04-10 
   Generated by userid. . . : KEYATL     Genereted by system.: ALR-MENU 
   Generation reference No. : 1996-04-10-22.05.16.776093 
   Vendor name. . . . . . . : IBM Software Solutions Toronto 
   Vendor id. . . . . . . . : 5da54a553b4c.02.09.15.31.00.00.00 
   Vendor Password. . . . . : agkrmbnthcsc4 
   Product Password . . . . : s8yewwjtbfh68jf4wewbvuf3jiaaa 
   Product Version. . . . . : 3 
   

Type at the command line (or cut and paste to the command line) two ls_admin commands (your path must include /usr/lib/netls/bin). The first adds the vendor to your license database. The second line adds the specific product licenses for that vendor in your license database. Once the vendor has been added, it does not have to be entered again for other product licenses provided by the same vendor. In this example, the two commands would be (note the backslashes indicating continuation):

    ls_admin -a -v "IBM Software Solutions Toronto" \ 
        5da54a553b4c.02.09.15.31.00.00.00 agkrmbnthcsc4 
    ls_admin -a -p "IBM Software Solutions Toronto" \ 
        "AIX XL Fortran/6000" s8yewwjtbfh68jf4wewbvuf3jiaaa 3 

Install licenses with the graphical user interface as follows:

1. Run the command /usr/lib/netls/bin/ls_admin with no flags.

2. In the Servers display box, click on the server where you will install the license.

3. In the Operations box, click on Add Vendor.

4. In the Add Vendor window that appears, click on the Vendor Name button. A Vendor Name window will pop up. Enter the vendor name, and then click on the OK button. In the example above, the vendor name would be:

       IBM Software Solutions Toronto 
   

5. A Vendor ID window should pop up. If this window does not appear, click on the Vendor ID button in Add Vendor window. Enter the vendor ID, and click on the OK button. In the example above, the vendor ID would be:

       5da54a553b4c.02.09.15.31.00.00.00 
   

6. The Vendor Password window should appear. Enter the vendor password, and click on the OK button. In the example above, the vendor password would be:

       agkrmbnthcsc4 
   

7. Click on Done in the Add Vendor window. Your vendor should be added.

8. Now add the product license for the newly-added vendor. Click on the Vendor button in the Operate On box.

9. In the Vendors display box, click on the vendor whose product you will be adding.

10. In the Operations box, click on Add Product button.

11. In the Add Product window that appears, click on the Product Name button. A window for Product Name will pop up. Enter the product name, and click on the OK button. In the example above, the product name would be:

        AIX XL Fortran/6000 
    

12. A window should pop up for Product Version. Enter the product version, and click on the OK button. In the example above, the product version would be 3.

13. A window should pop up for License Annotation. If a license annotation was supplied with your license, enter it now, and click on the OK button. If no annotation was supplied, leave the field blank and just click on the OK button. In the example above, no annotation was supplied.

14. A window should pop up for License Password. Enter the license password, and click on the OK button. In the example above, the license password would be:

        s8yewwjtbfh68jf4wewbvuf3jiaaa 
    

15. Click on Done in the Add Product window. Your license password should be added.

1. Click on the Server button in the Operate On box. Then click on the server to which you will add the license in the Servers display box.

2. Click on the Vendor button in the Operate On box. Then click on the vendor for which you will add the product in the Vendors display box.

3. Click on the Add Product button in the Operations box.

4. Add the product information as you normally would.

1. Click on the Server button in the Operate On box. Then click on the server to which you will add the license in the Servers display box.

2. Click on the Vendor button in the Operate On box. Then click on the vendor for which you will add the product in the Vendors display box.

3. Click on the Product button in the Operate On box. Then click on the product for which you will add the license in the Products display box.

4. Click on the Add Licenses button in the Operations box.

5. An ADD LICENSE window will pop up.

   If your license has an annotation, click on the button for license annotation and specify the license annotation that was supplied.

   Add the license password by clicking on the License Password button in the ADD LICENSE window, and specify the license password that was supplied.

6. Click on the Done button in the ADD LICENSE window when you have added the license information.

7. Your license should be added.

1. Use the fast path smit manage_prod_licenses

2. Select Add New Licenses and New Vendor Information if this is the first product license being for this vendor. If licenses for products from this same vendor have been previously added, select Add New Licenses for a Previously Added Vendor.

3. In either case, enter the information provided by the key generation center into the corresponding fields and press enter to add the licenses.

4. If your server machine has the file /etc/ncs/glb_obj.txt, then all users that need licenses from your server must copy that file to their client machines. The file simply contains the identifier for the alternate cell.

   Example /etc/ncs/glb_obj.txt file:

       90b82be849c7.02.81.23.86.fb.00.00.00 
   

5. If a client machine is on a different subnet than your server machine, then the client machine must have the file /etc/ncs/glb_site.txt. The contents of the file will identify the server machine. For example, if the server machine is myserver.mynet.mycompany, then the glb_site.txt file will contain the line:

       ip:myserver.mnet.mycompany 
   

   The glb_site.txt file can also specify the IP network address of the server machine. For example, if the IP address of the host machine is 111.22.333.444, then the glb_site.txt file will contain the line:

        ip:#111.22.333.444 
   

   Example /etc/ncs/glb_site.txt file:

        ip:myserver.mynet.mycompany 
        ip:#111.22.333.44