Magnolia CMS Install

Magnolia

Magnolia CE Installation steps on Amazon EC2.
Magnolia CE works well even if AMI is ti.micro

Environment

If you want to try to use Magnolia CE, Easiest way is to use tomcat bundle package.

If you use tomcat bundle package, installation steps are the followings.

  1. Download pacakage, and extract it.
  2. Change directory to bin, so you can find startup script. ( startup.bat ( Windows ), or, startup.sh ( Unix, Mac ))
  3. Execute startup script, then tomcat will start.

But, in this article, I describe how to install Magnolia CE on EC2.

The following is the environments

Magnolia Magnolia Community Edition 5.2.1
OS Amazon Linux ( 64 bit )
Java OpenJDK 1.7.0.51
Tomcat tomcat 7.0.47

Install

Verify Java and tomcat

Verify whether both of java and tomcat are installed.

  1. Check Java installation
    $ rpm -qa | grep java
    java-1.7.0-openjdk-1.7.0.51-2.4.4.1.34.amzn1.x86_64
    
    $ java -version
    java version "1.7.0_51"
    OpenJDK Runtime Environment (amzn-2.4.4.1.34.amzn1-x86_64 u51-b02)
    OpenJDK 64-Bit Server VM (build 24.45-b08, mixed mode)
    
    When Java already installed, the above messages displayed in console. If not installed, Install using yum.
    $ sudo yum install java-1.7.0-openjdk
    
  2. Check tomcat installation
    $ rpm -qa | grep tomcat
    tomcat7-lib-7.0.47-1.36.amzn1.noarch
    tomcat7-servlet-3.0-api-7.0.47-1.36.amzn1.noarch
    tomcat7-el-2.2-api-7.0.47-1.36.amzn1.noarch
    tomcat7-7.0.47-1.36.amzn1.noarch
    tomcat7-jsp-2.2-api-7.0.47-1.36.amzn1.noarch
    
    If tomcat not installed, install it.
    $ sudo yum install tomcat7
    
    If you need to start Tomcat on system startup,
    $ sudo chkconfig tomcat7 on
    $ chkconfig --list
    ...
    tomcat7         0:off   1:off   2:on    3:on    4:on    5:on    6:off
    ...
    

    ※Tomcat's directory is placed at /usr/share/tomcat7/

  3. Tomcat setting

    Configuration file of tomcat is placed at /usr/share/tomcat7/conf.
    I usually change the tomcat7.conf only.

    $ sudo vi /usr/share/tomcat7/conf/tomcat7.conf
    

    Change JAVA_OPTS for Magnolia.
    I added -server, -Dfile.encoding=UTF-8 -Xmx512m, and, -XX:MaxPermSize=256m

    #JAVA_OPTS="-Xminf0.1 -Xmaxf0.3"
    JAVA_OPTS="-server -Dfile.encoding=UTF-8 -Xmx512m -Xminf0.1 -Xmaxf0.3 -XX:MaxPermSize=256m"
    

Get Magnolia CE package

If you will install Magnolia into existing Tomcat(installed with the above steps), use war package.

If you get the package from Magnolia CMS Download Now Page、tomcat bundled will be download. So, download from Magnolia CMS files in SourceForge.

You will find 4 files in each Magnolia version, download magnolia-bundled-webapp-5.2.X.war.

Deploy war

To deply the war file, Copy the war to Tomcat's webapps directory. war file name is used as Context Path, so Change the war file name to proper one before copy it.
For example, when you change to magnolia.war, Magnolia CMS URL will be http://<tomcat-hostname>:8080/magnolia/.
If you want to use ROOT url like http://<tomcat-hostname>:8080/, change the war filename to ROOT.war .

When you copy war file into the webapps directory, deploy will be start.
If tomcat is stopped, start tomcat after copying war file.
war will be extracted under webapps directory ( a sub-directory with the same name as the war-file will be created ).

Magnolia Install Wizard

Magnolia installation
Zoom
Magnolia installation

After the deploy, access to the Magnolia URL.
http://<tomcat-hostname>:8080/<ContextPathName>/

Magnolia installation page is displayed at first time access, then run the installation by clicking [ Start install ... ] button. ( it takes a few minutes )

When the installation is complete, "Installation done." message is displayed, then click [ Start up Magnolia ... ] button.

Login page of Magnolia will be displayed.

Login

Magnolia login page
Zoom
Magnolia login page
ログイン画面

When login page appears, log in by entering the username and password.

Prepared Administrator accont is as follows.

Username superuser
Password superuser

Magnolia Console

Magnolia 管理画面
Zoom
Magnolia 管理画面
管理画面 Top

If the login is successful, Magnolia management console is displayed.

 

Initial Setting

You should change the following setting alter installation.

Change the superuser password

Minimum, change the prepared superuser password.
It's better to deactivate the default superuser account, and create the other administrator account which has password of sufficient strength.
The followings are the password change steps.

  1. Click [Security] icon
  2. Click [SYSTEM USERS] tab.
  3. List of system users are displayed, then double-click superuser.
  4. Edit page of superuser is displayed, then enter the new password, and save it.

Check whether you can log in correctly with the new password.
I recommend to use another Web browser, or another computer without logging out the current session, because if there is a problem with password change, you will not be able to log in.