Installing ThingWorx 8.0 H2 on Mac OS
Prerequisites:
● Java JDK 8
● ThingWorx Core 8.0 H2
● ThingWorx Core License
Download Tomcat
1. Goto http://tomcat.apache.org ⇒ Under "Tomcat 8.5.{xx} Released" (where { xx }
is the latest upgrade number) ⇒ Downloads ⇒ Scroll Down Past “8.5.{xx}” ⇒ Under
"8.0.{xx}"⇒ Binary distribution ⇒ Core ⇒ " tar.gz " package (e.g.,
"apache-tomcat-8.0.{ xx }. tar.gz ", about 9 MB).
Make sure to download Tomcat 8.0.xx NOT 8.5.xx
Install Tomcat
1. Go to "~/Downloads", double-click the downloaded tarball (e.g.,
"apache-tomcat-8.0.{ xx }.tar.gz") to expand it into a folder (e.g.,
"apache-tomcat-8.0.{ xx }").
2.Move the extracted folder (e.g., "apache-tomcat-8.0.{ xx }") to "/Applications".
3.For ease of use, we will shorten and rename this folder to "tomcat".
Take note of Your Tomcat Installed Directory . I’ll assume you placed it in Applications/tomcat
for the rest of guide.
Configure Tomcat
1. Open “Applications/tomcat/conf”
2. Open server.xml
3. Replace
protocol=“HTTP/1.1” WITH protocol=“org.apache.coyote.http11.Http11NioProtocol”
4. Save and close the file.
5. Open tomcat-users.xml
6. Add the following at the end of the file above </tomcat-users>
<role rolename=“manager-gui” />
<user username="admin" password="admin" roles="standard, manager-gui, admin" />
8. Save and close the file
9. Go to “Tomcat/bin”
10. Open “ catalina.sh”
11. Find the following:
JAVA_OPTS="$JAVA_OPTS -Djava.protocol.handler.pkgs=org.apache.catalina.webresources"
12. Below this line add:
JAVA_OPTS="$JAVA_OPTS -Djava.library.path=‘/Applications/tomcat/webapps/Thingworx/WEB-INF/extensions'"
13. Save and close the file.
Test Tomcat
1. Open a terminal
2. Run this command “cd Applications/tomcat/bin”
3. Now run “sudo ./catalina.sh run”
4. The terminal will start the tomcat server up, you should see something like this on the
terminal “Server startup in 24167 ms”
5. Open a browser and go to localhost:8080
6. You should see the Tomcat homepage
7. Now go back to the terminal and shutdown the server by pressing Control + C
* I will add a Troubleshooting section later. For now if you have problems
check “Tomcat/logs/catalina.log” to try to find out what went wrong.
Install ThingWorx
1. Open a new terminal
2. Run this command to go to your root directory “cd /“
3. Now run this “sudo mkdir ThingworxStorage” & “sudo mkdir
ThingworxPlatform”
4. Now open this directory in Finder by running “open . “
5. Place your Thingworx License file into “ThingworxPlatform”
6. Now go to “Applications/Tomcat/webapps”
7. Place the Thingworx.war file here
8. Open a new terminal run this command “cd Applications/tomcat/bin”
9. Run “sudo ./catalina.sh run”
10. Open your browser and go to localhost:8080/Thingworx
11. You’ll be prompted with a login form
12. Username: Administrator , Password: trUf6yuz2?_Gub
*For troubleshooting check out "ThingworxStorage/logs"
Congratulations you have ThingWorx running on your localhost!
