Versions Compared

Old Version 5

changes.mady.by.user Johan Montealegre

Saved on

compared with

New Version 6

changes.mady.by.user Johan Montealegre

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


On the page:

Table of Contents

Step 1. Install the Content Analytics expansion pack inside Ambari

  1. Copy the expansion pack file inside the Ambari server machine.

  2. Execute the command

    Code Block
    languagebash
    ambari-server install-mpack --mpack=content-analytics-1.0.0.0.tar.gz -v

  3. Restart the server with the command

    Code Block
    languagebash
    ambari-server restart

  4. Link the expansion pack with the Hortonworks stack version in use

    Code Block
    languagebash
    curl -u admin:DeltaSearch16. -H 'X-Requested-By: ambari' -X POST -d '{"ExtensionLink": {"stack_name": "<STACK_NAME>", "stack_version": "<STACK_VERSION>", "extension_name": "CONTENT_ANALYTICS", "extension_version": "1.0"}}' http://<HOSTNAME> :<PORT>/api/v1/links/
  5. Restart the server again.



Step 2. Add the New Service

On the cluster, click Actions and then Add Service to go to the add service wizard.

Step 2a. Add Aspire as a service

 In the wizard, Aspire should be listed as a service to install.

  1. Select Aspire from the available services.
  2. Select the hosts where Aspire Server will be installed.


