Quick Install (Requires that you have a shell account on the webserver and that the server allows CGIs to be run from anywhere.):

  1. Login to your account on your server via SSH or Telnet.
  2. Type (or paste) 
    lynx http://deekoo.net/technocracy/addendat/addendat.tar.gz
  3. Press enter.
  4. Press 'D' to download the Addendat archive.
  5. Type 
    tar xfzp addendat.tar.gz
  6. Press Enter.
  7. Now move the Addendat directory you just untarred into your website directory. Assuming your site lives in a public_html directory under your homedir, type this: 
    mv addendat ~/public_html/
  8. Press Enter
  9. Change to your new Addendat directory. 
    cd ~/public_html/addendat/
  10. Press Enter.
  11. And run the user-friendly install program: 
    ./install-addendat
  12. Press Return. If you don't have a Return key, you may need to get a Mac and use its Return key. If you can't get a Mac for some strange reason, you may use the Enter key. However, doing so will void your warrantee and may make it impossible to get a refund should anyone need to return you to the Creator for a replacement.
  13. The installer will try to determine the defaults for your blog. If all goes well, going to http://your.web.server/~your_username/addendat/ will take you to your blog. If you have a virtual domain instead of a normal ~username account, you'll want to edit your addendat.cfg so that it points at your domain instead of a ~username URL.

Manual installation (for users without shell accounts on their webservers.):

  1. Download Addendát
  2. Decompress addendát. You'll need a decompresser that understands tar and gzip.
  3. Get an editor that understands Unix line endings. On the Mac, Tex-Edit Plus will work. I don't know which editor(s) work under Windows; however, SimpleText, Notepad, MS-DOS Edit, DR Editor, and WordPad will corrupt any file they touch; do not use them.
  4. Use the aforementioned editor to edit addendat.cgi. Find the line that says 
    $configfile='/home/deekoo/deekoo.net_html/technocracy/addendat/addendat.cfg';
    and change it to have the actual path your addendat.cfg file will be in instead. You must save the file as plain text with unix line endings.
  5. Open addendat.cfg in your editor.
  6. Set the text between <%blogfile%> and </%blogfile%> to the full path to your blog file on the server.
  7. Set the text between <%blogurl%> and </%blogurl%> to the URL of your blog.
  8. Set the text between <%accesscode%> and </%accesscode%> to whatever you want your blog's access code to be.
  9. Set the text between <%blogtitle%> and </%blogtitle%> to whatever you want your blog's title to be. The title'll be used in the list on the hub.
  10. You may wish to edit the entry, entryseparator, and add tags.
  11. Upload addendat.cfg to wherever you said it'd be. ([your homedir]/addendat.cfg should work.) The config file has to be in a directory which CGI scripts will be able to read files in.
  12. Set the permissions on addendat.cfg to owner readable, owner writable, group readable, other readable (0644).
  13. Upload addendat.cgi to a directory that your server will allow you to run CGIs in.
  14. Set the permissions on addendat.cgi to owner readable, writable, and executable, group readable and executable, and world/other readable and executable (0755).
  15. Edit blog.html to reflect your desired design.
  16. Upload blog.html to wherever you said it'd be on your server.
  17. Set the permissions on blog.html to world, group, and owner readable and writable (0666).
  18. If you're putting add.html in a different directory from addendat.cgi, edit add.html so that the 'action="addendat.cgi"' has the correct path to addendat.cgi.
  19. Upload add.html to your server. It should be world/group/other readable and owner writable.
  20. That should be it. Now test.

FAQ