Installing an SAP Agent

[Samuel BRENOT]

Hello,

We want to test the SAP functionality in One Automation and after receiving a temporary license, I look at installing the SAP agent.

We are in One Automation 12.1.2
And I test with an SAP agent in 12.1.4 because there is no version 12.1.2 available for download on the site.

After placing the binaries on my linux server and setting the ini file, the agent does not launch.

I check the rights and the files are the property of the user automic and executable
-rwxr-xr-x 1 automic automic      22 Oct  8 16:05 ucxjr3x.sh
-rwxr-xr-x 1 automic automic 2938698 Oct  8 16:05 uc.msl
-rw-r--r-- 1 automic automic   11482 Oct  8 16:05 ucxjr3x.ori.ini
-rwxr-xr-x 1 automic automic 1425861 Oct  8 16:05 ucxjr3x.jar
-rwxr-xr-x 1 automic automic 2122369 Oct  8 16:05 uc4.jar
-rw-r--r-- 1 automic automic   11542 Oct  8 16:56 ucxjr3x.ini

they are the same as for sql, ftp, webservices and linux agents already installed and functional.

I set the launch of the SAP agent in the Dialog Service Manager with the command line :
java -d64 -Xrs -Xmx2048M -jar ucxjr3x.jar disable_cache -i/opt/awa/agents/sap/bin/ucxjr3x.ini

The Service Manager log is not very speaking:
20191009/081828.583 - U00022019 Client statement: process 'SAP_AGENT' should be started.
20191009/081828.583 - U00022031 Client data: User 'xxxxx' of computer 'xxxxxx'.
20191009/081828.583 - U00022004 Starting process 'SAP_AGENT' ...
20191009/081828.584 - U00022005 ... with command line  'java -d64 -Xrs -Xmx2048M -jar ucxjr3x.jar disable_cache -i/opt/awa/agents/sap/bin/ucxjr3x.ini'.
20191009/081828.584 - U00022006 ... and start directory  '/opt/awa/agents/sap/bin'.
20191009/081828.584 - U00022007 Process 'SAP_AGENT' (ID '29391') successfully started.
20191009/081828.716 - U00022012 Process 'SAP_AGENT' (ID '29391') ended.
20191009/081828.716 - U00022022 Process 'SAP_AGENT' ended, exit code='1'.

There is no log from the agent.

If I run the parameterized command in the SMD directly on the command line, I get:
Error: A JNI error has occurred, please check your installation and try again
Exception in thread "main" java.lang.NoClassDefFoundError: com/sap/conn/jco/ext/DestinationDataProvider
        at java.lang.Class.getDeclaredMethods0(Native Method)
        at java.lang.Class.privateGetDeclaredMethods(Class.java:2701)
        at java.lang.Class.privateGetMethodRecursive(Class.java:3048)
        at java.lang.Class.getMethod0(Class.java:3018)
        at java.lang.Class.getMethod(Class.java:1784)
        at sun.launcher.LauncherHelper.validateMainClass(LauncherHelper.java:544)
        at sun.launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.java:526)
Caused by: java.lang.ClassNotFoundException: com.sap.conn.jco.ext.DestinationDataProvider
        at java.net.URLClassLoader.findClass(URLClassLoader.java:381)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
        at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:338)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
        ... 7 more



