Initial Path settings after Installation

Install:

1.       Application server - Jboss. And set user variables as

·         JBOSS_HOME : D:\02_WORK\02_Diana\ATG\ATG_InstallContent\jboss-5.1.0.GA\jboss-5.1.0.GA

2.       Java JDK. Then set path for User variables. 

·         JAVA_HOME : D:\02_WORK\02_Diana\JAVA-Resources\jdk-7u45

3.       ATG. Then set paths for system variables.

·         ATG_ROOT: D:\02_WORK\02_Diana\ATG\ATG_InstallContent\ATG10.1.1

·         DYNAMO_HOME: D:\02_WORK\02_Diana\ATG\ATG_InstallContent\ATG10.1.1\home

·         DYNAMO_ROOT: D:\02_WORK\02_Diana\ATG\ATG_InstallContent\ATG10.1.1

4.       Finally, set all the JAVA and JBOSS’s bin directories path to the PATH variable as below

·         PATH : %JAVA_HOME%\bin;%JBOSS_HOME%\bin

5.       ACC. Access ATG from start menu (ATG Control Center)

6.       Update Eclipse with ATG plugins. For this, follow the below steps:

·         The plugins for Eclipse for ATG is in the jar file located at the ATG installation folder.(D:\02_WORK\02_Diana\ATG\ATG_InstallContent\ATG10.1.1\Eclipse ATGUpdateSite.jar)

ACC

***Remember to keep the server on before you start ACC.

When trying to open the ACC GUI from the start menu as in figure below: It requires the login credentials for connection which by default is id: admin , pwd: admin.  It is recommended to change this credentials. Follow the below steps to do the same:

·         Access the link : http://localhost:8080/dyn/admin

·         This will pop up a credentials window. Enter the default mentioned above and press OK.

·         Click admin >> Password Management. Done

The first time you open ACC.. the below window pops. Say “YES”

Sometimes the below error occurs:

·         Say “OK”.

·         Hence, as per the exception, download and drop the recommended .jar (jboss-javaee.jar) file at the recommended location, which is (D:\02_WORK\02_Diana\ATG\ATG_InstallContent\ATG10.1.1\DAS\j2ee-lib).

·         Include the below “Services” folder in the ATG installation folder at the below location: why ?? ---?? (D:\02_WORK\02_Diana\ATG\ATG_InstallContent\ATG10.1.1\home\localconfig\atg\dynamo)

There are 2 files in this location which has the details of the JNDI we use in ORACLE. This sd be the same as the JNDI-name in the ds.xml file which we placed in the deploy folder of Jboss. Which inturn is the name we provided for the JNDI, when we first opened Oracle DB Browser.

DirectJTDataSource.properties #Properties File created by CIM #Tue Apr 30 20:52:25 IST 2013 $class=atg.nucleus.JNDIReference JNDIName=java:/CORE

JTDataSource.properties #Properties File created by CIM #Tue Apr 30 20:52:24 IST 2013 dataSource=/atg/dynamo/service/jdbc/DirectJTDataSource

·          Now open Enter ACC credentials.

When open, select, “People and organisation” >> Select “Control Centre User” >>Select all options under “Groups”.

·          Click “New User” and fill in the below details(for example), with password(admin123).

·          Now select your user and Click all under “Groups”

·          Close the ACC Window.

·          Now you can open ACC again with new created User Credentials. Now create the Catalog and corresponding Categories and products and so on.

JBOSS

After installing Jboss,(with default port 8080).

-          Include the atg-ds.xml file in its below location. This file will have configuration details about the connection to the Oracle db. Include this file in the below location. (D:\02_WORK\02_Diana\ATG\ATG_InstallContent\jboss-5.1.0.GA\jboss-5.1.0.GA\server\default\deploy\atg-ds.xml). Code for this file is below:

<?xml version="1.0" encoding="UTF-8"?>

<datasources>

<xa-datasource>

          <jndi-name>CORE</jndi-name>

          <isSameRM-override-value>false</isSameRM-override-value>

          <min-pool-size>5</min-pool-size>

          <max-pool-size>10</max-pool-size>

          <blocking-timeout-millis>5000</blocking-timeout-millis>

          <idle-timeout-minutes>15</idle-timeout-minutes>

          <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>

          <xa-datasource-class>oracle.jdbc.xa.client.OracleXADataSource</xa-datasource-class>

          <xa-datasource-property name="URL">jdbc:oracle:thin:@localhost:1521:xe</xa-datasource-property>

          <xa-datasource-property name="User">core</xa-datasource-property>

          <xa-datasource-property name="Password">core</xa-datasource-property>

        

          <exception-sorter-class-name>

              org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter

          </exception-sorter-class-name>

    </xa-datasource>

</datasources>

Refer (www.javatpoint.com>>corejava) to learn more on the code in this file

-          We can run the Jboss server by opening the run.bat batch file from the Jboss’s bin folder.

-          If you need to include any colours to the jboss console(warning-green,errors-red,etc).. you can create the related file and include the same in the bin folder of the Jboss installation. Example of a run.bat file(majoris.bat) created for this task is below :

-          The highlighted file which has the code for colouring the various status in the jboss console needs to be put in the Jboss bin folder; failing which the newly created batch file will not execute.

-          DOWNLOAD and place the driver .jar file at the lib directory of the Jboss installation (D:\02_WORK\02_Diana\ATG\ATG_InstallContent\jboss-5.1.0.GA\jboss-5.1.0.GA\common\lib). In our current project, we require thin JDBC Driver; Hence download and place ojdbc.jar file at the lib folder.

-          Initial Errors in Jboss Installation and how to solve it:

·         Sometimes opening run.bat will fail to start Jboss by simply install opening the jboss console and closing. This is due to the missing file (java.io) declaration in the profile.xml (D:\02_WORK\02_Diana\ATG\ATG_InstallContent\jboss-5.1.0.GA\jboss-5.1.0.GA\server\default\conf\bootstrap\ profile.xml) file of Jboss. This can be resolved by replacing the code in the profile file at the highlighted location as in the figure below  :

·         Personal error while running Jboss: Inspite of all the above settings, Jboss still refused to start while I ran the run.bat file. The error was that I had removed the altered the PATH  System variable . This worked fine while I set the PATH variable to :  C:\Windows\System32

·         Uncomment the below line(remove rem in the start of the below line) in the run.conf.bat file present at the Jboss installation location(D:\02_WORK\02_Diana\ATG\ATG_InstallContent\jboss-5.1.0.GA\jboss-5.1.0.GA\bin),

set "JAVA_OPTS=%JAVA_OPTS% -Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n"