PureEngage On-Premises

Tomcat 7 Upgrade for SAP BOE 

10-16-2018 05:15

Disclaimer: Please read the following instructions carefully and proceed with caution. The below steps are not from Genesys or SAP. It has been provided for educational and informational purposes based on my experience. I strongly suggest that you validate the working in a test system before making any changes in production. Also, back up the production system before performing any changes. I will not responsible for anything that may happen to your system. You will be doing this at your own risk and take the responsibility upon yourself.

 

TOMCAT UPGRADE:

Precheck:

  1. Backup the Exisitng Tomcat and SAP BOE Install Folder
  2. Rename the Existing Tomcat folder as Tomcat_<existing version>
  3. Backup the SAP BOE related databases
  4. Make a note of the Tomcat Service name for BOE from Windows Services (take screenshot)
  5. Open Tomcat configuration file "Tomcatw.exe" from <Install Dir>\SAP BusinessObjects\tomcat\bin
  6. Take screenshots of all tabs

Note: you can find Tomcat Service name in the properties of the service as follows:

  1. Click Start -> Run -> cmd, execute command: services.msc

Right-click Apache Tomcat Service, select Properties, see Service Name

(Start-->Run-->Services.msc-->Apache Tomcat for BI4 --> Service Name: BOEXI40Tomcat

  1. Make a note of the HTTP/HTTPS ports for BOE, URL, CMS port and other information as below

URL:

http://localhost:8089/BOE/BI

http://localhost:8089/BOE/CMC

Destination folder (install path): D:\GCTI\SAP BusinessObjects\tomcat

CMS Port: 6400

Server Shutdown Port:8005

HTTP Connector Port:8089

AJP Connector Port:8009

Windows Service Name:BOEXI40Tomcat

UserName: admin

Password: password

Java Path: C:\Java\jre7 

  1. Check if the existing reports are working before the upgrade.
  2. Check whether all BOE Services are running from CMC before upgrade
  3. Ensure that the windows user has admin rights to perform the uninstall and install.

UNINSTALL TOMCAT:

  1. Go to Start --> Central Management Console
  2. Stop Server Intelligence Agent (GENUI)
  3. Stop Apache Tomcat
  4. Uninstall Apache Tomcat from Add/Remove Programs

 
INSTALL TOMCAT:

  1. Download Apache Tomcat 7 32-bit/64-bit Windows Service Installer from URL: http://tomcat.apache.org/download-70.cgi
  2. Ensure that the existing tomcat folder is removed after installation.
  3. Run apache-tomcat-7.0.xx.exe installer and go through the installation.
  4. Install Tomcat in the same folder name. (refer Tomcatw_Screenshots.docx)
  5. Click Finish to complete the Installation and start Tomcat
  6. Create a folder Catalina in <Install Dir>\SAP BusinessObjects\Tomcat\conf folder.
  7. Create a folder localhost in <Install Dir>\SAP BusinessObjects\Tomcat\conf\Catalina folder.
  8. Open a Command Prompt in elevated mode if you are using MS Windows Server 2008. Navigate to the directory <Install Dir>\SAP BusinessObjects\Tomcat\bin.
  9. Run command service install BOEXI40Tomcat.

 CONFIGURE TOMCAT: 

  1. Click on Start > All Programs > Tomcat > Tomcat Configuration. This will launch the Apache Tomcat BOEXI40TomcatProperties tool. You will have to open this tool in elevated mode if you are using MS Windows Server 2008
  2. On the General tab, change the Display name to Apache Tomcat 7.0.29. Delete all contents in the Description field. Change the Startup type to
  3. Click on Apply.
  4. Click on the Logging tab. Change the Level to Error. Delete contents of Logprefix
  5. Copy line C:\Program Files (x86)\SAP BusinessObjects\Tomcat\logs\stdout.log to the Redirect Stdout field
  6. Copy line C:\Program Files (x86)\SAP BusinessObjects\Tomcat\logs\stderr.log to the Redirect Stderror field. Click on Apply
  7. Click on the Java tab. Add the path C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI4.0\win64_x64\jdk\lib\tools.jar in Java Classpath field after the existing entry separated by a semicolon(;)
  8. Add the value 2048 in Maximum memory pool field 
  1. Delete following parameters from the Java Options field

 Djava.io.tmpdir=C:\Program Files (x86)\SAP BusinessObjects\Tomcat\temp

Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManage

Djava.util.logging.config.file=C:\Program Files (x86)\SAP BusinessObjects\Tomcat\conf\logging.properties 

  1. Add following parameters to the Java Options field.

 Djava.library.path=C:\Windows\SysWOW64\;C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI4.0\win64_x64\
Dbobj.enterprise.home=C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\

Xrs

XX:

MaxPermSize=384M

Dbusinessobjects.olap.bin=

Dbusinessobjects.olap.stylesheets=

Djava.awt.headless=true 

  1. Click on Apply. You may add some additional parameters to the Java Options field apart from the above mentioned if they were present on previous Tomcat. We have saved Java Options of previous Tomcat in a text file.
  2. Click on Startup tab. Copy the path D:\GCTI\SAP BusinessObjects\tomcat to the Working Path field. Click on Apply.
  3. Click on Shutdown tab. Copy the path D:\GCTI\SAP BusinessObjects\tomcat to the Working Path field. Click on Apply OK

 Deploying SAP BOE web Applications (WAR files)

  1. Open the file "config.tomcat7" in Notepad. It can be located in D:\GCTI\SAP BusinessObjects\tomcat\SAP BusinessObjectsEnterprise XI 4.0\wdeploy\conf folder.
  2. Assign the following values to the respective variables:

 as_dir= D:\GCTI\SAP BusinessObjects\tomcat

as_instance=localhost

as_service_name=BOEXI40Tomcat

  1. Save & close the file.
  2. Open a Command Prompt in elevated mode if you are using MS Windows Server 2008. Navigate to the directory D:\GCTI\SAP BusinessObjects\tomcat\SAP BusinessObjects Enterprise XI 4.0\wdeploy.
  3. Run the command wdeploy tomcat7 validateconfig to check if you have made the correct changes in config.tomcat7 file.
  4. A BUILD SUCCESSFUL message will appear if the validation is successful. (this will take roughly 1-2 mins)

NOTE: You can ignore if you get a Build Failed message for Tomcat 7.0.82. It will get deployed successfully.

  1. Now run the command wdeploy tomcat7 deployall to deploy the WAR files of SAP BO BI 4.0 on Tomcat 7.
  2. A BUILD SUCCESSFUL message will appear once all the WAR files are successfully deployed.(this will take roughly 25-45 mins)
  3. Click on Start > All Programs > Tomcat > Tomcat Configuration. This will launch the Apache Tomcat 7.0.29 Properties tool.
  4. Start Tomcat by clicking on Start button available on General tab. You will have to open this tool in elevated mode if you are using MS Windows Server 2008.
  5. Wait for 10 to 15 minutes until the Catalina servlet initializes itself & starts all applications.
  6. Now test BI Launchpad, CMC & Query Builder & Web Services to check if they are working fine with Tomcat 7.0.29 as Web Application Server.

Statistics
0 Favorited
40 Views
1 Files
0 Shares
18 Downloads

Comments

08-27-2020 03:46

Thanks, Siva for the useful post. I'm also looking solution to upgrade Tomcat from 7.0.55 to 7.0.104. 
There is a vulnerability:
CVE-2020-13935: The payload length in a WebSocket frame was not correctly validated. Invalid payload lengths could trigger an infinite loop. Multiple requests with invalid payload lengths could lead to a denial of service.

7.0.55 Tomcat is embedded in SAP 4.1 version. 

Related Entries and Links

No Related Resource entered.