Due to lack of documentation available today :(, I can not check if there are any other requirements 

and what may be the error in bold above.

Do you have some ideas to help me start the agent?

Thank you

------------------------------
AWA 12.1.2
Sam
------------------------------

[Carsten Schmitz]

Hi.

I can not tell you why your agent does not start - sorry.

I can, however, tell you why you don't see the exception in the smgr ​logs and have to launch it on the command line to get to see the error. I strongly suspect you are on a distribution with systemd (as most current Linux distributions are). With systemd, the last time I analyzed this, you needed to make extra configuration to capture the errors from Automic Java components into it's own log files. By default, it ends up in /var/log/messages where it might be missed.

See this tread for more details and a sample configuration:

https://community.broadcom.com/enterprisesoftware/communities/community-home/digestviewer/viewthread?MessageKey=ba449b80-5ca6-4854-bc3e-1304da3603cb

Automic has yet to comment on, or acknowledge the issue, and their support might tell you to go back to systemV init scripts of the past (at least they did for me).

Hth,

[Franz Zalubil]

Hi,

the SAP Agent needs in minimum one working ABAP connection object alligned, even it's not used. I guess you started it with JAVA based connections object only. 
Also I would reccomend to name a SAP Agent SAP_[SID] or [SID] - [SID] is the 3 character unique SAP ID.

When you start the SAP Agent without any connections object it will not work too.

I dont see the SAP JCO in the list. SAP JAVA connector is mandatory and has to be downloaded from SAP. 

In case you install the Agent on a linux system, please add the path of the SAP Java Connector directory ad the Agent bin directory to the start of the Agent.

If SAP Java Connector cannot load its native library the parameter -Djava.library.path can be used to point to a directory which contains the libsapjco3.so.  

Please follow the documentation:

https://docs.automic.com/documentation/webhelp/english/AWA/12.2/DOCU/12.2/AWA%20Guides/help.htm#Installation_Manual/InstallAgents/InstallAgentSAP.htm%3FTocPath%3DInstalling%7CManual%2520Installation%7CInstalling%2520the%2520Agents%7CInstalling%2520the%2520Agent%2520for%2520SAP%2520(Windows)%7C_____0

Hope it helps,
Franz

------------------------------
Managing Consultant Enterprise Studio
HCL Technologies Austria GmbH
------------------------------

[Samuel BRENOT]

Hi,

Thanks for your answers.

it was missing the SAP JAVA connector.

I dropped it in the bin directory of the SAP agent.

I am on linux, and I do not understand your sentence:
"In case you install the Agent on a linux system, please add the path of the SAP Java Connector directory ad the Agent bin directory to the start of the Agent."
Where should I indicate the path of the SAP Java Connector ?


When I launch the agent, he falls into error, but I have a little log:
20191010/154720.184 - U02000071 Current directory: /opt/awa/agents/sap/bin
20191010/154720.185 - U02000066 Host information: Host name='xxxxxxx', IP address='10.xxxx'
20191010/154720.485 - U02000153 The JVM Option HeapDumpOnOutOfMemoryError is enabled.
20191010/154720.536 - U02000072 Connection to system 'AE_xxx initiated.
20191010/154720.537 - U02000011 Connection to Server 'xxxxx:2217' initiated.
20191010/154720.589 - U02000004 Connection to Server 'AE_xxx#CP001' successfully created.
20191010/154720.590 - U02000075 CP Server 'AE_Xxx#CP001' has '1' client connections.
20191010/154721.305 - U02000020 Environment: Hardware = 'SAP'.
20191010/154721.306 - U02000021 Environment: Software = 'SAP'.
20191010/154721.306 - U02000022 Environment: SW version = '0'.
20191010/154722.319 - U02000017 The check interval for 'Jobs' has been set to '60' seconds.
20191010/154722.319 - U02000017 The check interval for 'Server' has been set to '660' seconds.
20191010/154722.320 - U02000017 The check interval for 'Reconnect' has been set to '600' seconds.
20191010/154722.320 - U02000017 The check interval for 'Report' has been set to '60' seconds.
20191010/154722.322 - U02004161 No connection assigned to the ABAP stack.
20191010/154722.323 - U07001001 Charset used by the Agent: 'windows-1252'
20191010/154722.324 - U02000041 Shutdown Agent 'SAP_AGENT_C1'.
20191010/154722.325 - U02000002 Agent 'SAP_AGENT_C1' version '12.1.6+build.1568033575584' ended abnormally.
20191010/154722.347 - U02000010 Connection to Server 'xxxxxxxx:2217' terminated.

and in the AE logs:
20191010/154722.268 - U01006000 Cache for 'HOST_NAME' successfully initialized. Length = '20000000'.
20191010/154722.299 - U00011861 Creating Agent entry 'SAP_AGENT_C1' with index '0000000011'.
20191010/154722.451 - U00011860 Deleting Agent entry 'SAP_AGENT_C1' with index '0000000011'.

Wanting to check for the presence of the SAP agent entry on client 0, I have an error :
error

Maybe this is related to the fact that there is at least one working ABAP connection.
How is this set?

"I know nothing" about SAP, and the person who knows the product is missing this day and tomorrow :(

Regards

------------------------------
AWA 12.1.2
Sam
------------------------------

[Franz Zalubil]

Hi,

you need to define in your System Client 000 a connections object what is providing the SAP Agent at it's startup the information to which SAP System it has to connect. As I wrote you need to allign a connections object to the agent. If you have define the connections object please open the host object with the name your sap agent has in client 000 folder HOSTS. Here you can select and align the connections object you have defined.

In the Service Manager Dialog or uc4.smd (last only if the UC4 ServiceManager is not running) please add the -Djavalibrarypath to the java -jar call. 

Using the link in my thread you will find any details to install a SAP Agent well. Also you will find the minimum Object rights the CPIC (System) user in SAP needs to provide the scheduling requirements the SAP Agent and Automation Platform needs. Try it, the Automic Documentation is very good and usefull.

Best,
Franz

------------------------------
Managing Consultant Enterprise Studio
HCL Technologies Austria GmbH
------------------------------

[Samuel BRENOT]

Hi Franz,

Thank you for the feedback

I think I got to work my agent there is not even 30 min after reading the doc and saw the actions on the client 0.
So I created a connector (which I had created directly in my work client) and an agent with the name only in the ini file.
And the agent started well after that.

Thanks again for the help and the patience to explain to me while I missed some passage of the doc :)

I will see next week with the SAP administrator to test if everything is working fine.

------------------------------
AWA 12.1.2
Sam
------------------------------