Versions Compared

Key

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

...

Code Block
themeRDark
$ sudo yum install -y rsync
Code Block
themeRDark
languagepowershell
$ sudo wget http://repository.it4i.cz/mirrors/repoforge/redhat/el6/en/x86_64/rpmforge/RPMS/rpmforge-release-0.5.3-1.el6.rf.x86_64.rpm
$ sudo rpm -i rpmforge-release-0.5.3-1.el6.rf.x86_64.rpm
$ sudo yum install -y rar
$ sudo yum install -y unrar

...

Code Block
themeRDark
$ cd /install
$ tar zxf crm_r10_rhel6_7_wildfly_10.tar.gz

...

 

Install required java version jdk1.8.0_72

 

CRM.COM requires java jdk1.8.0_72. Follow steps below to install it.

...

Code Block
themeRDark
$ cd /opt
$ sudo tar zxf /install/java/jdk-8u72-linux-x64.tar.gz
$ cd /opt/jdk1.8.0_72/
$ sudo alternatives --install /usr/bin/java java /opt/jdk1.8.0_72/bin/java 2

 

 

 

 

 

Execute the following command:

...

 

 

...

Code Block
themeRDark
languagepowershell
 $ sudo alternatives --config java

 

 

and make sure that java jdk1.8.0_72 is selected as in the example below:

Code Block

...

theme

...

RDark

...

 There are 2 programs which provide 'java'.

...

 

  Selection    Command


  Selection    Command
-----------------------------------------------

...


*+

...

 1           /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.65-3.b17.el7.x86_64/jre/bin/java

...


   2           /opt/jdk1.8.0_72/bin/java

...

 



Enter to keep the current selection[+], or type selection number: 2

...

Finally execute the following commands:

 

...

Code Block
themeRDark
languagepowershell
$ sudo alternatives --install /usr/bin/jar jar /opt/jdk1.8.0_72/bin/jar 2

...


$ sudo alternatives --install /usr/bin/javac javac /opt/jdk1.8.0_72/bin/javac 2

...


$ sudo alternatives --set jar /opt/jdk1.8.0_72/bin/jar

...


$ sudo alternatives --set javac /opt/jdk1.8.0_72/bin/javac

 

 

Confirm that the default java is now jdk1.8.0_72

 

...

Code Block
themeRDark
languagepowershell
$ java -version

...


java version "1.8.0_72"

...


Java(TM) SE Runtime Environment (build 1.8.0_72-b15)

...


Java HotSpot(TM) 64-Bit Server VM (build 25.72-b15, mixed mode)

...


$

 

 

 

 

...

Install Wildfly

 

Follow the instructions below to install Wildfly:

 

...

Code Block
themeRDark
languagepowershell
$ cd /install/bin

...


$ sudo ./install.sh

...

 

...

After successful installation you change the Wildfly admin user password using the following command:

 

...

Code Block
themeRDark
languagepowershell
$ sudo /opt/wildfly/bin/add-user.sh -s -u admin -p "<new password>"

 

 

Also you should change the java heap size to the appropriate value according to the application server available memory. 

To change the min and max heap size values edit the following file:

 

...

Code Block
themeRDark
languagepowershell
 $ sudo vi /opt/wildfly/bin/standalone.conf

...

 

...

Locate the line: 

Code Block
themeRDark
JAVA_OPTS="-Xms2g -Xmx6g -XX:MetaspaceSize=6g -XX:MaxMetaspaceSize=9g -Djava.net.preferIPv4Stack=true"

...

 

And modify -Xms (min) and -Xmx (max) values accordingly.

 

 

 

 

 

Now you should be able to access the application management console using the following URL:

 

http://<hostname>:9990

 

 Image Added

 

 

...

Connect to your database

...

The next step is to create JDBC connections to your database. The examples shown below assume that the database is Oracle.

 

CRM.COM application needs at least two database schemas:       

  • The Ecenter schema (for example ECENTER)

...

  • One Organisation schema (ORG1)

 

To configure JDBC connections in Wildfly navigate to:

 

  • Navigate to: Configuration->subsystems->Datasources->XA

 

  • And the

...

  • press Image Added button

  

Image Added

  • Select Oracle XA Datasource and press Next

  

Image Added

You can choose any name for the JDBC connection but it is better to reflect the fact that this is the ecenter. 

