WARNING: Unable to retrieve host 'ITLHost' associated with custom component

Problem:

When I was trying to deploy the CRS app that come with ATG11.1 on my linux box I got the following warning

WARNING: Unable to retrieve host 'ITLHost' associated with custom component 

Solution:

On looking at the Appconfig.xml and related configuration files, I found out that the warning occurred because the definition of ITLHost was happening in DataIngest.xml but it was used in WorkbenchConfig.xml which was imported before DataIngest.xml in Appconfig.xml, see below the CRS Default definition of Appconfig.xml 

  <spr:import resource="InitialSetup.xml" />
  <spr:import resource="DgraphDefaults.xml" />
  <spr:import resource="AuthoringDgraphCluster.xml" />
  <spr:import resource="LiveDgraphCluster.xml" />
  <spr:import resource="LiveAppServerCluster.xml" />
  <spr:import resource="UsageCollectionConfig.xml" />
  <spr:import resource="WorkbenchConfig.xml" />
  <spr:import resource="ReportGeneration.xml" />
  <spr:import resource="DataIngest.xml" />

  <spr:import resource="AssemblerConfig.xml" />

So changing the order of imports as follows, fixed that warning, when I tried to a new endeca deploy. See updated Appconfig.xml below..

  <spr:import resource="InitialSetup.xml" />
  <spr:import resource="DgraphDefaults.xml" />
  <spr:import resource="AuthoringDgraphCluster.xml" />
  <spr:import resource="LiveDgraphCluster.xml" />
  <spr:import resource="LiveAppServerCluster.xml" />
  <spr:import resource="UsageCollectionConfig.xml" />

  <spr:import resource="DataIngest.xml" />

  <spr:import resource="WorkbenchConfig.xml" />
  <spr:import resource="ReportGeneration.xml" />
  <spr:import resource="AssemblerConfig.xml" />

Error During BCC Deployment :: /atg/dynamo/service/jdbc/JTDataSource_production :: java.lang.IllegalStateException: Cannot delist resource, transaction has been rolled back :: Transaction timed out after 31 seconds

Problem:

I was trying to do a full deployment after setting up CA and got this error. I was using ATG 11.1 on Weblogic 12c connecting to a Oracle 12c Pluggable Database (with ojdbc7.jar) - used FakeXA as against WeblogicDS

**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production --- java.lang.IllegalStateException: Cannot delist resource, transaction has been rolled back. BEA1-346CAD26CDE45A7A06F2. xid=BEA1-346CAD26CDE45A7A06F2, status=Marked rollback. [Reason=weblogic.transaction.internal.TimedOutException: Transaction timed out after 31 seconds 
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production BEA1-346CAD26CDE45A7A06F2]
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at weblogic.transaction.internal.TransactionImpl.throwIllegalStateException(TransactionImpl.java:1889)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at weblogic.transaction.internal.ServerTransactionImpl.delistResource(ServerTransactionImpl.java:598)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.dtm.TransactionWrapper.delistResource(TransactionWrapper.java:183)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.service.jdbc.MonitoredDataSource.connectionClosed(MonitoredDataSource.java:1383)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.service.jdbc.PooledXAConnection.close(PooledXAConnection.java:329)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.service.jdbc.PooledMonitoredConnection.close(PooledMonitoredConnection.java:312)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.adapter.gsa.GSATransaction.closeConnection(GSATransaction.java:808)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.adapter.gsa.GSAItemDescriptor.close(GSAItemDescriptor.java:2764)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.adapter.gsa.GSAItemDescriptor.addItem(GSAItemDescriptor.java:7418)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.adapter.gsa.GSARepository.addItem(GSARepository.java:1054)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.deployment.repository.RepositoryWorkerThread.deployItem(RepositoryWorkerThread.java:1128)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.deployment.repository.RepositoryWorkerThread.processMarkerForAddUpdatePhase(RepositoryWorkerThread.java:263)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.deployment.DeploymentWorkerThread.processMarkerPhase(DeploymentWorkerThread.java:562)
**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production at atg.deployment.DeploymentWorkerThread.run(DeploymentWorkerThread.java:335)

