1. Installing Java
Java is not pre-installed since OS X 10.7, so we should check whether Java exists using the command:
java -version
If Java is not installed, please download Java from: http://www.oracle.com/technetwork/java/javase/downloads/index.html
After installing Java, we have to do some modification on /bash_profile. JAVA_HOME is an important environment variable, not just for Tomcat, and it’s important to get it right. Here is a trick that allows me to keep the environment variable current, even after a Java Update was installed. In ~/.bash_profile, I set the variable like so:
export JAVA_HOME=$(/usr/libexec/java_home)
2. Downloading Tomcat
Tomcat binary distribution can be downloaded on http://tomcat.apache.org/download-80.cgi. Download it and unarchive it to the default Downloads folder (~/Downloads/apache-tomcat-8.0.30).
3. Installing Tomcat
Move the unarchived directory to /usr/local using the command:
sudo mkdir -p /usr/local
sudo mv ~/Downloads/apache-tomcat-8.0.30 /usr/local
To make sure the old version of Tomcat is removed, we have to delete the Tomcat directory under Library directory using the command:
sudo rm -f /Library/Tomcat
Instead of copying the Tomcat directory to Library Directory, a recommended way to manager the installed package is to create a symbolic link under Library directory. So we can manage the original Tomcat file under /usr/local directory.
sudo ln -s /usr/local/apache-tomcat-8.0.30 /Library/Tomcat
4. Making all scripts excutable
Change the ownership and modify the authorization of all script under Tomcat directory using the follwing command:
sudo chown -R <your_username> /Library/Tomcat
sudo chmod +x /Library/Tomcat/bin/*.sh
5. Creating Tomcat User
Open the conf/tomcat-users.xml file in any editor and add the follwing lines:
<tomcat-users>
<!-- user manager can access only manager section -->
<role rolename='manager-gui' />
<user username='manager' password='_PASSWORD_' roles='manager-gui' />
<!-- user admin can access manager and admin section both -->
<role rolename='admin-gui' />
<user username='admin' password='_PASSWORD_' roles='manager-gui,admin-gui' />
</tomcat-users>
6. Starting and Stoping Tomcat
To start or stop Tomcat, we should type the following commands:
/Library/Tomcat/bin/startup.sh
/Library/Tomcat/bin/shutdown.sh
If the Tomcat installed successfully, you will be able to open up http://localhost:8080 and log in with your Tomcat user and password.
7. Setting maxPostSize
Two items have to be modified:
(1) In confserver.xml
<Connector port='80' protocol='HTTP/1.1'
connectionTimeout='20000'
redirectPort='8443'
maxPostSize='67589953' />
(2) In webappsmanagerWEB-INFweb.xml
<multipart-config>
<!-- 52MB max -->
<max-file-size>52428800</max-file-size>
<max-request-size>52428800</max-request-size>
<file-size-threshold>0</file-size-threshold>
</multipart-config>
References:
https://wolfpaulus.com/journal/mac/tomcat8/
http://tecadmin.net/set-admin-password-in-tomcat/#
http://tomcat.apache.org/download-80.cgi
http://www.oracle.com/technetwork/java/javase/downloads/index.html
http://maxrohde.com/2011/04/27/large-war-file-cannot-be-deployed-in-tomcat-7/
http://stackoverflow.com/questions/2947683/httprequest-maximum-allowable-size-in-tomcat