SAP BusinessObjects ONE Uninstaller – patch release v1.00.003

As you are aware with the SAP BusinessObjects BI 4.3 release we have introduced very useful tool for BI Administrators named SAP BusinessObjects ONE Uninstaller. And as you are aware that this tool was not shipped as part of the package rather it was shipped with the following SAP Note 2846512, as an attachment. And this blog is about the first patch release v1.00.003 of the SAP BusinessObjects ONE Uninstaller.

Points to Note:

1. Delivery of this patch release v1.00.003 is also done through the same SAP Note 2846512.
2. Also the future releases of this tool will also be done via the same SAP Note 2846512.
3. SAP will not maintain the previous versions of this tool with the Note, having said that, you will find only the latest version released for this tool in the Note.
4. You need to keep the backup of this tool when you plan to start using the latest version of this tool in your BI systems, in case of any unexpected results or blockers with the latest version, you can use previous version of the tool from your backup, until the issue is fixed in the future release.
5. And the guide which was delivered with the first release as part of the attachment, named “SAP_BusinessObjects_ONE_Uninstaller_Guide.pdf” has been discontinued and will not be shipped further, all the future documentation will be done through the corresponding blogs and the links for the same will be updated in the Note 2846512.

List of features and fixes delivered with this patch release v1.00.003:

1. Branding name in the command prompt has been implemented and the branding is shown as “SAP BusinessObjects ONE Uninstaller“. And the branding message will be displayed even in the log file as well.
2. Command-line input parameters has been introduced:
   1. Now the Install Directory path should be given with the dedicated parameter named “-InstallDir“.

      26/04/2021 08:11:51.640 - [INFO] - Welcome to SAP BusinessObjects ONE Uninstaller.
      
      26/04/2021 08:11:51.640 - [INFO] - Invalid number of arguments.
      26/04/2021 08:11:51.640 - [INFO] - Usage: java -jar OneUninstaller.jar -InstallDir <BI_Install_Dir> -LogDir <Log_Directory>
      26/04/2021 08:11:51.640 - [INFO] - Exiting Application!
      26/04/2021 08:11:51.640 - [INFO] - End of SAP BusinessObjects ONE Uninstaller.​

   2. New parameter named “-LogDir” for Log directory path input has been introduced.
      1. And this parameter is optional, if not provided log files will be created under the folder with default name “OneUninstallerLogs” at the same level where the ONE Uninstaller jar file is placed.
      2. In case the user do not have write permissions on logging folder provided, execution will be aborted with corresponding error message.

         Welcome to SAP BusinessObjects ONE Uninstaller.
         
         Invalid log directory. Please provide the valid log directory and have right permissions.
         Cannot create log directory under: D:\OneUninstaller\logs\restricted
         Exiting Application!
         End of SAP BusinessObjects ONE Uninstaller.​

   3. With the introduction of these parameters, the Command to execute to the tool java -jar OneUninstaller.jar -InstallDir <BI_Install_Dir>  -LogDir <Log_Directory>

      For Example – Using the bundled “SAP JVM” :-
      
      Windows: “<BI_Install_Dir>\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\win64_x64\sapjvm\bin\java” -jar OneUninstaller.jar “ -InstallDir <BI_Install_Dir>\SAP BusinessObjects” -LogDir <PathtoLog>
      
      Linux: <BI_Install_Dir>/sap_bobj/enterprise_xi40/linux_x64/sapjvm/bin/java -jar OneUninstaller.jar -InstallDir <BI_Install_Dir> -LogDir <PathtoLog>
      
      Solaris: <BI_Install_Dir>/sap_bobj/enterprise_xi40/solaris_sparcv9/sapjvm/bin/java -jar OneUninstaller.jar -InstallDir <BI_Install_Dir> -LogDir <PathtoLog>
      
      AIX: <BI_Install_Dir>/sap_bobj/enterprise_xi40/aix_rs6000_64/sapjvm/bin/java -jar OneUninstaller.jar -InstallDir <BI_Install_Dir> -LogDir <PathtoLog>

3. Log file enhancements: In the log file, OS type and its version along with Java from where and which version of Java is being used will also be printed.

   17/06/2021 08:31:38.408 - [INFO] - Welcome to SAP BusinessObjects ONE Uninstaller.
   
   17/06/2021 08:31:38.408 - [INFO] - install dirD:\SBOP
   17/06/2021 08:31:38.408 - [INFO] - Operating System: Windows Server 2019
   17/06/2021 08:31:38.408 - [INFO] - Java Version: 1.8.0_251
   17/06/2021 08:31:38.423 - [INFO] - Java Home: D:\SBOP\SAP BusinessObjects Enterprise XI 4.0\win64_x64\sapjvm\jre
   17/06/2021 08:31:38.423 - [INFO] - Install Directory: D:\SBOP
   17/06/2021 08:31:38.423 - [INFO] - Log Directory: Log directory parameter not specified, continuing with D:\SBOP\SAP BusinessObjects Enterprise XI 4.0\win64_x64\sapjvm\jre\bin
   
   17/06/2021 08:31:38.548 - [INFO] - Taking backup of InstallManifest.sqlite and inventory.txt files.
   
   17/06/2021 08:31:38.564 - [INFO] - Reading InstallManifest.sqlite from: D:\SBOP\InstallData\InstallManifest.sqlite
   17/06/2021 08:31:38.564 - [INFO] - Started analysing !!
   17/06/2021 08:31:38.720 - [INFO] - There are no products available for deletion. Exiting!​

4. Usability enhancement: Option to re-enter the selection from the suggested list has been introduced. The new key “R” for changing the selection than previously selected values by re-entering the input out of the suggested list. This new key “R” for changing the selection along with “Y” to confirm the selection and proceeding for the execution and “Q” to quit the application.
5. Started taking the backup of inventory.txt. This is along with backup of InstallManifest file. And also the entries in the inventory.txt file from the InstallData folder under the Installation directory will be updated similar to that of regular patch uninstallation.
6. Now the ONE Uninstaller detects any ongoing Installation operation i.e. any maintenance or Uninstallation from the same Installation directory and aborts the execution with corresponding error message.
   1. Note: At present tool is not able to detect the Update installation operation, hence it is highly recommended not to execute the tool when any Update Installation is going on.
7. Fixes related to enhance the detection of intermediate versions that can be deleted safely. With the initial release tool is unable to detect the patches related BI 4.3.x release, now this has been rectified.

For Information related to all releases and to know how the tool evolved, refer the table available at the end of the Note 2846512