|
This document is a step-by-step instruction on installing
the multiuser
version of SiteStudio with plugins.
- Xvfb installation
- JDK1.3 installation
- SiteStudio installation and configuration
- Trial version
- Full version
1. Xvfb installation
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. If you have Linux RedHat 7.2 OS installed, it's
the XFree86-Xvfb-4.1.0-3.i386.rpm file.
You can copy it from your Linux CD or download from any rpmfind.net
site, e.g. at
ftp://fr.rpmfind.net/linux/redhat/7.2/en/os/i386/RedHat/RPMS/XFree86-Xvfb-4.1.0-3.i386.rpm
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 at
ftp://fr.rpmfind.net/linux/redhat/7.2/en/os/i386/RedHat/RPMS/XFree86-4.1.0-3.i386.rpm
ftp://fr.rpmfind.net/linux/redhat/7.2/en/os/i386/RedHat/RPMS/Mesa-3.4.2-7.i386.rpm
ftp://fr.rpmfind.net/linux/redhat/7.2/en/os/i386/RedHat/RPMS/Xaw3d-1.5-10.i386.rpm
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 here all needed packages.
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).
2. JDK1.3 installation
SS requires Java version 1.3 and above. SS will not work
under any other vendor's Java or Sun Java version 1.2.
The JDK1.3 and setup instructions are located at the following
address:
http://java.sun.com/j2se/1.3/
You do not need to install the full version of Java; you
may install Java Runtime Environment only.
Later, after you have installed and configured SiteStudio,
you will also need to move (copy) its fonts to the directory
/usr/java/jdk1.3/jre/lib/fonts/ (see step 3).
3. SiteStudio installation and
configuration
Trial version:
Unpack the SiteStudioDemo installation file to the target
directory (e.g. home folder):
tar xzf SiteStudioDemo.tgz -C /home/
Next, chahge SiteStudio folder owner to the user under which
you want to run SiteStudio. Usually it is the root:
chown -R root:root /home/SiteStudioDemo/
Now you can start/stop SiteStudio by the commands below:
./ss.sh start
./ss.sh stop
When you start it go at: http://<your_IP_or_domain_name>:8080/servlet/psoft.masonry.Builder
Use test/test as login and password.
You can use this program, for 30 days after that you have
to contact sales@psoft.net
to buy the full version or remove our software from your box.
Full version:
Unpack the SiteStudio installation file to the target directory
(e.g. home folder):
tar xzf SiteStudio1.XX.tgz -C /home/
Hereinafter XX is the version of SiteStudio you have.
Next, chahge 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 SS 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
When it is done, upload *.sql files to the poll, counter,
and guestbook DB from the sql folder.
Set the JAVA_HOME system variable to the dir where JDK is
installed e. g.
export JAVA_HOME=/usr/java/jdk1.3.1
Now you can configure SS. Enter
./ss.sh setup
and answer the questions prompted.
When configuring procedure is over, you can start/stop SS
by the command
./ss.sh start
./ss.sh stop
You need to start it and go to the admin panel to add your
first user:
Go to http://<your_IP_or_domain_name>:8080/servlet/psoft.masonry.Admin
Default login and password are admin/admin. We recommend to change it
after the first login.
When you log into Admin panel for the first time, you see the error
message that says that user's table doesn't exist. Just ignore this massage and click on the CREATE TABLE icon in the top toolbar.
Next, click on the ADD USER icon to add your user:
You need to define the following data:
Id - some unique digital number
Login - login to SS
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)
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/servlet/psoft.masonry.Builder
Also, you need to move (copy) SiteStudio fonts from [path_to_SiteStudio]/fonts/*
to the directory
/usr/java/jdk1.3/jre/lib/fonts/ (see step 2).
To do this, run:
cp [path_to_SiteStudio]/fonts/* /usr/java/jdk1.3/jre/lib/fonts/
After successful installation please send an email to info@psoft.net
In case of any problems/questions please send an email to
support@psoft.net
Please include the file masonry.properties and
corresponding
parts of error logs, if any, to your email message.
|