**** Error Fri Apr 24 15:30:15 UTC 2015 1429889415294 /atg/dynamo/service/jdbc/JTDataSource_production

Solution:

Changed the JTA transaction timeout from 30 to 200 and the issue got resolved.

ATG - runAssembler The system cannot find the path specified

Problem

I was running ATG runAssembler script and got the following error

C:\ATGDEV\ATG\ATG10.0.2\home\bin>runAssembler DCSSampleCatalog.ear -m DCSSampleCatalog;DafEar.Admin
The system cannot find the path specified.

Solution

I opened up the runAssembler batch file, switched echo on and then reran the runAssembler command above. Figured out that the issue was with the path of the java exe, it was pointing to a wrong path. Actually I uninstalled JDK and reinstalled it onto some other path after I installed ATG and that was the cause of the issue. I had to open the dasEnv.bat inside ATG_HOME\localconfig folder and update the ATGJRE environment variable to point to the new java.exe path. Reran the runAssembler command it worked fine.

C:\ATGDEV\ATG\ATG10.0.2\home\bin>runAssembler DCSSampleCatalog.ear -m DCSSampleCatalog;DafEar.Admin
Assembly started.
Target application is C:\ATGDEV\ATG\ATG10.0.2\home\bin\DCSSampleCatalog.ear.
 Creating exploded ear file C:\ATGDEV\ATG\ATG10.0.2\home\bin\DCSSampleCatalog.ear.
Initializing...
 Before make meta-inf file.
Making meta-inf file C:\ATGDEV\ATG\ATG10.0.2\home\bin\DCSSampleCatalog.ear\META-INF
Creating application.xml...
 Creating Ear file MANIFEST...
 Importing classes...
Importing classes for module DafEar
 Importing classes for module DafEar.Admin
 Importing classes for module DafEar.base
      Importing classes for module DCSSampleCatalog
 Importing classes for module DCS
   Importing classes for module DSS
   Importing classes for module DPS
   Importing classes for module DAS-UI
    Importing classes for module DAS
  Ignoring classpath entry lib/servlet.jar from module DAS
 Ignoring classpath entry lib/jsp-api.jar from module DAS
      Importing classes for module manuals
  Importing J2EE module atg-admin.war declared in DafEar.Admin
  Parsing C:\ATGDEV\ATG\ATG10.0.2\home\bin\DCSSampleCatalog.ear\atg_admin.war\WEB-INF\web.xml
 Importing J2EE module atg-bootstrap.war declared in DafEar.base
  Parsing C:\ATGDEV\ATG\ATG10.0.2\home\bin\DCSSampleCatalog.ear\atg_bootstrap.war\WEB-INF\web.xml
 Importing J2EE module atg-bootstrap-ejb.jar declared in DafEar.base
 Importing J2EE module sampleCatalog.war declared in DCSSampleCatalog
  Parsing C:\ATGDEV\ATG\ATG10.0.2\home\bin\DCSSampleCatalog.ear\sampleCatalog.war\WEB-INF\web.xml
  Assembly took 2.72 seconds.

ATG - Caused by: java.lang.IllegalStateException: jboss.web.deployment:war=/dyn is already installed.

Problem

I recently deployed my ATG application EAR onto my JBoss and started by JBoss Server. The server started but it threw the following exception almost at the end of the startup

5:32:00,577 ERROR [AbstractKernelController] Error installing to Real: name=vfsfile:/C:/jboss-

eap-5.1/jboss-as/server/Admin/deploy/Live.ear/ state=

PreReal mode=Manual requiredState=Real

