IBM Operations Analytics - Log Analysis, Version 1.3.0

Installing IBM Operations Analytics - Log Analysis

You must complete the following steps to install IBM® Operations Analytics - Log Analysis.

Before you begin

Ensure that you complete all the prerequisites. For more information, see Prerequisite tasks.
Ensure that your user has the access rights that are required to add files to the location where you want to install IBM Operations Analytics - Log Analysis.
If you previously installed IBM Tivoli® Monitoring Log File Agent 6.3 or lower, the installation fails. To solve this problem, stop the existing IBM Tivoli Monitoring Log File Agent installation or rename the folder that was created when it was installed. For detailed information, see the topic about the installation failure if IBM Tivoli Monitoring Log File Agent was installed in the Troubleshooting IBM Operations Analytics - Log Analysis guide.
Before you install IBM Operations Analytics - Log Analysis, you must ensure that the details for each host server are maintained correctly in the /etc/hosts directory on the target system. Failure to complete this task can result in Oauth errors when you run a custom app. For more information, see the Verify host server IP address and names section in Prerequisite tasks.
Ensure that the Search service reposiutories during installation and updates check box is not selected. If you do select this check box and the server is not connected to the internet, the installation can stall or fail.
For more information about IBM Installation Manager, see the IBM Knowledge Center at https://www-01.ibm.com/support/knowledgecenter/SSDV2W/im_family_welcome.html.

About this task

When you run the installation script, IBM Operations Analytics - Log Analysis and IBM Installation Manager are installed. IBM Installation Manager Version 1.8.2 is installed when you install IBM Operations Analytics - Log Analysis. Where necessary, IBM Operations Analytics - Log Analysis upgrades the currently installed version of IBM Installation Manager.

Note: The installation path accepts ASCII characters only. Other characters, such as native language characters are not supported.

Procedure

Copy and extract the installation archive to a location on your server.
From the directory to which you extracted the installation files, run the command:
```
./install.sh 
```
Note: Add a -c parameter to start the installation in console only mode.

Note: To install IBM Operations Analytics - Log Analysis on a remote server using GUI mode, ensure that virtual desktop software is installed on the server that you want to install IBM Operations Analytics - Log Analysis on.
The Install Packages screen is displayed.
To install IBM Operations Analytics - Log Analysis in the default directory, click Next. To install IBM Operations Analytics - Log Analysis to a different location, click Browse, select an alternative location, and click Next.
To continue, accept the license agreement, and click Next.
To accept the default IBM Log File Agent, Apache Solr, and IBM Operations Analytics - Log Analysis options, click Next.
Note: If you cannot select the IBM Log File Agent, ensure that the hardware and software requirements are implemented.
The default ports that are used by IBM Operations Analytics - Log Analysis are displayed. Accept the default option if these ports are not in use by any other application or change them if necessary. Click Next.
If you want to install a local Indexing Engine instance, ensure that the Apache Solr check box is selected. The check box is selected by default. If you want to use a local Indexing Engine installation, you must install it now. You cannot install it after the IBM Operations Analytics - Log Analysis is installed. However, you can install instances of Indexing Engines on remote servers after the installation is completed. To enable search and indexing, you must install at least one Indexing Engine instance locally or remotely.
Review the summary information that is provided for the installation and click Install.
To complete the installation click Finish.

What to do next

Download a license for IBM Operations Analytics - Log Analysis from Passport Advantage®: http://www-01.ibm.com/software/lotus/passportadvantage/ and complete the steps that are outlined in the license file readme file. If you are upgrading from a previous version of IBM Operations Analytics - Log Analysis, you can manually copy your license details to the new IBM Operations Analytics - Log Analysis installation.

To verify that the installation is complete, log in to IBM Operations Analytics - Log Analysis. For more information, see Logging in to IBM Operations Analytics - Log Analysis.

To install Indexing Engines on remote servers, you can create them after IBM Operations Analytics - Log Analysis is installed. For more information, see Installing Apache Solr on remote machines.

If you do not install a local Indexing Engine instance, you must install Indexing Engine on a remotely connected server. If you do not install at least one Indexing Engine instance either locally or on a remote server, the search and indexing features do not work.

If you do not verify the server details as described in the Prerequisites topic, the following error message is displayed when you try to run a custom app:

Failed to launch. Could not retrieve OAuth access token.

To correct this error, you must ensure that the server details are correct and start the installation again. For more information, see Could not retrieve Oauth access token in the Troubleshooting section.

Feedback