Labs/Weave/User/1/Setup - Revision history

Telliott at 00:56, 3 March 2010

2010-03-03T00:56:57Z

← Older revision		Revision as of 00:56, 3 March 2010
Line 1:		Line 1:
	You want [[/Labs/Weave/User/1.0/Setup]]		You want [[Labs/Weave/User/1.0/Setup]]

Telliott: Replaced content with 'You want /Labs/Weave/User/1.0/Setup'

2010-03-03T00:56:24Z

Replaced content with 'You want /Labs/Weave/User/1.0/Setup'

← Older revision		Revision as of 00:56, 3 March 2010
Line 1:		Line 1:
	You want [/Labs/Weave/User/1.0/Setup ~~User Setup]~~		You want [[/Labs/Weave/User/1.0/Setup]]

	~~'''It is strongly recommended that you use the [[http://tobyelliott.wordpress.com/2009/09/11/weave-minimal-server Weave Minimal Server]~~] ~~rather than a full install.'''~~
	~~== Pre-Setup Considerations ==~~

	It is strongly recommended that the Weave User Server be set up under https, or behind a firewall with an https proxy in front of it. It uses standard http auth (implemented in the code), which will send the password in the clear unless done over https.

	~~The Weave Server requires PHP with PDO and JSON support installed. This should be the case if you are running PHP 5.1+. PDO will need drivers for whatever storage and authentications engines are used.~~

	~~WebDav must not be enabled for this server - it intercepts some of the http packets and syncing will fail.~~

	~~== Setting up the Server ==~~

	1) You can get the latest server from http://hg.mozilla.org/labs/weaveserver (there you can download it in different formats). Once things are fully established, we'll declare certain builds as stable, but for now assume all releases are beta quality. Unzip it into your html tree.

	~~2) Edit your apache conf files to add the following:~~

	~~<pre>~~
	~~Alias /user/1 <full path to weave directory>/server/user/1/index.php~~
	~~</pre>~~

	~~3) Copy /server/user/1/weave_user_constants.php.dist to weave_user_constants.php and edit it as described below.~~

	~~== Setting up Weave Authentication ==~~

	~~In weave_user_constants.php~~
	~~<pre>~~
	~~define('WEAVE_AUTH_ENGINE', '[sqlite\|mysql\|ldap\|none~~]~~');~~
	~~</pre>~~

	~~so for example~~

	~~<pre>~~
	~~define('WEAVE_AUTH_ENGINE', 'mysql');~~
	~~</pre>~~

	~~=== Sqlite ===~~

	~~<pre>~~
	~~define('WEAVE_SQLITE_AUTH_DIRECTORY', '<path to stores directory>');~~
	~~</pre>~~

	~~additionally, create the users table~~

	~~<pre>~~
	~~$ sqlite3 <path to stores directory>/_users~~
	~~SQLite version 3.4.0~~
	~~sqlite> create table users (username text primary key, md5 text, email text, status integer, location text, alert text);~~
	~~sqlite> .quit~~
	~~</pre>~~

	~~Change the owner of the _users db file to the account your webserver runs under.~~

	~~=== Mysql ===~~

	~~Create the mysql database. Add the following tables:~~

	~~<pre>~~
	~~CREATE TABLE `users` (~~
	~~id int(11) NOT NULL PRIMARY KEY auto_increment,~~
	~~username varbinary(32) NOT NULL,~~
	~~md5 varbinary(32) default NULL,~~
	~~email varbinary(64) default NULL,~~
	~~location text,~~
	~~status tinyint(4) default '1',~~
	~~alert text~~
	~~) ENGINE=InnoDB;</pre>~~

	~~Constants:~~

	~~<pre>~~
	~~define('WEAVE_MYSQL_AUTH_HOST', '<db host>');~~
	~~define('WEAVE_MYSQL_AUTH_DB', '<db name>');~~
	~~define('WEAVE_MYSQL_AUTH_USER', '<db username>');~~
	~~define('WEAVE_MYSQL_AUTH_PASS', '<db password>');~~
	~~</pre>~~

	~~(Note that you don't need to define the second set of constants if you are using the same db for reads and writes)~~

	~~You can create users directly in mysql with the following command:~~

	~~<pre>~~
	~~insert into users (username, md5, status) values ('username', md5('password'), 1);~~
	~~</pre>~~

	~~But it is recommended to use the create_user.pl script after setting up the admin-interface (see below).~~

	~~== Captcha ==~~

	If you wish to use a captcha for your account creation, you will need to get yourself a public key and private key from http://recaptcha.net/. Put those keys in the weave_user_constants.php file and change WEAVE_REGISTER_USE_CAPTCHA to 1. Also copy /server/misc/1/weave_misc_constants.php.dist to weave_misc_constants.php and add your keys there as well.

	~~To serve up the captchas, use the~~
	~~<pre>~~
	~~Alias /misc/1/captcha_html <full path to weave directory>/server/misc/1/captcha.php~~
	~~</pre>~~

	~~== Admin Access ==~~

	~~If you want to be able to programmatically create and delete accounts, you will need to enable the secret for the machine and change it from null~~
	~~<pre>~~
	~~if (!defined('WEAVE_REGISTER_ADMIN_SECRET')) { define('WEAVE_REGISTER_ADMIN_SECRET', null); }~~
	~~</pre>~~

	~~this will enable you to pass a secret as an 'X-Weave-Secret' header that overrides captcha and auth requirements.~~

	~~Accounts can be created, passwords changed and accounts deleted through the create_user.pl script. Make sure to change the constants in the header to match your local install.~~

	~~==Editing the Client==~~
	~~In about:config, set extensions.weave.ServerUrl to https://servername/user~~

Telliott at 00:55, 3 March 2010

2010-03-03T00:55:34Z

← Older revision		Revision as of 00:55, 3 March 2010
Line 1:		Line 1:
	[~~https://wiki.mozilla.org~~/Labs/Weave/~~Sync~~/1.0/Setup ~~Setting up Weave Sync~~]		You want [/Labs/Weave/User/1.0/Setup User Setup]

	'''It is strongly recommended that you use the [[http://tobyelliott.wordpress.com/2009/09/11/weave-minimal-server Weave Minimal Server]] rather than a full install.'''		'''It is strongly recommended that you use the [[http://tobyelliott.wordpress.com/2009/09/11/weave-minimal-server Weave Minimal Server]] rather than a full install.'''

Telliott: /* Mysql */

2009-11-14T00:14:50Z

Mysql

← Older revision		Revision as of 00:14, 14 November 2009
Line 63:		Line 63:
	email varbinary(64) default NULL,		email varbinary(64) default NULL,
	location text,		location text,
	~~shard varbinary(32) default NULL,~~
	status tinyint(4) default '1',		status tinyint(4) default '1',
	alert text		alert text

Iav: /* Mysql typo */

2009-11-13T19:08:08Z

Mysql typo

← Older revision		Revision as of 19:08, 13 November 2009
Line 65:		Line 65:
	shard varbinary(32) default NULL,		shard varbinary(32) default NULL,
	status tinyint(4) default '1',		status tinyint(4) default '1',
	alert text,		alert text
	) ENGINE=InnoDB;</pre>		) ENGINE=InnoDB;</pre>

