= Populating your database = This chapter will guide you through the initial tasks needed to start using !HaCi. [[Image(haci_firstdialog.jpg, right, nolink)]] == Admin Password == Once you have completed the installation, you can login as user admin (without password). Your first task will then be setting a password for the admin user and selecting the [HaCiLocalization language]. Once you have done this you will be presented with the full menu. [[Image(haci_login_fresh.jpg, 600, right)]] == Defining some users and groups == !HaCi allows you to create users and groups. When adding a new user, you will be prompted for a password and a description, and also for his group associations. Groups are where you define [HaCiPermissions permissions] for your users. As a first step, let's create a readonly group, and assign a user to it . While the admin will always see the full menu, the users will see some of the entries grayed out, depending on their [HaCiPermissions permissions]. == Roots == A Root is sort of a placeholder that allows you to group your network logically. The first grouping that comes to mind is ipv4 and ipv6 (since you can't mix them in the internal tree structure anyway). So you may want to [HaCiAddRoot create two roots], e.g. "My IPv4 Addresses" and "My IPv6 Addresses". Another useful grouping you could use is if you have address space from more than one RIR. So you could have "My RIPE v4 addys" and "My ARIN v4 addys". You can come up with several roots according to your needs. The software will also create some roots automatically when importing configurations. When you create a root, you will be prompted for a name and a description, and you will need to tick the IPv6 box if the root will be used for v6 addresses. You will also need to assign privileges to the user groups. The admin group can always read and write anything, but you can restrict privileges to the other users. Each node in the tree, from the root down to the single address, can have different privileges. == Importing your data == Your next step will be defining some networks to work on. You can [HaCiAddNetwork manually define your address blocks] but if you felt the need for an address management tool, it's likely that you have an ''allocation'' from a RIR. !HaCi will let you pull in the data from RIPE database by using [HaCiImportRoutes ASN Routes] from the menu. This will find all inetnum and route objects tied to your AS number (and inet6num and route6 respectively for IPv6), and place them under a newly created root named after your AS number. Of course, you can define your topmost network manually and skip the above step if you don't have an AS number. Another option is to import your [HaCiImportConfig router configurations]. !HaCi supports Cisco and Juniper configuration syntax. The importer will use the interface descprition, and will import both the subnet and the actual address that is configured. You can also import your data using a CSV file. In this case !HaCi will look at the fields and ask you how to use them. Last option for populating your database is importing [HaCiImportDns zone files from DNS]. You can do this either by querying the DNS directly, or by loading the zone files if you have them at hand. You can import either direct zones (mynetwork.example.com) or reverse zones (168.192.in-addr.arpa.) ---- [[HaCiOverview Overview]] [[WikiStart Start Page]] [[HaCiDayToDay Day to day operations]]