This is the documentation for Cloudera Search 1.3.0 for CDH 4.
Documentation for other versions is available at Cloudera Documentation.

Upgrading to the Latest Search 1.x

Upgrading Cloudera Search involves stopping the Search service, using your operating system's package management tool to upgrade Search to the latest version, and then restarting the Search service.

  Note: To see which version of Cloudera Manager is recommended with the latest version of Search, refer to Cloudera Search Requirements.

Upgrading Search through Cloudera Manager - Parcels

To upgrade Search in a Cloudera Manager managed environment, using parcels:

  1. If you originally installed using packages and now are switching to parcels, you must remove the Solr packages first.
    The list of packages you may need to remove are:
    • solr
    • solr-doc
    • solr-mapreduce
    • hbase-solr
    • hbase-solr-doc
    • search
    You can check which packages are installed using one of the following commands, depending on your operating system:
    rpm -qa               # RHEL, Oracle Linux, CentOS, Debian
    dpkg --get-selections # Debian
    Remove the packages using the appropriate remove command for your OS. For example:
    yum remove solr solr-doc solr-mapreduce hbase-solr hbase-solr-doc search    # RHEL, Oracle Linux, CentOS
  2. Connect to the Cloudera Manager Admin Console.
  3. Go to the Hosts < Parcels tab. You should see a parcel with a newer version of Search that you can upgrade to.
  4. Click Download, then Distribute. (The button changes as each step completes.)
  5. Click Activate.
  6. When prompted, click Restart to restart the Search service.

Upgrading Search through Cloudera Manager - Packages

To upgrade Search in a Cloudera Manager managed environment, using packages:

  1. Connect to the Cloudera Manager Admin Console.
  2. In the Services tab, click the Search service.
  3. Click Actions and click Stop.
  4. Update the .repo files to point to the latest repo URLs. Depending on your version of CDH 4, you may need to upgrade your CDH 4 deployment in addition to your Search version.
    • Download the latest search .repo file, cloudera-search.repo, from http://archive.cloudera.com/search/. You can find links to the latest .repo or .list files at Cloudera Search Version and Download Information.

      The contents of Search .repo file should look similar to the following:

      [cloudera-search]
      # Packages for Cloudera Search version 1.x, on RedHat or CentOS 6 x86_64
      name=Cloudera Search version 1.x
      baseurl=http://archive.cloudera.com/search/redhat/6/x86_64/search/1/
      gpgkey = http://archive.cloudera.com/search/redhat/6/x86_64/search/RPM-GPG-KEY-cloudera
      gpgcheck = 1

      The contents of a .list file should look similar to the following:

      # Packages for Cloudera Search, version 1.x, on Debian 6.0 amd64
      deb http://archive.cloudera.com/search/debian/squeeze/amd64/search squeeze-search1 contrib
      deb-src http://archive.cloudera.com/search/debian/squeeze/amd64/search squeeze-search1 contrib
    • You may also need to update your CDH 4 .repo or .list file. This can be found at http://archive.cloudera.com/cdh4/. Links to the CDH 4 repositories can be found at CDH 4 Version and Packaging Information.
        Note: Make sure you have only one .repo file for a specific component. If you have a .repo file for a previous version, you should remove it before you download a new version.
    • To verify that you have the .repo files you expect:
      • ls -l /etc/yum.repos.d/ for YUM

      • ls -l /etc/apt/sources.list.d/ for Debian/Ubuntu

      • ls -l /etc/zypp/repos.d/ for SLES

  5. Use one of the following sets of commands to update Solr on each node in your cluster where Solr-server is installed:
      Note: The solr-doc and hbase-solr-doc packages provide documentation and installing/updating them (as in the following commands) is optional.

    For RHEL, Oracle Linux, or CentOS systems:

    $ sudo yum clean all
    $ sudo yum update hbase-solr search solr solr-mapreduce solr-doc hbase-solr-doc

    For SUSE systems:

    $ sudo zypper clean --all
    $ sudo zypper install hbase-solr search solr solr-mapreduce solr-doc \
    hbase-solr-doc

    For Debian or Ubuntu systems:

    $ sudo apt-get install hbase-solr search solr solr-mapreduce solr-doc \
    hbase-solr-doc
  6. Connect to the Cloudera Manager Admin Console.
  7. In the Services tab, click the Search service.
  8. Click Actions and click Start.

Upgrading Search without Cloudera Manager

To upgrade Search without Cloudera Manager:

  1. Stop the solr-server on each Search node in your cluster:
    $ sudo service solr-server stop
  2. Update the .repo files to point to the latest .repo URLs. Depending on your version of CDH 4, you may need to upgrade your CDH 4 deployment in addition to your Search version.
    • Download the latest search .repo file, cloudera-search.repo, from http://archive.cloudera.com/search/. You can find links to the latest .repo or .list files at Cloudera Search Version and Download Information. See the examples above for what the contents of the .repo files should look like.
    • You may also need to update your CDH 4 .repo or .list file. This can be found at http://archive.cloudera.com/cdh4/. Links to the CDH 4 repos can be found at CDH 4 Version and Packaging Information.
        Note: Make sure you have only one .repo file for a specific component. If you have a .repo file for a previous version, you should remove it before you download a new version.
    • To verify that you have the .repo files you expect:
      • ls -l /etc/yum.repos.d/ for YUM

      • ls -l /etc/apt/sources.list.d/ for Debian/Ubuntu

      • ls -l /etc/zypp/repos.d/ for SLES

  3. Use one of the following sets of commands to update Search on each node in your cluster:
      Note: The solr-doc and hbase-solr-doc packages provide documentation and installing/updating them (as in the following commands) is optional.

    For RHEL, Oracle Linux, or CentOS systems:

    $ sudo yum update hbase-solr search solr solr-mapreduce solr-doc hbase-solr-doc

    For SUSE systems:

    $ sudo zypper update hbase-solr search solr solr-mapreduce solr-doc \
    hbase-solr-doc

    For Debian or Ubuntu systems:

    $ sudo apt-get install hbase-solr search solr solr-mapreduce solr-server \
    hbase-solr-indexer solr-doc hbase-solr-doc
  4. Restart the Search service. Expect to see a process named solrd if the service started successfully.
    $ sudo service solr-server start
    $ ps ax | grep [s]olrd
     30574 ?        S      0:02 /bin/bash /usr/lib/solr/bin/solrd run
  Note:

If the services did not start successfully (even though the sudo service command might display [OK]), check for errors in the Search log file, typically in /var/log/solr.