Skip to content

FAQ

Jump to bottom
Makoto "dave" Nakai edited this page Oct 25, 2022 · 5 revisions

Frequently Asked Questions (FAQ)

At this point, since all of our users are AQUA members, this is a set of questions we frequently ask ourselves.

Installation and getting it to run

Q: I can't get it to install!!!

  • A: Welcome to the club. Getting OMNeT++ to run is the biggest hassle. Once you have that done, everything else is smooth. There are a lot of dependencies on other free software packages, as well as on Java. The easiest install may be on a clean Ubuntu distribution, which can be done using Docker if you don't have such a machine handy. See Install OMNeT++ for additional info on troubleshooting.

Q: I tried to build QuISP from inside OMNeT++, and it bombs with some error about cocoa?!?

  • A: Ah, yes, the famous lack of hot chocolate. You need to run OMNeT++ from the command line, not the Finder (on a Mac), and you need to run . setenv to get some environment variables set properly. n.b.: there are probably multiple setenv files floating around, and I'm not certain which you need.

Q: I tried to start omnetpp, and I got this:

setenv error
  • A: Same as above. Do . setenv and try again, and it might work.

Q: I get a Java error about a null pointer when I try to run

quisp_tutorial.inior anything other than omnetpp.ini.

Java null pointer error
  • A: You might need to go to the Run menu and pick "Run As OMNeT++ Simulation".

Q: trouble with using xhost command

If you get this kind of error message when you use xhost command,

  • A: You can fix this with
export PATH="/opt/X11/lib$PATH"

Q: I got an error when I built quisp (especially make exe) on my local environment

make[1]: *** No rule to make target `out/clang-release//backends/ErrorTracking/Backend.o', needed by `out/clang-release//quisp'.  Stop.
make[1]: *** Waiting for unfinished jobs....
make: *** [all] Error 2
  • A: If you have an older version of make, you might get something like this.
GNU Make 3.81
Copyright (C) 2006  Free Software Foundation, Inc.
This is free software; see the source for copying conditions.
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.

This program built for i386-apple-darwin11.3.0

The newest version of make is 4.3 (as of Oct 25th, 2022), so you have to install the latest version.

Now what?

  • Q: Wow, OMNeT++ runs!!! Exciting! ...now what?
  • A: See the basic installation notes if you haven't, which will show you how to add QuISP into OMNeT++, and run your first QuISP sims.
    At the bottom of that you will find links to further build instructions, or you can skip straight to the running demos if you've already gotten QuISP installed.
  • Q: Okay, I got the basic first QuISP demo running. What the heck are these .ini and .ned files, and how do I create my own?
  • Q: There are a bunch of parameters in the .ini file that isn't described in the OMNeT++ documentation. What are they?
  • Q: QuISP is fantastic, but I want Feature X, which doesn't seem to be included...?
  • A: Time to start looking at the C++ code! OMNeT++ is very sophisticated and rich, i.e. complicated, so you'll have a bit of learning to do, but hopefully our existing code serves as a good guide to what you'll need. See also, of course, the OMNeT++ documentation. There are a lot of software design documents, which are potentially all suspect, as the code is evolving faster than the designs, and many elements of the desired design are still far from being implemented. But all of this should help you help yourself, and help us!
  • Q: Can I change the generation of RuleSets without changing C++ code?
  • A: At the moment, no.
Clone this wiki locally