Atrium Integrator Carte server
Working of
Carte Server
You can start a job from the
console only if the
Carte server is running. When you install the ,
Carte server is automatically installed on the same computer, and runs in the background. If you restart the , the Carte server also restarts automatically.
The start and stop functions of the
Carte server are monitored using the armonitor.cfg file.
Accessing
Carte server
You can access the
Carte server using the following URL:
http://<ARserver_host*>:20000*
20000 is the default port. You can find the port number from the UDM:Config form.
You can login using AI Admin or AI User credentials. For more information, see Permissions-to-access-Atrium-Integrator.
To access
Carter server from
console
When you run a job from
console, you can view the job run status from
Carte server.
- Log in to
and navigate to Manage Atrium Integrator Jobs.
- Click Executed to view the jobs that have completed a run.
- Select a job, and under the Runs History column, click the arrow icon to expand the details.
- View the details in the following tabs:
You can login toCarte server as a AI Admin or AI User.
To connect to the
Carte server by using a browser
- In a browser window, type:
http://<HostName>:<PortNumber> HostName is the host name of the computer where theserver is installed, and PortNumber is the number displayed in the Port field of the UDM:Config form.
- Click Enter.
- Log on to
Carte server with AI Admin or AI User permissions also.
- (optional) To view the status of the jobs and transformations that have been run from the Atrium Integrator console, click Show status in the Status window.
- (optional) To display the log details for a job, click on that job.
To change
Carte server port
You can identify a default
Carte server port by referring to the UDM:config form, which has the
Carte server details.
- Update the
Carte server port in the armonitor.cfg file on the .
- Update the
Carte server port in the UDM:Config form on the .
- Restart the .
If you have a server group environment, restart all the other in the server group. If the is connected to any server from mid-tier then the Pentaho AR plugin picks up these changes.
To Increase the carte server memory size
While running a complex job from
console or when loading high volume of data into
by using an
job, you might need to increase the default memory size of the Carte server. the default memory size is 1024MB. To increase the memory, you must increase the java heap size.
- Open the armonitor file.
(Windows) <AR Install Directory>\BMCARSystem\Conf\armonitor.cfg
(UNIX) /arsystem/<server name>/armonitor.conf - Edit the following parameters in the file:
"%BMC_JAVA_HOME%\java.exe" -Xmx1024m -classpath "<BMC_JAVA_HOME>\lib\ext\*;<BMC_JAVA_HOME>\lib\*;<BMC_AR_SERVER_HOME>\diserver\data-integration\*;<BMC_AR_SERVER_HOME>\diserver\data-integration\lib\*" "-Dorg.mortbay.util.URI.charset=UTF-8" "-DKETTLE_HOME=<BMC_AR_SERVER_HOME>\diserver" "-DKETTLE_REPOSITORY=" "-DKETTLE_USER=" "-DKETTLE_PASSWORD=" "-DKETTLE_PLUGIN_PACKAGES=" "-DKETTLE_LOG_SIZE_LIMIT=" "-DKETTLE_MAX_LOG_SIZE_IN_LINES=5000" "-DKETTLE_DISABLE_CONSOLE_LOGGING=Y" "-DKETTLE_COMPATIBILITY_MERGE_ROWS_USE_REFERENCE_STREAM_WHEN_IDENTICAL=Y" "-DKETTLE_LENIENT_STRING_TO_NUMBER_CONVERSION=Y" org.pentaho.di.www.Carte <AR Server Name> 20000 -i "<BMC_AR_SERVER_HOME>" - Edit the memory size in the parameter -Xmx<1024>m
- Save the file.
If you get an error while running the job in
Spoon, then you need to make changes in the (Windows) spoon.bat or (UNIX) spoon.sh file which is located at:<arserver home>\diserver\data-integration\.
To resolve any issues with the memory, enable the following parameters for both
Spoon and
Carte server:
-XX:+UseConcMarkSweepGC -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath="c:\temp\MyDump.hprof"
After making the changes in armonitor.cfg file, restart the service for the changes to take effect.