Difference between revisions of "FAQ"

From RackTables Wiki
Jump to navigation Jump to search
Line 1: Line 1:
 
= RackTables FAQ =
 
= RackTables FAQ =
  
== how to edit this wiki? ==
+
== How do I edit this wiki? ==
# get an account at SourceForge
+
# Get a SourceForge account.
# <del>open wiki</del> (you are already here)
+
# <del>Open the wiki</del> (you are already here).
# make sure you are still logged in (now wiki has copied your account from SF)
+
# Make sure you are still logged in (now wiki has copied your account from SF).
# send a message with your SF account name to devteam@racktables.org
+
# Send a message with your SF account name to devteam@racktables.org requesting acces.
Once you have got a reply with "done", your account is in "editors" group.
+
When you receive a response, your account will be in the "editors" group.
  
 
== Unknown OID (n.n.n.n.n) ==
 
== Unknown OID (n.n.n.n.n) ==
First of all, support for modular hardware is '''very very limited'''. To deal with a "chassis" (not modular) switch, the most preferred way is through [https://sourceforge.net/apps/mantisbt/racktables/bug_report_page.php filing a Mantis ticket]. The following information is absolutely necessary:
+
The preferred way of adding port auto-discovery support for new switch models is through [https://sourceforge.net/apps/mantisbt/racktables/bug_report_page.php filing a Mantis ticket]. The following information is necessary:
* exact model/part number of the device (this could be one of "network switch models" records, or could be not)
+
* The exact model/part number of the device.
* for a device, which features SFP (GBIC, X2 etc) pluggable ports, tell, which of these pluggable ports are "combo" (IOW, alternate socket for a copper port under the same name) and which are standalone ports
+
* 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:
 
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")
+
* 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 (if for some reason it is a problem posting this to public Mantis, e-mail it):
+
* Dump of SNMP info:
 
<pre>
 
<pre>
 
snmpwalk -v 1 -c public switchname sysDescr.0
 
snmpwalk -v 1 -c public switchname sysDescr.0
Line 21: Line 21:
 
</pre>
 
</pre>
  
== rack thumb images are broken ==
+
== Rack thumb images are broken ==
 
There are two common reasons for this:
 
There are two common reasons for this:
# Misformatted local.php extension file. For images to work correctly, every PHP file of your RackTables, which begins with '''<?php''' tag, MUST NOT have a newline before the tag. Every PHP file of your RackTables, which ends with '''?>''' tag, MUST NOT have a newline after the tag.
+
# 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.
 
# 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.
 
# 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.
  
== cannot browse objects by object type ==
+
== How do I browse objects by object type? ==
FIXME
+
FILL ME IN
  
 
== How do I handle blade systems/modular switches? ==
 
== 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 [[RackTablesUserGuide#Containers|Containers]] for details.
 
You can have one object represent the chassis, and other objects represent the blades.  See the documentation on [[RackTablesUserGuide#Containers|Containers]] for details.
  
== how do I reoder racks in a row?==
+
== How do I re-order racks in a row? ==
(By default RackTables sorts in alphabetical order.) A working way is to put a prefix into each rack's name:
+
RackTables sorts in alphabetical order. A work-around is to prefix each rack's name with a number:
 
* "01 F14"
 
* "01 F14"
 
* "02 E14"
 
* "02 E14"
Line 40: Line 40:
 
* "05 B14"
 
* "05 B14"
 
* "06 A14"
 
* "06 A14"
This way sorting order will be "nailed down" the way one needs it.
 
  
== how do I log out (and log in after that?) ==
+
== How do I log out (and log in after that?) ==
To log out: use "Click here to logout", see username/password prompt, DON'T enter anything, press "Cancel".
+
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 "back" to return to any of the normal pages (without "index.php?logout" in URL) and enter your username/password.
+
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? ==
+
== How do I enable IPv4 for object type X? ==
 
Answered by Ray Robertson:
 
Answered by Ray Robertson:
 
<pre>
 
<pre>

Revision as of 22:21, 14 May 2011

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.

Unknown OID (n.n.n.n.n)

The preferred way of adding port auto-discovery 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:

You need to bee looking here:
 
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}
 
The Type IDs for the object type can be found by hovering over the
Object Type as in the attached screen short.