Installing the Analytics Backend

To install the Analytics Backend, follow the steps below.

To install the Backend:

1. Unzip the content of the deployment package (Analytics.On.Premise_Analytics.Backend_.zip) into the folder where you want to run the backend (e.g.: C:\Automic\AnalyticsBackend).

   PackageEin Package ist eine Instanz (eine Version, eine Revision, ein Tag, ...) Ihrer Applikation und definiert den Content, den Sie deployen möchten. Hier entscheiden Sie, ob Sie die gesamte Applikation oder nur einige spezifische Komponenten deployen möchten. content:

   • ARA folder
   • Package Manager analytics-backend.jar
   • application.properties.sample
   • logging.xml
   • LICENSE.txt
   • README.txt
   • NOTICE.txt
2. Create a ”jdbc” folder (/automic/analytics/backend/jdbc) .

3. Copy the jdbc driver to the jdbc folder:

   ./analytics_backend.jar

   ./jdbc/sqljdbc4.jar (mssql)

   ./jdbc/ojdbc7.jar (oracle)

4. Rename the application.properties.sample file to application.properties.

5. Open the configuration file application.properties and adopt the settings for the Analytics Datastore:
   1. Add the datastore connection (last lines from executing the setup.psql script).

   2. Set the database connection to the AEdatabase as described (ARA is not required!).

      Make sure to also set the correct type to ORACLE or SQL.

   3. Configure a free port on the host:

      Parameter	Value (Example)	Remark
      datasource.analytics.url	jdbc:postgresql://localhost:5432/analytics?tcpKeepAlive=true	The value must be the JDBC connection string to your Analytics Datastore database
      datasource.username	analytics	The value must be the user name to connect to the Analytics Datastore database You have created the user during the installationnull of the Analytics Datastore.
      datasource.password	analyticsPW	The password for the user configured in spring.datasource.username
      server.port	8090	Set the HTTP server port for the Analytics Backend Tomcat webserver

6. The analytics-backend.jar has to be passed to a Java process. Assuming Java 1.8 is installed and executable via the 'java' command, the following line executed in a command shell (both Windows and Unix) will start the Backend:

   java -jar analytics-backend.jar

   This command only works when executed in the bin directory of the analytics-backend.

7. Verify that the Analytics Backend is running:

   Connect to configured port (server.port) from the host where AWIAutomic-Produkt: Übersichtliche und einfach zu bedienende Weboberfläche, mit welcher der Zugriff auf verschiedene Funktionalitäten der Automation Engine möglich ist. is installed.

   You may use curl, wget or a browser.

   Request:

   GET http://my-analytics-backend-url:8090/analytics/api/v1

   Response:

   { "_links" : { "reports" : { "href" : "http://my-analytics-backend-url:8090/reports{?page,size,sort}", "templated" : true }, "collectors" : {"href" : "http://my-analytics-backend-url:8090/collectors" }, "profile" : { "href" : "http://my-analytics-backend-url:8090/alps" } } }

   For a single-box installation, you can use localhost instead of my-analytics-backend-url.

8. To ensure that the Analytics Backend is running even after a reboot, configure the Automic Service ManagerProdukt(e): AE, RA_JMS. Der Service Manager dient dazu, Komponenten wie AE-Serverprozesse oder Agenten zu starten oder zu stoppen. Sie haben somit die Möglichkeit, von einer zentralen Stelle auf diese Programme zuzugreifen. to start the Analytics Backend.

   

   View in the Automic Service Manager (example)

   For more information about the Automic Service Manager, see the Administration Guide of the Automation EngineDiese Komponente steuert ein Automation Engine-System. Besteht aus verschiedenen Serverprozessen., which you can find on docs.automic.com.

9. Optionally, add the backend to the service manager.

Now, the Analytics Backend is installed and configured.