Versions Compared

    Key

    • This line was added.
    • This line was removed.
    • Formatting was changed.
    Comment: Published by Scroll Versions from this space and version 6.9-2

    ...

    MLA Installation Procedure

    Use On Windows and OS X hosts, we recommend using the Qube Installer to perform the MLA installation, and provide the username and password from the MLS user account.

    MLA installation from RPM on linux

    Many linux machines do not have a graphics head on them, and so installation must be done using the command line and installing directly from the RPM.  This will necessitate setting up the credentials file and cron job by hand.

     

    Expand
    titleClick here to expand the manual installation details...
    Install the MLA rpm
    No Format
    [root@ip-192-168-66-21 /tmp]# rpm -ivh qube-mla-6.9-2.CENTOS_6.7.x86_64.rpm
    Preparing...                ########################################### [100%]
       1:qube-mla               ########################################### [100%]
    [root@ip-192-168-66-21 /tmp]# 
    Install the credentials into a file readable only by root

    In the following example, the credentials are stored in a file name /root/.mla_creds.  You may use any file name you wish, but this path must be matched when you setup the cron in a later step.

    No Format
    [root@ip-192-168-66-21 ~]# cat /root/.mla_creds 
    export PFX_MLS_USER=<your MLS user name>
    export PFX_MLS_PASSWD=<your MLS password>
    
    [root@ip-192-168-66-21 ~]# chmod 600 /root/.mla_creds
    Test the credentials

    You must source the credentials file in order to load them into the environment; the command to source will vary depending on your shell.

    No Format
    sh-4.1# . /root/.mla_creds 
     
    sh-4.1# /usr/local/pfx/qube/mla/mla --check-creds --debug
    [2017-04-10 16:29:42] john.burk:axxxxxxf at https://mls.pipelinefx.com/api/v2/login
    [2017-04-10 16:29:43] Credentials test passed.  Exiting...
    Run all the tests

    This will test:

    • MLA -> supervisor connectivtiy
    • MLS login credentials
    • Supervisor MAC address is registered on the Metered Portal.
    No Format
    sh-4.1# /usr/local/pfx/qube/mla/mla --check --debug
    [2017-04-10 16:33:06] Testing supervisor connectivity...
    [2017-04-10 16:33:06] Qube supervisor defined in qb.conf: 192.168.66.21
    [2017-04-10 16:33:06] - passed
    [2017-04-10 16:33:06] Testing Metered License Server login credentials...
    [2017-04-10 16:33:06] john.burk:axxxxxxf at https://mls.pipelinefx.com/api/v2/login
    [2017-04-10 16:33:07] - passed
    [2017-04-10 16:33:07] Testing MAC address registration and authorization...
    [2017-04-10 16:33:07] - passed
    [2017-04-10 16:33:07] All checks passed.  Exiting...
    Once all tests pass, setup the cron file to run the MLA every minute

    Note that the command run includes the "source" command, with the path to the credentials file.

    No Format
    sh-4.1# ls -l /etc/cron.d/com.pipelinefx.meteredLicenseAgent.cron
    -rw-r--r-- 1 root root 107 Apr 10 16:40 /etc/cron.d/com.pipelinefx.meteredLicenseAgent.cron
    
    sh-4.1# cat /etc/cron.d/com.pipelinefx.meteredLicenseAgent.cron 
    MAILTO=''
    * * * * *       root    . /root/.mla_creds && /usr/local/pfx/qube/mla/mla --debug --records 1
    Check the MLA log

    verify that the MLA is correctly posting records to the Metered portal

    No Format
     sh-4.1# tail /var/log/mlalog
    [2017-04-10 16:41:01] Local journal not found, creating database PFX_metered.db
    [2017-04-10 16:41:01] Created database PFX_metered.db
    [2017-04-10 16:41:01] License data: used:0, prepaid:64, metered:0
    [2017-04-10 16:41:01] Records collected so far: 1
    [2017-04-10 16:41:01] john.burk:axxxxxxf at https://mls.pipelinefx.com/api/v2/login
    [2017-04-10 16:41:02] POST'ing records to MLS at https://mls.pipelinefx.com/api/v2/records
    [2017-04-10 16:41:02] Reporting {"insert": 1, "account": "jburk testing", "metered_key": "[metered]\nhostid = 02:EF:66:EF:90:97\nlicensee = \"jburk testing\"\nmax = 32\nexpires = \"Apr 11, 2017 00:41:02\"\nkey = 32450283602d5539f0d5f072cef69276", "update": 0, "authorized": true}
    [2017-04-10 16:41:02] Removed all POST'ed records from table license_data
    [2017-04-10 16:41:02] "[metered]\nhostid = 02:EF:66:EF:90:97\nlicensee = \"jburk testing\"\nmax = 32\nexpires = \"Apr 11, 2017 00:41:02\"\nkey = 32450283602d5539f0d5f072cef69276"
    [2017-04-10 16:41:02] Supervisor authorized for metered licensing: true
    Clean up once the logs show that the MLA is reporting correctly

    If there are no error messages in the log file, and you see "Supervisor authorized for metered licensing: true", edit the cron and remove the --debug --records 1 arguments, so that your cron now looks like:

    No Format
    sh-4.1# cat /etc/cron.d/com.pipelinefx.meteredLicenseAgent.cron 
    MAILTO=''
    * * * * *       root    . /root/.mla_creds && /usr/local/pfx/qube/mla/mla


    Verifying the MLA Installation

    ...