Workshop 2 Digging in Boris Wylutzki 2016
Agenda Workshop 2 – Digging in Error analysis techniques Debugging the server component Debugging the planboard Creating your own license keys Goals: Partner can issue own licenses Developer can provide support and fixes Duration: 3 hours presentation 1 hour questions & answers
Prerequisites Visual Studio 2013 Professional or Enterprise Edition; Community/Express Edition is not enough VS 2015 should also work, but we have not tested it yet. Microsoft SQL Server 2008 R2 / 2012 / 2014 2014 recommended; not Express Edition SAP Business One 9.2 PL04 You can follow with 9.1 PL13 as well, but we will use 9.2 for demonstration. VariAdd Project plus source code from 2016-11-23 See workshop invitation mail. Java SE Development Kit 8 in 32 bit and 64 bit http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Eclipse IDE for Java Developers http://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/neonr
Logfiles SAP Add-on %appdata%\VariAdd Project plus\Logs Server Component C:\Program Files (x86)\Variatec\VariAdd Project plus Server\log SELECT * FROM dbo.[@BXPCONFIG] WHERE Code = 'BXFFLOGL'; UPDATE dbo.[@BXPCONFIG] SET U_BXPValue = 4
Debugging the Server Component All steps documented in \VPRO\Sources\BXPRO\Documentation\ Developer Guide.docx Open and adjust in Eclipse: \VPRO\Sources\BXPRO\Trimergo-B2-Server\src\com\trimergo\bridge\app\Run.java Add new debug configuration in Eclipse: Type: Java Application Main class: com.trimergo.bridge.app.Run Add hostname and port to security exception list in Java Control Panel Add breakpoint to com.trimergo.bridge.app.content.planboard.PlanboardResponder.doPost()
Get/Set MS-SQL Server Port Default is port 1433 If running multiple instances: Disable dynamic ports Use unique port per instance
Debugging the Java Applet All steps documented in \VPRO\Sources\BXPRO\Documentation\ Developer Guide.docx Use different Eclipse workspace! Enable remote debugging for applets: -client -Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n Add new debug configuration in Eclipse: Type: Remote Java Application Host: localhost Port: 8000 Open planboard URL from Run.java comment in Internet Explorer Set breakpoint to com.trimergo.bridge.app.content.planboard.client.PlanboardRunner.openCalendar()
Setup License Generation Run BDemoApp to create public + private key Start SAP Business One as administrator Open \VPRO\Sources\BXFramework4PRO\BXFramework-BDemoApp.sln Rebuild for target “x86” (not Any CPU) and Run Click on Generate key pair Copy public key into add-on \VPRO\Sources\BXFramework4PRO\TxExtensionModulesBoImpl\TxLicensingBOImplementations\ SignatureKeys.xml Change ID and Comment attributes to YOUR company name! Re-build and re-install VariAdd Project plus, which then accepts your license Build license generator tool \VPRO\Sources\BXFramework4PRO\TxLicenseGeneratorApp\TxLicenseGeneratorApp.sln Copy private key into license generator …\bin\Debug\licenseprivatekey.txt (see licenseprivatekey.sample.txt) Use your company name as license name! YourCompanyName <RSAKeyValue><Modulus>vbtLs0MbTz0QAnN7wQFNan/Xtr8B8... same!
SignatureKeys.xml <?xml version="1.0" encoding="utf-8" ?> <SignatureKeys xmlns="http://tempuri.org/SignatureKeys.xsd"> <Key ID="Variatec" Version="1" Role="All" ValidUntil="2099-01-01" Comment="Variatec Main Signing key"> <PublicKey><![CDATA[<RSAKeyValue> <Modulus>kNI6yEUQihW7NFD5uJXwog3EFnj+Ugnvl/Xj5Z65v2p2EvMv0a4EIrj1Bfe5vQhP3cf06V32ROYROqRYDXdA4xCEDo/VJMBE7SFBftaHq9l1wNeJYZJ1PYvcfc5h7/FoRTkbNO9EW8d9nKuKPEk++d49zMB2WKotznutyNd4Wd8=</Modulus> <Exponent>AQAB</Exponent> </RSAKeyValue>]]></PublicKey> </Key> <Key ID="YOURCOMPANY" Version="1" Role="All" ValidUntil="2099-01-01" Comment="YOURCOMPANY Main Signing key"> <PublicKey><![CDATA[ PUT IN YOUR PUBLIC KEY HERE INCL ALL XML TAGS ]]></PublicKey> </SignatureKeys>
Product and License Types Product Functionality Generator Name License Code VariAdd Project BX PRO BXPROBAS VariAdd MRO BX MRO BXMROBAS VariAdd Project + MRO („plus“) BX PRO/MRO BXPROCOM License Type Max Users Expiration Comment Production ꝏ 01.01.2099 Issued only after payment Demo for Customer 40 days For customers as preparation for go-live Demo for Presentation 2 1 year Only one license per partner See: \VPRO\Sources\BXPRO\Documentation\License Types.xlsx
License Generation Start earlier created TxLicenseGeneratorApp.exe Copy in content of Mail body example.txt \VPRO\Sources\BXFramework4PRO\TxLicenseGeneratorApp\TxLicenseGeneratorApp\Mail body example.txt Adjust license settings Partner data, customer data, SAP keys, etc. AddOn: (see prev. slide “Generator Name”) AddOn Type: (see prev. slide “License Type”) Quantity: (number of users; restricted by type) Click Verify license data preview Send generated ZIP file (same directory) to customer
Thank you! Questions?