KB19645: How to install MicroStrategy Web 9.x and above on a certified Apache Tomcat version on a certified Linux system without access to the X-Window system

This technical note provides generic high-level steps on how to install Strategy Web 9.x and above on a certified Apache Tomcat version on a certified Linux system without access to the X-Window system.
The prerequisites for this technical note are:

• A valid Linux user account who is a member of the 'Wheel' group.
• All Kerberos libraries are installed and accessible.
• A certified version of JAVA is installed and is in the system path. (Test this by logging in via Telnet/SSH and running the command "java -version".)
• Full Strategy product suite is installed under `/home/mstruser/Strategy`

INSTALLATION PROCESS:

1. Download a supported version of Apache Tomcat (Apache Tomcat version 5.5.25 is used FOR ILLUSTRATION PURPOSES ONLY in this article)
2. Start the FTP Windows Command Line client by going to the Start menu > Run > ftp.
3. Set the FTP local directory to the folder, where the Tomcat archive is (ex. C:\download):
   ftp>lcd C:\download_
   
4. Connect to the Linux Server (ex. USRV):
   ftp>open USRV_
   
5. When requested for a user and password, provide a valid Linux user (ex. user "mstruser", password "mstruser").
6. Once logged in, the following message and prompt appear:
   230 User mstruser logged in
   ftp>_
   
7. Upload the Tomcat archive to the root of the home directory of the Linux user "mstruser". Set the transfer mode:
   ftp>bin_
   
8. Upload the file:
   ftp>put apache-tomcat-5.5.25.tar.gz_
   
9. Log off from FTP:
   ftp>quit_
   
10. Use the Windows Telnet client to login to the Linux server by going to Start menu > Run > telnet. The following prompt will be displayed:
    Welcome to Microsoft Telnet Client
    Escape Character is 'CTRL+]'
    Microsoft Telnet>_
    
11. Connect and login to the Linux system with the following command:
    Microsoft Telnet>open USRV_
    
12. Provide the "mstruser" account details to login.
     
    
13. Find and unzip the Tomcat archive within the home directory (ex. /home/mstruser/)Use the ls command to find the archive:
    USRV:/home/mstruser>ls_
    Strategy/ apache-tomcat-5.5.25.tar.gz
    
14. Unzip the archive:
    USRV:/home/mstruser>tar xzvf apache-tomcat-5.5.25.tar.gz_
    
15. With the command given above, Tomcat will be installed in /home/mstruser/jakarta-tomcat-5.5.25/.
     
    
16. By default, Tomcat will run on port 8080 and the Administrative user is "admin" with password "admin".
17. Copy the Strategy.war file to the Tomcat Webapps folder (/home/mstruser/jakarta-tomcat-5.5.25/webapps).
    USRV:/home/mstruser>cp /home/mstruser/Strategy/Web JSP/Strategy.war /home/mstruser/jakarta-tomcat-5.5.25/webapps
    
18. Start Tomcat and Web Universal will be deployed automatically.
    USRV:/home/mstruser>/home/mstruser/jakarta-tomcat-5.5.25/bin/catalina.sh start
    
19. The user should now be able to access the Strategy Web Administrator page by opening a browser and using the following URL:
    http://USRV:8080/MSTR/servlet/mstrWebAdmin
    

Note: In order to access Strategy Web Administrator page, a valid Tomcat user must be created in users.xml.
Third Party Software Installation:
WARNING:
The third-party product(s) discussed in this technical note is manufactured by vendors independent of Strategy. Strategy makes no warranty, express, implied or otherwise, regarding this product, including its performance or reliability.
KB19645