form 477 improvements #6499
[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">In almost all cases, legacy data import will require writing custom code to deal with your particular legacy data.  The example scripts here will probably <b>not</b> work "out-of-the-box", and are provided <b>as a starting point only</b>.</font>
7 <br><br><i>Some import scripts may require installation of the <a href="http://search.cpan.org/search?dist=Array-PrintCols">Array-PrintCols</a> and <a href="http://search.cpan.org/search?dist=Term-Query">Term-Query</a> (make test broken; install manually) modules.</i><br>
8 <ul>
9   <li><a name="bind">bin/bind.import</a> - Import domain information from BIND named
10   <li><a name="passwd">bin/passwd.import</a> - Just import `passwd' and `shadow' or `master.passwd', no RADIUS import.
11   <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:
12     <ul>
13       <li>Most accounts probably have entries in passwd and users (with Port-Limit nonexistant or 1)
14       <li>Some accounts have entries in passwd and users, but with Port-Limit 2 (or more)
15       <li>Some accounts might have entries in users only (Port-Limit 1)
16       <li>Some accounts might have entries in users only (Port-Limit >= 2)
17       <li>POP mail accounts have entries in passwd only, and have a particular shell.
18       <li>Everything else in passwd is a shell account.
19     </ul>
20 <!--  <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:
21     <ul>
22       <li>Domain (table svc_acct)
23       <li>Mail alias (table svc_acct_sm)
24     </ul>
25 -->
26   <li><a name="cust_main">Importing customer data</a>
27     <ul>
28       <li>Manually
29         <ul>
30           <li>Add a <a href="../edit/cust_main.cgi">new customer</a>
31           <li>Add one or more packages for this customer
32           <li>Enter a package by clicking on the package number
33           <li>Pick the `Link to existing' option
34         </ul>
35       <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.
36     </ul>
37 </ul>
38 </body>
39