Jump to: navigation, search

Provisioning the LFMT Application

This section describes how to provision the LFMT application:

1. Configuring the central log storage.
2. Creating the LFMT configuration object.
3. (Optional) Configuring the log puller script.

Deployment Procedures

1. Create the Central Log Storage (CLS) folder in a desired location. For example, /home/genesys/cls or C:\GCTI\CLS.

Important
Ensure that the CLS folder is accessible to all hosts utilizing log file retrieval.

Purpose: To establish the LFMT configuration by creating a configuration object to which LFMT will connect.

  1. Log in to Genesys Administrator, and create a new Application Template object, as follows:
    1. Go to Provisioning > Environment > Application Templates.
    2. Select Upload Template option from the Tasks pane on the right.
    3. Click the Add button, and select the LFMT_XXXXXXX.apd template.
    4. Name the new application template.
    5. Click Save & Close to create the new template and return to the list of Application Templates.
  2. Create a new LFMT Host object, as follows:
    1. Go to Provisioning > Environment > Hosts, and click New.
    2. On the Configuration tab, fill in the following fields:
      • In the Name field, enter a name for the host.
      • In the IP Address field, enter the IP Address of the host.
      • In the OS Type field, select from the drop-down list the operating system that the host is running.
      • Leave the rest of the fields as they are.
    3. Click Save & Close to create the new Host and return to the list of Hosts.
  3. Create and configure the new LFMT Application object, as follows:
    1. Go to Provisioning > Environment > Applications, and click New.
    2. In the General section on the Configuration tab, fill in the following fields:
      • In the Name field, enter the name of your LFMT application. For example, lfmt.
      • In the Application Template field, browse to the folder where the Application Template that you created is located and select the template.
      • Leave the rest of the fields as they are.
    3. In the Server Info section on the Configuration tab, fill in the following fields:
      • In the Host field, select the LFMT server host.
      • In the Listening Ports field, enter the listening port of Tomcat or Jetty.
      • In the Working Directory field, enter “.”.
      • In the Command Line field, enter “.”.
      • Leave the rest of the fields as they are.
    4. Click Save to save your changes.
    5. Configure LFMT options for this application, as follows:
      1. On the Options tab, select Advanced View (Options) from the View drop-down list.
      2. Set the following options in the given sections:
        Important
        Before starting Log Collector for the first time, specify the retention_period option according to your company's log retention policy.
        Section Option

        app_config

        absolute_cls_folder_path
        disable_ftp
        lfm_zip_chunk
        pk_location
        retention_period
        unix_user_account
        windows_user_account

        cfg_srv_n

        default_app
        hostip
        hostname
        backuphostip
        backuphostport
        password
        port
        username

        dbprops

        url
        dialect
        driver
        username
        schema
        password

        regexes

        <regular expression name>

        thread_setting

        max_queue
        max_threads
        min_threads

        smtp

        from
        host
        password
        username
        port

        ftp

        host
        password
        username
        port

        Remove all other configuration options.
    6. Select Save and Close to save your changes and return to the list of Applications.
  4. Configure the Genesys Administrator Extension application associated with the LFMT application.
    1. In Genesys Administrator, go to Provisioning > Environment > Applications and select the Genesys Administrator Extension running on the same host with the LFMT application.
    2. Configure the options for this application, as follows:
      1. On the Options tab, select Advanced View (Options) from the View drop-down list.
      2. Create a section called lfmt.
      3. In the lfmt section, add the option lfmts and set its value to the name of the newly created LFMT application.
      4. If more than one LFMT application is to be associated with a single Genesys Administrator Extension application, the value for lfmts will be a comma-delimited list of all the LFMT application names (for example, lfmts = lfmt, lfmt_2, lfmt_3).
  5. Restart Genesys Administrator Extension Genesys Administrator.
  6. Check that the installation was successful by entering the following URL in a browser and logging in: http://<IpAddressofGaxHost>:<tomcat or jetty port>/gax
  7. After providing the login credentials, make sure LFMT section is present in CONFIGURATION menu.

Purpose: To impose limits on the number of RSYNC transfer processes that can be run concurrently, and limit the amount of bandwidth that one transfer process uses. In the logpuller.sh script, modify one or both of the following parameters, as required:

  • OPTION_CONCURRENCY—This parameter defines the maximum number of RSYNC transfer processes that can run concurrently. The default value of zero (0) indicates that there is no limit; an unlimited number of these processes can be spawned and run concurrently. You can set a limit in one of two ways:
    • Modify the value of this parameter in the logpuller.sh file.
    • Append -c <n> to the logpuller.sh file command line, where <n> is the maximum number of concurrent processes.
  • OPTION_BANDWIDTH—This parameter sets the bandwidth limit for the RSYNC transfer in kBytes per second. The default value of zero 0 indicates that there is no limit. You can set a limit in one of two ways:
    • Modify the value of this parameter in the logpuller.sh file.
    • Append -b <n> to the logpuller.sh file command line, where <n> is the bandwidth limit in kBytes per second.
  • ARCHIVE_SIZE—This parameter sets the number of log puller archives to retain. The default value is 7.
  • RSYNC_COMPRESSION—This parameter sets the compression level of the rsync transfer. The default value is 1.
  • RSYNC_MAXSIZE—This parameter sets the largest individual file size log collector will transfer CLS. The default value is 200MB.
  • RSYNC_TIMEOUT—This parameter sets the i/o timeout rsync will wait (in seconds) for logs files to be transferred from the application servers. The default value is 60.
    • When transferring a large number of log files this value may need to be increased.
This page was last modified on February 11, 2015, at 14:01.

Feedback

Comment on this article:

blog comments powered by Disqus