Confluence is a project collaboration software with an extensive set of features that help to improve the efficiency of joint teams work and gain development productivity in general. It provides a centrified location to collaborate on projects, allowing to build product knowledge base with different content types – docs, files, ideas, specs, diagrams, mockups, etc. Being a truly flexible tool, Confluence supports ex add-ons, includes built-in templates, JIRA integration and lots of other appealing features.
To run Confluence software inside Jelastic, you’ll need to accomplish the next steps, described in the same-named sections within the guide below:
- Create new environment
- Download and deploy Confluence Server package
- Apply the required configurations
- Install Confluence instance
So, let’s go on!
Create New Environment
To start with, log in to the Jelastic dashboard with your credentials and click New environment in its top left corner.
Within the opened wizard, switch toJava-dedicated tab (the first one) and select Tomcat 8 as your application server.Allocate the required amount of resources for this node with vertical scaling sliders on the central pane, type Environment Name and click Create.
In a few minutes, your new environment will appear at the dashboard. Meanwhile, let’s proceed to downloading Confluence Server sources.
Download and Deploy Confluence Server
1. While the environment is being created, visit the official Atlassian website to get a free 30-day trial version of Confluence Server software – just select ZIP Archive package type and click Download.2. Unzip the downloaded package, locate the confluence directory and compile a WAR file with its content.
Since the compiled WAR archive most likely will exceed the 150MB limit for being uploaded to your dashboard as a local file, put it to any online file storage (e.g. Dropbox, Google Drive, OneDrive etc) and copy the direct link to its location.
3. Return to the Jelastic dashboard (we assume the appropriate environment has been already created by this time) and click Upload under the Deployment manager section name. In the appeared dialog box, switch to the URL tab, paste the saved link to your WAR file and click Upload.
4. Hover over the uploaded package, click the Deploy to… button and select the destination environment (confluence in our case).Within the opened confirmation window, optionally specify application context name it should be deployed to (or just leave the corresponding field blank to use the default ROOT location) and wait until the deployment is successfully completed to proceed to the next section.
Configure Confluence Environment
As the last step, some additional configurations should be applied to Confluence settings for enabling it running properly within the Jelastic Cloud – accomplish them as follows.
1. Click Config next to the Tomcat node to open container File Manager. Switch to the temp directory within Favorites list to the left and create new data folder inside.Copy the absolute path to it using the directories nesting bar above the main manager frame (/opt/tomcat/temp/data in our case).
2. Now, navigate to the confluence-init.properties file within the opt/tomcat/webapps/ROOT//WEB-INF/classes directory. Uncomment the confluence.home parameter and specify the copied path to the data directory as a value. Save the changes.
3. Click Restart nodes next to the Tomcat application server for the new settings appliance.Once Tomcat is up again, you can proceed to the next section.
Install Confluence Instance
Finally, now you are ready to set up your own Confluence instance.
1. Within the main environment management pane, select Open in browser for Tomcat in order to launch Confluence setup wizard in a new tab.2. In the opened Set up Confluence page, select Trial Installation and click Next.
3. Under the Confluence box, click the Get an evaluation license link to generate a key and confirm its usage for the current installation.
When you are finished, click Next and give some time for the system to configure your license and set up a trial database.
4. At the next frame, define how the users and user groups should be managed within your Confluence instance – either by the service itself or through the externally connected JIRA system (if you already have one).5. Finally, configure your system administrator account by providing the desired credentials and click Next. At this point, all the basic configurations have been provided, so just click Next to finish the wizard and launch the main Confluence dashboard page.Here you are! In case you need to learn the basic concepts of collaboration within Confluence, watch the proposed video tutorial or dive deeper by browsing documentation. Otherwise, just start filling up the system with the required product-related data, share these materials with your teammates and enjoy all the features for joint work this tool provides.