Difference between revisions of "Metadot"

From SME Server
Jump to navigationJump to search
 
(48 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== Metadot 6.4.5.4 for SME Server 7 ==
+
== Maintainer ==
  
'''This How to is currently under construction'''
+
[mailto:russell@fixitcomputers.com.au?subject=Metadot Russell Taihn]
  
will continue soon
+
== Description ==
 +
'''Metadot Portal Server'''
 +
 
 +
[http://www.metadot.com/ Metadot] is a leading open source portal software (GPL) used to create websites, intranets, extranets, project and team spaces
 +
 
 +
Metadot Portal Server is a leading open source portal system. Its ease of use allows non technical people to create very powerful websites and portals just with the clicks of a mouse. Its architecture makes it extremely easy to customize and deploy. It is available for free under the GNU General Public License (GPL). It provides collaboration, content management, as well as My News Page (like My Yahoo) and online database applications. Typically it is used to create web portals, intranets, extranets, organization and project websites.
 +
 
 +
When it was first released in April 2000, it revolutionized the way complex websites are built by giving easy-to-use tools to non-technical users allowing them to create powerful database-backed websites without having to involve a webmaster or the IT department!
 +
 
 +
It runs primarily on Linux, Apache, MySQL and Perl and supports Sun Solaris, Windows OSes and Oracle database.
  
'''NOTE''', for this howto I am using '''youribay''' as an example, replace youribay with your own choice
 
  
 
russell@fixitcomputers.com.au
 
russell@fixitcomputers.com.au
  
 +
[http://forums.contribs.org/index.php?topic=36617.0 Forum Discussion]
  
  
Line 19: Line 28:
 
  tar xvzf Metadot6.4.5.4.tar.gz
 
  tar xvzf Metadot6.4.5.4.tar.gz
  
  mv /tmp/metadot/metadot/* /home/e-smith/files/ibays/'''youribay'''/html
+
  mv /tmp/metadot/metadot /opt
 +
 +
chown -R www.www /opt/metadot
  
  mv /tmp/metadot/metadot/.cvsignore /home/e-smith/files/ibays/'''youribay'''/html
+
  chmod 750 /opt/metadot
  
  chown -R www.www /home/e-smith/files/ibays/'''youribay'''/html
+
  chmod 640 /opt/metadot/etc/metadot.conf
  
  chmod 750 /home/e-smith/files/ibays/youribay/html/
+
  mv /opt/metadot/html/* /opt/metadot/
  
  chmod 640 /home/e-smith/files/ibays/youribay/html/etc/metadot.conf
+
  cd /opt/metadot/metadot
 
 
cd /home/e-smith/files/ibays/youribay/html/metadot
 
  
 
  chmod 755 *.pl
 
  chmod 755 *.pl
  
 
== Setup Dag Repositories ==
 
== Setup Dag Repositories ==
 +
You need to activate the [[Dag]] reposity before installing this contrib.<br />
  
/sbin/e-smith/db yum_repositories set dag repository \
+
see [[dag|dag repository]] <br />
Name 'Dag - EL4' \
 
BaseURL 'http://apt.sw.be/redhat/el4/en/$basearch/dag' \
 
EnableGroups no \
 
GPGCheck yes \
 
GPGKey http://dag.wieers.com/packages/RPM-GPG-KEY.dag.txt \
 
Visible yes \
 
Exclude freetype,htop,iptraf,rsync,syslinux \
 
status disabled
 
 
 
 
 
 
 
expand-template /etc/yum.conf
 
  
 
== Installing Required Modules ==
 
== Installing Required Modules ==
  
  
  yum -y --enablerepo=updates --enablerepo=addons install mod_perl gd ImageMagick ImageMagick-perl netpbm
+
  yum --enablerepo=updates --enablerepo=addons install mod_perl gd ImageMagick ImageMagick-perl netpbm
  
 
  config setprop modPerl status enabled
 
  config setprop modPerl status enabled
Line 60: Line 58:
 
== Installing Required Perl Modules ==
 
== Installing Required Perl Modules ==
  
  yum --enablerepo=base --enablerepo=updates --enablerepo=addons --enablerepo=dag install perl-GD perl-GD-Graph perl-GD-Graph3d perl-GD-Text-Util perl-Date-Pcalc perl-Email-Valid perl-Apache-DBI perl-AppConfig perl-Archive-Tar perl-Archive-Zip perl-Bit-Vector perl-CGI-SpeedyCGI perl-Compress-Zlib perl-Data-Compare perl-Date-Calc perl-ExtUtils-PkgConfig perl-File-Find-Rule perl-File-HomeDir perl-HTML-Format perl-HTML-Template perl-HTML-Tree perl-Image-Base perl-Image-Size perl-Lingua-EN-NameParse perl-LWP-UserAgent-Determined perl-Mail-POP3Client perl-MailTools perl-HTTP-BrowserDetect perl-HTTP-Server-Simple perl-HTTP-Request-Form perl-HTTP-DAV perl-MIME-tools perl-Number-Compare perl-Number-Format perl-OLE-Storage_Lite perl-Parse-RecDescent perl-Pod-POM perl-Spreadsheet-WriteExcel perl-Template-Toolkit perl-Test-Builder-Tester perl-Test-Manifest perl-Test-Simple perl-Test-SimpleUnit perl-Text-Autoformat perl-Text-CSV_XS perl-Unicode-String perl-XML-Dumper perl-XML-RSS perl-XML-Simple -y
+
  yum install\
 +
--enablerepo=base \
 +
--enablerepo=updates \
 +
--enablerepo=addons \
 +
--enablerepo=dag install \
 +
perl-GD perl-GD-Graph perl-GD-Graph3d perl-GD-Text-Util \
 +
perl-Date-Pcalc perl-Email-Valid perl-Apache-DBI \
 +
perl-AppConfig perl-Archive-Tar perl-Archive-Zip \
 +
perl-Bit-Vector perl-CGI-SpeedyCGI perl-Compress-Zlib \
 +
perl-Data-Compare perl-Date-Calc perl-ExtUtils-PkgConfig \
 +
perl-File-Find-Rule perl-File-HomeDir perl-HTML-Format \
 +
perl-HTML-Template perl-HTML-Tree perl-Image-Base \
 +
perl-Image-Size perl-Lingua-EN-NameParse \
 +
perl-LWP-UserAgent-Determined perl-Mail-POP3Client \
 +
perl-MailTools perl-HTTP-BrowserDetect perl-HTTP-Server-Simple \
 +
perl-HTTP-Request-Form perl-HTTP-DAV \
 +
perl-MIME-tools perl-Number-Compare perl-Number-Format \
 +
perl-OLE-Storage_Lite perl-Parse-RecDescent perl-Pod-POM \
 +
perl-Spreadsheet-WriteExcel perl-Template-Toolkit \
 +
perl-Test-Builder-Tester perl-Test-Manifest perl-Test-SimpleUnit \
 +
perl-Text-Autoformat perl-Text-CSV_XS perl-Unicode-String \
 +
perl-XML-Dumper perl-XML-RSS perl-XML-Simple
  
 
== Create Database ==
 
== Create Database ==
  
  cd /home/e-smith/files/ibays/youribay/html/default_data/
+
  cd /opt/metadot/default_data
  
 
  mysql -uroot mysql < createdbanduser4x.sql
 
  mysql -uroot mysql < createdbanduser4x.sql
Line 73: Line 92:
 
   
 
   
 
  mysql -umetadot -p'''yourpassword''' metadotdb < sampledata.sql
 
  mysql -umetadot -p'''yourpassword''' metadotdb < sampledata.sql
 
  
 
== Create a Template Fragement ==
 
== Create a Template Fragement ==
Line 86: Line 104:
 
  #Metadot
 
  #Metadot
 
   
 
   
ServerName www.fixitcomputers.com.au
+
    ServerName yourdomain.com
DocumentRoot "/home/e-smith/files/ibays/youribay/html/metadot/"
+
   
Alias /images/ /home/e-smith/files/ibays/youribay/html/images/
+
    DocumentRoot         /opt/metadot/metadot
Alias /js/ /home/e-smith/files/ibays/youribay/html/js/
+
    Alias /metadot /opt/metadot/metadot
Alias /index.pl /home/e-smith/files/ibays/youribay/html/metadot/index.pl
+
    Alias /images/ /opt/metadot/images/
Alias /public/  /home/e-smith/files/ibays/youribay/html/sitedata/public/
+
    Alias /js/ /opt/metadot/js/
Alias /skins/    /home/e-smith/files/ibays/youribay/html/sitedata/skins/
+
    Alias /index.pl /opt/metadot/metadot/index.pl
Alias /htmlarea3/ /home/e-smith/files/ibays/youribay/html/js/htmlarea3/
+
    Alias /public/  /opt/metadot/sitedata/public/
Alias /private/  /home/e-smith/files/ibays/youribay/html/sitedata/private/
+
    Alias /skins/    /opt/metadot/sitedata/skins/
Alias /userchannel.pl /home/e-smith/files/ibays/youribay/html/metadot/userchannel.pl
+
    Alias /htmlarea3/ /opt/metadot/js/htmlarea3/
 +
    Alias /private/  /opt/metadot/sitedata/private/
 +
    Alias /userchannel.pl /opt/metadot/metadot/userchannel.pl
 
   
 
   
  <Directory "/home/e-smith/files/ibays/youribay/html/metadot">
+
  <Directory /opt/metadot>
Options +Indexes +Includes +FollowSymLinks -MultiViews
+
    Options +Indexes +Includes +FollowSymLinks -MultiViews +ExecCGI
  AllowOverride All
+
    AllowOverride All
SetHandler cgi-script
+
    allow from all
PerlHandler speedy::Registry
+
    AddHandler  cgi-script .pl
PerlSendHeader On
+
    PerlHandler speedy::Registry
Options +ExecCGI
+
    PerlSendHeader     On
AddType application/.html .pl .pm .cgi
+
    DirectoryIndex     index.pl
DirectoryIndex index.pl
 
 
  </Directory>
 
  </Directory>
 
+
 
Save by pressing Ctrl x, press y to save changes and press enter
 
Save by pressing Ctrl x, press y to save changes and press enter
  
 
  expand-template /etc/httpd/conf/httpd.conf  
 
  expand-template /etc/httpd/conf/httpd.conf  
  
  /etc/rc.d/init.d/httpd-admin restart
+
  /etc/rc.d/init.d/httpd-e-smith restart
  
/etc/rc.d/init.d/httpd-e-smith  restart
+
== Modify Metadot configuration file ==
  
 +
Metadot uses a configuration file that associates database information with the web server that you are running. It is located: '''''/opt/metadot/etc'''''
  
== Adding index.pl to DirectoryIndex ==
+
cd /opt/metadot/etc
 +
 
 +
Edit Metadot.conf
 +
you will need to modify these lines in the metadot.conf file to match the location where you install metadot on your server.
  
modify 50DirectoryIndex00 to include index.pl
+
''' metadot.conf'''
 +
Line 16 change the password created in the mysql setup. pass = '''yourpassword,'''
 +
Line 34 change /opt/metadot/sitedata/public
 +
Line 108 change to /opt/metadot/sitedata/skins
  
cd /etc/e-smith/templates/etc/httpd/conf/httpd.conf/
+
== Performance configuration ==
  
pico 50DirectoryIndex00
+
{{Warning box|If you don't do this configuration, your metadot site will be extremely poor.}}
Add '''index.pl'''
 
# DirectoryIndex: Name of the file or files to use as a pre-written HTML
 
# directory index.  Separate multiple entries with spaces.
 
 
DirectoryIndex index.htm index.html index.shtml index.cgi '''index.pl'''
 
  
 +
cd /opt/metadot/metadot
  
== Modify Metadot configuration file ==
+
edit index.pl and change the top line from #!/usr/bin/perl to #!/usr/bin/speedy. This needs to be done to all .pl files in the metadot/
  
Metadot uses a configuration file that associates database information with the web server that you are running. It is located: /home/e-smith/files/ibays/youribay/html/etc
+
index.pl
cd /home/e-smith/files/ibays/'''youribay'''/html/etc
 
  
Edit Metadot.conf
+
md_clean.pl
you will need to modify these lines in the metadot.conf file to match the location where you install metadot on your server.
 
  
''' metadot.conf'''
+
metadotd.pl
Line 16 change the password created in the mysql setup. pass = '''yourpassword,'''
 
Line 34 change /home/e-smith/files/ibays/'''youribay'''/html/sitedata/public
 
Line 108 change to /home/e-smith/files/ibays/'''youribay'''/html/sitedata/skins
 
  
== WARNING Performance configuration ==
+
soap.pl
  
'''If you don't do this configuration, your metadot site will be extremely poor.'''
+
startup.pl
  
cd /home/e-smith/files/ibays/Primary/html/metadot
+
userchannel.pl
  
edit index.pl and change the top line from #!/usr/bin/perl to #!/usr/bin/speedy. This needs to be done to all .pl files in the metadot/
+
smoke
  
 
'''Example'''
 
'''Example'''
Line 158: Line 175:
 
== Testing the installation ==
 
== Testing the installation ==
  
  cd /home/e-smith/files/ibays/Primary/html/metadot
+
  cd /opt/metadot/metadot
 
Next, run the index.pl file on the command line :
 
Next, run the index.pl file on the command line :
 
  perl index.pl
 
  perl index.pl
 
if no errors go to next step
 
if no errors go to next step
 +
 +
 +
Now bring up the Metadot start page by accessing it from your web browser:
 +
 +
http://type.your.domain.com or http://type.your.domain.com/metadot/
  
 
== Metadot Aministration Information ==
 
== Metadot Aministration Information ==
  
The default out-of-the box user name & password for Metadot is admin and the password is "123456". In your browser, go to the Metadot
+
The default out-of-the box user name & password for Metadot is admin and the password is "123456".  
home page. In the upper right corner click on "Login".
+
In your browser, go to the Metadot home page. In the upper right corner click on "Login".
This will take you to the login screen. Log in as 'admin' using the default '123456' password. This will take you back to the main screen. [Note: If you are using the Konqueror web browser, then it has been reported that you may see an error screen the first time you log in.
+
 
If you see this, then just go back and then click on 'Home'].
+
This will take you to the login screen. Log in as 'admin' using the default '123456' password. This will take you back to the main screen.  
 +
 
 +
'''[Note: If you are using the Konqueror web browser, then it has been reported that you may see an error screen the first time you log in. If you see this, then just go back and then click on 'Home']'''
 +
 
 
Go to the bottom of the page and click "Enable Editing". This will enter edit mode, which will cause the page's edit controls to become visible.
 
Go to the bottom of the page and click "Enable Editing". This will enter edit mode, which will cause the page's edit controls to become visible.
 
Change the password for the Admin user (the site's admin account). Do this in the following manner:
 
Change the password for the Admin user (the site's admin account). Do this in the following manner:
 +
 
• Log in as admin, as described above.
 
• Log in as admin, as described above.
 +
 
• Go to "Manage..."->"My Profile". This will take you to the edit profile page for the admin user.
 
• Go to "Manage..."->"My Profile". This will take you to the edit profile page for the admin user.
 +
 
• Change the admin password and save.
 
• Change the admin password and save.
 +
 
'''Dont change the url in admin'''
 
'''Dont change the url in admin'''
  
Russell Taihn
+
also, you will need to modify the system params
email: russell@fixitcomputers.com.au
+
 
 +
click on manage and select config from the drop down selection,
 +
 
 +
[[Image:Metadot_config.png]]
 +
 
 +
then select, Modify next to the System params as seen in screen shot
 +
 
 +
[[Image:Metadot_params.png]]
 +
 
 +
scroll down untill you find
 +
 
 +
Absolute path for private file upload directory
 +
 
 +
and change to /opt/metadot/sitedata/private
 +
 
 +
scroll down to bottom of page and press save
 +
 
 +
Your Metadot Portal is now ready for to use, '''Enjoy'''
 +
 
 +
== Note ==
 +
 
 +
I will add instruction on how to add a virtual host for Metadot soon, some hints if you are attempting virtual host, you will need to modify createdbanduser4x.sql & sampledata.sql found in the /metadot/default_data
 +
 
 +
edit createdbanduser4x.sql and change create database metadotdb; to create database metadotvhdb; save changes
 +
 
 +
mysql -uroot mysql < createdbanduser4x.sql
 +
 
 +
mysql -e "grant all privileges on metadotvhdb.* to metadotvh@localhost identified by 'yourpassword'"
 +
 
 +
mysql -e "flush privileges"
 +
 
 +
mysql -umetadotvh -pyourpassword metadotvhdb < sampledata.sql
 +
 
 +
 
 +
 
 +
 
 +
[mailto:russell@fixitcomputers.com.au?subject=Metadot Russell Taihn]
 +
 
  
 
[[Category:Howto]]
 
[[Category:Howto]]
 +
[[Category:CMS]]

Latest revision as of 21:05, 2 November 2013

Maintainer

Russell Taihn

Description

Metadot Portal Server

Metadot is a leading open source portal software (GPL) used to create websites, intranets, extranets, project and team spaces

Metadot Portal Server is a leading open source portal system. Its ease of use allows non technical people to create very powerful websites and portals just with the clicks of a mouse. Its architecture makes it extremely easy to customize and deploy. It is available for free under the GNU General Public License (GPL). It provides collaboration, content management, as well as My News Page (like My Yahoo) and online database applications. Typically it is used to create web portals, intranets, extranets, organization and project websites.

When it was first released in April 2000, it revolutionized the way complex websites are built by giving easy-to-use tools to non-technical users allowing them to create powerful database-backed websites without having to involve a webmaster or the IT department!

It runs primarily on Linux, Apache, MySQL and Perl and supports Sun Solaris, Windows OSes and Oracle database.


russell@fixitcomputers.com.au

Forum Discussion


mkdir -p /tmp/metadot
cd /tmp/metadot
wget http://download.metadot.com/Metadot6.4.5.4.tar.gz
tar xvzf Metadot6.4.5.4.tar.gz
mv /tmp/metadot/metadot /opt

chown -R www.www /opt/metadot
chmod 750 /opt/metadot
chmod 640 /opt/metadot/etc/metadot.conf
mv /opt/metadot/html/* /opt/metadot/
cd /opt/metadot/metadot
chmod 755 *.pl

Setup Dag Repositories

You need to activate the Dag reposity before installing this contrib.

see dag repository

Installing Required Modules

yum --enablerepo=updates --enablerepo=addons install mod_perl gd ImageMagick ImageMagick-perl netpbm
config setprop modPerl status enabled
signal-event post-upgrade

Installing Required Perl Modules

yum install\
--enablerepo=base \
--enablerepo=updates \
--enablerepo=addons \
--enablerepo=dag install \
perl-GD perl-GD-Graph perl-GD-Graph3d perl-GD-Text-Util \
perl-Date-Pcalc perl-Email-Valid perl-Apache-DBI \
perl-AppConfig perl-Archive-Tar perl-Archive-Zip \
perl-Bit-Vector perl-CGI-SpeedyCGI perl-Compress-Zlib \
perl-Data-Compare perl-Date-Calc perl-ExtUtils-PkgConfig \
perl-File-Find-Rule perl-File-HomeDir perl-HTML-Format \
perl-HTML-Template perl-HTML-Tree perl-Image-Base \
perl-Image-Size perl-Lingua-EN-NameParse \
perl-LWP-UserAgent-Determined perl-Mail-POP3Client \
perl-MailTools perl-HTTP-BrowserDetect perl-HTTP-Server-Simple \
perl-HTTP-Request-Form perl-HTTP-DAV \
perl-MIME-tools perl-Number-Compare perl-Number-Format \
perl-OLE-Storage_Lite perl-Parse-RecDescent perl-Pod-POM \
perl-Spreadsheet-WriteExcel perl-Template-Toolkit \
perl-Test-Builder-Tester perl-Test-Manifest perl-Test-SimpleUnit \
perl-Text-Autoformat perl-Text-CSV_XS perl-Unicode-String \
perl-XML-Dumper perl-XML-RSS perl-XML-Simple

Create Database

cd /opt/metadot/default_data
mysql -uroot mysql < createdbanduser4x.sql

mysql -e "grant all privileges on metadotdb.* to metadot@localhost identified by 'yourpassword'"

mysql -e "flush privileges"

mysql -umetadot -pyourpassword metadotdb < sampledata.sql

Create a Template Fragement

mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/
cd /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/
pico 87Metadot


#Metadot

   ServerName yourdomain.com
    
   DocumentRoot         /opt/metadot/metadot
   Alias /metadot /opt/metadot/metadot
   Alias /images/ /opt/metadot/images/
   Alias /js/ /opt/metadot/js/
   Alias /index.pl /opt/metadot/metadot/index.pl
   Alias /public/   /opt/metadot/sitedata/public/
   Alias /skins/    /opt/metadot/sitedata/skins/
   Alias /htmlarea3/ /opt/metadot/js/htmlarea3/
   Alias /private/  /opt/metadot/sitedata/private/
   Alias /userchannel.pl /opt/metadot/metadot/userchannel.pl

<Directory /opt/metadot>
   Options +Indexes +Includes +FollowSymLinks -MultiViews +ExecCGI
   AllowOverride All
   allow from all
   AddHandler  cgi-script .pl
   PerlHandler speedy::Registry
   PerlSendHeader      On
   DirectoryIndex      index.pl
</Directory>

Save by pressing Ctrl x, press y to save changes and press enter

expand-template /etc/httpd/conf/httpd.conf 
/etc/rc.d/init.d/httpd-e-smith restart

Modify Metadot configuration file

Metadot uses a configuration file that associates database information with the web server that you are running. It is located: /opt/metadot/etc

cd /opt/metadot/etc

Edit Metadot.conf you will need to modify these lines in the metadot.conf file to match the location where you install metadot on your server.

 metadot.conf
Line 16 change the password created in the mysql setup. pass = yourpassword,
Line 34 change /opt/metadot/sitedata/public
Line 108 change to /opt/metadot/sitedata/skins

Performance configuration

Warning.png Warning:
If you don't do this configuration, your metadot site will be extremely poor.


cd /opt/metadot/metadot

edit index.pl and change the top line from #!/usr/bin/perl to #!/usr/bin/speedy. This needs to be done to all .pl files in the metadot/

index.pl

md_clean.pl

metadotd.pl

soap.pl

startup.pl

userchannel.pl

smoke

Example

#!/usr/bin/speedy

Testing the installation

cd /opt/metadot/metadot

Next, run the index.pl file on the command line :

perl index.pl

if no errors go to next step


Now bring up the Metadot start page by accessing it from your web browser:

http://type.your.domain.com or http://type.your.domain.com/metadot/

Metadot Aministration Information

The default out-of-the box user name & password for Metadot is admin and the password is "123456". In your browser, go to the Metadot home page. In the upper right corner click on "Login".

This will take you to the login screen. Log in as 'admin' using the default '123456' password. This will take you back to the main screen.

[Note: If you are using the Konqueror web browser, then it has been reported that you may see an error screen the first time you log in. If you see this, then just go back and then click on 'Home']

Go to the bottom of the page and click "Enable Editing". This will enter edit mode, which will cause the page's edit controls to become visible. Change the password for the Admin user (the site's admin account). Do this in the following manner:

• Log in as admin, as described above.

• Go to "Manage..."->"My Profile". This will take you to the edit profile page for the admin user.

• Change the admin password and save.

Dont change the url in admin

also, you will need to modify the system params

click on manage and select config from the drop down selection,

Metadot config.png

then select, Modify next to the System params as seen in screen shot

Metadot params.png

scroll down untill you find

Absolute path for private file upload directory

and change to /opt/metadot/sitedata/private

scroll down to bottom of page and press save

Your Metadot Portal is now ready for to use, Enjoy

Note

I will add instruction on how to add a virtual host for Metadot soon, some hints if you are attempting virtual host, you will need to modify createdbanduser4x.sql & sampledata.sql found in the /metadot/default_data

edit createdbanduser4x.sql and change create database metadotdb; to create database metadotvhdb; save changes

mysql -uroot mysql < createdbanduser4x.sql

mysql -e "grant all privileges on metadotvhdb.* to metadotvh@localhost identified by 'yourpassword'"

mysql -e "flush privileges"

mysql -umetadotvh -pyourpassword metadotvhdb < sampledata.sql



Russell Taihn