org.jboss.deployers.spi.DeploymentException: Error deploying: jboss.web.deployment:war=/dyn

        at org.jboss.deployers.spi.DeploymentException.rethrowAsDeploymentException(DeploymentException.java:49)

        at org.jboss.system.deployers.ServiceDeployer.deploy(ServiceDeployer.java:118)

        at org.jboss.system.deployers.ServiceDeployer.deploy(ServiceDeployer.java:46)

        at org.jboss.deployers.spi.deployer.helpers.AbstractSimpleRealDeployer.internalDeploy(AbstractSimpleRealDeployer.java:62)

        at org.jboss.deployers.spi.deployer.helpers.AbstractRealDeployer.deploy(AbstractRealDeployer.java:55)

        at org.jboss.deployers.plugins.deployers.DeployerWrapper.deploy(DeployerWrapper.java:179)

        at org.jboss.deployers.plugins.deployers.DeployersImpl.doDeploy(DeployersImpl.java:1454)

        at org.jboss.deployers.plugins.deployers.DeployersImpl.doInstallParentFirst(DeployersImpl.java:1172)

        at org.jboss.deployers.plugins.deployers.DeployersImpl.doInstallParentFirst(DeployersImpl.java:1193)

        at org.jboss.deployers.plugins.deployers.DeployersImpl.doInstallParentFirst(DeployersImpl.java:1225)

        at org.jboss.deployers.plugins.deployers.DeployersImpl.install(DeployersImpl.java:1113)

        at org.jboss.dependency.plugins.AbstractControllerContext.install(AbstractControllerContext.java:348)

        at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:1652)

        at org.jboss.dependency.plugins.AbstractController.incrementState(AbstractController.java:938)

        at org.jboss.dependency.plugins.AbstractController.resolveContexts(AbstractController.java:1082)

        at org.jboss.dependency.plugins.AbstractController.resolveContexts(AbstractController.java:988)

        at org.jboss.dependency.plugins.AbstractController.change(AbstractController.java:826)

        at org.jboss.dependency.plugins.AbstractController.change(AbstractController.java:556)

        at org.jboss.deployers.plugins.deployers.DeployersImpl.process(DeployersImpl.java:789)

        at org.jboss.deployers.plugins.main.MainDeployerImpl.process(MainDeployerImpl.java:699)

        at org.jboss.system.server.profileservice.repository.MainDeployerAdapter.process(MainDeployerAdapter.java:117)

        at org.jboss.system.server.profileservice.repository.ProfileDeployAction.install(ProfileDeployAction.java:70)

        at org.jboss.system.server.profileservice.repository.AbstractProfileAction.install(AbstractProfileAction.java:53)

        at org.jboss.system.server.profileservice.repository.AbstractProfileService.install(AbstractProfileService.java:403)

        at org.jboss.dependency.plugins.AbstractControllerContext.install(AbstractControllerContext.java:348)

        at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:1652)

        at org.jboss.dependency.plugins.AbstractController.incrementState(AbstractController.java:938)

        at org.jboss.dependency.plugins.AbstractController.resolveContexts(AbstractController.java:1082)

        at org.jboss.dependency.plugins.AbstractController.resolveContexts(AbstractController.java:988)

        at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:778)

        at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:543)

        at org.jboss.system.server.profileservice.repository.AbstractProfileService.registerProfile(AbstractProfileService.java:308)

        at org.jboss.system.server.profileservice.ProfileServiceBootstrap.start(ProfileServiceBootstrap.java:256)

        at org.jboss.bootstrap.AbstractServerImpl.start(AbstractServerImpl.java:461)

        at org.jboss.Main.boot(Main.java:221)

        at org.jboss.Main$1.run(Main.java:556)

        at java.lang.Thread.run(Thread.java:662)

Caused by: java.lang.IllegalStateException: jboss.web.deployment:war=/dyn is already installed.

        at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:719)

        at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:543)

        at org.jboss.system.ServiceController.doInstall(ServiceController.java:670)

        at org.jboss.system.ServiceController.install(ServiceController.java:273)

        at org.jboss.system.deployers.ServiceDeployer.deploy(ServiceDeployer.java:90)

        ... 35 more

15:32:00,629 INFO  [ProfileServiceBootstrap] Loading profile: ProfileKey@462d62d9[domain=default, server=default, name=Admin]

15:32:00,632 ERROR [ProfileServiceBootstrap] Failed to load profile: Summary of incomplete deployments (SEE PREVIOUS ERRORS FOR DETAILS):

DEPLOYMENTS IN ERROR:

  Deployment "vfsfile:/C:/jboss-eap-5.1/jboss-as/server/Admin/deploy/Live.ear/" is in error due to the following reason(s): java.lang.IllegalStateEx

