TrueSight Capacity Optimization (TSCO) - What are the steps to rebuild the Search Index? - INCLUDES VIDEO

Version 25
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    TrueSight Capacity Optimization


    Capacity Optimization


    TrueSight Capacity Optimization 20.02, 11.5, 11.3.01, 11.0, 10.7, 10.5, 10.3, 10.0 ; BMC Capacity Optimization 9.5.02


    Versão em Português deste Artigo:

    The patch I've installed suggests that it is necessary to rebuild the TrueSight Capacity Optimization (TSCO) Search index after installation.
    How can I manually rebuild the TSCO Search Index?



    The following video shows how to rebuild the search index in TSCO:

    Simple index rebuild


    An immediate rebuild can be initiated via the TrueSight Capacity Optimization (TSCO) console. 


    The steps to manually rebuild the search index on TSCO are:


    TSCO 11.5.01 and later

    1. Access the TSCO console UI
    3. Navigate to Administration > System > Status
    5. Find the 'Data Hub' component and click on it
    7. In the 'Data Hub' component list find the 'API Providers - Search service' and click on it
    9. In the 'API Providers - Search service' screen click on the buttons 'Rebuild main index' and 'Rebuild tag index'

    TSCO 11.3.01 and earlier

    1. Access the Console
    3. Navigate to Administration > COMPONENTS > Backend Services
    5. Select API Providers - Search service in the table
    7. Click on the buttons Rebuild main index and Rebuild tag index
    You can find more details in official product documentation.  

    Advanced index rebuild, when the first procedure gives back errors


    Resolution for the following error when rebuilding main index:


      To resolve    BCO_DH_ERROR11: "failed to acquire random test lock" error (all the commands need to me run from the TSCO installation directory, default /opt/bmc/BCO): 
    1. Stop all TSCO components that lock the TSCO index files. To do this, you have to run the command ./cpit stop on all the Application Servers
    3. Backup and then remove the existing search index files      That will create a backup of your current search_index directory and then the rm -rf * will remove the current search_index contents.

      WARNING: Be cautious when running an rm -rf since if the command is executed from the wrong directory it could result critical files being removed from the BCO environment which must be restored from backup to recover the environment.

      • cd repository
      • tar -zcvf search_index_bad.tar.gz search_index
      • cd search_index
      • rm -rf idx_cpit
      • rm -rf idx_tag
    5. Restart the TSCO components that were stopped in step 1 with the command ./cpit start
    7. The Search Index rebuild will start automatically and it can take a few minutes to complete.
    You can check the search index service logs under:  
    • Administration -> Components -> Backend Services -> API Providers - Search service than click on Show Log
    • Administration -> ETL & System Tasks -> System Tasks -> Search index Updater than click on Show Log
    • You can also check the Search Index Updater (system task ID 34) logs: this task will search for the present of the index, once its not found as it was deleted, it will rebuild it, you will see the following lines in this log:
      [taskid=34]-Index is no present. Built it.
      [taskid=34]-Building CPIT_INDEX index...

    If these steps doesn't solve the problem, check also that the nfslock demon is running on all TSCO Application Servers.

    You can refer to this article for more details:
      KA 000099056: In TrueSight Capacity Optimization (TSCO) the Search Index Updater task Failed to acquire random test lock

    Legacy ID:KA356414


    Article Number:


    Article Type:


      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles