How to download, install and run Hippo CMS so you can edit the content of a Hippo Repository.

Hippo CMS

• Download the latest build from http://repository.hippocms.org/hippo-cms/v6.x/
• Unzip the build into a folder on your harddisk, for example ~/hippo/hippo-cms-v6.01.00

  Warning Windows Explorer's built-in "compressed folder" functionality is reported to incorrectly unzip the Hippo CMS binary distribution. Windows users are adviced to use a third-party ZIP utility, e.g. 7-Zip.

• Then you need to change directory to where the startup scripts are; if this is your first run, make them executable, then run them. In a new console, type:

  cd ~hippo/hippo-cms-v6.01.00/bin
  chmod u+x fortress.sh wrapper.bin libwrapper.so
  ./fortress.sh start
  

NB. Windows Users, Linux Users, MacOSX Users.

Now you can see if it is working

• Open a webbrowser (only IE and Firefox are currently supported) and navigate to http://localhost:50000/
• You should see the login window
• Enter the username "root" and password "password"
• Congratulations, your Hippo CMS is running!

Changing the Hippo CMS hostname

Great! But what about this localhost thing? I want other developers to connect to my CMS and repository, but where do I start?

Well it's not that hard. You will have to change 2 files within the Hippo CMS folder:

• sites.xconf - hold the host configuration for the current CMS (located in the cocoon/WEB-INF/ folder)
• localdevDomains.xml - The localdevDomains.xml is used by the Hippo CMS workflow (located in the cocoon/WEB-INF/configuration/projects/localdev/ folder)

sites.xconf

Your sites.xconf should look something like this:

<sites version="1.0">
  <site name="hippo-cms">
    <domain>localhost</domain>
    <directory>../sites/hippo-cms/</directory>
    <repository>default</repository>
    <model>context://types/types.xml</model>
    <workflow>default</workflow>
    <httpstate>session-attr:httpstate</httpstate>
  </site>
</sites>

As you might have noticed the domain is set to 'localhost'. Change this to the hostname you had in mind and your done with the sites.xconf.

localdevDomains.xml

Your localdevDomains.xml should look something like this:

<beans>
  <bean id="projectDomains" class="java.util.HashSet">
    <constructor-arg index="0" type="java.util.Collection">
      <list>
        <value>localhost</value>
      </list>
    </constructor-arg>
  </bean>
</beans>

Again the value is set to 'localhost'. Change it to the same url used in the sites.xconf.

Well that's it. There is only one more thing to do and that is restarting the CMS. Afterwards you will be able to reach Hippo CMS on http://yoururl:50000/.

In the future you might want to build the CMS from source. The 'localhost' value will then be a single build property. (for more information see: http://www.hippocms.org/display/CMS/Hippo+CMS+Developers)