FAQ

From RackTables Wiki
Jump to navigation Jump to search

RackTables FAQ

How do I edit this wiki?

  1. Get a SourceForge account.
  2. Open the wiki (you are already here).
  3. Make sure you are still logged in (now wiki has copied your account from SF).
  4. Send a message with your SF account name to devteam@racktables.org requesting acces.

When you receive a response, your account will be in the "editors" group.

Why does the SNMP sync feature return Unknown OID (n.n.n.n.n)

RackTables only supports some specific switch models, and yours is not one of them.

The preferred way of adding support for new switch models is through filing a Mantis ticket. The following information is necessary:

  • The exact model/part number of the device.
  • For a device which features SFP (GBIC, X2 etc) pluggable ports, specify which of these pluggable ports are "combo" (IOW, alternate socket for a copper port under the same name) and which are standalone ports.

If possible, add the following information:

  • Manufacturer's markup of device's ports (this can be "21, 22, 23, 24", "21X, 22X, 23X, 24X" or even "21, 22, 23C, 23F, 24C, 24F")
  • Dump of SNMP info:
snmpwalk -v 1 -c public switchname sysDescr.0
snmpwalk -v 1 -c public switchname sysObjectID.0
snmpwalk -v 1 -c public switchname ifTable

Rack thumb images are broken

There are two common reasons for this:

  1. A mis-formatted local.php extension file. For images to work correctly, every PHP file of your RackTables, which begins with <?php tag, CAN NOT have a newline before the tag. Every PHP file of your RackTables, which ends with ?> tag, CAN NOT have a newline after the tag.
  2. GD library is not working (although it probably was at the time of installation). This can be confirmed by means of phpinfo() and fixed with the help of package manager of your server and RackTables README file.

How do I browse objects by object type?

FILL ME IN

How do I handle blade systems/modular switches?

You can have one object represent the chassis, and other objects represent the blades. See the documentation on Containers for details.

How do I re-order racks in a row?

RackTables sorts in alphabetical order. A work-around is to prefix each rack's name with a number:

  • "01 F14"
  • "02 E14"
  • "03 D14"
  • "04 C14"
  • "05 B14"
  • "06 A14"

How do I log out (and log in after that?)

To log out: Use the "Click here to logout" link. When presented with the username/password prompt, do not enter anything. Instead, press "Cancel".

To log in: Press your browser's "back" button to return to any of the normal pages (without "index.php?logout" in the URL) and enter your username/password.

How do I enable IPv4 for object type X?

Answered by Ray Robertson:

Configuration --> User Interface --> Change
 
Edit the entry for 'List source: IPv4-enabled objects'
 
e.g.
List source: IPv4-enabled objects  {$typeid_2} or {$typeid_4} or {$typeid_7} or {$typeid_8} or {$typeid_12} or {$typeid_445} or {$typeid_447} or {$typeid_798}
 
To determine an object's typeid, hover your mouse pointer over the 'Object type' field when viewing the object.  The typeid will be revealed in the URL.


Scenario:

At Company X you have a proprietary transceiver-type device that is network accessible & can be assigned an IP. You add a new RackObjectType called "Transceiver". To add the IPv4 tab to new "Transceiver" objects, do the following.

1. Navigate to Main > Configuration > Dictionary > RackObjectType.

2. Mouse-over the new RackObjectType you created, in this case "Transceiver". In this example, the Transceiver typeid is 50012.

3. Now navigate to Main > Configuration > User Interface > Change.

4. Scroll down to the item/entry "List source: IPv4-enabled objects". 

5. Now go to the end of the line, and enter "or {$typeid_50012}". 

6. Your new line looks like: {$typeid_2} or {$typeid_4} or {$typeid_7} or {$typeid_8} or {$typeid_12} or {$typeid_445} or {$typeid_447} or {$typeid_798} or {$typeid_50012}

7. Save changes.

8. Navigate to one of your Transceiver objects, and confirm that the IPv4 tab is now present.