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
• Trial version
• Full version
4. 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):

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

The installation order for these packages is the following:

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.

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:

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:

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/

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
3. When it is done, upload *.sql files to the poll, counter, and guestbook DB from the sql folder.

 

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).

4. Set the JAVA_HOME system variable to the dir where JDK is installed, e.g:
   export JAVA_HOME=/usr/java/jdk1.3.1
5. Now you can configure SiteStudio. Enter:
   ./ss.sh setup
   and answer the questions prompted.
6. When configuring procedure is over, you can start/stop SiteStudio by the command
   
   ./ss.sh start
   ./ss.sh stop
7. You need to start it and go to the admin panel to add your first user:
8. 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.
9. 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.

10. 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/
11. The on-line demo similar to ours is available at
    http://<your_IP_or_domain_name>:8080/demo/
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.

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:
./ss.sh setup
2. Choose the CP you need to integrate SiteStudio with.

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.

3. For CPanel and PLESK you should download and manually install the File publisher utility by running the following commands:
wget psoft.net/downloads/publisher-1.1.tar.gz
tar xvfz ./publisher-1.1.tar.gz
cd publisher-1.1
./configure
make
make install
4. 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.