IBM Operations Analytics - Log Analysis, Version 1.3.0

Installing using the console

You can install IBM® Operations Analytics - Log Analysis by using the console.

Before you begin

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.
Ensure that you complete all the prerequisites. For more information, see Prerequisite tasks.
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.
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.
Do not enter Control -C to cancel the installation because this setting can cause the installer to behave inconsistently. Instead, to cancel the installation, enter c when prompted.
Ensure that IBM Installation Manager is not configured to search the service repositories. If the server is not connected to the internet, this setting can cause the installation to fail or stall.
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.
To install IBM Operations Analytics - Log Analysis:
1. From the directory location of the extracted installation files, run the command:
```
./install.sh -c
```
2. Select the default IBM Log File Agent, Apache Solr, and IBM Operations Analytics - Log Analysis packages.
  Note: If you cannot select the IBM Log File Agent, ensure that the hardware and software requirements are implemented.
3. Accept the license agreement.
4. If required, change the installation location. Otherwise, accept the default location.
5. Choose the IBM Operations Analytics - Log Analysis feature and, if required, the IBM Tivoli Monitoring Log File Agent feature.
6. If necessary, change the default port numbers. Otherwise, accept the default ports.
7. To install a local Indexing Engine instance, ensure that Apache Solr is selected. Apache Solr is selected by default. 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 Indexing Engine instances on remote machines after the installation is completed. To enable search and indexing, you must install at least one Indexing Engine instance locally or remotely.
8. If you want to generate an installation response file for future silent installations, select Generate an Installation Response File.
9. When the installation is complete, select Finish.
To check the details of the installation, choose View Installed Packages.

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 Apache Solr on remote server, 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