ception: jboss.web.deployment:war=/dyn is already installed.

Solution

After a quick analysis I found that the above error was thrown when I had two ATG EARs inside my jboss server's deploy folder. Its always advisable to build all necessary modules into a single ATG EAR and deploy it onto to the application server. I removed the old unwanted EAR and the error vanished.The above error was caused because both my ATG EARs were built with DafEar.Admin which adds the dyn content. Having two EARs could also cause other issues, so watchout.

ATG - javax.naming.NameNotFoundException: ca not bound

Problem

I was getting the following error when I was starting my JBoss Server with an ATG Application deployed. I had a custom datasource by name DirectJTDataSource_CA which was having a JNDI configured as java:/ca - JNDIName=java:/ca

14:43:28,178 ERROR [DirectJTDataSource_CA]
javax.naming.NameNotFoundException: ca not bound
        at org.jnp.server.NamingServer.getBinding(NamingServer.java:771)
        at org.jnp.server.NamingServer.getBinding(NamingServer.java:779)
        at org.jnp.server.NamingServer.getObject(NamingServer.java:785)
        at org.jnp.server.NamingServer.lookup(NamingServer.java:443)
        at org.jnp.interfaces.NamingContext.lookup(NamingContext.java:726)
        at org.jnp.interfaces.NamingContext.lookup(NamingContext.java:686)
        at javax.naming.InitialContext.lookup(InitialContext.java:392)
        at atg.nucleus.JNDIReference.getReference(JNDIReference.java:140)
        at atg.nucleus.JNDIReference.doStartService(JNDIReference.java:116)

Solution

The issue was because I did not have the JNDI "ca" configured in my jboss ds.xml file. I added the same (see below for what I added) pointing to the schema I had to point it to and restarted the server and the error was gone.

 <xa-datasource>
      <jndi-name>ca</jndi-name>
      <track-connection-by-tx>false</track-connection-by-tx>
      <isSameRM-override-value>false</isSameRM-override-value>
      <min-pool-size>5</min-pool-size>
      <max-pool-size>100</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">atg_ca</xa-datasource-property>
      <xa-datasource-property name="Password">atg123</xa-datasource-property>
      <!-- Uncomment the following if you are using Oracle 9i
          <xa-datasource-property name="oracle.jdbc.V8Compatible">true</xa-datasource-property>
      -->
      <exception-sorter-class-name> org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter
      </exception-sorter-class-name>
  </xa-datasource>

ATG - atg.repository.rql.RqlStatement java.lang.IllegalArgumentException: CONTAINER:atg.repository.RepositoryException

Problem

I got this pretty simple error when I tried to inject an RQLStatement through a component property file and try and start my component

10:52:59,566 ERROR [nucleusNamespace.] Cannot parse property value "id=?0 OR name CONTAINS ?1 OR myBillingAddrs INCLUDES ITEM(postalCode CONTAINS ?2 OR city CONTAINS ?3" of "/demoApp/customer/dao/Cust
omerDAO.organizationSearchRQL" as a atg.repository.rql.RqlStatement java.lang.IllegalArgumentException: CONTAINER:atg.repository.RepositoryException; SOURCE:atg.repository.rql.ParseException: Encounte
red "<EOF>" at line 1, column 100.
Was expecting one of:
    <AND> ...
    <OR> ...
    ")" ...
    "." ...

Solution

The error message was pretty clear. I was missing a closing brace ")" at the end of the RQLStatement at column 100 as rightly notified by the Exception.

id=?0 OR name CONTAINS ?1 OR myBillingAddrs INCLUDES ITEM(postalCode CONTAINS ?2 OR city CONTAINS ?3)

ATG - atg.search.routing.RoutingSearchException: No engines responded. Verify the configuration for environment 'default1'

Problem

I was getting the following error when I tried to start my Live aka Core aka StoreFront server which was using ATG Search and tried to do a Search.

atg.search.routing.RoutingSearchException: No engines responded. Verify the configuration for environment 'default1' 

I was also seeing a couple of warnings as below.

