This page describes the steps to install gnizr web applications. Developers can also download and build gnizr from the SVN source code.

If you have any questions, post them in Gnizr User Discussion.

System Requirement

• Apache Tomcat 5.x
• MySQL 5.0+
• Cygwin (if running on a Windows machine)

Steps to Install

1. Download and unpack a gnizr release.
• e.g., after unpacking, the top-level directory is gnizr-x.y.z
2. Prepare MySQL database for installation
• See SetupGnizrDatabase
3. Copy gnizr web application directory to Tomcat
• cp -r gnizr-x.y.z/gnizr /your/tomcat/webapps/
4. Edit gnizr configuration
• For gnizr 2.3.0: See GnizrConfigXML
• For gnizr 2.4.0: See GnizrConfigXML_2_4
5. Start Tomcat

Steps to Upgrade

1. Download and unpack a gnizr release.
• e.g., after unpacking, the top-level directory is gnizr-x.y.z
2. Upgrade gnizr database
• See Upgrade database tables and stored procedures in SetupGnizrDatabase
3. Backup your existing gnizr web application in Tomcat
• e.g., mv /your/tomcat/webapps/gnizr to /tmp/backup-gnizr
4. Copy gnizr web application directory to Tomcat
• cp -r gnizr-x.y.z/gnizr /your/tomcat/webapps/
5. Edit gnizr configuration
• For gnizr 2.3.0: See GnizrConfigXML
• For gnizr 2.4.0: See GnizrConfigXML_2_4
6. Start Tomcat

Login and Create New Accounts

Gnizr comes with a default user account -- gnizr, who is the administrator of the system. After you have logged in as gnizr, you can create additional user accounts.

1. Go to the front page of gnizr
• If installed on localhost port 8080, http://localhost:8080/gnizr
2. Log in as gnizr
• username: gnizr
• password: gnizr
3. Change gnizr password (IMPORTANT!)
• Go to settings -> Change your password
4. Create new accounts
• Go to settings -> Manage user accounts

Enable UTF-8 Support (Optional)

If you want to be able to save bookmarks in non-English languages, you may need to configure both Tomcat and MySQL to support UTF-8.

Tomcat Configuration

In server.xml file, configure the <Connector/> to encode URI with UTF-8. This ensures all HTTP-GET and HTTP-POST parameters are properly encoded using UTF-8.

<Connector port="8080" maxHttpHeaderSize="8192"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               connectionTimeout="20000" disableUploadTimeout="true"
               URIEncoding="UTF-8"/>

MySQL Configuration

In the MySQL server configuration file (e.g. my.ini), configure both client and server to use UTF-8 as their default encoding character set.

[mysql]
default-character-set=utf8
[mysqld]
default-character-set=utf8
character_set_server=utf8