Step 2b. Configure Aspire

  1. General settings
    • Install Directory: The path to install Aspire, it will be used as the Aspire Home to use. Once the service is installed, the directory can not be changed.
    • Log Directory: The path for the Aspire logs.
    • License Path: The path of the Aspire license file.
    • Server Port: The Aspire server port number.
    • Aspire User: The user used to run the Aspire process.
    • Aspire Group: The group used to run the Aspire process.
    • Aspire System Properties: Specify the required Aspire system properties to use in the format: NAME:VALUE, one per line. This properties will be available to use on the installed Aspire Components.
    • Enable Debug: Check to enable Aspire debug mode.
    • Debug Port: The aspíre server debug port number.

  2. Repository
    • Maven Repository URL: The Maven repository URL.
    • Maven User Name: The Maven account user name.
    • Maven User Password: The Maven account password.
    • Default Version: The Aspire Bundles Default version.
    • Bundle Versions: Specify the required bundle versions to use in the following format: ARTIFACT_ID:VERSION, one per line.

  3. Security
    • UI protocol: Protocol used on the Aspire UI.
    • Keystore Location: The path of the file containing the keystore, it can be relative to ASPIRE_HOME.
    • Keystore Password: The password for the keystore.
    • Keystore Key Password: The password for the key in the keystore.
    • Truststore Location: The path of the file containing the truststore, it can be relative to ASPIRE_HOME.
    • Truststore Password: The password for the truststore.
    • Authentication Type: The type of authentication user by the Aspire Admin UI. Use None or Ldap.
    • Ldap Server: The ldap server to validate against. This will be ignored if the authentication type is set to None.
    • Ldap Authentication: The ldap authentication to use (anonymous/simple/DIGEST-MD5). This will be ignored if the authentication type is set to None.
    • Ldap Search Base: The search base for ldap queries for the user's dn. This will be ignored if the authentication type is set to None.
    • Ldap Administrator User DN: Holds the dn of one user that may access Aspire with Administration role. Enter one DN per line.
    • Ldap Administrator Group DN: Holds the dn of one group that may access Aspire with Administration role. NOTE: currently, the users must be direct members of this group (not a member of a group that is a member of this group). Enter one DN per line.
    • Ldap Developer User DN: Holds the dn of one user that may access Aspire with Developer role. Enter one DN per line.
    • Ldap Developer Group DN: Holds the dn of one group that may access Aspire with Developer role. NOTE: currently, the users must be direct members of this group (not a member of a group that is a member of this group). Enter one DN per line.
    • Ldap Groups Hold Members: Indicates that ldap group objects hold the membership information. By default, user objects are expected to hold group membership. This will be ignored if the authentication type is set to None.
    • Ldap User DN Query: The ldap query used to find the dn for the user that logged in. This will be ignored if the authentication type is set to None.

    • Ldap Member Attribute: The attribute of the ldap object (be it user or group) that holds information about group membership. This will be ignored if the authentication type is set to None.

      Info

      For more details about how these properties work check the Aspire security documentation

  4. NoSQL
    • Database Provider Implementation: The noSQL database provider implementation.
    • HBase Namespace Prefix: The prefix to use for the HBase namespaces. This will be ignored if the provider is not HBase.
    • HBase Create Namespaces: By default Aspire will create database name spaces. This will be ignored if the provider is not HBase.
    • HBase Properties: Specify the required Hbase properties to use in the format: NAME:VALUE, one per line. This will be ignored if the provider is not HBase.
    • HBase Configuration Path: The path to the HBase configuration files. This will be ignored if the provider is not HBase.
    • HBase Kerberos User: The HBase user to use with Kerberos. This will be ignored if the provider is not HBase.
    • HBase Kerberos Keytab File: The HBase keytab file to use with Kerberos. This will be ignored if the provider is not HBase.

    • MongoDB Server: The MongoDB server. This will be ignored if the provider is not MongoDB.

      Info

      For Check the documentation for more details about how these properties work check the HBase provider documentationproperties work

  5. System
    • Initial Memory: Aspire initial memory.
    • Maximum Memory: Aspire maximum memory.
    • Maximum Metaspace: Aspire maximum metaspace memory.
    • Extra System Packages: Appends packages (one per line) to the default set of exported system packages.
    • Boot Delegation Packages: The following property makes specified packages (one per line) from the class path available to all bundles. You should avoid using this property.
    • Additional Felix Properties: Add any additional Felix properties to use, format: PROPERTY=VALUE, one per line.
    Ldap settings. These will be ignored if the authentication type is set to None. For more details about how these properties work check the Aspire security documentation
  6. LDAP server: The ldap server to validate against.
  7. LDAP Authentication: The ldap authentication to use (anonymous/simple/DIGEST-MD5).
  8. LDAP Search Base: The search base for ldap queries for the user's dn.
  9. LDAP Administrator User DN: Holds the dn of one user that may access Aspire with Administration role
  10. LDAP Administrator Group DN: Holds the dn of one group that may access Aspire with Administration role. NOTE: currently, the users must be direct members of this group (not a member of a group that is a member of this group).
  11. LDAP Developer User DN: Holds the dn of one user that may access Aspire with Developer role.
  12. LDAP Developer Group DN: Holds the dn of one group that may access Aspire with Developer role. NOTE: currently, the users must be direct members of this group (not a member of a group that is a member of this group).
  13. LDAP Groups Hold Members: Indicates that ldap group objects hold the membership information. By default, user objects are expected to hold group membership.
  14. LDAP User DN Query: The ldap query used to find the dn for the user that logged in.
    15. LDAP Member Attribute: The attribute of the ldap object (be it user or group) that holds information about group membership.
    Other Aspire settings
  15. System Properties: Specify the required Aspire system properties to use in the format: NAME:VALUE. This properties will be available to use on the installed Aspire Components by referencing them as ${PROPERTY_NAME}.
    16. Bundle Versions:  Specify the required bundle versions to use in the following format: ARTIFACT_ID:VERSION.  Use this for components that require a different version from the default one.
    Felix settings. Settings related with the felix properties file used by Aspire. Use only if there properties required that are not included by the default felix.properties file.
  16. Additional Felix Properties: Add any additional Felix properties to use, format: PROPERTY=VALUE.
  17. Extra System Packages: Appends packages to the default set of exported system packages.
    18. Boot Delegation Packages: The following property makes specified packages from the class path available to all bundles. You should avoid using this property.
    JVM settings
    • Initial Memory: Aspire initial memory.
    • Maximum Memory: Aspire maximum memory
    • Maximum Metaspace: Aspire maximum Metaspace
    • JVM Additional Options: Add any additional JVM options to use, format: OPTION=VALUE.


Step 2c. Finish the installation

Continue to the next tab on the wizard and review the configurations, finally clink on deploy and wait for Aspire to start running, after that the installation process is done.