MOSS/Distribution Specific Instructions - Revision history

Cjkelly1: Add link to Ubuntu Server download page to test wiki captcha

2019-02-21T02:38:03Z

Add link to Ubuntu Server download page to test wiki captcha

Cjkelly1 at 01:53, 18 February 2019

2019-02-18T01:53:02Z

Cjkelly1: add apt commands to add repositories

2018-12-22T23:26:44Z

add apt commands to add repositories

Cjkelly1 at 21:24, 24 November 2018

2018-11-24T21:24:46Z

Christian Walther: /* Prerequesites */ Note on OpenSSL on Mac OS X 10.4 (in case anyone else is crazy enough to install on that old system)

2012-04-02T20:13:07Z

Prerequesites: Note on OpenSSL on Mac OS X 10.4 (in case anyone else is crazy enough to install on that old system)

Christian Walther: /* Mac OS X */ Remove obsolete uncertainty declaration.

2012-04-02T20:02:53Z

Mac OS X: Remove obsolete uncertainty declaration.

Mac Fife: /* See Also */ Add more links

2012-03-09T08:01:00Z

Mac Fife: Bypass redirects

2012-02-21T13:09:07Z

Bypass redirects

Mac Fife: moved MOSS-Distribution Specific Instructions to MOSS/Distribution Specific Instructions: Subdoc convention

2012-02-21T12:56:47Z

moved MOSS-Distribution Specific Instructions to MOSS/Distribution Specific Instructions: Subdoc convention

Lyrositor at 03:37, 21 February 2012

2012-02-21T03:37:04Z

@@ Line 6: / Line 6: @@
 It is recommend to install MOSS only on Server LTS releases of Ubuntu for increased stability and reliability.
-'''Current Ubuntu Server LTS version:''' Ubuntu 18.04.1 LTS.
+'''[https://www.ubuntu.com/download/server Ubuntu Server LTS version]:''' Current tested version: Ubuntu 18.04.1 LTS.
 === Compile ===

@@ Line 2: / Line 2: @@
 == Linux - Ubuntu ==
