Optional: Configuring SmartCloud Analytics

You can configure SmartCloud Analytics into Insight Server if you want to search for logged events and generate analytic content from this data.

Before you begin

SmartCloud Analytics Embedded is an option in the installer. If you want to use SmartCloud Analytics, then you must select this feature when you install Decision Server Insights. A SmartCloud Analytics image is created when the feature is installed.

About this task

After you install and configure your development server, you can set up SmartCloud Analytics to process and analyze logs and event history.

The SmartCloud Analytics image is included in the distribution after you install Decision Server Insights on Linux. You use the image to create SmartCloud Analytics servers.

Procedure

In a command shell, go to the SmartCloud Analytics image <InstallDir>/SmartCloud_Analytics, and then run the following command:
```
./setup.sh all cluster_name
```
Where cluster_name specifies the search cluster name.
Go to the SmartCloud Analytics home directory /opt/IBM/x2020, and start the server by entering the following command:
```
./iwap.sh start
```
In a browser, go to the following address http://localhost:port/x2020/x2020.html.
Tip: If you receive an HTTP 403 'Forbidden' error, give group and other read and execute permissions to the opt, IBM, and x2020 directories.
Log in by using the user name admin, and password superuser.
On the tenants page, press [+] to add a tenant. Typically add a different tenant for each solution.
For each solution that you want to log in SmartCloud Analytics, you must set several solution properties in the server.xml of your development server.
1. Set the x2020HostPort property.
2. Set the x2020UserName property to the name of the tenant you added.
3. Set the x2020Password property to the password for the tenant.
4. Optional: Set the x2020DisableSSLHostnameVerification property. The default value of this property is false, which means that the host part of the x2020HostPort property must match the host name in the certificate that is presented by the server during SSL handshake negotiation. Set the value of the property to true to disable verification of the SSL credentials.
For example:
```
<ia_runtimeSolutionProperty solutionName="hello_world" propertyName="x2020HostPort" value="2020server.hostname.com" />
<ia_runtimeSolutionProperty solutionName="hello_world" propertyName="x2020UserName" value="admin2" />
<ia_runtimeSolutionProperty solutionName="hello_world" propertyName="x2020Password" value="admin2" />
<ia_runtimeSolutionProperty solutionName="hello_world" propertyName="x2020DisableSSLHostnameVerification" value="true" />
```
Add the SmartCloud Analytics server's public certificate to the server's Java™ truststore. You can add a public certificate in a number of different ways. One way is to use your browser to fetch the public certificate from the SmartCloud Analytics server, export it from the browser, and import it to the truststore.
1. Open the SmartCloud Analytics console in a browser by entering the following URL: http://server_name:port/x2020/x2020.html, and login as an admin user.
  Where server_name is the name of the host computer and port is the port number for your server. The default port number for WebSphere® Application Server is 9080, but it can be different depending on your installation.
2. When prompted, accept the server's public certificate through the browser.
  When you accept, the SmartCloud Analytics server's public certificate is added to your browser's certificate store.
3. From the browser's menu bar, click Tools > Options > Advanced > Certificates > View certificates > Servers tab.
4. Select the x2020Default certificate, and click Export.
5. Save the certificate as a .crt file.
6. Copy the .crt file to the Java truststore of your cisDev server.
  For example, run the following command from the <InstallDir>/jdk/bin/ directory to import the certificate.
```
./keytool -import -file x2020Default.crt -alias x2020Default -keystore <InstallDir>/runtime/wlp/usr/servers/cisDev/resources/security/key.jks -storepass tester
```
Restart your development server.
After the server is started, open the SmartCloud Analytics console, and enter the name of your solution in the search field to test that the search works.