Versions Compared

Old Version 2

changes.mady.by.user IT Stonebranch

Saved on

compared with

New Version Current

changes.mady.by.user Stonebranch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To unpack the Universal Controller distribution file, use the following method appropriate for your platform:

Linux/Unix


<pre>tar
tar xvf uc-controller-N.N.N.N.
tar</pre>
tar
Panel
Html bobswift


Windows

Use an appropriate archiving / unzipping product.

...

To install the Controller, issue the following command that is appropriate for your platform:

Linux


<pre> 
> sh install-controller.sh
<parameters></pre>
 Panel
 Html bobswift

Windows

html-bobswift
 Panel
<pre> 
> install-controller.bat
 <parameters></pre>

You must include command line switches that specify information the Controller needs to access the Tomcat installation directory, the war file, and the database. You can include additional command line switches, but they are not required.
...
<ul>
<li> mysql
<li> sqlserver
<li> oracle 
</ul>
  • mysql
  • sqlserver
  • oracle
Command Line Switch
Description
Default
Required
Controller Property

html-bobswift
 Panel
<pre>
--controller-
file</pre>
file

Full path of the Universal Controller war file from the downloaded Universal Controller package.
none
Yes


 Panel
html
-
bobswift<pre>--dbname</pre>
-dbname

Universal Controller database name.
uc
No
uc.db.name=

 Panel
html
-
bobswift<pre>--dbpass</pre>
-dbpass

Database user's password.
none
Yes
uc.db.password=

 Panel
html
-
bobswift<pre>--dburl</pre>
-dburl

JDBC connection URL. 
 
Format:   jdbc:<jdbc vendor>:<other jdbc vendor data>
 
Examples (for MS SQLServer, uc is the database name; for Oracle, XE is the SID): 
 
 Include Page
IL:dburl examples - 7.0.0.0
IL:dburl examples - 7.0.0.0
jdbc:mysql://localhost
No
uc.db.url=

 Panel
html
-
bobswift<pre>--dbuser</pre>
-dbuser

Database user name.
none
Yes
uc.db.user=

 Panel
html
-
bobswift<pre>--port</pre>
-port

Used by the Universal Controller to generate a unique Cluster Node Node Id in the format of hostname:port-dbname.
 Note
titleNote
This is meant to represent the value of the Tomcat HTTP/1.1 Connector port configured in the server.xml.
It is used solely for Node Id generation and does not impact the Tomcat HTTP/1.1 Connector configuration.

8080
No
uc.servlet.port

 Panel
html
-
bobswift<pre>--rdbms</pre>
-rdbms

Database type. 
 
Valid values are:
 Html bobswift
 Note
iconfalse
* --rdbms is required if --dburl is used in the command.

mysql
No *
uc.db.rdbms=

html-bobswift
 Panel
<pre>
--tomcat-
dir</pre>
dir

Path to the Tomcat installation directory (contains the directories:/bin, /conf, /logs, webapps).
none
Yes

...
Shown below are sample commands for installing the Controller on Linux and Windows platforms, using defaults for the database:
Linux

html-bobswift
 Panel
<pre>

sh install-controller.sh --tomcat-dir ~/tomcat --controller-file ./uc-controller-N.N.N.N-build.N.war --dbuser root --dbpass userpass

</pre>

Windows

<pre>

install-controller.bat --tomcat-dir "c:\Program Files\Apache Software Foundation\Tomcat 8.5"
--controller-file uc-controller-N.N.N.N-build.N.war --dbuser root --dbpass userpass

</pre>
 Panel
 Html bobswift

 Note
titleNote
In the Tomcat directory (--tomcat-dir), when quoting the directory is necessary due to spaces, do not use a single backslash before the ending quotation mark; use either a double backslash or no backslash to avoid the command shell from treating \" as an escape character.

...
Step 1
Start Tomcat as follows:
 
Linux
Start the Tomcat daemon using the script placed in the /etc/init.d directory for Tomcat.
 
html-bobswift
 Panel
<pre>

service [name of Tomcat service] start

</pre>
 
Windows
We recommend you use Windows Services to start Tomcat. Or, you can start Tomcat from the command line as follows:
 
<pre>

net start [name of Tomcat service]

</pre>
 Panel
 Html bobswift
 
Linux or Windows
You can start the service using the $CATALINA_HOME/bin/startup.bat or $CATALINA_HOME/bin/startup.sh scripts.
 Anchor
Opswise log
Opswise log
Step 2
You can view details of the start-up in the Tomcat window or monitor the Controller log, as described below:
 
Linux/Unix
Users can tail the uc.log to monitor the deployment process, as follows:
 
html-bobswift
 Panel
<pre>

tail -f $TOMCAT_DIR/uc_logs/uc.log

</pre>
 
Windows
Users can use a third-party tailing utility or open the log file using Notepad or other editor and scroll to the bottom to view the latest activity.
 
html-bobswift
 Panel
<pre>

$TOMCAT_DIR/uc_logs/uc.log

</pre>

Step 3
When you see the following, the Controller is ready:
  • INFO [Ops.Cluster.Monitor.0] Server is now Running in Passive mode.
  • INFO [Ops.Cluster.Monitor.0] Setting server to PASSIVE.
Step 4
AIX and z/Linux only: Follow this procedure to change two default values in the Universal Controller start-up properties file, uc.properties, which is read by the Controller. 
 
(The uc.properties file resides in <tomcat directory>/webapps/uc/WEB-INF/properties).
 
  1. Change the following two properties from their default value to the AIX - z/Linux value:
     
    • uc.trustmanager.algorithm= (Java trust manager algorithm)
      • Default value = SunX509
      • AIX - z/Linux value = IbmX509
         
    • uc.trustmanager.provider= (Java trust manager provider)
      • Default value = SunJSSE
      • AIX - z/Linux value = IBMJSSE2
         
  2. Restart Tomcat.
...