13:27:06,212 WARN  [RoutingSearchService] No running search engines for env default1, partition 1000117 in LP Content Set 1
13:27:06,346 WARN  [RoutingSearchService] No running search engines for env default1, partition 1000117 in LP Content Set 1


Solution

Assuming that you have had your Search configured properly and deployed and its been working before and suddenly it has started giving the above mentioned errors, here is the solution. Its probably because your atgsearch.exe isnt running anymore and you may have to start it manually by going into CA/Search Administration and start the default1 instance or you can follow the below steps to start it using the dyanmo admin of the Live server.


1. If you Live server is running on port 8180, navigate to http://localhost:8180/dyn/admin/nucleus/atg/search/routing/RoutingSystemService/


2. You should be able to see all the configured search environments in a table.


3. Click on the start link against the search environment which you have to start, in my case it was default1 as the error notified.


4. After clicking on the start link wait for the RunningEngineCount to show a value > 0

5. When the RunningEngineCount is greater than 0, do a search on your StoreFront application and it should work now.

ATG - IPlanet/Dynamo Address already in use error

Problem

I got the following error when I was testing my iplanet  [sun java system web server] connected to dynamo server via the connection module
[27/Feb/2009:13:54:11] failure ( 2784): for host 10.2.30.43 trying to GET /demo/index.jsp, Dynamo NSAPI Module reports: Cannot connect to DRP server due to the error: Address already in use (WSAEADDRINUSE).
[27/Feb/2009:13:54:11] warning ( 2784): for host 10.2.30.43 trying to GET /demo/index.jsp, Dynamo NSAPI Module reports: Failure while attempting to use DRP server at 10.2.30.43:8850 to service a request.

Solution

I fixed it by adding a MaxUserPort property as mentioned in http://support.microsoft.com/kb/319502 and restarted my iplanet web and admin servers and it started working properly.

ATG - Illegal attempt to diff snapshots on different branches

Problem
    Are you getting the following error in your when you deploy projects from BCC to a target ? Are you using late staged deployment ?

[12/27/08 7:24:35:795 UTC] 000000be SystemOut     O /atg/epub/DeploymentServer  ---     CONTAINER:atg.deployment.common.DeploymentException: Deployment '{0}' to target '{1}' encountered a versioning error building the manifest.; SOURCE:atg.versionmanager.exceptions.VersionException: java.lang.IllegalArgumentException: illegal attempt to diff snapshots on different branches.
        at atg.deployment.common.ResourceUtil.exception(ResourceUtil.java:360)
        at atg.deployment.adapter.DistributedDeploymentAdapter.createStandardDeploymentData(DistributedDeploymentAdapter.java:1082)
        at atg.deployment.adapter.DistributedDeploymentAdapter.createDeploymentData(DistributedDeploymentAdapter.java:554)
        at atg.deployment.adapter.DistributedDeploymentAdapter.transferData(DistributedDeploymentAdapter.java:277)
        at atg.deployment.server.Deployment.run(Deployment.java:1549)
        at java.lang.Thread.run(Thread.java:570)
Caused by :atg.versionmanager.exceptions.VersionException: java.lang.IllegalArgumentException: illegal attempt to diff snapshots on different branches.
        at atg.versionmanager.impl.SnapshotRepositoryImpl.createSnapshotDiff(SnapshotRepositoryImpl.java:108)
        at atg.deployment.adapter.DistributedDeploymentAdapter.createStandardDeploymentData(DistributedDeploymentAdapter.java:1034)
        at atg.deployment.adapter.DistributedDeploymentAdapter.createDeploymentData(DistributedDeploymentAdapter.java:554)
        at atg.deployment.adapter.DistributedDeploymentAdapter.transferData(DistributedDeploymentAdapter.java:277)
        at atg.deployment.server.Deployment.run(Deployment.java:1549)
        at java.lang.Thread.run(Thread.java:570)
