Legacy Knowledge Base
Published Jul. 2, 2025

Setting Up Liferay Portal on tc Server 2.9.3

Written By

Liferay Support

How To articles are not official guidelines or officially supporteddocumentation. They are community-contributed content and may not alwaysreflect the latest updates to Liferay DXP. We welcome your feedback toimprove How to articles!

While we make every effort to ensure this Knowledge Base is accurate, itmay not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with anyfeedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack"publication program, made available for informational purposes. Articlesin this program were published without a requirement for independentediting or verification and are provided "as is" withoutguarantee.

Before using any information from this article, independently verify itssuitability for your situation and project.

This guide is on how to set up tc Server 2.9.3.

Resolution

  1. Download the tc Server zip file called: vfabric-tc-server-standard-2.9.3.RELEASE.zip.
  2. Open a command prompt to /../vfabric-tc-server-standard-2.9.3.RELEASE. This location will be shortened to {tc Server Home}
  3. Run the command: mkdir servers
  4. Run the command: tcruntime-instance.bat|sh create -i servers lp-server
  5. Navigate to {tc Server Home}/servers/lp-server/conf. Open the **wrapper.conf** file.
  6. Change '-Xmx' to 1024m in wrapper.java.addition.8.
  7. Change change `-Xss` to 512k in wrapper.java.addition.9.
  8. Add wrapper.java.additional.10="-XX:MaxPermSize=256m".
  9. Add wrapper.java.additional.11="-Dfile.encoding=UTF-8".
  10. Save and close the file.
  11. In the {tc Server Home}/servers/lp-server/conf, create a new folder called **Catalina**.
  12. In the {tc Server Home}/servers/lp-server/conf/Catalina, create a new folder called localhost. In the {tc Server Home}/servers/lp-server/conf/Catalina/localhost, create a new file called ROOT.xml.
  13. In ROOT.xml, enter the following:
    <Context path="" crossContext="true">
    
    			<!-- JAAS -->
    
    			<!--<Realm className="org.apache.catalina.realm.JAASRealm"
    			appName="PortalRealm"
    			userClassNames="com.liferay.portal.kernel.security.jaas.PortalPrincipal"
                roleClassNames="com.liferay.portal.kernel.security.jaas.PortalRole" />-->
    
    			<!-- Uncomment the following to disable persistent sessions across reboots. -->
    
               <!-- Uncomment the following to not use sessions. See the property "session.disabled" in portal.properties. -->
    
              <!-- <Manager className="com.liferay.support.tomcat.session.SessionLessManagerBase" /> -->
    </Context> 			
    
  14. In the {tc Server Home}/servers/lp-server/conf folder, open the server.xml file.
  15. Add URIEncoding="UTF-8" to the Connector property so it looks like this:
    <Connector acceptCount="100"
               connectionTimeout="20000"
               executor="tomcatThreadPool"
               maxKeepAliveRequests="15"
               port="${bio.http.port}"
               protocol="org.apache.coyote.http11.Http11Protocol"
               redirectPort="${bio.https.port}"
    	   URIEncoding="UTF-8"/>
    
  16. Unlike Tomcat where dependencies are deployed to the 'lib/ext' folder, dependencies for tc Server are deployed directly in the 'lib' folder. Copy all the following .jars:
    • activation.jar
    • ccpp.jar
    • hsql.jar
    • jta.jar
    • jutf7.jar
    • mail.jar
    • mysql.jar
    • persistence.jar
    • portal-service.jar
    • portlet.jar
    • postgresql.jar
    • script-10.jar
  17. Next, configure the {tc Server Home}/servers/lp-server/bin/setenv.bat|setenv.sh. Add this property to the end of the file: set JVM_OPTS=-Dfile.encoding=UTF-8 -Xmx1024M -Xss512K -XX:MaxPermSize=512m
  18. We are now ready to deploy the portal. Navigate to {tc Server Home}/servers/lp-server/webapps/ROOT. Delete any default content in this folder. Unzip the Liferay .war file here. Note that the .war file can come from either the packager or by running **ant -f build-dist.xml zip-portal-war** in the source folder.
  19. Set the portal-ext.properties parallel to the /lp-server inside the {tc Server Home}/servers folder. Configure the portal-ext.properties to run on MySQL.
  20. Enable or disable the startup wizard in the portal-ext.properties.
  21. In the /bin folder, enter: tcruntime-ctl.bat run |./tcruntime-ctl.sh run
  22. To shut down, CTRL + C will suffice
Did this article resolve your issue ?

Legacy Knowledge Base