SiteStudio Online Documentation

SiteStudio Installation on Linux

This document gives a step-by-step instruction on installing the multiuser version of SiteStudio with plugins. This installation manual refers only to stand-alone SiteStudio or integrated with Plesk, Ensim or other non-psoft control panels. It doesn't refer to SiteStudio integrated with H-Sphere.

  1. Java installation
  2. Xvfb installation
  3. SiteStudio installation and configuration
  • Integration with CPanel, PLESK and Ensim
  • 1. Java installation

    SiteStudio requires Java version 1.3 or 1.4. We have not tested SiteStudio with Java 1.5.0 or IBM Java, but generally it should work with them. SiteStudio will not work under any other vendor's Java or Sun Java version 1.2.

    The JDK 1.3 and setup instructions are located at: http://java.sun.com/j2se/1.3/
    JDK 1.4 is at http://java.sun.com/j2se/1.4/

    2. Xvfb installation

    Note: Xvfb installation is needed only if you're using jdk 1.3. If you have jdk 1.4.x you should skip this section.

    Before you begin installing the SiteStudio, please make sure that you have X11 libraries and an X server (used by Java for image generation). Xvfb is a good choice because it does not use video hardware.

    Usually, you can install XFree-Xvfb using the standard Linux RPM package. For example, RedHat Linux 7.2 takes the XFree86-Xvfb-4.1.0-3.i386.rpm file.

    You can copy the respective XFree-Xvfb package from your Linux CD or download from any rpmfind.net site. This package requires at least the following three RPMs installed in the system (for the standard Linux RedHat 7.2 installation):

    XFree86-4.1.0-3.i386.rpm
    Mesa-3.4.2-7.i386.rpm
    Xaw3d-1.5-10.i386.rpm

    You can copy them from your Linux CD, download from any rpmfind.net site.

    The installation order for these packages is the following:

    Mesa-3.4.2-7.i386.rpm
    XFree86-4.1.0-3.i386.rpm
    Xaw3d-1.5-10.i386.rpm

    If the Mesa-3.4.2-7.i386.rpm RPM returns an error during the installation procedure stating that it requires a XFree86 installed, use the "--nodeps" parameter.

    rpm -ivh --nodeps ./Mesa-3.4.2-7.i386.rpm
    rpm -ivh ./XFree86-4.1.0-3.i386.rpm
    rpm -ivh ./Xaw3d-1.5-10.i386.rpm
    rpm -ivh ./XFree86-Xvfb-4.1.0-3.i386.rpm

    The XFree-Xvfb package also requires the 100dpi and 75dpi XFree fonts installed. If you don't have those fonts, you can install the standard XFree RPMs. But we recommend a simpler way: download and install the required fonts from the www.psoft.net web site. To do it, please perform the following actions:

    wget http://www.psoft.net/downloads/X11.tgz
    tar xfz ./X11.tgz -C /usr/X11R6/lib/

    NOTE: XFree-Xvfb package may require several other RPMs installed, we don't specify all necessary packages here. In this case you need to install these RPMs too.

    When you have all these packages installed, you can start Xvfb:

    /usr/X11R6/bin/Xvfb ':0' -screen 0 100x100x8 &

    Also, don't forget to add this string into the server startup (the /etc/rc.d/rc.local file).

    3. SiteStudio Installation and Configuration

    Trial version:

    1. Unpack the SiteStudioDemo installation file to the target directory (e.g. home folder):
      tar xzf SiteStudioDemo.tgz -C /home/
    2. Next, change SiteStudio folder owner to the user under which you want to run SiteStudio. Usually it is the root:
      chown -R root:root /home/SiteStudioDemo/
    3. Now you can start/stop SiteStudio by the commands below:
      ./ss.sh start
      ./ss.sh stop
    4. When SiteStudio is started, go to:
      http://<your_IP_or_domain_name>:8080/servlet/psoft.masonry.Builder
    5. Use test/test as login and password.

    You can use this program for 30 days. After that, contact us to buy the full version or remove our software from your box.

    Full version:

    1. Unpack the SiteStudio installation file to the target directory (e.g. home folder):
      tar xzf SiteStudio1.XX.tgz -C /home/
      Note: Hereinafter XX stands for the version of SiteStudio you have.
    2. Next, change SiteStudio folder owner to the user under which you want to run SiteStudio. Usually it is the root:
      chown -R root:root /home/SiteStudio1.XX/
    3. If you have MySQL or Postgres installed, you need to create databases for SiteStudio and plugins:

      For MySQL:

      mysqladmin create hosting
      mysqladmin create poll
      mysqladmin create counter
      mysqladmin create guestbook

      For Postgres:

      createdb hosting
      createdb poll
      createdb counter
      createdb guestbook
    4. When it is done, upload *.sql files to the poll, counter, and guestbook DB from the sql folder.

    5.  

      For MySQL users only:

      Log into MySQL through any administrative account and execute the following command for each SiteStudio database:

      GRANT ALL PRIVILEGES ON <DB_NAME>.* TO <DB_USER>@<YOUR_IP> IDENTIFIED BY <DB_PASSWORD>

      Where
      <DB_NAME> is a database name
      <DB_USER> is a MySQL account for access to <DB_NAME>
      <YOUR_IP> for security reasons enter the IP of the server where SiteStudio is installed
      <DB_PASSWORD> is a password to account <DB_USER>

      You must use the same <DB_USER> and <DB_PASSWORD> for all SiteStudio databases (hosting, poll, counter, guestbook).

    6. Set the JAVA_HOME system variable to the dir where JDK is installed, e.g:
      export JAVA_HOME=/usr/java/jdk1.3.1
    7. Now you can configure SiteStudio. Enter:
      ./ss.sh setup
      and answer the questions prompted.
    8. When configuring procedure is over, you can start/stop SiteStudio by the command
      ./ss.sh start
      ./ss.sh stop
    9. You need to start it and go to the admin panel to add your first user:
    10. Go to
      http://<your_IP_or_domain_name>:8080/servlet/psoft.masonry.Admin
      Note: Default login and password are admin/admin. We recommend to change it after the first login.
    11. Add new user by entering the following data:
      Id—some unique digital number
      Login—login to SiteStudio
      Real_login—FTP login to the site
      Pass—ftp password to this site
      Email—email address
      Dir—path to the site has to end with a slash (/)
      Host—URL of the site, also has to end with a slash (/) e.g. http://mycraftmarket.net/
      Server—127.0.0.1 or localhost. Usually, it can be the domain name of user site
      Port—the port to login the FTP server (usually it is port 21)

      Read SiteStudio Admin Panel Guide for details.

    12. When the user is added, you can login to the SiteStudio by the URL below and test it:
      http://<your_IP_or_domain_name>:8080/
    13. The on-line demo similar to ours is available at
      http://<your_IP_or_domain_name>:8080/demo/
    14. Note: Please, point you potential clients to your SiteStudio demo, not to ours, because our demo might have a different SiteStudio version than yours.

    4. Integration with CPanel, PLESK or Ensim.

    SiteStudio can be integrated with Ensim, CPanel and PLESK Control Panels (CP), but it doesn't mean that you will have the SiteStudio icon in your CP and user will be able to log into SiteStudio through your control panel.

    To log into SiteStudio, your users will have to specify the login information (depending on your CP it would be either login/domain/password or login/password), and SiteStudio will become accessible for ALL users of corresponding CP (no Admin panel for adding users into SiteStudio will be available).

    If you want to have the feature to enable/disable SiteStudio for your users, you need to have the standard installation (without any integration). In this case you will have SiteStudio Administration Panel for manual user management.

    Since version 1.6RC3, integration with CPanel, PLESK and Ensim control panels is included into the SiteStudio setup script.

    SiteStudio must be installed on the same server of the hosting system you are going to integrate it with.

    You need to follow the general installation instruction:

    1. Unpack the install package and start setup procedure with:
    2. ./ss.sh setup
    3. Choose the CP you need to integrate SiteStudio with.
    4. NOTE 1: if you choose integration, you need to skip the step with creation DB named 'hosting'.
      NOTE 2: Administration Panel for user management will not be enabled in case of integration.

    5. For CPanel and PLESK you should download and manually install the File publisher utility by running the following commands:
    6. wget psoft.net/downloads/publisher-1.1.tar.gz
      tar xvfz ./publisher-1.1.tar.gz
      cd publisher-1.1
      ./configure
      make
      make install
    7. Once configuration is completed, you can log into SiteStudio with the following parameters:
        - For PLESK: FTP username and password to a site.
        - For CPanel: CPanel username and password
        - For Ensim: FTP ID, domain and password.

    In case of any problems/questions, please contact us. Please include the file masonry.properties and corresponding parts of error logs, if any, to your request.


    See also

    Product Page
    Online Demo
    FAQ
    SS Doc Home



    . Positive Software Corporation.
    All rights reserved.