5f59bb83f2e0e6904222112037b37da061f6a003
[freeside.git] / httemplate / docs / legacy.html
1 <head>
2   <title>Importing legacy data</title>
3 </head>
4 <body>
5   <h1>Importing legacy data</h1>
6 <font size="+2">NOTE: This file is OUT OF DATE with the landing of the new export code.  Importing your legacy data will most probably involve some hacking on the example scripts noted below.  Contributions to the import process are welcome.</font>
7 <ul>
8   <li><a name="svc_acct">bin/svc_acct.import</a> - Import `passwd', ( `shadow' or `master.passwd' ) and RADIUS `users'.  Before running bin/svc_acct.import, you need <a href="../browse/part_svc.cgi">services</a> (with table svc_acct) as follows:
9     <ul>
10       <li>Most accounts probably have entries in passwd and users (with Port-Limit nonexistant or 1)
11       <li>Some accounts have entries in passwd and users, but with Port-Limit 2 (or more)
12       <li>Some accounts might have entries in users only (Port-Limit 1)
13       <li>Some accounts might have entries in users only (Port-Limit >= 2)
14       <li>POP mail accounts have entries in passwd only, and have a particular shell.
15       <li>Everything else in passwd is a shell account.
16     </ul>
17   <li><a name="svc_acct_sm">bin/svc_acct_sm.import</a> - Import qmail ( `virtualdomains' and `rcpthosts' ), or sendmail ( `virtusertable' and `sendmail.cw' ) files.  Before running bin/svc_acct_sm.import, you need <a href="../browse/part_svc.cgi">services</a> as follows:
18     <ul>
19       <li>Domain (table svc_acct)
20       <li>Mail alias (table svc_acct_sm)
21     </ul>
22   <li><a name="cust_main">Importing customer data</a>
23     <ul>
24       <li>Manually
25         <ul>
26           <li>Add a <a href="../edit/cust_main.cgi">new customer</a>
27           <li>Add one or more packages for this customer
28           <li>Enter a package by clicking on the package number
29           <li>Pick the `Link to existing' option
30         </ul>
31       <li>Batch - You will need to write a script to import your particular legacy data.  You can use eg/TEMPLATE_cust_main.import as a starting point.
32     </ul>
33 </ul>
34 </body>
35