FlexDeploy provides a file distribution for Tomcat which simplifies the installation process. This distribution contains Tomcat, the FlexDeploy WAR, and the base configurations, leaving only a few simple steps to complete the install. The distribution contains the following components.
...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<Resource name="jdbc/flexdbDS" auth="Container"
type="javax.sql.DataSource"
factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
driverClassName="com.mysql.jdbc.Driver"
url="**CONNECT_STRING**"
username="fd_admin"
password="**FD_ADMIN_PASSWORD**"
maxTotal="100"
maxIdle="10"
initialSize="10"
validationQuery="SELECT 1"
testOnBorrow="true"
defaultTransactionIsolation="READ_COMMITTED"
useLocalSessionState="true"
defaultAutoCommit="false"/> |
Step 5. (Optional) Modify Tomcat server.xml for port if necessary.
...
- By default, the Tomcat server is configured to run on port 8000. If this port is in use, change to some other unused port. Search for <Connector port="8000" protocol="HTTP/1.1" if you want to change it.
- There are other ports referenced in the server.xml file as well. If the logs contain a port in use error, you can find the open ports on your machine and then search this file for ports that you find are in use and change them.
Step 6. (Optional) Modify Tomcat Environment script (setenv.sh or setenv.bat) for FlexDeploy server side directories.
...
Here is example of setenv.bat which is modified to use non-default folders.
Step 7. (Optional) Modify Tomcat Environment script (setenv.sh or setenv.bat) for JAVA_HOME.
File - <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/setenv.sh (setenv.bat on windows)
| Tip |
|---|
Even when If JAVA_HOME is already set in your environment, it would be a good idea to set it in this file (setenv.sh or setenv.bat) as well.you can skip this step. Unix Example - export JAVA_HOME=/u01/java/jdk1.8.0_121 Windows Example - set JAVA_HOME=c:/installs/Java/jdk1.8.0_121 |
...
| Note |
|---|
If adding another JDBC driver, be sure to remove the default one which comes with the ADF Essentials libraries (ojdbc6dms.jar). If you leave multiple JDBC drivers in the lib folder, you could encounter the following exception on startup: java.lang.SecurityException: sealing violation: package oracle.jdbc is sealed at java.net.URLClassLoader.getAndVerifyPackage(Unknown Source) at java.net.URLClassLoader.definePackageInternal(Unknown Source) at java.net.URLClassLoader.defineClass(Unknown Source) at java.net.URLClassLoader.access$100(Unknown Source) at java.net.URLClassLoader$1.run(Unknown Source) |
Step 9. (Optional) Only ff using IBM ClearCase, you will need to copy some jar files from your ClearCase server or ClearTeam Explorer installation to the FlexDeploy installation
Copy all of the jar files found in the com.ibm.rational.teamapi_8.0.1.vxxx folder of your ClearCase server or ClearTeam Explorer installation to <FlexDeploy Home>/apache-tomcat-flexdeploy/lib. (commons-codec-1.3.jar, commons-lang-2.3.jar, icu4j-4_8.jar, remote_core.jar, stpclientws.jar, stpcq.jar, teamapiextensions.jar, unicodetypemgr.jar, commons-httpclient-3.0.jar, commons-logging-1.0.4.jar, icu4j-charset-4_8.jar, stpcc.jar, stpcmmn.jar, stpwvcm.jar, ucleardiffmerge.jar)
Step 10. (Linux only) - set the shell scripts executable with this command:chmod +x <FlexDeploy Home>.
| Code Block | ||||
|---|---|---|---|---|
| ||||
chmod +x <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/*.sh chmod +x <FlexDeploy Home>/*.sh |
Step 11. Skip this step if you did not modify setenv.sh or setenv.bat to use non-default server side directories in Step 6.
...
Step 13. Start tomcat by running the following script. Make sure to set JAVA_HOME to JDK 7 or JDK 8 if not already set in your environment.
File - <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/StartFlexDeploy.sh(you can also use startup.sh (or startup.bat on Windowsscripts)
| Note | ||
|---|---|---|
| ||
After starting your server, check the <FlexDeploy Home>/apache-tomcat-flexdeploy/logs/flexdeploy.0.log file for the following error message:
If present, increase the number of processes for the database
|
...