Guide: How to Install GreyMatter

DLashley · - Joined: 18 Dec 2002 Posts: 207 Location: New York, NY

***THIS IS WHAT I DID. YOU MAY WISH TO CHANGE SOME OF THESE SETTINGS TO SUIT YOUR OWN SETUP***

1. Before you begin - TURN ON THE SERVER!
2. Browse to this site: http://www.noahgrey.com/greysoft/
and DOWNLOAD these 2 files from the front page

"Greymatter 1.21d (117k ZIP)" - the program
"Icon Collection (172k ZIP)" - GreyMatter Linking Images (*optional)

3. Unzip the Greymatter Installation zip file to your DESKTOP.
4. Read the "Install.html" files.
5. Edit these 4 files: "gm.pl", "gm-comments.pl", "gm-karma.pl", and "gm-upload.pl" so the top line in all 4 files says:

#!C:\Perl\bin\perl.exe

***(This SHOULD BE the path to Perl on your PC if you accepted the default settings during the Perl installation . If you installed Perl somewhere else, then change the path accordingly.)

6. Create 3 FOLDERS (directories):

a. Place a folder called "blog" in your "cgi-bin"
b. Place a folder called "blog" in your "htdocs" folder
c. Place a folder called "archives" in your "htdocs/blog" folder

7. Copy all of the files ending in ".cgi" into the "blog" folder that you created inside the cgi-bin.
8. Rename the "index.htm" file to "index.php", and copy it to the "blog" folder that you created inside the "htdocs" folder
9. Copy "gm-icon.gif" to the "blog" folder that you created inside the "htdocs" folder
10. Start IE and browse to:

"http://yourdomain.com/cgi-bin/blog/gm.cgi "

11. Log in as "Alice" with the password "wonderland" (do NOT save a cookie for this password!!!)
, then fill in these settings on the CONFIGURATION screen:

Path Configuration:

Local Log Path: C:\Program Files\Abyss Web Server\htdocs\blog
Local Entries/Archives Path: C:\Program Files\Abyss Web Server\htdocs\blog\archives
Local CGI Path: . (just a period)

Website Log Path: http://yourdomain.com/blog
Website Entries Path: http://yourdomain.com/blog/archives
Website CGI Path: http://yourdomain.com/cgi-bin/blog

Index filename: index.php
.suffix to entry files: php
.suffix to log archives: php

Days to keep on main index: 7
Generate pages for individual entries? Yes
Keep archive master index? Yes
Keep monthly/weekly log archives? Yes
Keep main index and archive log
indexes concurrent with each other? Yes
Archive by month or week? Weekly

Email Options:

I left the first 2 lines blank

Send e-mail notifications for: Neither

*** (There's no mail server setup yet on my PC. If yours is setup - add the correct info above)

Karma & Comments Options:

Allow karma voting and/or comment posting? Comments Only
Order of comments on entry pages: Ascending
Can post comments and vote on karma in archives? No
Karma voting on by default? No
Comment posting on by default? Yes
HTML allowed in comments? No HTML Allowed (so hackers can't insert harmful code!)
Auto-link URLs in comments? Yes
Strip new lines from comments? No
Allow multiple karma votes from same IP? No
Mention it in the control panel log when
comments and karma votes are added? Yes

Date & Time Options:

Server Offset Time: 0
Your Time Zone: EST

File Uploading Options:

Allowed File Types: jpg;gif;zip
Maximum Filesize Allowed: 5000 KB

Censoring Options:

Enable censoring? Neither (I will change this later when I find a good list of cuss words)
Censor List: (I didn't put anything here yet. I'll put the cuss words I want to censor later)

Connect Other Files (Advanced Users Only):

Filename List: (I didn't put anything here yet)
Update them when adding entries? No (I'll change it to YES when I put filenames in the box)

Miscellaneous Options:

Enable cookies? Yes
Keep control panel log? Yes
Allow "easy formatting"? Both
Default entry list view: Current entries (7 days)
Order of list links: Ascending
Log entry list variable number: 10
Link to entries in {{logentrylist comments}} only if comments are active? Yes
Entries to link to in {{calendar}}: Always link to entry for that calendar day
"Automatically rebuild" selected by default? Yes

12. Click on SAVE CONFIGURATION first, then go back into CONFIGURATION, and run DIAGNOSTICS AND REPAIR. If you've followed the above instructions, you should have a successful install!!!

13. When you get the on-screen message that Greymatter was successfully installed, go back to the MAIN MENU, and click on EDIT AUTHORS. Create a new author for yourself with a password, then go back to the MAIN MENU, and click on RE-LOGIN.

14. You'll be automatically logged out. Then you must log back in with your new USERNAME and PASSWORD (save a COOKIE for this password).

15. You MUST go back to EDIT AUTHORS, and delete author ALICE for security reasons.

16. Go back to the MAIN MENU, and click on ADD AN ENTRY.

17. Add an entry to your weblog, then go back to the MAIN MENU, and click on VISIT YOUR SITE.

18. Your GreyMatter blog will pop up in a new window, complete with your new entry!!!

19. Use the Greymatter Manual ("manual.html") included in the zip to figure out how to create templates and perform other customizations to your blog.

20. Go to the GreyMatter site to check for updates, and to GM Hacks to check for MODS to the GreyMatter software. (Be sure to download the alternate GM logos or create your own - if you'd prefer, and link back to the GreyMatter site!). The GreyMatter Forum is the BEST place to ask questions and get help for this program! Please go there, and SEARCH first before you ask questions! If you aren't any good at HTML or CSS or making layouts/graphics, go to the GM Templates site to snatch a free template to change the look of your blog.

GreyMatter main site: http://noahgrey.com/greysoft/
GM Hacks: http://www.foshdawg.net/gm/mods/
GreyMatter Forum: http://foshdawg.net/forums/index.php
GM Templates: http://foshdawg.net/gm/templates/

THAT'S ALL FOLKS!!!

:!: This post was originally posted here. I just moved it here today.
_________________
DLashley

Bluedog · - Joined: 05 Jan 2003 Posts: 179

nice, thanks a lot, this was very useful :D

DLashley · - Joined: 18 Dec 2002 Posts: 207 Location: New York, NY

You're very welcome. Your contributions are very helpful too. :)
_________________
DLashley

DLashley · - Joined: 18 Dec 2002 Posts: 207 Location: New York, NY

Hmm... time to update this tute. New version of GreyMatter makes this obsolete. :)
_________________
DLashley

wally007 · - Joined: 13 Jan 2004 Posts: 17

humm , yes , indeed it'd be great if someone update this tutorial for noobs. I'm about ready to implement this in my web site that i'm trying to design but i'm kinda scared doing it without any tutorial at all.

Thanks !

vlad

Kindagreywolf · - Joined: 14 Aug 2004 Posts: 8

I just set it up per instructions. The only thing I didn't do was the Perl or Pl files. Works great! I can do the instructions, all I have to do is copy and paste it and delete the the instructions for the PL!

Moe Figit · - Joined: 10 Oct 2004 Posts: 5

New URL for the forums is:
http://www.greymatterforums.com

New URL for the latest version(currently 1.3.1):
http://www.greymatterforums.com/download/

You can pretty well ignore what is listed above for version 1.21 as some of it does not apply.

Instead go here:
http://freebies.wiccked.com/content/tutorials/gm_installation_for_dummies.php

Good luck and happy blogging.