Magnolia 5.3 reached end of life on June 30, 2017. This branch is no longer supported, see End-of-life policy.

Page tree
Skip to end of metadata
Go to start of metadata

Multiple public instances are useful when:

  • Publishing parts of a site to a different public instances, for example, /sports to one subscriber and /news to another.
  • Managing multiple sites in one author instances and publishing each site to a separate public instance.
  • Restoring corrupted data to a new public instance.
  • Adding a public instance to cope with high load.
  • Adding public instances to ensure high-availability.

Copying a public instance

The fastest and simplest way is to create a new public instance is to copy an existing one.

(warning) Before you do this, back up the webapps folder and the database. There is always the risk of corrupting the existing instance.

  1. Copy a public instance folder such as magnoliaPublic. If you use an external database, such as MySQL, copy the database folder too.
  2. Rename the copied folder, for example magnoliaPublic2.
  3. Delete unnecessary subfolders from the copy. The copy is a clone of the source instance. Some folders are essential to the new instance but some may be deleted.
    • OK to delete:
      • cache contains cached entries of the original instance.
      • logs contains log entries of the original instance. Empty log files will be recreated during server startup.
      • repositories can be reindexed by deleting the index subfolders in each /repositories/magnolia/workspaces/* folder but the rest of the folders should remain intact.
      • tmp is a temporary folder which Tomcat or Jackrabbit uses for its processes during export/import.
    • Don't delete:
      • docroot contains the Tomcat docBase static resources.
      • META-INF
      • templates contains static resources.
      • WEB-INF

Node name

Value

 server

 

 activation

 

 subscribers

 

  magnoliaPublic8080

 

 subscriptions

 

 URL

http://localhost:8080/magnoliaPublic

 active

true

 class

info.magnolia.module.activation.DefaultSubscriber

  magnoliaPublicTwo8080

 

 subscriptions

 

 URL

http://localhost:8080/magnoliaPublic2

 active

true

 class

info.magnolia.module.activation.DefaultSubscriber

Other ways to create a public instance

Other ways to create new public instances or situations where an additional public instance is useful include:

  • Backup module. Use the Restore function. This creates a new public instance for the restored data automatically.
  • Backup and restore JSP scripts. The Packager module is also useful here.
  • Synchronization module. Create new public instances without shutting down existing ones.
  • Programmatically by writing a cloneInstanceCommand.
  • How to replicate a public instance lists many options to repair a broken public instance using a second instance.
  • Jackrabbit DataStore for blobs in special cases.
  • No labels