Upgrading the InTracer

The information and instructions in this chapter should be used to upgrade an InTracer installation. These instructions assume that you have already obtained the upgrade file(s) and have stored them on the server running the InTracer application. InTracer supports upgrade to newer releases so that new functionalities are available to the end-user.

This chapter includes following sections:

Pre-Upgradation Check

Before upgrading InTracer components, perform the following check:

  1. Make sure that C-InTracer with data is installed at the location <C-InTracer-Home>.
  2. Make sure that R-InTracer with data is installed at the location <R-InTracer-Home>.
  3. Make sure that R-TCE with data is installed at the location <R-TCE-Home>.

C-InTracer Upgradation

This section describes the steps required for manual upgradation of C-InTracer component.

IMPORTANT:

All files required to manually upgrade each component is available in the upgrade folder.

Stop individual component before proceeding with upgradation. To stop the component use the command: ./ipmssys stop

To upgrade C-InTracer, perform the following steps:

  1. Back up the configuration by performing the following steps:
    1. Go to the directory in which the C-InTracer files are located by executing the command
      cd <C-InTracer-Home>
      
    2. From the upgrade folder, copy Backup.sh and C-InTracer-InstallValues.txt to <C-InTracer-Home>
    3. Backup the C-InTracer data by executing the command
      ./Backup.sh 
      
    4. To upgrade C-InTracer component, enter option 1.
    5. To save the configuration information, enter <valid-location>. Your configuration information is now available at <valid-location>/C-InTracer-InstallValues.txt
  2. Backup the C-InTracer data by executing the following commands:
    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:`pwd`/3rdparty/postgres/lib
    
    <C-InTracer-Home>/3rdparty/postgres/bin/pg_start
    
    ./3rdparty/postgres/bin/pg_dump
    -p <POSTGRES_PORT> ipmsdb > <data_backup_path>/ipmsdb.backup
    ;   
    

    IMPORTANT:

    The <data_backup_path> should be outside the folder created during installation.

  3. Stop the C-InTracer component by executing the command
    <C-InTracer-Home>/3rdparty/postgres/bin/pg_stop
    
  4. Copy the data under <Install_dir>/data/QS/scheduled_queries/ to a specific directory to be retrieved later.
  5. Uninstall the C-InTracer component by executing the command
    ./Uninstall_InTracer/Uninstall_InTracer
    
  6. Install the new binary at the same location, that is, < C-InTracer-Home>, using console mode, entering the same configuration details as previous installation. Copy the data backed up in Step 4 under <C-Intracer-Home>/data/QS/scheduled_queries/ directory.
  7. Go to the directory in which the C-InTracer files are located by executing the command
    cd <C-InTracer-Home>
    
  8. Start the C-InTracer component by executing the command
    ./ipmssys
    start
    
  9. Stop the C-InTracer component by executing the command
    ./ipmssys
    stop
    
  10. Restore the data by executing the following commands:
    <C-InTracer-Home>/3rdparty/postgres/bin/pg_start
    
    ./3rdparty/postgres/bin/psql
    -U <username> -p <POSTGRES_PORT> template1 
    
         drop
    database ipmsdb;
    
         create
    database ipmsdb;
    
         \q 
    
    ./3rdparty/postgres/bin/psql
    -d ipmsdb -f <data_backup_path>/ipmsdb.backup
    -p <POSTGRES_PORT>
    
  11. Copy the following files to <C-InTracer-Home> :
    • update_postgres1.sql
    • update_postgres2.sql
    • sync_C.py
    • sync_R.py
    • sync_T.py
    • Backup.sh
  12. Apply the update_postgres1.sql file on the database, using the command
    ./3rdparty/postgres/bin/psql
    -U <username> -d ipmsdb -p <POSTGRES_PORT> -f update_postgres1.sql
    
  13. Take backup by executing the command
    ./Backup.sh
    
  14. Choose option 4 - Restore.
  15. Export relevant paths as mentioned in the set_paths.txt document in upgrade folder.
  16. Run python scripts as follows:
    python sync_C.py;
    python sync_R.py; python sync_T.py
    
  17. Apply the update_postgres2.sql file on the database by executing the command
    ./3rdparty/postgres/bin/psql
    -U <username> -d ipmsdb -p <POSTGRES_PORT> -f update_postgres2.sql
    
  18. Start the C-InTracer component by executing the command
    ./ipmssys
    start
    
  19. Stop the C-InTracer component by executing the command
    ./ipmssys stop
    

R-InTracer Upgradation

