Installation of hns

### Hyper NIKKI System Version 2.10

# Installation of hns

### To use hns

You need the system below.

- Web Server (Apache etc)
- Perl 5.004 or lator (Patch for Perl 5.003 is contributed, but not offical)
- sendmail (If you want to update diary via email or web browser)
- ftp (If you use webif ftp mode)
- nkf (You don't need it, if you don't use Japanese)

You can use hns, if you can use the software above.

If you can't use shell, you would be better to install hns-lite.

There is a installation documentation for begginers, はいぱ〜日記システムによるWeb日記のすすめ。(Japanese only).

Now,

- FreeBSD 2.2.5, 2.2.6, 2.2.7, 2.2.8, 3.1, 3.2, 3.3, 3.4
  Linux 2.0.34, 2.0.36, 2.1, 2.2.9, 2.2.13
  - MkLinux DR3, RedHat(Japanese) 5.2, Vine 1.1, Slackware 3.4, Cobalt Linux 3.0
  - Debian GNU/Linux 2.1, 2.2
  - TuroboLinux Server 6.0, TurboLinux 6.0
  OSF1 1.3
  DigitalUnix 4.0B, 4.0D(Rev. 878), 4.0F
  Solaris 2.6 for Sparc
  Solaris 2.6, Solaris 2.7 for Intel
  NetBSD 1.3.4, 1.4.1
  SunOS 4.1.4-JLE1.1.4, 5.6
  BSDI 4.1
- Apache 1.2.1, 1.2.6, 1.3.1 Cobalt, 1.3.3, 1.3.4, 1.3.6, 1.3.9, 1.3.11, 1.3.12
- Perl 5.004_01, 5.004_03, 5.004_04, 5.004_05, 5.004_25
  5.005_02, 5.005_03, 5.005_54, 5.005_56
  jperl 5.004_04-980303, 5.005_02-981225

we recieved reports that hns worked on above environment (not tested all any mix) . If you want to know hns-ready-ISPs, please see List of ISPs which hns worked.

HOWTO Documentation may help you.

You need the environment that Namazu works to search your diary. See Full Text Search by Namazu for hns for the detail

### Getting hns

Get the latest hns from http://www.h14m.org/dist/ (hns-2.10-pl?.tar.gz).
deb for Debian and port for FreeBSD are also available from http://www.h14m.org/dist/binaries/.
rpm will be released soon.

### Installing hns

Diary Directory(the directory to put every day hnf) is "~/diary/"， Web Diary Directory(the directory accessible from web) is "~/public_html/diary/".

1. $ gzip -dc hns-2.10-pl?.tar.gz | tar xvf -
   (or $ tar zxvf hns-2.10-pl?.tar.gz)
2. $ cd hns-2.10
3. If you use interactive setup program;
   $ sh hns-setup.ja
   and answer the questions.
   Caution:
   You can't input the letter "!". If you use it, installation fails. If you want use the letter "!" in your configuration, you must edit configuration file of hns after installation completed.
4. Below is in case not to use interactive setup program.
   $ vi Makefile
   `NIKKITITLE` is your diary tilte
   `NIKKITITLE = HNS: Hoge's Diary`
   `USERMAIL` is your email address (the address is embedded in every diary page)
   `USERMAIL = hoge@foo.bar.jp`
   `DIARYMAIL` is your email address(to) for Updating Diary via Email .
   `DIARYMAIL = hoge@foo.bar.jp`
   `FROMADDR` is your email address(from) for Updating Diary via Email (the address is for authorization).
   `FROMADDR = hoge@foo.bar.jp`
   `PASSWORD` is password for Updating Diary via Email
   `PASSWORD = hirakegoma`
   Set `UNAGIUSE` ON if you want search form of Namazu for hns in your diary page. You need to install "Namazu for hns" to search your diary.
   `UNAGIUSE = OFF`
   `MYDIARYURI` is your diary URL
   `MYDIARYURI = http://www.foo.bar.jp/~hoge/diary/`
   Caution:
   index.cgi を DirectoryIndex に指定できない場合(上記の URL に アクセスするとディレクトリの中身が見えてしまう場合など)は、
   `MYDIARYURI = http://www.foo.bar.jp/~hoge/diary/index.cgi`
   と設定して下さい。
   Set the theme name that you want in `THEME`. Default theme is japanese.
   `THEME = ruribaka`
   `ANTENNA` には， Hoshino Antennaに 捕捉された場合，星野アンテナに登録してよいかどうかを記載します． 星野アンテナに登録してかまわない場合は OK と，登録して欲しくない場合には， NG と指定します．Default is OK.
   `ANTENNA = OK`
   Set the path of Perl5 to `PERL_PATH`.
   `PERL_PATH = /usr/local/bin/perl`
   Set the path of sendmail to `SENDMAIL_PATH`.
   `SENDMAIL_PATH = /usr/sbin/sendmail`
   Set the path of nkf to `NKF_PATH`.
   `NKF_PATH = /usr/local/bin/nkf`
   `DIARYDIR` is diary directory, `HTMLDIR` is web diary directory. Change these only if you want.
5. Type
   $ make install
   hns is going to be installed.
   Caution:
   Installer installs Apache access control file, .htaccess to your web diary directory. .htaccess is blow:

       DirectoryIndex index.cgi index.html
       <Files "*.pm">
        deny from all
       </Files>
       <Files "*.ph">
        deny from all
       </Files>
       <Files "*.bak">
        deny from all
       </Files>

   Your Apache configuration may cause Internal Server Error when you access to your diary. In this case, if you can ask webmaster to change Apache configuration, plese do. Or you can remove .htaccess. But if you remove .htaccess, then configuration files etc. are readable via web brower.
6. If installation finished successfully, go to How to Set up Config File

### Hyper NIKKI System Version 2.10

Index