Caused by (#2):java.lang.IllegalArgumentException: illegal attempt to diff snapshots on different branches.
        at atg.versionmanager.impl.SnapshotRepositoryImpl.createSnapshotDiff(SnapshotRepositoryImpl.java:108)
        at atg.deployment.adapter.DistributedDeploymentAdapter.createStandardDeploymentData(DistributedDeploymentAdapter.java:1034)
        at atg.deployment.adapter.DistributedDeploymentAdapter.createDeploymentData(DistributedDeploymentAdapter.java:554)
        at atg.deployment.adapter.DistributedDeploymentAdapter.transferData(DistributedDeploymentAdapter.java:277)
        at atg.deployment.server.Deployment.run(Deployment.java:1549)
        at java.lang.Thread.run(Thread.java:570)

Solution
    I got this error because i was having both my staging and production targets in my late staged workflow point to the same node. When i made them point to two different customer facing node instances the issue got resolved.

ATG - IPlanet/Dynamo Failure to connect via TCP to Load Manager

Problem
    Are you getting the following error in your iplanet error log ?

[20/Mar/2009:01:58:50] info ( 4476): WEB0100: Loading web module in virtual server [https-machinename.com] at [/search]
[20/Mar/2009:01:58:50] failure ( 4476): Dynamo NSAPI Module reports: CMLDRP(TCP) Failure to connect via TCP to Load Manager=192.168.1.100:8880, io status=Connection refused.  Please check that the IP Address and Port of the Load Manager is correct and that the Load Manager is using TCP instead of UDP.
Solution
    I had my Dynamo and IPlanet connected via the Dynamo Connection module and the load manager component on the Dynamo App Server side was not started. So I started the following in the atg/dynamo/Configuration.properties and restart the app server and the issue got fixed

loadManagerEnabled=true
drpEnabled=true

ATG - atg.service.idgen.IdGeneratorException java.sql.SQLException: java.lang.ClassNotFoundException: oracle.jdbc.driver.OracleDriver

Problem
    Are you getting the following error when you start your dynamo server ?

**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator ---     CONTAINER:atg.service.idgen.IdGeneratorException; SOURCE:java.sql.SQLException: atg.service.resourcepool.ResourcePoolException: java.sql.SQLException: java.lang.ClassNotFoundException: oracle.jdbc.driver.OracleDriver
**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator         at atg.service.idgen.SQLIdGenerator.getConnection(SQLIdGenerator.java:624)
**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator         at atg.service.idgen.SQLIdGenerator.initializeIdSpaces(SQLIdGenerator.java:810)
**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator         at atg.service.idgen.PersistentIdGenerator.initialize(PersistentIdGenerator.java:305)
**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator         at atg.service.idgen.AbstractSequentialIdGenerator.doStartService(AbstractSequentialIdGenerator.java:621)
**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator         at atg.nucleus.GenericService.startService(GenericService.java:495)
**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator         at atg.nucleus.NucleusNameResolver.startService(NucleusNameResolver.java:1229)
**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator         at atg.nucleus.NucleusNameResolver.configureAndStartService(NucleusNameResolver.java:1002)
**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator         at atg.nucleus.NucleusNameResolver.createFromName(NucleusNameResolver.java:705)
**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator         at atg.nucleus.NucleusNameResolver.createFromName(NucleusNameResolver.java:576)
**** Error      Thu Mar 19 23:46:20 CST 2009    1237527980062   /atg/dynamo/service/IdGenerator ....stack trace CROPPED after 10 lines.
Solution
     By default ATG adds Solid database driver to the classpath. But I changed the JTDatasource/FakeXA configurations to point to my oracle express and changed it to use the the Oracle JDBC Driver. So I had to add Oracle JDBC driver jar file ojdbc14.jar to classpath. So I edited the home/localconfig/postEnvironment.bat and added the path to ojdbc14.jar to the CLASSPATH environment variable and restarted the server to fix the issue.

ATG - Could not create log file

Problem
    Are you getting the following error when you start your dynamo server ?

Could not create log file: .\servers\devserver\logs\dynamo.log (The system cannot find the path specified)
java.io.FileNotFoundException: .\servers\devserver\logs\dynamo.log (The system cannot find the path specified)
        at java.io.FileOutputStream.openAppend(Native Method)
        at java.io.FileOutputStream.<init>(FileOutputStream.java:177)
        at java.io.FileOutputStream.<init>(FileOutputStream.java:102)
        at atg.core.io.SystemOutRecorder.pushLogFileImpl(SystemOutRecorder.java:152)
        at atg.core.io.SystemOutRecorder.pushLogFile(SystemOutRecorder.java:105)
        at atg.nucleus.Nucleus.startNucleusCheckLicense(Nucleus.java:3582)
        at atg.nucleus.Nucleus.startNucleus(Nucleus.java:3464)
        at atg.nucleus.Nucleus.main(Nucleus.java:3452)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
        at java.lang.reflect.Method.invoke(Method.java:324)
        at atg.applauncher.AppLauncher.launch(AppLauncher.java:795)
        at atg.applauncher.dynamo.DynamoServerLauncher.main(DynamoServerLauncher.java:305)
Dynamo exited abnormally.  For troubleshooting information go to the URL:
  http://www.atg.com/support
Press any key to continue . . .

Solution
    I have created a new dynamo server folder by name devserver and just added localconfig and put in some component overrides inside that folder. I had to create a logs folder inside devserver to fix the issue. Make sure you create the logs folder inside dynamo_home/servers/devserver. If not just go ahead and create the directory tree and bounce the server. The error should go away.

ATG - Unable to start service /atg/dynamo/service/j2ee/JarFileCache

Problem
    Are you getting the following error when you start your dynamo server ?

**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197078   /       Unable to start service "/atg/dynamo/service/j2ee/JarFileCache": atg.nucleus.ServiceException: Could not create directory servers\devserver\j2ee\runtime\jar-cache
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /       Unable to resolve component /atg/dynamo/service/j2ee/J2EEContainer      java.lang.NullPointerException
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /at atg.j2ee.service.jarcache.JarFileCachingService.getZipFileSystem(JarFileCachingService.java:172)
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /at atg.j2ee.configuration.ConfigVirtualFileOpener.createZipFileSystem(ConfigVirtualFileOpener.java:115)
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /at atg.vfs.VirtualFileOpenerImpl.getVFSFromFile(VirtualFileOpenerImpl.java:166)
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /at atg.vfs.VirtualFileOpenerImpl.openVirtualFileFromFile(VirtualFileOpenerImpl.java:185)
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /at atg.j2ee.configuration.ConfigurationImpl.getClassLoaderVirtualFileForFile(ConfigurationImpl.java:702)
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /at atg.j2ee.configuration.WebModuleConfigurationBuilder.createRootModuleClassLoader(WebModuleConfigurationBuilder.java:219)
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /at atg.j2ee.configuration.ModuleConfigurationBuilderImpl.setRootClassPathAndLoader(ModuleConfigurationBuilderImpl.java:437)
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /at atg.j2ee.configuration.ModuleConfigurationBuilderImpl.initializeModuleConfiguration(ModuleConfigurationBuilderImpl.java:414)
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /at atg.j2ee.configuration.ModuleConfigurationBuilderImpl.parseModule(ModuleConfigurationBuilderImpl.java:257)
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /       ....stack trace CROPPED after 10 lines.
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197187   /
**** Error      Thu Mar 19 23:49:57 CST 2009    1237528197296   /       Unable to set configured property "/atg/dynamo/service/Initial.initialServices" atg.nucleus.ConfigurationException: Unable to resolve component /atg/dynamo/service/j2ee/J2EEContainer

Solution
    I had created dynamo server folder by name devserver and just had localconfig folder and some contents in it nothing else. I had to create the required folder structure and it worked. Make sure you already have this directory structure under dynamo_home/servers/devserver - j2ee\runtime\jar-cache. If not just go ahead and create the directory tree and bounce the server. The error should go away.

ATG - runAssembler Document root element is missing

Problem
    Are you getting an error "Document root element is missing" while building an EAR or deploying an application ? I got that when I was bundling ATG modules using runassembler :)

CAUGHT AT:CONTAINER:atg.appassembly.ApplicationAssemblerException
Document root element is missing

Solution
    Guess which XML its trying to read, mine was application.xml inside the META-INF folder. Open it in an editor delete the first character and retype it usually it be the less than sign (<). Save the file and try redoing what you did more chance that it would work :)