On the other hand, the JNDI name must be named java:/ecenter. This is how CRM.COM application locates the ecenter schema. CRM.COM will not be able to connect to any organisation if the JNDI name is not specified exactly as java:/ecenter

 


  • Press Next

 

 

 Image Added

  • Select Detected Driver, select oracle and press Next

 Image Added

 

  • Click on the value parameter and change the URL to the appropriate one for your environment.

...

  • e.g. jdbc:oracle:thin:@cyn1ora001:1521:crm

...

  • Press Next

 

 

 

  • Specify username and password for your schema

 

 

 

 

Image Added

  • Press Next

 Image Added

...

  • Press

...

  • Test Connection

At this point you should get a successful message.

 Image Added

 

  • Press OK

 

  • Press

...

  • Finish to exit

 

  • Change the default pool size by navigating again to:

...

 

  • Configuration->subsystems->Datasources->XA

...

  • Select the XA Datasource and click on View

...

  • Select

...

  • Pool

 Image Added

 

 

    • Enter 1 for Min Pool Size
    • Enter 1 for Initial Pool size
    • Enter 600 for Max Pool Size
    • Select EntirePool for Flush Strategy

 

  • Press Save

 

 

 

Repeat the process for your Organisation schema.

Please note that for the organisation JDBC connection the JNDI name should be named as follows:

 

java:/<MPID>

 

where MPID should be the lower case value of the field MPID in table MASTERPARTNERS that exists in the ecenter schema.

 

For example, if the MPID value is ‘ORG1’ then the JNDI name should be java:/org1

 

 

 

...

Install CRM.COM

 

Now that Wildfly is installed and configured, the next step is to install the CRM.COM application.  Before installing CRM.COM application make sure that you locate the EAR file and possible the custom rar file in the following directory:

 

/install/crm.com/YYYY-MM-DD

 

Where where YYYY-MM-DD is the date stamp of the last installation that took place in this app server.

 

For example:

 

 

...

Code Block
themeRDark
languagepowershell
 $ ll /install/crm.com/2016-10-19

...


-rw-r--r--. 1 root root 143155773 Oct 18 18:21 Crm_10.1.0(201610181820WFL).ear

...


-rw-r--r--. 1

...

 root root    583511 Oct 19 12:59 org1_10.1.0(78606).rar

...


$

 

 

The example above shows that directory /install/crm.com/2016-10-19 has both a CRM release 10.1.0 built on 2016-10-18 at 18:2020 

And also a custom archive for organisation ORG1 with build version 78606 intended for CRM.COM release 10.1.0.

 

To install CRM.COM follow the steps below:

Code Block

...

themeRDark

...

language

...

powershell
$ cd /install/crm.com

...


$ copyinstallfiles.sh 2016-10-19

...


$ installear.sh

...

 

Within a few minutes the installation will be completed and Wildfly will be restarted.

 

 

 

At this point you should be able to navigate to the CRM.COM login page using the following URL:

 

https://<hostname>:28443/crm

 Image Added

 

 

 

 

...

Post installation tasks

 

If you require to connect to third party secure sites like for example CA systems, usually there is a need to trust the SSL certificates of the third party site.

 

The following steps are required to put the certificate in the java trust store:

 

Locate the required certificate file. For example in /install/cert

 

 

...

Code Block
themeRDark
languagepowershell
 $ ll /install/cert

...


-rw-r--r--. 1 root root 1678 Oct 22 10:47 omi.verimatrix.com.crt

 

 

To install a trusted SSL certificate run the following command: 

Code Block
themeRDark
languagepowershell
$ sudo /opt/jdk1.8.0_72/bin/keytool -import -alias omi.verimatrix.com -file /install/cert/omi.verimatrix.com.crt -keystore /opt/jdk1.8.0_72/jre/lib/security/cacerts

 

When asked for a password, the default password is "changeit".

 

Answer yes to the question Trust this certificate? [no]: 

To view installed certificates run the following command:

 

...

Code Block
themeRDark
languagepowershell
$ sudo /opt/jdk1.8.0_72/bin/keytool -list -keystore /opt/jdk1.8.0_72/jre/lib/security/cacerts

...

 

...

Widlfy should be restarted for this to take effect: 

Code Block
theme

...

RDark

...

language

...

powershell
 $ stopwildfly
 $ startwildfly