Koozali.org: home of the SME Server
Obsolete Releases => SME 7.x Contribs => Topic started by: jessica on December 04, 2008, 02:10:18 AM
-
Can anyone show me step by step how to install Epiware on SME server 7.3?
-
Can anyone show me step by step how to install Epiware on SME server 7.3?
It's pretty easy, but there was one infuriating item that I couldn't solve until I tricked it to work. The way the program is set up by its install script, with the storage area in a folder called '/storage,' with 'binaries' and 'document_area' subfolders, produces an error when you first log in which says 'Either the directory '/storage/document_area' doesn't exist or the httpd user doesn't have permission to write to it. No matter what I did I couldn't solve this. Then it dawned on me that I should move the document storage area into the 'files' area of the ibay and the problem simply went away. Program looks very nice! Here's how to do it.
Because my server does lots of stuff, I couldn't place the php code in the primary ibay which would give a straightforward URL for the program in the form http://www.myserver.com/epi. Instead I had to place the code in a new ibay which I called 'epiware', and this gives the URL: http://www.myserver.com/epiware/epi - a bit clumsy. So I altered the install to get round this...
First create an ibay called 'epiware' with the kind of access you want and allow it to run CGI etc. For my trial I just chose to make it accessible on the local network with no password, but you could make it face the internet and protect it with a password - make it really strong.
Now log in to your server console and download the program with...
wget http://downloads.sourceforge.net/epiware/Epiware_4.8.6.tar.gz
Once the download is complete run...
tar -xvzf Epiware_4.8.6.tar.gz
...and you'll see the archive decompress with a long stream of filenames scrolling up the screen.
Now do...
cd Epiware_4.8.6
and then run...
./install
You'll get a set of instructions on the screen telling you to run...
mysql -u root -p < epi/project_db.sql
...do so. Then it says you should move the program's 'epi' folder to your htdocs directory. This is the first thing you need to vary. To avoid the clumsy URL problem described above, we don't want the 'epi' folder, only it's contents, so run...
cp -r epi/* /home/e-smith/files/ibays/epiware/html
When that's done we need to change the ownership of the files...
chown -R www:www /home/e-smith/files/ibays/epiware/html
Now for the second variation from their way of doing things: the install routine created a folder '/storage' which contains subfolders 'binaries' and 'document_area'; leave the 'binaries' folder alone but delete the 'document_area' folder...
rm -r /storage/document_area
Now we need to tell the program where it's going to store it's files, and one or two other items of configuration information, so we need to edit the file 'config.inc.php'...
cd /home/e-smith/files/ibays/epiware/html
[I've assumed you are a linux newby, so slap my wrist for the next command if you are a time-seved maven who swims about in the editor vi for fun - I *hate* it.]
mcedit config.inc.php
This gets you a nice text editor with the configuration file loaded. You need to make the following changes...
On the first two lines with a pink 'define' at the beginning, change 'www.mycompany.com' to your own domain URL and change the email address to something like 'doc-admin@yourdomain.com'.
Skip down to the series of lines at the bottom...
define("DOCUMENT_DIRECTORY","/storage/document_area");
define("CALENDAR_ATTACHMENT_DIRECTORY","/storage/attachments");
define("IMAGE_GALLERY_PATH","/storage/document_area");
define("ERROR_LOG_PATH", "/storage/document_area");
//a document area for wiki-group banners - unlike document area, this cannot be changed w/o moving all files at a later date
define("EPI_BANNER_DIRECTORY","/storage/document_area");
...and change all the directory settings to '/home/e-smith/files/ibays/epiware/files' - that's 4 '/storage/document_area' settings and 1 '/storage/attachment' setting.
When you've done all the editing check it carefully to be sure you haven't mistyped anything, then hit F2 and confirm you want to save the file and hit F10 to leave the editor. You can log out of the server console also.
Now go to a workstation and type http://www.yourserver.com/epiware into the browser and you should get your first login prompt - you need to enter a bunch of stuff about yourself and give a username and password and the next time you go in you'll only get asked for username and password.
Enjoy.
Ed Form
-
Here's how to do it.
Please also post this in the wiki in the Category:Howto (http://wiki.contribs.org/Category:Howto)
-
Please also post this in the wiki in the Category:Howto (http://wiki.contribs.org/Category:Howto)
I've created the page...
http://wiki.contribs.org/Category:Howto/Epiware
What do I do next?
-
I've created the page...
http://wiki.contribs.org/Category:Howto/Epiware
What do I do next?
Please also post this in the wiki in the Category:Howto (http://wiki.contribs.org/Category:Howto)
That shouldn't mean that you would create a new subpage but to create a new page which you would then categorize as a Howto to have it appear on the category page.
But never mind, thanks for the effort anyway.
It seems I can't move a subpage of the category, let's have cactus have a look at this :D
-
edform
The original page has been copied to
http://wiki.contribs.org/Epiware
Perhaps an admin can delete the original at
http://wiki.contribs.org/Category:Howto/Epiware
-
It seems I can't move a subpage of the category, let's have cactus have a look at this :D
Of course, as always.
Perhaps an admin can delete the original at
http://wiki.contribs.org/Category:Howto/Epiware
Done.
-
Of course, as always.
:P
Done.
Thanks ;)
-
That shouldn't mean that you would create a new subpage but to create a new page which you would then categorize as a Howto to have it appear on the category page.
Do I take it that the correct method for creating a Howto is to produce a page at...
http://wiki.contribs.org/NewHowtoSubject
...and then add the single line...
Category: Difficulty|Howto
...at the end of the Howto text?
I searched for quite a while and found no instructions on how to do this - there were several documents on how to format wiki text, most of which were seriously confusing, so I just cheated and cut-and-pasted the text of a well-formatted Howto into my new page then overlaid my text on that formatting - what I did not find was a simple: 'Howto add a Howto to the SME wiki.' Perhaps someone should add a second sticky to the top of the contribs forum like the comprehensive one on creating and uploading new contribs.
Ed Form
-
Do I take it that the correct method for creating a Howto is to produce a page at...
http://wiki.contribs.org/NewHowtoSubject
...and then add the single line...
Category: Difficulty|Howto
...at the end of the Howto text?
Nearly :)
It's correct that a new Howto should be created as a seperate page like http://wiki.contribs.org/NewHowtoSubject
[[Category:Howto]] adds the page to the Howto Category which means it will be shown at http://wiki.contribs.org/Category:Howto (http://wiki.contribs.org/Category:Howto).
For more information on categories you could read this page: http://wiki.contribs.org/Help:Categories (http://wiki.contribs.org/Help:Categories)
{{Level|Medium}} (in this case) adds the Skill template on top off the page and makes sure that the page is allocated to the Medium Category. (For more information read this: http://wiki.contribs.org/Template:Level (http://wiki.contribs.org/Template:Level))
I searched for quite a while and found no instructions on how to do this - there were several documents on how to format wiki text, most of which were seriously confusing, so I just cheated and cut-and-pasted the text of a well-formatted Howto into my new page then overlaid my text on that formatting - what I did not find was a simple: 'Howto add a Howto to the SME wiki.' Perhaps someone should add a second sticky to the top of the contribs forum like the comprehensive one on creating and uploading new contribs.
You're right AFAIK there is no 'Howto add a Howto to the SME wiki' but there is this page (http://wiki.contribs.org/Help:Contents) which is a overview of the things you may need to know for contributing to the wiki.
I don't know if a sticky post in the contribs forum would be the right place for this maybe let's do it like on http://wiki.contribs.org/Category:Contrib (http://wiki.contribs.org/Category:Contrib) where on the talk page is a outline for new contribs wiki pages.
But generally you're starting point with copying another page is absolutely right. You just copied it to the wrong place ;)
Regards,
Niklas
-
Hi,
Thanks for the Epiware Howto, well I have one small issue in Epiware. I have installed new server-only SME 7.4 and installed Epiware as per your howto but I am not able to upload any files (no error is also shown). Can you please help me out with this issue.
With Regards,
Avi
-
Hi,
Thanks for the Epiware Howto, well I have one small issue in Epiware. I have installed new server-only SME 7.4 and installed Epiware as per your howto but I am not able to upload any files (no error is also shown). Can you please help me out with this issue.
Hi Avi,
I'm not going to be much help, I'm afraid; I don't actually use this program. I only got involved and wrote the HowTo because a forum member wanted help. What I do remember is that my HowTo works because I wrote it as I did it, point by point. My guess is your problem is a permissions issue or a mistype in one of the directory lines that have to be changed.
Did you carry out the Chown command...
chown -R www:www /home/e-smith/files/ibays/epiware/html ?
And have you checked the 5 changed lines in config.inc.php?
I don't have a running server at the moment because I'm moving offices and the bad weather has put a crimp in my schedule. I'll try to redo this install on my own server when I get it up again, but please don't hold your breathe.
Ed Form
-
Hi Avi,
I'm not going to be much help, I'm afraid; I don't actually use this program. I only got involved and wrote the HowTo because a forum member wanted help. What I do remember is that my HowTo works because I wrote it as I did it, point by point. My guess is your problem is a permissions issue or a mistype in one of the directory lines that have to be changed.
Did you carry out the Chown command...
chown -R www:www /home/e-smith/files/ibays/epiware/html ?
And have you checked the 5 changed lines in config.inc.php?
I don't have a running server at the moment because I'm moving offices and the bad weather has put a crimp in my schedule. I'll try to redo this install on my own server when I get it up again, but please don't hold your breathe.
Ed Form
Hey Ed,
Thanks for the reply, I have installed and followed exactly the same way from your how to. I have double, triple checked, rechecked the configuration from the how to and it exactly reflects the same on my machine also, but I am not able to find why I cannot upload any files.
Any way I have also raised a ticket for this issue to Epiware support and waiting for their reply.
Thanks again for the reply and I hope you get time to redo this installation and post your results back (take your time and I’ll not hold my breath :lol: )
Little late though but belated New Year Wishes from all of us here.
Thanks & Regards,
Avi
-
Update:
I have done some modifications according to PHP how to (http://wiki.contribs.org/PHP) that is
db accounts setprop eroom PHPBaseDir /home/e-smith/files/ibays/eroom/html/
signal-event ibay-modify eroom
(before applying the above command, PHPBaseDir was blank)
now when I am trying to upload the files it throws an error “Error, cannot to write to directory /home/e-smith/files/ibays/eroom/files” I have applied chown to all the folders available in the “eroom” ibay
[root@dms eroom]# ls -ls
total 44
4 drwxrws--- 2 www www 4096 Oct 14 2008 cgi-bin
4 drwxrws--- 3 www www 4096 Jan 7 16:26 files
36 drwxrws--- 19 www www 36864 Jan 7 17:40 html
I also found some error in /var/log/httpd/error_log :
Thu Jan 07 16:44:21 2010] [error] [client 192.x.x.x] File does not exist: /home/e-smith/files/ibays/eroom/html/undefined, referer: http://192.x.x.x/eroom/index_library.php
[Thu Jan 07 16:48:50 2010] [error] [client 192.x.x.x] File does not exist: /home/e-smith/files/ibays/eroom/html/undefined, referer: http://192.x.x.x/eroom/index_library.php
[Thu Jan 07 16:49:32 2010] [error] [client 192.x.x.x] File does not exist: /home/e-smith/files/ibays/eroom/html/undefined, referer: http://192.x.x.x/eroom/index_library.php
[Thu Jan 07 16:51:21 2010] [error] [client 192.x.x.x] File does not exist: /home/e-smith/files/ibays/eroom/html/undefined, referer: http://192.x.x.x/eroom/index_library.php
[Thu Jan 07 16:51:21 2010] [error] [client 192.x.x.x] File does not exist: /home/e-smith/files/ibays/eroom/html/undefined, referer: http://192.x.x.x/eroom/index_library.php
Anyone worked on Epiware with SME, please do help me to resolve this issue.
Thanks & Regards,
Avi
-
I, too, am getting these errors and I have chmod 777 all dirs as a test.
Is there some kind of file upload blockage in SME server for PHP that is not in the templets? I am also unable to upload files from multiple web applications, not just Epi.
Thanks in advance for any assistance.
Joe
-
manegar & Joeg1484
I believe it goes like this.
PHP code in an ibay has restricted access to that ibay only. This is so that errant apps cannot write stuff to elsewhere in your servers file system that you don't want written. This is part of the good default security design/model in SME server.
I think the correct way to do it, is to create a tmp folder within the ibay and then specifiy that location.
If you repeatedly specify /tmp as the PHPBaseDir for different apps in different ibays, then there is the security risk that one app may be able to read another apps files, and again do something that you don't really want done.
ie (using example given)
mkdir -p /home/e-smith/files/ibays/eroom/html/tmp
db accounts setprop eroom PHPBaseDir /home/e-smith/files/ibays/eroom/:/home/e-smith/files/ibays/html/tmp
signal-event ibay-modify eroom
Please also refer to this
http://wiki.contribs.org/DB_Variables_Configuration#Apache_server_ibay_specific_.28httpd-e-smith.29
where it is indicated that the default value for a ibay is
/home/e-smith/files/ibays/ibayname
Note that default values apply where there is no specific db entry, so the absence of a db entry associated with that ibay does not mean there is no PHPBaseDir setting.
-
manegar & Joeg1484
I believe it goes like this.
PHP code in an ibay has restricted access to that ibay only. This is so that errant apps cannot write stuff to elsewhere in your servers file system that you don't want written. This is part of the good default security design/model in SME server.
I think the correct way to do it, is to create a tmp folder within the ibay and then specifiy that location.
If you repeatedly specify /tmp as the PHPBaseDir for different apps in different ibays, then there is the security risk that one app may be able to read another apps files, and again do something that you don't really want done.
ie (using example given)
mkdir -p /home/e-smith/files/ibays/eroom/html/tmp
db accounts setprop eroom PHPBaseDir /home/e-smith/files/ibays/eroom/:/home/e-smith/files/ibays/html/tmp
signal-event ibay-modify eroom
Please also refer to this
http://wiki.contribs.org/DB_Variables_Configuration#Apache_server_ibay_specific_.28httpd-e-smith.29
where it is indicated that the default value for a ibay is
/home/e-smith/files/ibays/ibayname
Note that default values apply where there is no specific db entry, so the absence of a db entry associated with that ibay does not mean there is no PHPBaseDir setting.
Thanks for the reply... Would something like this work. I only need it for one application that I am planing on using, however, the knowlege is great incase I get a new client that needs more... So, would this work as well?
mkdir -p /home/e-smith/files/ibays/epi/files/storage
db accounts setprop epi PHPBaseDir /home/e-smith/files/ibays/epi/files:/home/e-smith/files/ibays/epi/files/storage:/home/e-smith/files/ibays/html
signal-event ibay-modify eroom
Thanks again for the assistance !!!
Joe
-
Joeg1484
Try (read it carefully for slight correction/changes)
mkdir -p /home/e-smith/files/ibays/epi/files/storage
db accounts setprop epi PHPBaseDir /home/e-smith/files/ibays/epi/:/home/e-smith/files/ibays/epi/files/storage/:/home/e-smith/files/ibays/epi/html
signal-event ibay-modify epi
-
I tried this morning to get it going again and it still failed with this in the logs:
[Sat May 15 09:38:13 2010] [error] [client 68.127.89.107] File does not exist: /home/e-smith/files/ibays/epi/html/undefined, referer: http://epi.joeman1.com/index_library.php
So there is something more that needs to happen... I will put a bug report in and see what happens...
Thanks!
Joe
-
Ok, posted bug 5956 to the list.
Also, to mention, I am using SME 8 beta 5, so this might be relevant to my product only. You should post as well to 7.x if you want too.
Thanks!
Joe
-
Joeg1484
I do not think your problem is a bug, as Charlie says at bugzilla.
I don't use epiware so cannot be more specific than the following.
.....File does not exist: /home/e-smith/files/ibays/epi/html/undefined, referer: http://epi.joeman1.com/index_library.php
is saying the file referred to by the code in index_library.php, does not exist.
It may be that the location has not been defined correctly in the epiware config.inc.php
Check your configuration settings for epiware. There would usually be a root dir setting something like
/home/e-smith/files/ibays/epi/html/
and then other locations may be relative to that eg
just
/foldername
instead of
/home/e-smith/files/ibays/epi/html/foldername
Alternatively it may require the full path, I don't know for sure.
This post may be mildly informative, although to do with Joomla, the concept is the same.
http://forums.contribs.org/index.php/topic,45948.msg224434.html#msg224434
"Joomla (by default) uses the /tmp directory to upload files. Have a look in /var/log/messages and see if you have open_basedir errors. If so, either change Joomla's upload directory to somewhere within the html path or change the open_basedir value.
See PHPBaseDir db setting here: http://wiki.contribs.org/DB_Variables_Configuration#Apache_server_ibay_specific_.28httpd-e-smith.29
You may also need to chown everything under the html directory to www:www so that the web server has write access to the folders.
(Note: DO NOT chmod anything in the html directory to 777, it is not recommended, safe or necessary)."
-
Ok, I can take a look at that link for Joomla. Thanks for that!
As a side note, and I appreciate that the developers cant support EVERY app that is out there, but as I stated in the bug report just now, Hord is also not allowing me to upload stuff.
I was trying to set up pictures of people in my address book and it was doing the same thing as EPI. It would start the upload process and then just return blank. In the errors.log, there was a similar error, although not the same paths.
I checked my paths in the php config file for the EPI app, and they looked spot on (Unless I was supposed to put the trailing / on them).
We will see what happens when SME 8 is released; as I mentioned, Im using 8 beta 5 atm. I got EPI up on a VM server using Ubuntu and its working fine over there, so at least I have a temp solution for my needs.
I do appreciate your assistance with this and look forward to posting again and working though other issues :).
Take it easy!
Joe
-
manegar & Joeg1484
I see no mention in the Howto of the need to change the PHPBaseDir setting from default.
Perhaps you did that inappropriately.
I suggest you do.
db accounts delprop eroom PHPBaseDir
signal-event ibay-modify eroom
or
db accounts delprop epi PHPBaseDir
signal-event ibay-modify epi
and try again with the default settings that will be generated by the code in the templates, rather than being based on a db value.
Re-read the howto and follow it carefully.
-
I also found some error in /var/log/httpd/error_log :
Thu Jan 07 16:44:21 2010] [error] [client 192.x.x.x] File does not exist: /home/e-smith/files/ibays/eroom/html/undefined, referer: http://192.x.x.x/eroom/index_library.php
You need to discover why index_library.php is trying to read a file called 'undefined' in that folder. It's either a bug or a configuration error. It does not look like a permissions problem.