Telliott at 19:04, 13 November 2009

2009-11-13T19:04:17Z

← Older revision		Revision as of 19:04, 13 November 2009
Line 1:		Line 1:
	[https://wiki.mozilla.org/Labs/Weave/Sync/0.5/Setup Setting up Weave Sync]		[https://wiki.mozilla.org/Labs/Weave/Sync/1.0/Setup Setting up Weave Sync]

	'''It is strongly recommended that you use the [[http://tobyelliott.wordpress.com/2009/09/11/weave-minimal-server Weave Minimal Server]] rather than a full install.'''		'''It is strongly recommended that you use the [[http://tobyelliott.wordpress.com/2009/09/11/weave-minimal-server Weave Minimal Server]] rather than a full install.'''

Telliott: /* Pre-Setup Considerations */

2009-11-13T19:03:07Z

Pre-Setup Considerations

← Older revision		Revision as of 19:03, 13 November 2009
Line 4:		Line 4:
	== Pre-Setup Considerations ==		== Pre-Setup Considerations ==

	It is strongly recommended that the Weave User Server be set up under https, or behind a firewall with an https proxy in front of it. It uses standard http auth, which will send the password in the clear unless done over https.		It is strongly recommended that the Weave User Server be set up under https, or behind a firewall with an https proxy in front of it. It uses standard http auth (implemented in the code), which will send the password in the clear unless done over https.

	The Weave Server requires PHP with PDO and JSON support installed. This should be the case if you are running PHP 5.1+. PDO will need drivers for whatever storage and authentications engines are used.		The Weave Server requires PHP with PDO and JSON support installed. This should be the case if you are running PHP 5.1+. PDO will need drivers for whatever storage and authentications engines are used.

Telliott at 19:02, 13 November 2009

2009-11-13T19:02:02Z

← Older revision		Revision as of 19:02, 13 November 2009
Line 1:		Line 1:
	[https://wiki.mozilla.org/Labs/Weave/0.5/Setup~~/Storage~~ Setting up Weave ~~Storage~~]		[https://wiki.mozilla.org/Labs/Weave/Sync/0.5/Setup Setting up Weave Sync]

	'''It is strongly recommended that you use the [[http://tobyelliott.wordpress.com/2009/09/11/weave-minimal-server Weave Minimal Server]] rather than a full install.'''		'''It is strongly recommended that you use the [[http://tobyelliott.wordpress.com/2009/09/11/weave-minimal-server Weave Minimal Server]] rather than a full install.'''

Telliott: /* Mysql */

2009-11-13T18:38:18Z

Mysql

← Older revision		Revision as of 18:38, 13 November 2009
Line 57:		Line 57:

	<pre>		<pre>
	~~create table~~ users		CREATE TABLE `users` (
	(		id int(11) NOT NULL PRIMARY KEY auto_increment,
	username ~~varchar~~(32) ~~primary key~~,		username varbinary(32) NOT NULL,
	md5 varbinary(32),		md5 varbinary(32) default NULL,
	email varbinary(64),		email varbinary(64) default NULL,
	status tinyint,		location text,
	~~location~~ text,		shard varbinary(32) default NULL,
	~~alert text~~		status tinyint(4) default '1',
	) ~~engine~~=InnoDB;		alert text,
	</pre>		) ENGINE=InnoDB;</pre>

	Constants:		Constants:
Line 82:		Line 82:

	<pre>		<pre>
	insert into users values ('username', md5('password')~~, null~~, 1~~, null~~);		insert into users (username, md5, status) values ('username', md5('password'), 1);
	</pre>		</pre>

Telliott at 18:32, 13 November 2009

2009-11-13T18:32:25Z

← Older revision		Revision as of 18:32, 13 November 2009
Line 1:		Line 1:
	[https://wiki.mozilla.org/Labs/Weave/0.5/Setup/Storage Setting up Weave Storage]		[https://wiki.mozilla.org/Labs/Weave/0.5/Setup/Storage Setting up Weave Storage]

	'''It is ~~stringly~~ recommended that you use the ~~<a href="~~http://tobyelliott.wordpress.com/2009/09/11/weave-minimal-server~~/">~~Weave Minimal Server~~</a>~~ rather than a full install.'''		'''It is strongly recommended that you use the [[http://tobyelliott.wordpress.com/2009/09/11/weave-minimal-server Weave Minimal Server]] rather than a full install.'''
	== Pre-Setup Considerations ==		== Pre-Setup Considerations ==