install-ns

Install Scripts for NaviServer

This repository provides installation scripts for NaviServer—and optionally OpenACS. For more details, see the links below:

• Source Code
• Releases
• OpenACS

Overview

The install-ns.sh script allows you to install NaviServer with customizable settings. When run without additional parameters, it displays the default configuration values.

To view the default settings, run:

sudo bash install-ns.sh

This command outputs a list of settings, similar to the example below:

 SETTINGS   build_dir              (Build directory)                 /usr/local/src
            ns_install_dir         (Installation directory)          /usr/local/ns
            version_ns             (Version of NaviServer)           4.99.31
            git_branch_ns          (Branch for git checkout of ns)   main
            version_modules        (Version of NaviServer Modules)   4.99.31
            version_tcllib         (Version of Tcllib)               1.20
            version_thread         (Version Tcl thread library)
            version_xotcl          (Version of NSF/NX/XOTcl)         2.4.0
            version_tcl            (Version of Tcl)                  8.6.16
            version_tdom           (Version of tDOM)                 0.9.5
            ns_user                (NaviServer user)                 nsadmin
            ns_group               (NaviServer group)                nsadmin
                                   (Make command)                    make
                                   (Type command)                    type -an
            ns_modules             (NaviServer Modules)              nsdbpg
            with_mongo             (Add MongoDB client and server)   0
            with_postgres          (Install PostgreSQL DB server)    1
            with_postgres_driver   (Add PostgreSQL driver support)   1
            with_system_malloc     (Tcl compiled with system malloc) 0
            with_debug_flags       (Tcl and nsd compiled with debug) 0
            with_ns_doc            (NaviServer documentation)        1

            pg_user                (PostgreSQL user)                 postgres
                                   (PostgreSQL include)              /usr/include/postgresql
                                   (PostgreSQL lib)                  /usr/lib
                                   (PostgreSQL Packages)             postgresql libpq-dev

The first column lists variable names that you can use to override the defaults. You can edit the script directly or provide these variables as environment variables when invoking the script.

Customizing the Installation

For example, to compile NaviServer with site-specific settings, run:

sudo with_debug_flags=1 version_tcl=8.6.13 ns_modules="nsdbpg nssmtpd" \
     bash install-ns.sh

This command changes the defaults by:

• Enabling debugging (compilation flag -g).
• Using a specific version of Tcl (8.6.13).
• Including additional NaviServer modules (e.g., nsdbpg and nssmtpd).

One can specify every released version of Tcl 8.6.* or 9.* (indicated by the dots) or tags from the Tcl Fossil repository. To use the latest version from the Tcl 8.5 branch from Fossil, use core-8-5-branch (no dots in the name) for version_tcl.

If you wish to reuse an existing PostgreSQL database installation, but still building the PostgreSQL module, use:

sudo with_postgres=0 bash install-ns.sh

If you want to build without PostgresQL support at all, use:

sudo with_postgres=0 with_postgres_driver=0 bash install-ns.sh

To compile and build NaviServer, append the word build at the end of the command:

sudo bash install-ns.sh build

Additional Information

For further details, visit:
http://openacs.org/xowiki/naviserver-openacs