Similar content

Loading

Powered by Canoo FindIT.

Enterprise Edition on Linux

Installing Magnolia CMS Enterprise Edition on a Linux computer.

  1. Check the prerequisites
  2. Register for license key
  3. Download, install and run Magnolia CMS
  4. Run the Web update
  5. Register
  6. Log in to author instance
  7. Troubleshooting
Tip!

These instructions rely on the Enterprise installer application. If you need to do fast installations repeatedly, download the Tomcat and Magnolia CMS bundle instead and follow the Community Edition installation steps. You still need to register for a license key.

Check the prerequisites

Java Runtime Environment (JRE)

Magnolia CMS needs a Java Runtime Environment (JRE). Most likely you already have it on your Linux computer. Use the Java Tester to check.

If you don't have JRE, download and install it from http://java.sun.com/javase/downloads/index.jsp. Installation directory varies from one Linux system to another. For example on Ubuntu Linux 10 the OpenJDK Runtime Environment is installed in /usr/lib/jvm/java-6-openjdk/jre by default.

Register for license key

Magnolia CMS Enterprise Edition is available for a free 60-day trial. To get a license key you must register.

  1. Go to http://registration.magnolia-cms.com/.
  2. Fill the form with your details. A license key will be sent to the email address you provide.
If you bought an Enterprise license, a license key will be sent to you upon signing of the Magnolia Network Agreement.

Download, install and run Magnolia CMS

Download

  1. Go to http://files.magnolia-cms.com/.
  2. Click the latest Magnolia CMS version.
  3. Download the Installer (Installer bundle with Tomcat) JAR file. The file name depends on the release, for example magnolia-enterprise-installer-4.2.3.jar.

Install

  1. Run the installer JAR file you downloaded:
    java -jar magnolia-enterprise-installer-4.2.3.jar
  2. Select an installation language and click OK.
  3. Click Next.
  4. Click Next.
  5. Accept the license terms and click Next.
  6. Optional: Configure Magnolia CMS to use a Java Runtime Environment other than your default JRE. The default is usually fine. Click Next.
  7. Click Next.
  8. Select the installation path. Default is /home/userAccount/MagnoliaEnterpriseEdition. If you are installing Magnolia CMS for personal use extract to the default or equivalent directory. If you are installing a production server extract to /usr/local or /opt.
  9. Click Next. Installation will start.
  10. Click Next.
  11. Clear the Start menu and desktop shortcuts. They only work in Windows. Click Next.
  12. Click Done.
The folder structure of the installed application looks like this: 
/home/
  userAccount/
    MagnoliaEnterpriseEdition/
      add-ons/
      apache-tomcat/
        bin/
        common/
        conf/
        logs/
        server
        shared/
        webapps/
          MagnoliaAuthor/
          MagnoliaPublic/
          ROOT/

Run

  1. Open a terminal window.
  2. Go to the Magnolia CMS installation directory:
    cd /home/userAccount/magnolia-4.2.3/apache-tomcat/bin
    Your path may be different.
  3. Start Magnolia CMS:
    ./magnolia_control.sh start
Tip

Use ./magnolia_control.sh start && tail -f ../logs/catalina.out to start Magnolia.

The first part of the command ./magnolia_control.sh start launches Magnolia CMS. The second part && tail -f ../logs/catalina.out displays startup messages written to /apache-tomcat/logs/catalina.out log file. This makes it easier to troubleshoot startup errors. If startup fails, look for the reason in the report. See Troubleshooting to resolve the issues. In a successful startup the last line reads:
INFO: Server startup in 12345 ms

To stop Magnolia CMS use ./magnolia_control.sh stop

Run the Web update

  1. Open a browser and go to http://localhost:8080.
  2. Click the Run the Web update on the author instance link.
    A list of modules that need updating is displayed.
  3. Click Start install.
    The modules are updated.
  4. Click Start up Magnolia.
Repeat the update on the public instance.
  1. Open a browser and go to http://localhost:8080.
  2. Click the Run the Web update on the public instance link.
    A list of modules that need updating is displayed.
  3. Click Start install.
    The modules are updated.
  4. Click Start up Magnolia.

Register

Now you need the license key that was sent to your email address. Copy only the key string part from the message. Fill in the same email address that you used when registering.

Tip

Before you paste the license key make sure that it is a continuous string of characters with no spaces or line breaks. If you have any problems you can paste the key to Notepad or another plain text editor first to strip out any formatting.

Log in to author instance

At the login page, sign in with:

  • Username: superuser
  • Password: superuser
Info

Superuser is a system administration account that has permission to every function. End users should not use this account. See Users for instructions how to create new user accounts and Default users for accounts that you can use for testing right away.

The AdminCentral is displayed.

Troubleshooting

Having problems? See Known issues.