Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Minor edits to installation instructions #9

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

Tocacar
Copy link

@Tocacar Tocacar commented Aug 2, 2012

Some minor text edits made. Also, I made the following notes on the process in general:

  • It is a shame that APC and php_gettext are so hard to install (on a Mac anyway). It might be good to provide some instructions, or links to reliable instructions, especially for novice users.
  • On trying to to install PHP gettext, I founds lots of material online about 'gettext', which appears to be something different(?). Maybe this needs to be a bit clearer in the text (or, if either will do, it might be good to say so)?
  • It would be nice to explain what the ArmChair submodule is (or add a readme file to the ArmChair github repo so curious readers can click through and find out).
  • This might just be me, but chmod 775 FRAPI_PATH/src/frapi/custom/Action and chmod 775 FRAPI_PATH/src/frapi/custom/Config/ didn't seem to work correctly (when I viewed the admin screen in my browser it said I didn't have writeable permission on these items - chmod 777 fixed it, but I realise that's probably not correct either).
  • "If you open your browser to http://api.frapi you should now see an XML payload that has an error that has the code ERROR_INVALID_ACTION_REQUEST". I did not get this error, I just got a login screen.
  • I was temporarily confused when I got to 'Configuring Nginx' and thought I had to do that as well (then I realised I could skip it because I had followed the instructions for configuring Apache). The styling of the headers makes it difficult to see what is a main header and what is a subheader - they are a bit too similar.

@jeremykendall
Copy link
Member

I know I haven't been around for about a billion years, but regarding the 775 vs 777 permissions issue: It wasn't clear in your comment who owns the directories in question. The web user should either own those directories or should be the group owner of the directory. For example, on Ubuntu the web user is www-data. In order for 775 to work properly, those directories must be owned by the web user outright (in which case 755 might be more appropriate), or by your user as the owner and www-data as the group.

Apologies if that's so obvious as to be redundant, but I figured it was worth commenting on, just in case.

@Tocacar
Copy link
Author

Tocacar commented Aug 2, 2012

I'm not very well versed in this stuff, so it isn't obvious at all to me! Apache is running as me on my Mac desktop:

I started with ls -l showing me this:

drwxr-xr-x 8 rowan02 1830632722 272 2 Aug 12:29 Action
drwxr-xr-x 9 rowan02 1830632722 306 2 Aug 12:29 Config

Then ran the specified commands and did ls -l to see this:

drwxrwxr-x 8 rowan02 1830632722 272 2 Aug 12:29 Action
drwxrwxr-x 9 rowan02 1830632722 306 2 Aug 12:29 Config

Which gave me warnings in admin.frapi on my browser. chmod 777 fixed it:

drwxrwxrwx 8 rowan02 1830632722 272 2 Aug 12:29 Action
drwxrwxrwx 9 rowan02 1830632722 306 2 Aug 12:29 Config

I'm not sure if this extra info helps at all.

@jeremykendall
Copy link
Member

Something about that doesn't strike me as quite right, but I'm not familiar enough with developing on a Mac to steer you in the right direction. A little more info might be helpful, and then we wait for someone who develops on a Mac to chime in.

What are you using to serve websites on your Mac? You said you're using Apache, but was that installed via MAMP or some similar package? Or did you install a MAMP stack yourself?

@Tocacar
Copy link
Author

Tocacar commented Aug 2, 2012

I'm not using MAMP, just the standard Mac OSX install for 10.6 (I think it came with Apache as standard). I'm not sure what other information might be useful at this point, so I'll do as you suggest and wait until another Mac user sees the thread.

@jeremykendall
Copy link
Member

OK then, try this. To find the user and group that Apache is running under, try 'grep User /private/etc/apache2/httpd.conf' and 'grep Group /private/etc/apache2/httpd.conf'. You'll probably discover that the user and group are both '_www'. With that knowledge, go back to the instructions for installation, make the required user and group changes to your configuration, and try again: http://frapi.github.com/installing/index.html#frapi.installing.directory.and.file.permissions

@Tocacar
Copy link
Author

Tocacar commented Aug 2, 2012

Adding myself to _www and re-setting the Action/ Config permissions worked (with no warning shown in admin.frapi console in the browser). Thank you.

@jeremykendall
Copy link
Member

w00t!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants