Difference between revisions of "NATS Requirements"

From TMM Wiki
Jump to navigationJump to search
Line 13: Line 13:
 
** Must not use Safe Mode
 
** Must not use Safe Mode
 
** Must have FollowSymLinks enabled in Apache for your NATS install.
 
** Must have FollowSymLinks enabled in Apache for your NATS install.
* [http://www.mysql.com/ MySQL version 5.0;] we prefer MySQL version 5.1 for its database partitioning capability. Future versions of NATS4 will require MySQL 5.1.
+
* [http://www.mysql.com/ MySQL version 5.1;] for its database partitioning capability.
 
** MySQL must also be accessible from the CLI, which may require changes to the my.cnf file
 
** MySQL must also be accessible from the CLI, which may require changes to the my.cnf file
 
** The MySQL user must have all priviliges on the nats DB, grant is optional.
 
** The MySQL user must have all priviliges on the nats DB, grant is optional.
 
** Ensure that NO_UNSIGNED_SUBTRACTION is enabled
 
** Ensure that NO_UNSIGNED_SUBTRACTION is enabled
 
* [http://www.maxmind.com/ MaxMind GeoIP.]  You must have at least the free version. Must install mod_geoip. Please ensure that you install the '''Apache''' Module for GeoIP, as this will not work without the GeoIP Apache API installed.
 
* [http://www.maxmind.com/ MaxMind GeoIP.]  You must have at least the free version. Must install mod_geoip. Please ensure that you install the '''Apache''' Module for GeoIP, as this will not work without the GeoIP Apache API installed.
* [http://php.net/ mod_PHP 5.2.] ('''5.3.x is not supported''')
+
* [http://php.net/ mod_PHP 5.2.] or higher.
 
** Enable [http://us.php.net/ini.core <code>short_open_tag</code>] in your server's ''php.ini''
 
** Enable [http://us.php.net/ini.core <code>short_open_tag</code>] in your server's ''php.ini''
 
** Disable [http://php.net/manual/en/security.globals.php <code>register_globals</code>] in your server's ''php.ini''
 
** Disable [http://php.net/manual/en/security.globals.php <code>register_globals</code>] in your server's ''php.ini''

Revision as of 11:05, 11 February 2011

NATS 4
About NATS 4
NATS4 Requirements
NATS4 vs NATS3 Advantages
IPSP Integration
NATS4 Changelog
Members Admin
The Members Admin
View Member Details
Add Member
MySQL Auth
Mod Authn DB
Multisite Access
Member Logging
Member Password Retrieval
OpenID Connect
Mod Auth OpenIDC
ID Numbers

Software Requirements

Please verify the following programs are installed. Your host can install any missing or out-of-date programs.

  • Linux or Unix, including BSD, Macintosh OS X, and Darwin
  • Apache
    • Must not use mod_security
    • Must not use Safe Mode
    • Must have FollowSymLinks enabled in Apache for your NATS install.
  • MySQL version 5.1; for its database partitioning capability.
    • MySQL must also be accessible from the CLI, which may require changes to the my.cnf file
    • The MySQL user must have all priviliges on the nats DB, grant is optional.
    • Ensure that NO_UNSIGNED_SUBTRACTION is enabled
  • MaxMind GeoIP. You must have at least the free version. Must install mod_geoip. Please ensure that you install the Apache Module for GeoIP, as this will not work without the GeoIP Apache API installed.
  • mod_PHP 5.2. or higher.
    • Enable short_open_tag in your server's php.ini
    • Disable register_globals in your server's php.ini
    • PHP CLI (should be the same version used by apache and should use the same php.ini)
    • Apache and the CLI must allow exec commands from PHP
    • must have cURL, FreeType with Open SSL, GDlib, and mcrypt (with blowfish and ecb support) included)
    • must have Ctype functions installed.
    • Must not use Safe Mode
  • unzip must be installed in /usr/bin/
  • CVS
    • Ensure your firewall doesn't block port 2401
  • GNU Tar with Gzip
  • Ioncube
    • If possible ensure the "enable_dl" setting is turned on in php.ini
  • FFMPEG
  • MPlayer with all codecs

Server Requirements

NATS requires a Web-accessible domain. It should be the domain you plan on using permanently. For example: nats.example.com. Your domain must be Web-accessible before we start installing NATS.

Note: Make sure that your installation of NATS is on its own unique domain name. If NATS shares its domain name with any other site or content that uses cookies to store information, you will run into issues.

For example, if your site's domain name is www.example.com, your NATS installation should be located on another domain, such as www.examplecash.com

We also require secure shell (SSH) access. Please give us access to the same account you use to log in to the server. The account must be allowed to create files and folders in your user directory and replace the Apache VirtualHost directory with a symlink to your user directory. The user account must also be able to create a crontab entry.

Please create a new database in the current MySQL server. Grant all access to that database to a username and password of your choosing. Commands to create a database and grant all access to a specific user can be found in the MySQL documentation.

Please remove any server administration software. Server administration software might break NATS. We cannot support NATS issues arising from the interaction with server administration software.

Dedicated Server Required

For numerous reasons, NATS will not be installed on a shared server (this includes VPS systems). Performance issues, load issues, permissions issues, and directory restriction issues are just some of the potential reasons why it has been determined that NATS installations on a shared server cannot realistically be done. It's also common that shared servers will use control panel programs and/or have too many restrictions on functionality to operate properly or predictably.

Installation Information

After you server meets the above requirements, please reply to your install ticket saying that you have met the requirements and have the following information ready when we contact you:

  • The SSH server IP or host address
  • The SSH username
  • The SSH password
  • The SSH port
  • The MySQL host name (even if its localhost, please specify)
  • The MySQL database name
  • The MySQL username
  • The MySQL password
  • The NATS admin and affiliate area domain
  • Note: The document root cannot be a sub directory of another domain. Example, you have your domain, www.somesite.com, nats can be installed under nats.somesite.com, but cannot be installed under www.somesite.com/nats/
  • The Apache document root for the above domain
    • Please give us written permission to overwrite the contents of this directory
  • What type of encoding to use: Ioncube

We will email the above instructions to you after you purchase NATS. Please contact us if you have any questions even before your installation begins. You host can help you with any questions you have about the software on this list.