[jboss-svn-commits] JBL Code SVN: r34942 - in labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide: en-US and 1 other directory.
jboss-svn-commits at lists.jboss.org
jboss-svn-commits at lists.jboss.org
Wed Sep 1 00:59:35 EDT 2010
Author: misty at redhat.com
Date: 2010-09-01 00:59:35 -0400 (Wed, 01 Sep 2010)
New Revision: 34942
Added:
labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/output.zip
Modified:
labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Additional_JAR_Requirements.xml
labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/ArjunaCore_Installation_Guide.xml
labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Logging.xml
labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/ObjectStore_Management.xml
labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Operating_System_Services.xml
labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Preparing_Your_System.xml
labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Revision_History.xml
labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Setting_Properties.xml
labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/publican.cfg
Log:
ArjunaCore Installation Guide converted to Docbook. Deliverables in output.zip
Modified: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Additional_JAR_Requirements.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Additional_JAR_Requirements.xml 2010-09-01 03:44:30 UTC (rev 34941)
+++ labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Additional_JAR_Requirements.xml 2010-09-01 04:59:35 UTC (rev 34942)
@@ -3,31 +3,10 @@
<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaCore_Installation_Guide.ent">
%BOOK_ENTITIES;
]>
-<chapter id="chap-ArjunaCore_Installation_Guide-Test_Chapter">
- <title>Test Chapter</title>
- <para>
- This is a test paragraph
- </para>
- <section id="sect-ArjunaCore_Installation_Guide-Test_Chapter-Test_Section_1">
- <title>Test Section 1</title>
- <para>
- This is a test paragraph in a section
- </para>
- </section>
-
- <section id="sect-ArjunaCore_Installation_Guide-Test_Chapter-Test_Section_2">
- <title>Test Section 2</title>
- <para>
- This is a test paragraph in Section 2
- <orderedlist>
- <listitem>
- <para>
- listitem text
- </para>
- </listitem>
- </orderedlist>
- </para>
- </section>
-
+<chapter>
+ <title>Additional JAR Requirements</title>
+ <para>
+ To use all of the facilities available within ArjunaCore, you need to add all of the JAR files contained in the <filename>lib/</filename> directory of the distribution to the <varname>CLASSPATH</varname>.
+ </para>
</chapter>
Modified: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/ArjunaCore_Installation_Guide.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/ArjunaCore_Installation_Guide.xml 2010-09-01 03:44:30 UTC (rev 34941)
+++ labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/ArjunaCore_Installation_Guide.xml 2010-09-01 04:59:35 UTC (rev 34942)
@@ -9,9 +9,6 @@
<!-- <xi:include href="Chapter.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
<xi:include href="Preparing_Your_System.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Operating_System_Services.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Installing_and_Uninstalling.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Windows.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="UNIX.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Logging.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="ObjectStore_Management.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Additional_JAR_Requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
Modified: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Logging.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Logging.xml 2010-09-01 03:44:30 UTC (rev 34941)
+++ labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Logging.xml 2010-09-01 04:59:35 UTC (rev 34942)
@@ -3,31 +3,31 @@
<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaCore_Installation_Guide.ent">
%BOOK_ENTITIES;
]>
-<chapter id="chap-ArjunaCore_Installation_Guide-Test_Chapter">
- <title>Test Chapter</title>
+<chapter>
+ <title>Logging</title>
+ <para>
+ The recovery manager and the transaction server services produce log files which are located in the <filename>services/logs/</filename> directory. Two log files are created per service.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term><filename><replaceable>service-name</replaceable>-service.log</filename></term>
+ <listitem>
<para>
- This is a test paragraph
+ Contains information regarding whether the service is stopped, started, restarted, or in another state.
</para>
- <section id="sect-ArjunaCore_Installation_Guide-Test_Chapter-Test_Section_1">
- <title>Test Section 1</title>
- <para>
- This is a test paragraph in a section
- </para>
- </section>
-
- <section id="sect-ArjunaCore_Installation_Guide-Test_Chapter-Test_Section_2">
- <title>Test Section 2</title>
- <para>
- This is a test paragraph in Section 2
- <orderedlist>
- <listitem>
- <para>
- listitem text
- </para>
- </listitem>
- </orderedlist>
- </para>
- </section>
-
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><filename><replaceable>service-name</replaceable>.log</filename></term>
+ <listitem>
+ <para>
+ Contains information logged from the actual service.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ To configure what information is logged in these files, edit the appropriate LOG4J configuration files located in <filename>services/config/</filename>.
+ </para>
</chapter>
Modified: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/ObjectStore_Management.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/ObjectStore_Management.xml 2010-09-01 03:44:30 UTC (rev 34941)
+++ labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/ObjectStore_Management.xml 2010-09-01 04:59:35 UTC (rev 34942)
@@ -3,31 +3,24 @@
<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaCore_Installation_Guide.ent">
%BOOK_ENTITIES;
]>
-<chapter id="chap-ArjunaCore_Installation_Guide-Test_Chapter">
- <title>Test Chapter</title>
- <para>
- This is a test paragraph
- </para>
- <section id="sect-ArjunaCore_Installation_Guide-Test_Chapter-Test_Section_1">
- <title>Test Section 1</title>
- <para>
- This is a test paragraph in a section
- </para>
- </section>
-
- <section id="sect-ArjunaCore_Installation_Guide-Test_Chapter-Test_Section_2">
- <title>Test Section 2</title>
- <para>
- This is a test paragraph in Section 2
- <orderedlist>
- <listitem>
- <para>
- listitem text
- </para>
- </listitem>
- </orderedlist>
- </para>
- </section>
-
+<chapter>
+ <title>ObjectStore Management</title>
+ <para>
+ Within the transaction service installation, the object store is updated
+ regularly whenever transactions are created, or when
+ <application>Transactional Objects for Java</application> is used. In a
+ failure-free environment, the only object states which should reside within
+ the object store are those which represent objects created with the
+ <application>Transactional Objects for Java</application> API.
+ </para>
+ <para>
+ If failures occur, transaction logs may remain in the object store until
+ crash recovery facilities resolve the transactions the logs represent. As
+ such, it is very important not to delete the contents of the object store
+ without due care and attention. Without the relevant logs, it is impossible
+ to resolve in-doubt transactions. In addition, if multiple users share the
+ same object store, they must exercise caution, and never delete the contents
+ of the object store if anyone else is using the object store.
+ </para>
</chapter>
Modified: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Operating_System_Services.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Operating_System_Services.xml 2010-09-01 03:44:30 UTC (rev 34941)
+++ labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Operating_System_Services.xml 2010-09-01 04:59:35 UTC (rev 34942)
@@ -3,31 +3,159 @@
<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaCore_Installation_Guide.ent">
%BOOK_ENTITIES;
]>
-<chapter id="chap-ArjunaCore_Installation_Guide-Test_Chapter">
- <title>Test Chapter</title>
+<chapter>
+ <title>Operating System Services</title>
+
+ <section>
+ <title>Microsoft Windows Server</title>
+ <para>
+ Four scripts, located in the <filename>Services\bin\windows</filename> folder, install and uninstall the recovery manager and transaction server services.
+ </para>
+ <variablelist>
+ <title>Installation Scripts for Microsoft Windows</title>
+ <varlistentry>
+ <term>Recovery Manager Service</term>
+ <listitem><para><filename>InstallRecoveryManagerService-NT.bat</filename></para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Transaction Server</term>
+ <listitem><para><filename>InstallTransactionServiceService-NT.bat</filename></para></listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <title>Uninstallation Scripts for Microsoft Windows</title>
+ <varlistentry>
+ <term>Recovery Manager Service</term>
+ <listitem><para><filename>UninstallRecoveryManagerService-NT.bat</filename></para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Transaction Server</term>
+ <listitem><para><filename>UninstallTransactionServerService-NT.bat</filename></para></listitem>
+ </varlistentry>
+ </variablelist>
+ <note>
+ <para>
+ Each of the scripts requires administrative privileges.
+ </para>
+ </note>
+ <para>
+ After running any of the scripts, a status message indicates success or failure.
+ </para>
+
+ </section>
+
+ <section>
+ <title>Linux / UNIX</title>
+
+ <procedure>
+ <title>Installing Services in Linux / UNIX</title>
+ <step>
+ <title>Log into the system with <systemitem>root</systemitem> privileges.</title>
<para>
- This is a test paragraph
+ The installer needs these privileges to create files in <filename>/etc</filename>.
</para>
- <section id="sect-ArjunaCore_Installation_Guide-Test_Chapter-Test_Section_1">
- <title>Test Section 1</title>
- <para>
- This is a test paragraph in a section
- </para>
- </section>
-
- <section id="sect-ArjunaCore_Installation_Guide-Test_Chapter-Test_Section_2">
- <title>Test Section 2</title>
- <para>
- This is a test paragraph in Section 2
- <orderedlist>
- <listitem>
- <para>
- listitem text
- </para>
- </listitem>
- </orderedlist>
- </para>
- </section>
+ </step>
+ <step>
+ <title>Change to <filename><replaceable>JBOSS_HOME</replaceable>/services/installer</filename> directory.</title>
+ <para>
+ <filename><replaceable>JBOSS_HOME</replaceable></filename> refers to the directory where you extracted ArjunaCore.
+ </para>
+ </step>
+ <step>
+ <title>Set the <varname>JAVA_HOME</varname> variable, if necessary.</title>
+ <para>
+ Set the <varname>JAVA_HOME</varname> variable to the <firstterm>base directory</firstterm> of the JVM the service will use. The base directory is the directory above <filename>bin/java</filename>.
+ </para>
+ <substeps>
+ <step>
+ <para>Bash: <command>export JAVA_HOME="/opt/java"</command></para>
+ </step>
+ <step>
+ <para>CSH: <command>setenv JAVA_HOME="/opt/java"</command></para>
+ </step>
+ </substeps>
+ </step>
+ <step>
+ <title>Run the installer script.</title>
+ <para>
+ <command>./install_service.sh</command>
+ </para>
+ </step>
+ <step>
+ <title>The start-up and shut-down scripts are installed.</title>
+ <para>Information similar to the output below is displayed.</para>
+ <screen>
+ Adding $JAVA_HOME (/opt/java) to $PATH in
+ /opt/arjuna/ats-3.2/services/bin/solaris/recoverymanagerservice.sh
+ Adding $JAVA_HOME (/opt/java) to $PATH in
+ /opt/arjuna/ats-3.2/services/bin/solaris/transactionserverservice.sh
+ Installing shutdown scripts into /etc/rcS.d:
+ K01recoverymanagerservice
+ K00transactionserverservice
+ Installing shutdown scripts into /etc/rc0.d:
+ K01recoverymanagerservice
+ K00transactionserverservice
+ Installing shutdown scripts into /etc/rc1.d:
+ K01recoverymanagerservice
+ K00transactionserverservice
+ Installing shutdown scripts into /etc/rc2.d:
+ K01recoverymanagerservice
+ K00transactionserverservice
+ Installing startup scripts into /etc/rc3.d:
+ S98recoverymanagerservice
+ S99transactionserverservice
+ </screen>
+ <para>
+ The start-up and shut-down scripts are installed for each run-level. Depending on your specific operating system, you may need to explicitly enable the services for automatic start-up.
+ </para>
+ </step>
+ </procedure>
+ <procedure>
+ <title>Uninstalling Services in Linux / UNIX</title>
+ <step>
+ <title>Log into the system with <systemitem>root</systemitem> privileges.</title>
+ <para>
+ The installer needs these privileges to delete files in <filename>/etc</filename>.
+ </para>
+ </step>
+ <step>
+ <title>Change to <filename><replaceable>JBOSS_HOME</replaceable>/services/installer</filename> directory.</title>
+ <para>
+ <filename><replaceable>JBOSS_HOME</replaceable></filename> refers to the directory where you extracted ArjunaCore.
+ </para>
+ </step>
+
+ <step>
+ <title>Run the installation script with the <option>-u</option> option.</title>
+ <para>
+ <command>./install_services.sh -u</command>
+ </para>
+ </step>
+ <step>
+ <title>The start-up and shut-down scripts are removed.</title>
+ <para>
+ Messages like the ones below indicate that the start-up and shut-down scripts have been removed successfully.
+ </para>
+ <screen>
+ Removing startup scripts from /etc/rc3.d:
+ S98recoverymanagerservice
+ S99transactionserverservice
+ Removing shutdown scripts from /etc/rcS.d:
+ K01recoverymanagerservice
+ K00transactionserverservice
+ Removing shutdown scripts from /etc/rc0.d:
+ K01recoverymanagerservice
+ K00transactionserverservice
+ Removing shutdown scripts from /etc/rc1.d:
+ K01recoverymanagerservice
+ K00transactionserverservice
+ Removing shutdown scripts from /etc/rc2.d:
+ K01recoverymanagerservice
+ K00transactionserverservice
+ </screen>
+ </step>
+ </procedure>
+ </section>
</chapter>
Modified: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Preparing_Your_System.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Preparing_Your_System.xml 2010-09-01 03:44:30 UTC (rev 34941)
+++ labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Preparing_Your_System.xml 2010-09-01 04:59:35 UTC (rev 34942)
@@ -12,6 +12,9 @@
</para>
<step>
<title>Install the distribution into the required location.</title>
+ <para>
+ Typically, the distribution is extracted from a <filename>.ZIP</filename> file.
+ </para>
</step>
<step>
<title>Specify the Location for the Object Store</title>
Modified: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Revision_History.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Revision_History.xml 2010-09-01 03:44:30 UTC (rev 34941)
+++ labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Revision_History.xml 2010-09-01 04:59:35 UTC (rev 34942)
@@ -4,24 +4,24 @@
%BOOK_ENTITIES;
]>
<appendix id="appe-ArjunaCore_Installation_Guide-Revision_History">
- <title>Revision History</title>
- <simpara>
- <revhistory>
- <revision>
- <revnumber>0</revnumber>
- <date>Fri Aug 27 2010</date>
- <author>
- <firstname>Dude</firstname>
- <surname>McPants</surname>
- <email>Dude.McPants at example.com</email>
- </author>
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>1</revnumber>
+ <date>Fri Aug 27 2010</date>
+ <author>
+ <firstname>Misty</firstname>
+ <surname>Stanley-Jones</surname>
+ <email>misty at redhat.com</email>
+ </author>
<revdescription>
- <simplelist>
- <member>Initial creation of book by publican</member>
- </simplelist>
+ <simplelist>
+ <member>Converted guide from .odt to Docbook</member>
+ </simplelist>
</revdescription>
- </revision>
- </revhistory>
- </simpara>
+ </revision>
+ </revhistory>
+ </simpara>
</appendix>
Modified: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Setting_Properties.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Setting_Properties.xml 2010-09-01 03:44:30 UTC (rev 34941)
+++ labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/en-US/Setting_Properties.xml 2010-09-01 04:59:35 UTC (rev 34942)
@@ -4,30 +4,43 @@
%BOOK_ENTITIES;
]>
<chapter id="chap-ArjunaCore_Installation_Guide-Test_Chapter">
- <title>Test Chapter</title>
- <para>
- This is a test paragraph
- </para>
- <section id="sect-ArjunaCore_Installation_Guide-Test_Chapter-Test_Section_1">
- <title>Test Section 1</title>
- <para>
- This is a test paragraph in a section
- </para>
- </section>
-
- <section id="sect-ArjunaCore_Installation_Guide-Test_Chapter-Test_Section_2">
- <title>Test Section 2</title>
- <para>
- This is a test paragraph in Section 2
- <orderedlist>
- <listitem>
- <para>
- listitem text
- </para>
- </listitem>
- </orderedlist>
- </para>
- </section>
-
+ <title>Setting Properties</title>
+ <para>
+ ArjunaCore has been designed to be highly configurable at runtime through
+ the use of various property attributes. <!--, which will be described in
+ subsequent sections.-->Although these attributes can be provided at runtime
+ on the command line, it may be more convenient to specify them through a
+ single properties file or via <methodname>setter</methodname> methods on the
+ beans. At runtime, ArjunaCore looks for the file
+ <filename>jbossts-properties.xml</filename>, in a specific search order.
+ </para>
+ <orderedlist>
+ <listitem><para>A location specified by a system property<!--Which one? -->, allowing the normal search path to be overridden.</para></listitem>
+ <listitem><para>The directory from which the application was executed.</para></listitem>
+ <listitem><para>The home directory of the user that launched ArjunaCore.</para></listitem>
+ <listitem><para><varname>java.home</varname></para></listitem><!-- Is that like $JAVA_HOME? -->
+ <listitem><para>The <varname>CLASSPATH</varname>, which normally includes the installation's <filename>etc/</filename> directory.</para></listitem>
+ <listitem><para>A default set of properties embedded in the <filename>JAR</filename> file.</para></listitem>
+ </orderedlist>
+ <para>
+ Where properties are defined in both the system properties by using the <parameter>-D</parameter> switch, and in the properties file, the value from the system property takes precedence. This facilitates overriding individual properties easily on the command line.
+ </para>
+ <para>
+ The properties file uses <filename>java.uil.Properties</filename> XML format, for example:
+ </para>
+ <programlisting>
+ <![CDATA[
+<entry key="CoordinatorEnvironmentBean.asyncCommit">NO</entry>
+<entyr key="ObjectStoreEnvironmentBean.objectStoreDir">/var/ObjectStore</entry>
+ ]]>
+ </programlisting>
+ <para>
+ You can override the name of the properties file at runtime by specifying a new file using the <varname>com.arjuna.ats.arjuna.common.propertiesFile</varname> attribute variable.
+ </para>
+ <note>
+ <para>
+ Unlike earlier releases, there is no longer one properties file name per module. This properties file name key is now global for all JBoss Transaction Service components in the JVM.
+ </para>
+ </note>
</chapter>
Added: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/output.zip
===================================================================
(Binary files differ)
Property changes on: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/output.zip
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/publican.cfg
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/publican.cfg 2010-09-01 03:44:30 UTC (rev 34941)
+++ labs/jbosstm/trunk/ArjunaCore/docs/install_guide/docbook/ArjunaCore_Installation_Guide/publican.cfg 2010-09-01 04:59:35 UTC (rev 34942)
@@ -3,5 +3,5 @@
xml_lang: en-US
type: Book
-brand: common
+brand: jboss-community
More information about the jboss-svn-commits
mailing list