Using Blojsom with Sun Java System Web Server 7.0

Blojsom and Web Server 7.0 <script defer id="snap_preview_anywhere" type="text/javascript" src=""></script> What is Blojsom ?

A Java-based, lightweight, full-featured, multi-blog, multi-user weblog application software. This uses the file system as its content database so that you do not have to setup a database such as MySQL or Oracle.

Where to get the software from ?

You can download Blojsom QuickStart application from here
It is a WAR file named “ blojsom.war “.

How to use it with Web Server 7.0 ?

  1. Install Web Server 7.0
    • Download the latest Technology Preview release from here. Please refer this blog for detailed installation instructions.

  2. Deploy Blojsom application onto Web Server 7.0 [ Using CLI ] :

    • Start the Web Server 7.0 Administration Server.

      On UNIX/Linux platforms:
      % cd ws7-install-root
      % admin-server/bin/startserv

      On Windows:
      c:\\> click on Start-> Programs-> Sun Microsystems -> Sun Web Server 7.0 -> Start Admin Server

       where ws7-install-root is the location where you have installed Sun Java System Web Server 7.0 on your machine. The default installation location  is either /sun/webserver7 or /opt/sun/SUNwbsvr7

    • Run the following CLI commands to deploy "blojsom.war".

      % <ws7-install-root>/bin/wadm add-webapp –user=<admin-user-name> –password-file=<admin-password-file-path> --host=<hostname> --port=<admin-ssl-port> --config=<config-name> --vs=<vs-name> --uri=/blojsom <path to blojsom.war>

      % <ws7-install-root>/bin/wadm deploy-config --user=admin –password-file=/admin.passwd --host=<hostname> --port=<admin-ssl-port> <config-name>


      % /ws7/bin/wadm add-webapp –user=admin –password-file=/admin.passwd –host=localhost --port=8989 --config=test --vs=test --uri=/blojsom /app/blojsom.war

      % /ws7/bin/wadm deploy-config --user=admin –password-file=/admin.passwd --host=localhost --port=8989 test

  3. Go to “ <ws7-install-root>/https-<config-name>/web-app/<vs-name>/blojsom “ directory.

    • Configure the WEB-INF/ file which contains global properties for blojsom.
      Note: You must provide one user id for the blojsom-users and blojsom-default-user properties.

      Configure the following configuration parameters in WEB-INF/ For information on other parameters, refer to the User Guide.

      Configuration parameter Usage
      blojsom-users Comma-separated list of users with blogs for this blojsom installation. This list will be used to initialize the individual blogs.
      NOTE: You can also list each user on a separate line using the blojsom-users property.
      blojsom-default-user This option provides legacy blojsom (i.e. pre 2.0) installations a way of preserving their current installations. Set the name of the default user from one of the blog ids in the blojsom-users property. The default user will not have to enter their blog id in the URL for the blojsom installation to request their blog.
      For example, http://localhost:8080/blojsom/blog/ would point to the blog of the default user where http://localhost:8080/blojsom/blog/david/ would point to the blog for the user david.
      blojsom-blog-home Directory that will be used for storing blogs (categories and entries) for each user. If this property begins with a {, blojsom assumes that a } will follow and uses the contents to retrieve a system property. After that it will append everything after the } and use that as the value for this parameter. For example:
      would expand the {user.home} property (let's say it resolves to /ws7) and use /ws7/blogs/ as the value for this property.

      \* If you have added users to the blojsom-users property, you will need to create directories off the directory indicated in blojsom-configuration-base-directory for each of the users. It is recommended that you initially create another user and copy all of the directories and files from the default user directory into this new user's directory. You would then set the blojsom-default-user property to the appropriate user id you just created and remove the default user id from the blojsom-users configuration property. This allows you to keep the default user directory as a set of template directories and files when adding new users to your blojsom installation.

    • Authorized users are added to an blog's WEB-INF/(blog-id)/ file. The usernames and passwords in this file control the users that can access the individual blog either via the administration console or XML-RPC. The format of this file is as follows.

            username=password,\\{optional e-mail address}

      Each separate line represents an individual username and password combination. You may associate an e-mail address with the username by adding a "," and the username's e-mail address. The e-mail address is used to send the username an e-mail message if they forget their password. If the e-mail address is not present, the username is assumed to be associated with the blog owner and therefore an e-mail message in this case would be sent to the blog owner's e-mail address.

    • Edit the permissions file located in WEB-INF/(blog-id)/ This file specifies the users permissions on the individual blog. The format of this file is as follows.


      Each separate line represents an individual username and permission combination. The permissions page describes more on individual permissions for blojsom components.

    • Configure the appropriate WEB-INF/(blog-id)/ file for your blog. This will need to be done for each of the users that you have indicated in the blojsom-users property. If you have setup a user to access the administration console, then you should only need to configure the blog-home property, after which you can configure the other properties through the administration console.

      The following configuration parameters can be found in WEB-INF/(blog-id)/ List of all the properties and additional information on installation and configuration can be found here.

      Configuration parameter Default value Usage
      blog-home     Points to the directory where your blog entries will be located
      For example:

      NOTE : This parameter should point to the absolute directory where your blog entries will be kept. It should exist outside the web application root directory.
      blog-country US Indicates the country code for this blog.
      blog-name   The name of your blog.
      blog-description     A concise description of your blog.
      blog-base-url   Base URL for your blog
      For example:
      blog-url   URL for your blog. This URL should include the appropriate user id otherwise links will be generated for the default user's blog.
      For example:

      NOTE : The default servlet-mapping configured in the /WEB-INF/web.xml for blojsom is set to pass all requests for /blog/\* to blojsom. If you change the mapping in the /WEB-INF/web.xml file, then you will need to make sure that change is reflected in the URL for your blog.

  4. After the above configuration, start the Web Server 7.0

  5. Check to see blojsom is running by accessing the following URL:  http://localhost:1894/blojsom/blog/default/
    Assumption: "localhost" as Web Server host  and "1894" as port

    If you have added a user by name “david” as mentioned in step 3, try accessing

  6. Login to blojsom's Admin Console
          " http://localhost:8080/blojsom/blog/default/?flavor=admin"

    with the username "default" and password "123default456" to change blog settings, add categories, entries, users, etc.

Now, you are ready to blog !!


good blog thanks

Posted by astroloji on August 14, 2007 at 10:31 PM IST #

Hi everyone,

first of all allow me to say I am a complete newbie in Blojsom.

I am working with a J2EE-Struts Application and Oracle Database. The aim is to use Blojsom so users from the current system (stored in the Oracle Database) can create their own blogs.

In some way I need to integrate my application login with users from Blojsom. For example, when a new user gets registered in my system I will need to add this user to Blojsom. Another difficulty would be to control permissions, as no all users from my system will have access to all blogs.

Anyone has tried anything similar?Any clue on how to get started?


Posted by Amadou on October 03, 2007 at 08:42 AM IST #

Post a Comment:
Comments are closed for this entry.



« June 2016