:original_name: mrs_01_1070.html

.. _mrs_01_1070:

Typical Scenario: Collecting Local Static Logs and Uploading Them to HDFS
=========================================================================

Scenario
--------

This section describes how to use Flume client to collect static logs from a local PC and save them to the **/flume/test** directory on HDFS.

Prerequisites
-------------

-  The cluster, HDFS and Flume services, and Flume client have been installed.
-  User **flume_hdfs** has been created, and the HDFS directory and data used for log verification have been authorized to the user.

Procedure
---------

#. Generate the certificate trust lists of the server and client of the Flume role respectively.

   a. Log in to the node where the Flume server is located as user **omm**. Go to the **${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/bin** directory.

      **cd ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/bin**

   b. Run the following command to generate and export the server and client certificates of the Flume role:

      **sh geneJKS.sh -f sNetty12@ -g cNetty12@**

      The generated certificate is saved in the **${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf** path .

      -  **flume_sChat.jks** is the certificate library of the Flume role server. **flume_sChat.crt** is the exported file of the **flume_sChat.jks** certificate. **-f** indicates the password of the certificate and certificate library.
      -  **flume_cChat.jks** is the certificate library of the Flume role client. **flume_cChat.crt** is the exported file of the **flume_cChat.jks** certificate. **-g** indicates the password of the certificate and certificate library.
      -  **flume_sChatt.jks** and **flume_cChatt.jks** are the SSL certificate trust lists of the Flume server and client, respectively.

      .. note::

         All user-defined passwords involved in this section (such as *sNetty12@*) must meet the following requirements:

         -  Contain at least four types of the following: uppercase letters, lowercase letters, digits, and special characters.
         -  Contain at least eight characters and a maximum of 64 characters.
         -  It is recommended that the user-defined passwords be changed periodically (for example, every three months), and certificates and trust lists be generated again to ensure security.

#. On FusionInsight Manager, choose **System > User** and choose **More > Download Authentication Credential** to download the Kerberos certificate file of user **flume_hdfs** and save it to the local host.
#. Configure the server parameters of the Flume role and upload the configuration file to the cluster.

   a. Log in to any node where the Flume role is located as user **omm**. Run the following command to go to the ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/bin directory:

      **cd ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/bin**

   b. .. _mrs_01_1070__en-us_topic_0000001219350773_lf43fc3e7d9364ddb9e475908dc382fc9:

      Run the following command to generate and obtain Flume server keystore password, trust list password, and keystore-password encrypted private key information. Enter the password twice and confirm the password. It is the password of the **flume_sChat.jks** certificate library, for example, *sNetty12@*.

      **./genPwFile.sh**

      **cat password.property**

      .. code-block::

         password=D03C2D03D97CBA3F4FD2491A40CAA5E0

   c. Use the Flume configuration tool on the FusionInsight Manager portal to configure the server parameters and generate the configuration file.

      #. Log in to FusionInsight Manager and choose **Cluster** > *Name of the desired cluster* > **Services** > **Flume** > **Configuration Tool**.

      #. Set **Agent Name** to **server**. Select the source, channel, and sink to be used, drag them to the GUI on the right, and connect them.

         For example, use Avro Source, File Channel, and HDFS Sink, as shown in :ref:`Figure 1 <mrs_01_1070__en-us_topic_0000001219350773_f6daeef3446e547b29a54dde54d85e083>`.

         .. _mrs_01_1070__en-us_topic_0000001219350773_f6daeef3446e547b29a54dde54d85e083:

         .. figure:: /_static/images/en-us_image_0000001349139425.png
            :alt: **Figure 1** Example for the Flume configuration tool

            **Figure 1** Example for the Flume configuration tool

      #. Double-click the source, channel, and sink. Set corresponding configuration parameters by seeing :ref:`Table 1 <mrs_01_1070__en-us_topic_0000001219350773_t90702710f4c74f1ea2a89064a9507879>` based on the actual environment.

         .. note::

            -  If the server parameters of the Flume role have been configured, you can choose **Cluster** > *Name of the desired cluster* > **Services** > **Flume** > **Instance** on FusionInsight Manager. Then select the corresponding Flume role instance and click the **Download** button behind the **flume.config.file** parameter on the **Instance Configurations** page to obtain the existing server parameter configuration file. Choose **Cluster** > *Name of the desired cluster* > **Services** > **Flume** > **Configuration Tool** > **Import**, import the file, and modify the configuration items related to encrypted transmission.
            -  It is recommended that the numbers of Sources, Channels, and Sinks do not exceed 40 during configuration file import. Otherwise, the response time may be very long.
            -  A unique checkpoint directory needs to be configured for each File Channel.

      #. Click **Export** to save the **properties.properties** configuration file to the local.

         .. _mrs_01_1070__en-us_topic_0000001219350773_t90702710f4c74f1ea2a89064a9507879:

         .. table:: **Table 1** Parameters to be modified of the Flume role server

             
            | Parameter              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                             | Example Value                                                                                                                                                                                                                              |
             
            | Name                   | The value must be unique and cannot be left blank.                                                                                                                                                                                                                                                                                                                                                                                                      | test                                                                                                                                                                                                                                       |
             
            | bind                   | Specifies the IP address to which Avro Source is bound. This parameter cannot be left blank. It must be configured as the IP address that the server configuration file will upload.                                                                                                                                                                                                                                                                    | 192.168.108.11                                                                                                                                                                                                                             |
             
            | port                   | Specifies the IP address to which Avro Source is bound. This parameter cannot be left blank. It must be configured as an unused port.                                                                                                                                                                                                                                                                                                                   | 21154                                                                                                                                                                                                                                      |
             
            | ssl                    | Indicates whether to enable the SSL authentication. (You are advised to enable this function to ensure security.)                                                                                                                                                                                                                                                                                                                                       | true                                                                                                                                                                                                                                       |
            |                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                                                                                                                                            |
            |                        | Only Sources of the Avro type have this configuration item.                                                                                                                                                                                                                                                                                                                                                                                             |                                                                                                                                                                                                                                            |
            |                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                                                                                                                                            |
            |                        | -  **true** indicates that the function is enabled.                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                            |
            |                        | -  **false** indicates that the client authentication function is not enabled.                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                                                                                            |
             
            | keystore               | Indicates the server certificate.                                                                                                                                                                                                                                                                                                                                                                                                                       | ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/flume_sChat.jks                                                                                                                                 |
             
            | keystore-password      | Specifies the password of the key library, which is the password required to obtain the keystore information.                                                                                                                                                                                                                                                                                                                                           | D03C2D03D97CBA3F4FD2491A40CAA5E0                                                                                                                                                                                                           |
            |                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                                                                                                                                            |
            |                        | Enter the value of **password** obtained in :ref:`3.b <mrs_01_1070__en-us_topic_0000001219350773_lf43fc3e7d9364ddb9e475908dc382fc9>`.                                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                                                            |
             
            | truststore             | Indicates the SSL certificate trust list of the server.                                                                                                                                                                                                                                                                                                                                                                                                 | ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/flume_sChatt.jks                                                                                                                                |
             
            | truststore-password    | Specifies the trust list password, which is the password required to obtain the truststore information.                                                                                                                                                                                                                                                                                                                                                 | D03C2D03D97CBA3F4FD2491A40CAA5E0                                                                                                                                                                                                           |
            |                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                                                                                                                                            |
            |                        | Enter the value of **password** obtained in :ref:`3.b <mrs_01_1070__en-us_topic_0000001219350773_lf43fc3e7d9364ddb9e475908dc382fc9>`.                                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                                                            |
             
            | dataDirs               | Specifies the directory for storing buffer data. The run directory is used by default. Configuring multiple directories on disks can improve transmission efficiency. Use commas (,) to separate multiple directories. If the directory is inside the cluster, the **/srv/BigData/hadoop/dataX/flume/data** directory can be used. **dataX** ranges from data1 to dataN. If the directory is outside the cluster, it needs to be independently planned. | /srv/BigData/hadoop/data1/flumeserver/data                                                                                                                                                                                                 |
             
            | checkpointDir          | Specifies the directory for storing the checkpoint information, which is under the run directory by default. If the directory is inside the cluster, the **/srv/BigData/hadoop/dataX/flume/checkpoint** directory can be used. **dataX** ranges from data1 to dataN. If the directory is outside the cluster, it needs to be independently planned.                                                                                                     | /srv/BigData/hadoop/data1/flumeserver/checkpoint                                                                                                                                                                                           |
             
            | transactionCapacity    | Specifies the transaction size, that is, the number of events in a transaction that can be processed by the current Channel. The size cannot be smaller than the batchSize of Source. Setting the same size as batchSize is recommended.                                                                                                                                                                                                                | 61200                                                                                                                                                                                                                                      |
             
            | hdfs.path              | Specifies the HDFS data write directory. This parameter cannot be left blank.                                                                                                                                                                                                                                                                                                                                                                           | hdfs://hacluster/flume/test                                                                                                                                                                                                                |
             
            | hdfs.inUsePrefix       | Specifies the prefix of the file that is being written to HDFS.                                                                                                                                                                                                                                                                                                                                                                                         | TMP\_                                                                                                                                                                                                                                      |
             
            | hdfs.batchSize         | Specifies the maximum number of events that can be written to HDFS once.                                                                                                                                                                                                                                                                                                                                                                                | 61200                                                                                                                                                                                                                                      |
             
            | hdfs.kerberosPrincipal | Specifies the Kerberos authentication user, which is mandatory in security versions. This configuration is required only in security clusters.                                                                                                                                                                                                                                                                                                          | flume_hdfs                                                                                                                                                                                                                                 |
             
            | hdfs.kerberosKeytab    | Specifies the keytab file path for Kerberos authentication, which is mandatory in security versions. This configuration is required only in security clusters.                                                                                                                                                                                                                                                                                          | /opt/test/conf/user.keytab                                                                                                                                                                                                                 |
            |                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                                                                                                                                            |
            |                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                         | .. note::                                                                                                                                                                                                                                  |
            |                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                                                                                                                                            |
            |                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |    Obtain the **user.keytab** file from the Kerberos certificate file of the user **flume_hdfs**. In addition, ensure that the user who installs and runs the Flume client has the read and write permissions on the **user.keytab** file. |
             
            | hdfs.useLocalTimeStamp | Specifies whether to use the local time. Possible values are **true** and **false**.                                                                                                                                                                                                                                                                                                                                                                    | true                                                                                                                                                                                                                                       |
             

   d. Log in to FusionInsight Manager and choose **Cluster** > *Name of the desired cluster* > **Services** > **Flume**. On the displayed page, click the **Flume** role under **Role**.

   e. Select the Flume role of the node where the configuration file is to be uploaded, choose **Instance Configurations** > **Import** beside the **flume.config.file**, and select the **properties.properties** file.

      .. note::

         -  An independent server configuration file can be uploaded to each Flume instance.
         -  This step is required for updating the configuration file. Modifying the configuration file on the background is an improper operation because the modification will be overwritten after configuration synchronization.

   f. Click **Save**, and then click **OK**.

   g. Click **Finish**.

#. Configure the client parameters of the Flume role.

   a. Run the following commands to copy the generated client certificate (**flume_cChat.jks**) and client trust list (**flume_cChatt.jks**) to the client directory, for example, **/opt/flume-client/fusionInsight-flume-1.9.0/conf/**. (The Flume client must have been installed.) **10.196.26.1** is the service plane IP address of the node where the client resides.

      **scp ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/flume_cChat.jks user@10.196.26.1:/opt/flume-client/fusionInsight-flume-1.9.0/conf/**

      **scp ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/flume_cChatt.jks user@10.196.26.1:/opt/flume-client/fusionInsight-flume-1.9.0/conf/**

      .. note::

         When copying the client certificate, you need to enter the password of user **user** of the host (for example, **10.196.26.1**) where the client resides.

   b. Log in to the node where the Flume client is decompressed as user **user**. Run the following command to go to the client directory **/opt/flume-client/fusionInsight-flume-1.9.0/bin**.

      **cd** opt/flume-client/fusionInsight-flume-1.9.0/bin

   c. .. _mrs_01_1070__en-us_topic_0000001219350773_lf5cdb5eca44842caac47a27a09a4e206:

      Run the following command to generate and obtain Flume client keystore password, trust list password, and keystore-password encrypted private key information. Enter the password twice and confirm the password. The password is the same as the password of the certificate whose alias is *flumechatclient* and the password of the *flume_cChat.jks* certificate library, for example *cNetty12@*.

      **./genPwFile.sh**

      **cat password.property**

      .. code-block::

         password=4FD2491A40CAA5E0D03C2D03D97CBA3F

      .. note::

         If the following error message is displayed, run the export **JAVA_HOME=\ JDKpath** command.

         .. code-block::

            JAVA_HOME is null in current user,please install the JDK and set the JAVA_HOME

   d. Use the Flume configuration tool on FusionInsight Manager to configure the Flume role client parameters and generate a configuration file.

      #. Log in to FusionInsight Manager and choose **Cluster** > *Name of the desired cluster* > **Services** > **Flume** > **Configuration Tool**.

      #. Set **Agent Name** to **client**. Select the source, channel, and sink to be used, drag them to the GUI on the right, and connect them.

         Use SpoolDir Source, File Channel, and Avro Sink, as shown in :ref:`Figure 2 <mrs_01_1070__en-us_topic_0000001219350773_f736dda46e68742568d523a52754a5fde>`.

         .. _mrs_01_1070__en-us_topic_0000001219350773_f736dda46e68742568d523a52754a5fde:

         .. figure:: /_static/images/en-us_image_0000001296059712.png
            :alt: **Figure 2** Example for the Flume configuration tool

            **Figure 2** Example for the Flume configuration tool

      #. Double-click the source, channel, and sink. Set corresponding configuration parameters by seeing :ref:`Table 2 <mrs_01_1070__en-us_topic_0000001219350773_t4e49dd595a71448eb33a418332772306>` based on the actual environment.

         .. note::

            -  If the client parameters of the Flume role have been configured, you can obtain the existing client parameter configuration file from *client installation directory*\ **/fusioninsight-flume-1.9.0/conf/properties.properties** to ensure that the configuration is in concordance with the previous. Log in to FusionInsight Manager, choose **Cluster** > *Name of the desired cluster* > **Services** > **Flume** > **Configuration Tool** > **Import**, import the file, and modify the configuration items related to encrypted transmission.
            -  It is recommended that the numbers of Sources, Channels, and Sinks do not exceed 40 during configuration file import. Otherwise, the response time may be very long.

      #. Click **Export** to save the **properties.properties** configuration file to the local.

         .. _mrs_01_1070__en-us_topic_0000001219350773_t4e49dd595a71448eb33a418332772306:

         .. table:: **Table 2** Parameters to be modified of the Flume role client

             
            | Parameter             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                             | Example Value                                                     |
             
            | Name                  | The value must be unique and cannot be left blank.                                                                                                                                                                                                                                                                                                                                                                                                      | test                                                              |
             
            | spoolDir              | Specifies the directory where the file to be collected resides. This parameter cannot be left blank. The directory needs to exist and have the write, read, and execute permissions on the flume running user.                                                                                                                                                                                                                                          | /srv/BigData/hadoop/data1/zb                                      |
             
            | trackerDir            | Specifies the path for storing the metadata of files collected by Flume.                                                                                                                                                                                                                                                                                                                                                                                | /srv/BigData/hadoop/data1/tracker                                 |
             
            | batch-size            | Specifies the number of events that Flume sends in a batch.                                                                                                                                                                                                                                                                                                                                                                                             | 61200                                                             |
             
            | dataDirs              | Specifies the directory for storing buffer data. The run directory is used by default. Configuring multiple directories on disks can improve transmission efficiency. Use commas (,) to separate multiple directories. If the directory is inside the cluster, the **/srv/BigData/hadoop/dataX/flume/data** directory can be used. **dataX** ranges from data1 to dataN. If the directory is outside the cluster, it needs to be independently planned. | /srv/BigData/hadoop/data1/flume/data                              |
             
            | checkpointDir         | Specifies the directory for storing the checkpoint information, which is under the run directory by default. If the directory is inside the cluster, the **/srv/BigData/hadoop/dataX/flume/checkpoint** directory can be used. **dataX** ranges from data1 to dataN. If the directory is outside the cluster, it needs to be independently planned.                                                                                                     | /srv/BigData/hadoop/data1/flume/checkpoint                        |
             
            | transactionCapacity   | Specifies the transaction size, that is, the number of events in a transaction that can be processed by the current Channel. The size cannot be smaller than the batchSize of Source. Setting the same size as batchSize is recommended.                                                                                                                                                                                                                | 61200                                                             |
             
            | hostname              | Specifies the name or IP address of the host whose data is to be sent. This parameter cannot be left blank. Name or IP address must be configured to be the name or IP address that the Avro source associated with it.                                                                                                                                                                                                                                 | 192.168.108.11                                                    |
             
            | port                  | Specifies the IP address to which Avro Sink is bound. This parameter cannot be left blank. It must be consistent with the port that is monitored by the connected Avro Source.                                                                                                                                                                                                                                                                          | 21154                                                             |
             
            | ssl                   | Specifies whether to enable the SSL authentication. (You are advised to enable this function to ensure security.)                                                                                                                                                                                                                                                                                                                                       | true                                                              |
            |                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                   |
            |                       | Only Sources of the Avro type have this configuration item.                                                                                                                                                                                                                                                                                                                                                                                             |                                                                   |
            |                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                   |
            |                       | -  **true** indicates that the function is enabled.                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                   |
            |                       | -  **false** indicates that the client authentication function is not enabled.                                                                                                                                                                                                                                                                                                                                                                          |                                                                   |
             
            | keystore              | Specifies the **flume_cChat.jks** certificate generated on the server.                                                                                                                                                                                                                                                                                                                                                                                  | /opt/flume-client/fusionInsight-flume-1.9.0/conf/flume_cChat.jks  |
             
            | keystore-password     | Specifies the password of the key library, which is the password required to obtain the keystore information.                                                                                                                                                                                                                                                                                                                                           | D03C2D03D97CBA3F4FD2491A40CAA5E0                                  |
            |                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                   |
            |                       | Enter the value of **password** obtained in :ref:`4.c <mrs_01_1070__en-us_topic_0000001219350773_lf5cdb5eca44842caac47a27a09a4e206>`.                                                                                                                                                                                                                                                                                                                   |                                                                   |
             
            | truststore            | Indicates the SSL certificate trust list of the server.                                                                                                                                                                                                                                                                                                                                                                                                 | /opt/flume-client/fusionInsight-flume-1.9.0/conf/flume_cChatt.jks |
             
            | truststore-password   | Specifies the trust list password, which is the password required to obtain the truststore information.                                                                                                                                                                                                                                                                                                                                                 | D03C2D03D97CBA3F4FD2491A40CAA5E0                                  |
            |                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                   |
            |                       | Enter the value of **password** obtained in :ref:`4.c <mrs_01_1070__en-us_topic_0000001219350773_lf5cdb5eca44842caac47a27a09a4e206>`.                                                                                                                                                                                                                                                                                                                   |                                                                   |
             

   e. Upload the **properties.properties** file to **flume/conf/** under the installation directory of the Flume client.

#. Generate the certificate and trust list of the server and client of the MonitorServer role respectively.

   a. Log in to the host with the MonitorServer role assigned as user **omm**.

      Go to the **${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/bin** directory.

      **cd ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/bin**

   b. Run the following command to generate and export the server and client certificates of the MonitorServer role:

      **sh geneJKS.sh -m sKitty12@ -n cKitty12@**

      The generated certificate is saved in the **${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf** path. Where:

      -  **ms_sChat.jks** is the certificate library of the MonitorServer role server. **ms_sChat.crt** is the exported file of the **ms_sChat.jks** certificate. **-m** indicates the password of the certificate and certificate library.
      -  **ms_cChat.jks** is the certificate library of the MonitorServer role client. **ms_cChat.crt** is the exported file of the **ms_cChat.jks** certificate. **-n** indicates the password of the certificate and certificate library.
      -  **ms_sChatt.jks** and **ms_cChatt.jks** are the SSL certificate trust lists of the MonitorServer server and client, respectively.

#. Set the server parameters of the MonitorServer role.

   a. .. _mrs_01_1070__en-us_topic_0000001219350773_la6ea6d1571ea4b2a94b3c942a18144db:

      Run the following command to generate and obtain MonitorServer server keystore password, trust list password, and keystore-password encrypted private key information. Enter the password twice and confirm the password. The password is the same as the password of the certificate whose alias is *mschatserver* and the password of the *ms_sChat.jks* certificate library, for example *sKitty12@*.

      **./genPwFile.sh**

      **cat password.property**

      .. code-block::

         password=AA5E0D03C2D4FD24CBA3F91A40C03D97

   b. Run the following command to open the ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/service/application.properties file: Modify related parameters based on the description in :ref:`Table 3 <mrs_01_1070__en-us_topic_0000001219350773_tc32e0ef5ae504791afb953e98354efa7>`, save the modification, and exit.

      **vi ${BIGDATA_HOME}/FusionInsight_Porter\_**\ 8.1.2.2\ **/install/FusionInsight-Flume-1.9.0/flume/conf/service/application.properties**

      .. _mrs_01_1070__en-us_topic_0000001219350773_tc32e0ef5ae504791afb953e98354efa7:

      .. table:: **Table 3** Parameters to be modified of the MonitorServer role server

         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | Parameter                           | Description                                                                                                                                                               | Example Value                                                                                            |
         +=====================================+===========================================================================================================================================================================+==========================================================================================================+
         | ssl_need_kspasswd_decrypt_key       | Indicates whether to enable the user-defined key encryption and decryption function. (You are advised to enable this function to ensure security.)                        | true                                                                                                     |
         |                                     |                                                                                                                                                                           |                                                                                                          |
         |                                     | -  **true** indicates that the function is enabled.                                                                                                                       |                                                                                                          |
         |                                     | -  **false** indicates that the client authentication function is not enabled.                                                                                            |                                                                                                          |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_server_enable                   | Indicates whether to enable the SSL authentication. (You are advised to enable this function to ensure security.)                                                         | true                                                                                                     |
         |                                     |                                                                                                                                                                           |                                                                                                          |
         |                                     | -  **true** indicates that the function is enabled.                                                                                                                       |                                                                                                          |
         |                                     | -  **false** indicates that the client authentication function is not enabled.                                                                                            |                                                                                                          |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_server_key_store                | Set this parameter based on the specific storage location.                                                                                                                | ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/ms_sChat.jks  |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_server_trust_key_store          | Set this parameter based on the specific storage location.                                                                                                                | ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/ms_sChatt.jks |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_server_key_store_password       | Indicates the client certificate password. Set this parameter based on the actual situation of certificate creation (the plaintext key used to generate the certificate). | AA5E0D03C2D4FD24CBA3F91A40C03D97                                                                         |
         |                                     |                                                                                                                                                                           |                                                                                                          |
         |                                     | Enter the value of **password** obtained in :ref:`6.a <mrs_01_1070__en-us_topic_0000001219350773_la6ea6d1571ea4b2a94b3c942a18144db>`.                                     |                                                                                                          |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_server_trust_key_store_password | Indicates the client trust list password. Set this parameter based on the actual situation of certificate creation (the plaintext key used to generate the trust list).   | AA5E0D03C2D4FD24CBA3F91A40C03D97                                                                         |
         |                                     |                                                                                                                                                                           |                                                                                                          |
         |                                     | Enter the value of **password** obtained in :ref:`6.a <mrs_01_1070__en-us_topic_0000001219350773_la6ea6d1571ea4b2a94b3c942a18144db>`.                                     |                                                                                                          |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_need_client_auth                | Indicates whether to enable the client authentication. (You are advised to enable this function to ensure security.)                                                      | true                                                                                                     |
         |                                     |                                                                                                                                                                           |                                                                                                          |
         |                                     | -  **true** indicates that the function is enabled.                                                                                                                       |                                                                                                          |
         |                                     | -  **false** indicates that the client authentication function is not enabled.                                                                                            |                                                                                                          |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+

   c. Restart the MonitorServer instance. Choose **Cluster >** *Name of the desired cluster* **> Services > Flume > Instance > MonitorServer**, select the configured MonitorServer instance, and choose **More > Restart Instance**. Enter the system administrator password and click **OK**. After the restart is complete, click **Finish**.

#. Set the client parameters of the MonitorServer role.

   a. Run the following commands to copy the generated client certificate (**ms_cChat.jks**) and client trust list (**ms_cChatt.jks**) to the **/opt/flume-client/fusionInsight-flume-1.9.0/conf/** client directory. **10.196.26.1** is the service plane IP address of the node where the client resides.

      **scp ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/ms_cChat.jks user@10.196.26.1:/opt/flume-client/fusionInsight-flume-1.9.0/conf/**

      **scp ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/ms_cChatt.jks user@10.196.26.1:/opt/flume-client/fusionInsight-flume-1.9.0/conf/**

   b. Log in to the node where the Flume client is located as user **user**. Run the following command to go to the client directory **/opt/flume-client/fusionInsight-flume-1.9.0/bin**.

      **cd** /opt/flume-client/fusionInsight-flume-1.9.0/bin

   c. .. _mrs_01_1070__en-us_topic_0000001219350773_l6c040d3a99c04a7d87c53e59bafe8394:

      Run the following command to generate and obtain MonitorServer client keystore password, trust list password, and keystore-password encrypted private key information. Enter the password twice and confirm the password. The password is the same as the password of the certificate whose alias is *mschatclient* and the password of the *ms_cChat.jks* certificate library, for example *cKitty12@*.

      **./genPwFile.sh**

      **cat password.property**

      .. code-block::

         password=BA3F91A40C03D97AA5E0D03C2D4FD24C

   d. Run the following command to open the **/opt/flume-client/fusionInsight-flume-1.9.0/conf/service/application.properties** file. (**/opt/flume-client/fusionInsight-flume-1.9.0** is the directory where the client is installed.) Modify related parameters based on the description in :ref:`Table 4 <mrs_01_1070__en-us_topic_0000001219350773_ta0130cca376a4aaf833fa310a2e59e9d>`, save the modification, and exit.

      **vi** **/opt/flume-client/fusionInsight-flume-1.9.0/conf/service/application.properties**

      .. _mrs_01_1070__en-us_topic_0000001219350773_ta0130cca376a4aaf833fa310a2e59e9d:

      .. table:: **Table 4** Parameters to be modified of the MonitorServer role client

         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | Parameter                           | Description                                                                                                                                                         | Example Value                                                                                            |
         +=====================================+=====================================================================================================================================================================+==========================================================================================================+
         | ssl_need_kspasswd_decrypt_key       | Indicates whether to enable the user-defined key encryption and decryption function. (You are advised to enable this function to ensure security.)                  | true                                                                                                     |
         |                                     |                                                                                                                                                                     |                                                                                                          |
         |                                     | -  **true** indicates that the function is enabled.                                                                                                                 |                                                                                                          |
         |                                     | -  **false** indicates that the client authentication function is not enabled.                                                                                      |                                                                                                          |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_client_enable                   | Indicates whether to enable the SSL authentication. (You are advised to enable this function to ensure security.)                                                   | true                                                                                                     |
         |                                     |                                                                                                                                                                     |                                                                                                          |
         |                                     | -  **true** indicates that the function is enabled.                                                                                                                 |                                                                                                          |
         |                                     | -  **false** indicates that the client authentication function is not enabled.                                                                                      |                                                                                                          |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_client_key_store                | Set this parameter based on the specific storage location.                                                                                                          | ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/ms_cChat.jks  |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_client_trust_key_store          | Set this parameter based on the specific storage location.                                                                                                          | ${BIGDATA_HOME}/FusionInsight_Porter\_8.1.2.2/install/FusionInsight-Flume-1.9.0/flume/conf/ms_cChatt.jks |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_client_key_store_password       | Specifies the keystore password. Set this parameter based on the actual situation of certificate creation (the plaintext key used to generate the certificate).     | BA3F91A40C03D97AA5E0D03C2D4FD24C                                                                         |
         |                                     |                                                                                                                                                                     |                                                                                                          |
         |                                     | Enter the value of **password** obtained in :ref:`7.c <mrs_01_1070__en-us_topic_0000001219350773_l6c040d3a99c04a7d87c53e59bafe8394>`.                               |                                                                                                          |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_client_trust_key_store_password | Specifies the trustkeystore password. Set this parameter based on the actual situation of certificate creation (the plaintext key used to generate the trust list). | BA3F91A40C03D97AA5E0D03C2D4FD24C                                                                         |
         |                                     |                                                                                                                                                                     |                                                                                                          |
         |                                     | Enter the value of **password** obtained in :ref:`7.c <mrs_01_1070__en-us_topic_0000001219350773_l6c040d3a99c04a7d87c53e59bafe8394>`.                               |                                                                                                          |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+
         | ssl_need_client_auth                | Indicates whether to enable the client authentication. (You are advised to enable this function to ensure security.)                                                | true                                                                                                     |
         |                                     |                                                                                                                                                                     |                                                                                                          |
         |                                     | -  **true** indicates that the function is enabled.                                                                                                                 |                                                                                                          |
         |                                     | -  **false** indicates that the client authentication function is not enabled.                                                                                      |                                                                                                          |
         +-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+

8. Verify log transmission.

   a. Log in to FusionInsight Manager. For details, see :ref:`Accessing FusionInsight Manager <mrs_01_2124>`. Choose **Cluster >** *Name of the desired cluster* > **Services** > **HDFS**, click the HDFS WebUI link to go to the HDFS WebUI, and choose **Utilities > Browse the file system**.

   b. Check whether the data is generated in the **/flume/test** directory on the HDFS.


      .. figure:: /_static/images/en-us_image_0000001295899872.png
         :alt: **Figure 3** Checking HDFS directories and files

         **Figure 3** Checking HDFS directories and files
