I was recently attempting to setup a Publish instance on a demo AEM 6.1 JEE server I am running. My goal was to set up more of a real world environment with various instances for the purpose of learning how the instances work together.
Before posting this I did a search on this forum and found this thread http://help-forums.adobe.com/content/adobeforums/en/experience-manager-forum/aem-forms.topic.html/fo... which contained this link https://helpx.adobe.com/aem-forms/6/aem-forms-architecture-deployment.html detailing various author/publish/processing topologies.
When spinning up a JEE version of AEM you get an Author instance by default. This documentation goes onto say that the Processing instance (when required) would typically be the JEE version and if I understand correctly the Author and Publish instances could technically be JEE or standalone versions, although the general recommendation seems to be to try and stick with standalone versions when possible. I realize the topologies using HTML Workspace and the AEMS Forms Workflow add-on (ie Process Management) are a little more complex and at least the Author instance will require JEE.
Before coming across this forum post I found this bit of documentation about creating a Publish instance on a JEE server http://help.adobe.com/en_US/AEMForms/6.1/InstallTurnkey/WS0b373c8e7f652f14-5cc6d7413c5cb4e174-8000ae... which, among other things, says "You must run separate author and publish instances. You can configure the two instances on the same or on different machines."
This documentation seems to be saying that the JEE server (jboss in this case) can run multiple instances of different types. Is this correct?
While the instructions seem fairly straight forward, step 1 mentions creating an "appserver profile" with no explanation of what this is or how to create it. There seems to be a presumption the reader should know what this is. Forgive me if this is common knowledge but I'm not clear on what this is or what the context of this term is. It sounds to me like it's a jboss term.
I've googled this term but did not come up with anything meaningful, either from an AEM or Jboss perspective.
To summarize the information from both of these links, there seems to be more than one way to configure Publish instances (1 using standalone versions and another using JEE servers).
Can anyone talk about the ins and outs of these different options and which one might be recommended over another?
If the "appserver profile" method is still a valid and viable approach in AEM 6.1, can anyone expand on how to create an "appserver profile" and/or how to set up a author/publisher instances with the AEM JEE version?
Thanks in advance.
Creating an appserver profile means, running a new instance of JBoss application server. You can use the Adobe pre-configured JBoss application server provided with JEE installer ([AEM Forms JEE instllaer]Adobe\Adobe Experience Manager\JBoss) on a different location on the same machine and pass the following startup argument:
You can change the value of offset. The argument helps run multiple instances of JBoss on the same machine.
If you run instance of JBoss application server on a new machine, the above argument is not required.
- Khushwant Singh
Thanks for all the help, I played a bit more with this, and was able to somewhat get to a CMD prompt screen that didn't offer to many errors, and was able to complete the Publish instance instruction on page 66/178 of the turnkey.PDF i've been using.
When I finished all of this, I got a webpage that kinda loaded automatically in IE like so:
This is familiar as I remember seeing that web site inside AEM forms GUI. so happy about that (and 8190 is that offset port I created.)
now, lets say this is good news, how can I validate that?
So I loaded up a form on my author instance and clicked publish.It went well.
Now, is there a quick way to check and see if this form is available, a bit like that URL that popped-out of nowhere
Again, thank you so much for the help..... its been great
so I deployed the above files, then started the server (in its new location) using
and then I get this info :
What is this, and can it be fixed?
Thanks again so much,
Perfect, thank you so much again Maruan
I will be doing this now and see how this all goes.
Mhmm - looks like you are mixing some things up.
When you use AEM Forms JEE you don't need and shouldn't use cry-qucikstart, as this is the OSGI version of CRX. AEM Forms JEE already includes that. Also don't copy the repository, it will be created upon initial startup of the server.
So you need to deploy
Also make sure that the configurations are not conflicting with your initial copy of AEM Forms e.g. use a different database table ...
Thank you all for your inputs, it seams i'm making a bit of progress.
So what I changed and that was thanks to Maruan, I did a copy of the JBoss zip folder that comes with the entire windows .exe file to install.
This fresh copy seams to be working good, and I continued using the info in the turnkey PDF, mentioned above.
so I copied the following things 1. the publish.ear and 2. the crx repository into my new instance in their right location and typed-in:
This works well until I get to the end and I get the following error messages (it hangs there after that):
Is there something I could type somewhere to get this to work?
Again, thank you so much for all the help
Agree with the above, fresh install for publish instance.
If you are looking to create qa and production instances for the product you are building this will be needed anyway as turnkey is just for evaluation purposes:
From the docs:
"For Turnkey deployment, which is only for evaluation
purposes, see Installing and Deploying AEM forms on JEE usingJBossTurnkey."
Yes I did the turnkey for the first instance, so I just look, thru your links, for the manual install.
I will check that tomorrow morning and keep you posted on how things went.
Thank you so very much
You need to do a manual installation (I assume you did a Turnkey Installation for the first instance).
There are also PDF downloads available on the links above in the upper right hand corner.
Thank you so much for your reply. Ok, how do I start a fresh install for second instance?
Are you running
from the command prompt? If yes, there should be a console output as well as log output in <jboss 2nd install>/standalone(log/server.log.
That works just fine. Now to an important topic. You wrote that you copied the installed/running version. Don't do this!
You need to do a fresh install on the second JBoss instance as otherwise the Database, Temp directory ... is shared which will cause you issues at least remove the adobe*.ear/war files from the deployment directory before starting the second instance of JBoss.
Ok, so tried doing what you mentioned in last thread, did that to the first instance, and it broke it, to the point i had to re-install, couldn't restart it afterwards properly.
Tried it on second instance (where i i have a copy of the jboss folder) and that didn't work either.
Guys, thank you so much for your help thus far.
Again i yet to have this working, the documentation says its doable, the community says its doable, but yet, nothing i try gets that second instance working.
We paid so much money for this, and to get a software that is so difficult to run on first try, is new to me.... So now, i have first instance running again, could i get an actual step-by-step of what is exactly needed for that second instance to run???
I'M RUNNING AEM 6.3, JBoss 6.4 i believe on windows server. I'm using the "aemforms_server_6_3_0_jboss_all_win.zip" for the .exe file. and following the info in this PDF: "Installing and Deploying AEM forms on JEE Using JBoss Turnkey".
You test this out and let me know via private email if you prefer, just let me know if someone is going to look into this.
Thank you very much again,
For AEM 6.3 Forms documentation, visit Adobe Experience Manager Help | AEM 6.3 Forms User Guide
Still cant get this to run, that pesky second instance.
I successfully install the first one using the exe file for Jboss windows and I can test it on port 8080, I connect to the forms page and can design from there and so many other things.
For the second instance, what I do is:
1. copy the Jboss Folder (from working install, the first instance) and copy it to a different location on that machine.
2. I go to the \Bin folder and locate the standalone.bat file and pass it arguments like so: standalone.bat -Djboss.socket.binding.port-offset=110
3. What should I look for after that command, and how do I test all of this??
Not sure if these steps are ok, and when I test it, using the 8080/form URL, but changing it to 8190, I get nothing.
I just want this thing to finally work
Good morning Again
ok, based of off Khushwant info and a bit of research I got this syntax going from the bin folder inside the Jboss folder of my author instance: (JBoss\bin\)
the offset means also that if my first instance is at 8080, I would now get the second one at 8990, correct??
ok, when I get this started, how could I validate the install to see if this all went well or not?
thank you so much again guys,
Wow, thank you so much, I will try this right away.
Thank you so very much Khushwant and sorry, I just realized that's what you had mentioned previously to OP. I didn't make the conection.
Before you run the second install (Publish instance) on a different location on the same machine, pass the following startup argument. It will bump the port number by the count of 110.
You can use any value in place of 110. Ensure that the value used for publish and author instances is different.
- Khushwant Singh
I still need an answer guys on that port config issue, anyone know how this can be done for JEE/jboss of course?
Thank you so much, once i get this going, i might finally have a working environment
Thank you very much, again
I marked the response as correct - i will get them to follow up here too
Thank you so much for the info Khushwant, that was very helpful.
So I have now the first install done (my Author instance, from what I understand) and that's great. Now before I start a second install on the same machine, but a different location. I see here in the "publish notes under the turnkey PDF that it mentions this:
If author and publish instances are on the same machine, ensure that you start the publish
instance using a different port.
Now, my next question would be, how do you change the initial 8080 port to be something else? I know how to do this using the Quickstart approach, but with this install, I don't know how at all.
Would you, or someone else be able to let me know how I can start my second install to have a different port all together???
Thank you very much again
Thank you very much, I look forward to hearing from them
I asked the AEM Forms team to look here and help you.
i'm looking into this PDF right now: Installing and Deploying AEM forms on JEE Using JBoss Turnkey
And the section at the end doesn't specify what is needed here. if its anywhere else, perhaps you good give me an idea on where it is hiding at.
The info is buried deep I find, to try to get all of AEM to work. I've looked at a few different sites from Adobe as well, I saw how to configure the Quickstart Author and Publish instance, but I couldn't get it to work well. so went back to the big install "aemforms_server_6_3_0_jboss_all_win" from the LWS website.
This installs version 6.3. with a lot of configurations.Right now I would like to get this install working at some point, and it works ok, I just need the Publish instance now in order to have my users connect to it and view my forms catalog. if I understand it all.
I need a bit more help from you guys, so sorry
This should all be in the AEM Forms Documentation.
I also have the same, is this resolved???
Also using 6.3 now
Thank you very much, i also need to know how to create that appserver profile.
Thank you for your feedback. We are going to use this feedback to open a bug on the AEM install docs. In mean while - we will get your question addressed.