Difference between revisions of "TheSchwartz Setup"

From Dreamwidth Notes
Jump to: navigation, search
(make it clear that these instructions don't apply to dreamhacks)
(On your own install: Fixing up the TheSchwartz setup.)
Line 13: Line 13:
 
                 dsn => 'dbi:mysql:dw_schwartz;host=localhost',
 
                 dsn => 'dbi:mysql:dw_schwartz;host=localhost',
 
                 user => 'dw',
 
                 user => 'dw',
                 pass => $DW::PRIVATE::THESCHWARTZ_DBS{pass},
+
                 pass => 'password',     # CHANGETHIS
 
             },
 
             },
 
         );
 
         );
 
</source>
 
</source>
  
In this block of code, ''dw_schwartz'' represents the database name used by TheSchwartz, and ''dw'' represents the username. If you wish, you can change these to different values - but it's probably best not to use the same database as your main Dreamwidth installation uses, just in case.
+
In this block of code, ''dw_schwartz'' represents the database name used by TheSchwartz, and ''dw'' represents the username. If you wish, you can change these to different values - but it's probably best not to use the same database as your main Dreamwidth installation uses, just in case. You should change the 'password' setting to a new database password used only for TheSchwartz.
  
(The rest of this page assumes that you're not changing these values.)
+
(The rest of this page assumes that you're not changing the database name and username.)
  
You first need to create the database. Run the following two commands, changing ''databasepass'' to whatever password you wish, and entering the MySQL root password when prompted:
+
You then need to create the database. Run the following two commands, changing ''databasepass'' to the password you created above, and entering the MySQL root password when prompted:
  
 
<source lang="bash">
 
<source lang="bash">
Line 29: Line 29:
 
</source>
 
</source>
  
Then, initialise the database, again entering the MySQL root password when prompted:
+
Then, initialise the database, entering the MySQL root password when prompted:
  
 
<source lang="bash">
 
<source lang="bash">
 
mysql -uroot -p dw_schwartz < $LJHOME/cvs/TheSchwartz/doc/schema.sql
 
mysql -uroot -p dw_schwartz < $LJHOME/cvs/TheSchwartz/doc/schema.sql
</source>
 
 
Finally, edit <code>etc/config-private.pl</code>, uncomment the <var>%THESCHWARTZ_DBS</var> block, and enter your database password before the comma, in single quotes:
 
 
<source lang="perl">
 
    %THESCHWARTZ_DBS = (
 
        pass => 'databasepass',
 
    );
 
 
</source>
 
</source>
  

Revision as of 21:13, 29 September 2010

Expand: What jobs need to be run?

To run any jobs that require queueing, such as the journal content importer and the sending of email (if you have email set up to send through TheSchwartz), you'll need to set up TheSchwartz. This requires that you set up the database and define it in etc/config-local.pl.

On your own install

In etc/config-local.pl, find the following block of code:

    # Schwartz DB configuration
    @THESCHWARTZ_DBS = (
            {
                dsn => 'dbi:mysql:dw_schwartz;host=localhost',
                user => 'dw',
                pass => 'password',     # CHANGETHIS
            },
        );

In this block of code, dw_schwartz represents the database name used by TheSchwartz, and dw represents the username. If you wish, you can change these to different values - but it's probably best not to use the same database as your main Dreamwidth installation uses, just in case. You should change the 'password' setting to a new database password used only for TheSchwartz.

(The rest of this page assumes that you're not changing the database name and username.)

You then need to create the database. Run the following two commands, changing databasepass to the password you created above, and entering the MySQL root password when prompted:

echo "create database dw_schwartz" | mysql -uroot -p
echo "grant all on dw_schwartz.* to 'dw'@'localhost' identified by 'databasepass'" | mysql -uroot -p

Then, initialise the database, entering the MySQL root password when prompted:

mysql -uroot -p dw_schwartz < $LJHOME/cvs/TheSchwartz/doc/schema.sql

The initial setup of TheSchwartz is now complete. To actually *use* TheSchwartz you'll need to run the worker for whatever jobs you need, and in the case of the importer you'll need to run the import scheduler too. More information on using the importer can be found at Importer Testing.

On a Dreamhack

To set up TheSchwartz on a Dreamhack, see Dreamhack getting started.

Note: Until this guide is better filled out, a lot of stuff can be run with $LJHOME/bin/worker-manager --debug