Populating your database
This chapter will guide you through the initial tasks needed to start using HaCi.
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 language. Once you have done this you will be presented with the full menu.
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 permissions for your users. <insert screenshot of group creation> As a first step, let's create a readonly group, and assign a user to it <screenshots, step by step guide>. While the admin will always see the full menu, the users will see some of the entries grayed out, depending on their permissions.
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 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 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 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 router configurations. HaCi supports Cisco, Juniper and Brocade (Foundry) 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 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.)
At this point you have some data to work on. The next chapter will guide you through day to day operations.