This section describes the steps required for manual upgradation of R-InTracer component.

IMPORTANT:

All files required to manually upgrade each component is available in the upgrade folder.

Stop individual component before proceeding with upgradation. To stop the component use the command: ./ipmssys stop

To upgrade R-InTracer, perform the following steps:

  1. Back up the configuration by performing the following steps:
    1. Go to the directory in which the R-InTracer files are located by executing the command.
      cd <R-InTracer-Home>
      
    2. From the upgrade folder, copy Backup.sh and R-InTracer-InstallValues.txt to <R-InTracer-Home>.
    3. Backup the R-InTracer data by executing the following commands:
      ./Backup.sh 
      
    4. To upgrade R-InTracer component, enter option 2.
    5. To save the configuration information, enter <valid-location>. Your configuration information is now available at <valid-location>/R-InTracer-InstallValues.txt.
  2. Stop the R-InTracer component by executing the command.
    ./ipmssys
    stop
    
  3. Backup the R-InTracer data by executing the following commands:
    tar -cvf nodal_data.tar intracer_data
    

    IMPORTANT:

    The intracer_data folder will be available in the DATA PATH given during installation. This is as per default location.

    cp nodal_data.tar
    <data_backup_path>
    

    IMPORTANT:

    This <data_backup_path> should be outside the folder created during installation.

  4. Uninstall the R-InTracer component by executing the command.
    ./Uninstall_InTracer/Uninstall_InTracer
    
  5. Install the new binary at the same location, that is, <R-InTracer-Home>, using console mode, entering the same configuration details as previous installation.
  6. Go to the directory in which the R-InTracer files are located by executing the command.
    cd <R-InTracer-Home>
    
  7. Restore the data by executing the following commands:
    ./ipmssys
    start
    
    ./ipmssys
    stop
    
    rm -rf intracer_data
    
    cp <data_backup_path>/nodal_data.tar
    .
    
    tar -xvf nodal_data.tar
    
    rm nodal_data.tar
    
  8. Start the R-InTracer component by executing the command.
    ./ipmssys start
    

R-TCE Upgradation

This section describes the steps required for manual upgradation of R-TCE component.

IMPORTANT:

All files required to manually upgrade each component is available in the upgrade folder.

Stop individual component before proceeding with upgradation. To stop the component use the following command: ./ipmssys stop

To upgrade R-TCE, perform the following steps:

  1. Back up the configuration by performing the following steps:
    1. Go to the directory in which the R-TCE files are located by executing the command.
      cd <R-TCE-Home>
      
    2. From the upgrade folder, copy Backup.sh and R-TCE-Home-InstallValues.txt to <R-TCE-Home>
    3. Backup the R-TCE data by executing the following commands:
      ./Backup.sh 
      
    4. To upgrade R-TCE component, enter option 3.
    5. To save the configuration information, enter <valid-location>. Your configuration information is now available at <valid-location>/R-TCE-InstallValues.txt
  2. Stop the R-TCE component by executing the command.
    ./ipmssys
    stop
    
  3. Backup the R-TCE data by executing the following commands:
    cd ./data/TCE/<TCE_NAME>
    
    tar -cvf 3gpp_data.tar
    events
    
    cp 3gpp_data.tar
    <data_backup_path>
    

    IMPORTANT:

    This <data_backup_path> should be outside the folder created during installation.

  4. Uninstall the R-TCE component by executing the command.
    ./Uninstall_InTracer/Uninstall_InTracer
    
  5. Install the new binary at the same location, that is, <R-TCE-Home>, using console mode, entering the same configuration details as previous installation.
  6. Go to the directory in which the R-TCE files are located by executing the command.
    cd <R-TCE-Home>
    
  7. Restore the data by executing the following commands:
    ./ipmssys
    start
    
    ./ipmssys
    stop
    
    cd ./data/TCE/<TCE_NAME>
    
    rm -rf events
    
    cp <data_backup_path>/3gpp_data.tar 
    
    tar -xvf 3gpp_data.tar
    
    rm 3gpp_data.tar
    
  8. Start the R-TCE component by executing the command.
    ./ipmssys start
    

Post Upgradation

After upgrading InTracer components, perform the following steps:

  1. Restart the C-InTracer using the commands : ./ipmssys stop;./ipmssys start
  2. Clear your browser cache.
  3. Invoke InTracer UI.
  4. Check that all your data such as Active Traces, Search results, Saved or Scheduled Queries, Saved Users, User Preferences and so on are all available in the newer upgraded version.