-Installing MOSS on [http://www.ubuntu.com Ubuntu] is comparatively easy, and very few changes need to be made to the default instructions. In fact, what follows is mostly just applying general instructions to the specifics of this Linux distribution. Please note however that this does not provide full instructions for installation, as MOSS-Setup does a more-than-decent job of it already.
+Installing MOSS on [http://www.ubuntu.com Ubuntu] is comparatively easy, and very few changes need to be made to the default instructions. In fact, what follows is mostly just applying general instructions to the specifics of this Linux distribution. Please note however that this does not provide full instructions for installation, as [[MOSS-Setup]] does a more-than-decent job of it already.
 It is recommend to install MOSS only on Server LTS releases of Ubuntu for increased stability and reliability.

@@ Line 14: / Line 14: @@
 The programs listed on the main setup page are all conveniently available using APT.
-# Add the "restricted" and "universe" repositories to your "sources.list" file if they are not already there and do <code>sudo apt-get update</code>.
+# Add the "restricted" and "universe" repositories to your "sources.list" file if they are not already there and update the APT cache using the following commands.
 # Run this command to install the prerequisites:
   sudo apt-get install libssl-dev postgresql postgresql-server-dev-all libpqxx-dev autoconf libtool zlib1g-dev unzip

@@ Line 6: / Line 6: @@
 It is recommend to install MOSS only on Server LTS releases of Ubuntu for increased stability and reliability.
-'''Current Ubuntu Server LTS version:''' Ubuntu 10.04.4 LTS.
+'''Current Ubuntu Server LTS version:''' Ubuntu 18.04.1 LTS.
 === Compile ===
@@ Line 12: / Line 12: @@
 ==== Prerequisites ====
-The programs listed on the main setup page are all conveniently available using APT. Running this command should be sufficient:
+The programs listed on the main setup page are all conveniently available using APT.
-  sudo apt-get install libssl-dev postgresql postgresql-server-dev-8.4 libpqxx-dev g++ autoconf automake libtool
 If you also need to clone a Mercurial repository snapshot, you need to install Mercurial through the following command:
   sudo apt-get install mercurial
 ==== configure ====
-By default in Ubuntu, MOSS will be installed under <code>/usr/local</code>. If you prefer another location (such as the home directory of the user who will run MOSS), be sure to specify with the '''--prefix''' option.
+By default in Ubuntu, MOSS will be installed under <code>/usr/local</code>. If you prefer another location (such as the home directory of the user who will run MOSS), be sure to specify with the '''--prefix''' option.  I also recommended to use the '''--enable-fast-download''' option, as the zero seconds bug does not exist in MOSS.
 ==== Compile ====
@@ Line 28: / Line 30: @@
 '''PostgreSQL module:''' assuming you run <code>sudo make install</code>, the PostgreSQL module should automatically be copied over to your PostgreSQL directory. Make sure to restart PostgreSQL with the following command:
-  sudo service postgresql-8.4 restart
+  sudo service postgresql restart
 === Set Up the Database ===

← Older revision		Revision as of 20:13, 2 April 2012
Line 80:		Line 80:

	The last line above should cause the server to start on reboot. Don't reboot yet - proceed to the database setup instructions where there are more steps you'll want to complete before starting the server.		The last line above should cause the server to start on reboot. Don't reboot yet - proceed to the database setup instructions where there are more steps you'll want to complete before starting the server.
		+
		+	===== Note on OpenSSL on Mac OS X 10.4 =====
		+	If you install OpenSSL from source (this is necessary on Mac OS X 10.4, which ships with an older version (0.9.7) than required), make sure to also build shared libraries (''./config shared''). If you only build static libraries (the default choice), you will run into missing symbol errors, because the Mac OS X linker always prefers shared to static libraries and will therefore try to link to the system-provided shared library instead of the static one that the command line options point to.

	==== configure ====		==== configure ====

← Older revision		Revision as of 20:02, 2 April 2012
Line 43:		Line 43:

	== Mac OS X ==		== Mac OS X ==
−
−	~~Theoretically, Mac OS X (a UNIX-based system) ought to be able to run MOSS. It is however currently unknown whether anyone has achieved this in practice yet.~~

	=== Compile ===		=== Compile ===

@@ Line 173: / Line 173: @@
 == See Also ==
-* [[MOSS/Setup]]
+{{:MOSS/See Also}}
 [[Category:MOSS]]

← Older revision	Revision as of 12:56, 21 February 2012
(No difference)

@@ Line 1: / Line 1: @@
-This document is meant to collect any known distribution-specific instructions for installing [[MOSS]]. For general directions on installation, or if your distribution isn't listed here, you can consult [[MOSS-Setup]]. The general steps described in the main setup article will be detailed for each individual OS or distribution for which documentation has been contributed. Feel free to contribute to the knowledge gathered here by adding information on the subject of your own distribution.
+This document is meant to collect any known distribution-specific instructions for installing [[MOSS]]. For general directions on installation, or if your distribution isn't listed here, you can consult [[MOSS-Setup]]. The general steps described in the main setup article are detailed for each individual OS or distribution for which documentation has been contributed. Feel free to contribute to the knowledge gathered here by adding information on the subject of your own distribution.
 == Linux - Ubuntu ==
@@ Line 6: / Line 6: @@
 It is recommend to install MOSS only on Server LTS releases of Ubuntu for increased stability and reliability.
-'''Current Ubuntu Server LTS version:''' Ubuntu 10.04.3 LTS.
+'''Current Ubuntu Server LTS version:''' Ubuntu 10.04.4 LTS.
 === Compile ===
@@ Line 21: / Line 21: @@
 ==== configure ====
-By default in Ubuntu, MOSS will be installed under <tt>/usr/local</tt>. If you prefer another location (such as the home directory of the user who will run MOSS), be sure to specify with the '''--prefix''' option.
+By default in Ubuntu, MOSS will be installed under <code>/usr/local</code>. If you prefer another location (such as the home directory of the user who will run MOSS), be sure to specify with the '''--prefix''' option.
 ==== Compile ====
-'''MOSS:''' MOSS should compile without any problems. If you are install to a root-owned directory, make sure to use <tt>sudo make install</tt>, unless you rejoice in seeing a permission error message.
+'''MOSS:''' MOSS should compile without any problems. If you are installing to a root-owned directory, make sure to use <code>sudo make install</code>, unless you rejoice in seeing a permission error message.
-'''PostgreSQL module:''' assuming you run <tt>sudo make install</tt>, the PostgreSQL module should automatically be copied over to your PostgreSQL directory. Make sure to restart PostgreSQL with the following command:
+'''PostgreSQL module:''' assuming you run <code>sudo make install</code>, the PostgreSQL module should automatically be copied over to your PostgreSQL directory. Make sure to restart PostgreSQL with the following command:
   sudo service postgresql-8.4 restart
 === Set Up the Database ===
-The default PostgreSQL user in Ubuntu is <tt>postgres</tt>. If you don't change anything, only he is allowed to connect to the database, even if you have created a new role in PostgreSQL. It might therefore be to your advantage to create a new role in PostgreSQL matching the user which will run the server (e.g. moss); to do so:
+The default PostgreSQL user in Ubuntu is <code>postgres</code>. If you don't change anything, only he is allowed to connect to the database, even if you have created a new role in PostgreSQL. It might therefore be to your advantage to create a new role in PostgreSQL matching the user which will run the server (e.g. moss); to do so:
   sudo -u postgres createuser -l $USER
-Which will automatically create a new role with the same name as your current user. You can now edit SQL tables you have access to without su-ing to the postgres user (don't remember to change all appropriate moss configuration files, as detailed below).
+Which will automatically create a new role with the same name as your current user. You can now edit SQL tables you have access to without su-ing to the postgres user (don't forget to change all appropriate moss configuration files, as detailed below).
 Now you can follow all other instructions as detailed in the main setup instructions.
@@ Line 40: / Line 40: @@
 === Configuration Files ===
-When setting up <tt>moss_backend.cfg</tt>, make sure you specify a PostgreSQL role with read and write access to your database (this can be same user as the one who will run MOSS, already authorized of access if you followed the previous recommendations).
+When setting up <code>moss_backend.cfg</code>, make sure you specify a PostgreSQL role with read and write access to your database (this can be same user as the one who will run MOSS, already authorized of access if you followed the previous recommendations).
 == Mac OS X ==
@@ Line 50: / Line 50: @@
 ==== Prerequesites ====
-First, you will need the Mac OS X [https://developer.apple.com/technologies/tools/ Developer Tools] installed.
+First, you need the Mac OS X [https://developer.apple.com/technologies/tools/ Developer Tools] installed.
-Second, you will need to install <tt>libpqxx</tt>, <tt>zlib</tt>, and <tt>postgresql</tt>. You can use [http://www.macports.org/ MacPorts] to install as follows:
+Second, you need to install <code>libpqxx</code>, <code>zlib</code>, and <code>postgresql</code>. You can use [http://www.macports.org/ MacPorts] to install as follows:
   sudo port install libpqxx zlib postgresql84 postgresql84-server
-Some instruction guides for installing PostgreSQL (such as the README for EnterpriseDB's version) suggest editing <tt>/etc/sysctl.conf</tt> and increasing the shmall setting from the default (8192 under Mac OS X 10.6, exactly 1/4096th of shmmax).  Whatever number you choose for shmall, it should be (a) smaller than shmmax, and (b) divisible by 4096. For example, a valid value might be:
+Some instruction guides for installing PostgreSQL (such as the README for EnterpriseDB's version) suggest editing <code>/etc/sysctl.conf</code> and increasing the shmall setting from the default (8192 under Mac OS X 10.6, exactly 1/4096th of shmmax).  Whatever number you choose for shmall, it should be (a) smaller than shmmax, and (b) divisible by 4096. For example, a valid value might be:
   kern.sysv.shmall=65536
@@ Line 75: / Line 75: @@
   sudo dscl . -create /Groups/postgres Password \*
-The following instructions must be performed after installing PostgreSQL. If the <tt>chown</tt> step fails, then you're probably missing the user and group settings indicated above.
+The following instructions must be performed after installing PostgreSQL. If the <code>chown</code> step fails, then you're probably missing the user and group settings indicated above.
   sudo mkdir -p /opt/local/var/db/postgresql84/defaultdb
   sudo chown -R postgres:postgres /opt/local/var/db/postgresql84
@@ Line 85: / Line 85: @@
 ==== configure ====
-The bootstrap.sh file does not currently work because <tt>libtoolize</tt> is named <tt>glibtoolize</tt> under Mac OS X. A patch has been submitted. With the patched boostrap, you'll just need to <code>export LIBTOOLIZE=glibtoolize</code>.
+The bootstrap.sh file does not currently work because <code>libtoolize</code> is named <code>glibtoolize</code> under Mac OS X. A patch has been submitted. With the patched boostrap, you'll just need to <code>export LIBTOOLIZE=glibtoolize</code>.
 If you installed PostgreSQL and libpqxx from MacPorts, your configure command line will need to look like this:
@@ Line 103: / Line 103: @@
 === Set Up the Database ===
-Copy <tt>moss_uuidgen.so</tt> to <tt>/opt/local/lib/postgresql84/</tt>. From the root of your MOSS build tree:
+Copy <code>moss_uuidgen.so</code> to <code>/opt/local/lib/postgresql84/</code>. From the root of your MOSS build tree:
   sudo cp postgresql/moss_uuidgen.so /opt/local/lib/postgresql84/
-Now you'll need to start the server.  The <tt>&</tt> will background the process:
+Now you need to start the server.  The <code>&</code> backgrounds the process:
   sudo su postgres -c '/opt/local/lib/postgresql84/bin/postgres -D /opt/local/var/db/postgresql84/defaultdb' &
-The database user is postgres.  Start <tt>psql</tt>, the postgreSQL command line interface, as user postgres:
+The database user is postgres.  Start <code>psql</code>, the postgreSQL command line interface, as user postgres:
   sudo su -m postgres -c "/opt/local/lib/postgresql84/bin/psql postgres"
@@ Line 137: / Line 137: @@
 ==== Prerequesites ====
-Only PostgreSQL and the autotools are needed. You can build the packages or use the prebuilt packages with <tt>pkg_add</tt>.
+Only PostgreSQL and the autotools are needed. You can build the packages or use the prebuilt packages with <code>pkg_add</code>.
   pkg_add automake
   pkg_add libtool
   pkg_add libpqxx
-I recommend starting with <tt>libpqxx</tt> because it seems to lag the postgresql-client package, and installing libpqxx will get the correct client.
+I recommend starting with <code>libpqxx</code> because it seems to lag the postgresql-client package, and installing libpqxx will get the correct client.
   pkg_add postgresqlNN-server
 Where "NN" is the version number to match the client installed for pqxx.
@@ Line 152: / Line 152: @@
 === Set Up the Database ===
-Copy <tt>moss_uuidgen.so</tt> to <tt>/usr/pkg/lib/postgresql/</tt>
+Copy <code>moss_uuidgen.so</code> to <code>/usr/pkg/lib/postgresql/</code>
-The database user is <tt>pgsql</tt>. It has root access to the DB by default. Connect from localhost (the default).
+The database user is <code>pgsql</code>. It has root access to the DB by default. Connect from localhost (the default).
 Create the database:
@@ Line 164: / Line 164: @@
   su -m pgsql -c "psql postgres -f moss.sql"
-Then set "db_user = moss" in <tt>moss_backend.cfg</tt>.
+Then set "db_user = moss" in <code>moss_backend.cfg</code>.
 == Solaris ==
@@ Line 171: / Line 171: @@
 Substantial customizations need to be applied to MOSS in order for it to be installed on Solaris. Examples of Solaris installations of MOSS include the Minkata shard.
 == See Also ==
 * [[MOSS-Setup]]
 [[Category:MOSS]]