|
|
Frequently Asked Questions
Since PWLIB and OPAL are used within OpenSIPStack, some of the entry
questions here are lifted from
http://www.voxgratia.org/docs/faq.html.
1.
General
1.1 - Where can I find the FAQ?
1.2 - My question is not
answered by the FAQ, how can I make a suggestion?
1.3 - Who maintains the
FAQ?
1.4 - Who is the Project
Coordinator of OpenSIPStack, and how do I contact him if I am having
problems?
1.5 - The FAQ describes
something that
sounds like my problem, and it refers to a document that I don't really
understand. I don't have time for all of this - can I just email
someone or contact them via IM and get them to explain it all to me?
1.6 - What is
OpenSIPStack?
1.7 - What is ATLSIP
1.8 - What is OpenSBC
1.9 - What are the
development plans for OpenSIPStack?
1.10 - What is the
license used for OpenSIPStack, and why is it published using a tripple
license?
1.11
- What license restrictions are placed on changes I make to
OpenSIPStack, ATLSIP and OpenSBC?
2. Mailing List
2.1 - How do I subscribe
to the mailing list?
2.2 - How do I
unsubscribe from the mailing list?
2.3 - How do I make a
posting to the mailing list?
2.4 - What is the mailing
list used for?
2.5 - What is the mailing
list *not* used for?
2.6 - There is too much
traffic on the mailing list. Is there a digest?
2.7 - Is there an
searchable archive of the list available?
2.8 - Are there any rules?
2.9 - Who enforces the
rules?
2.10 - How can I ensure
someone will answer my question?
2.11 - But I really need
an URGENT answer to my question?
2.12 - Who answers
questions on the list?
2.13 - I want to help by
answering questions? How do I do this?
2.14 - Why aren't there
separate lists for users and developers like
other projects?
2.15 - Can I ask
questions about how to use/debug/understand another
SIP stack?
3. Downloading Codes
3.1 - Where can I
download source code from?
3.2 - Where can I
download binaries from?
3.3 - Where can I get the
very latest source code from?
3.4 - How do I access the
CVS repository?
3.5 - Where can I get ZIP
versions of the source archives?
3.6 - How do I know what
version to download?
3.7 - Where can I
download a particular version of the code?
3.8 - What are Russel and
Descartes. Why are these names
used?
4. Compiling the Code
4.1 - The code does not compile - what is the problem?
4.2 - Microsoft Visual Studio will not load the DSP and DSW files
provided with OpenH323
4.3 - I know the OpenSSL/Foobah library on my system is
broken, but OpenSIPStack uses it anyway. How do I prevent this?
4.4 - How do I cross compile OpenSIPStack for another platform?
4.5 - Are there detailed instructions for building OpenSIPStack on
Windows?
4.6 - Can I compile OpenSIPStack
using VS.NET 2003, VS.net 2005 and Visual C++ 2005 Express Edition?
4.7 - How do I fix the Windows build error "Cannot open include file:
'ptbuildopts.h', 'ossbuildopts': No such file or directory"?
4.8 - How do I fix the Windows build error "Configuring Build
Options \ This program cannot run in DOS mode \ Error executing
c:\windows\system32\cmd.exe" ?
4.9 - How do I fix the errors in vfakeio.cxx starting at line 411 like
"newline in constant", "too many characters in constant", "syntax
error: string"?
4.10 - How do I report a bug in the code?
4.11 - How do I fix errors like "Cannot open source file:
getdate_tab.c': No such file or directory"?
4.12 - How do I compile OpenH323 on Solaris?
4.13 - How do I submit patches to the code?
4.14 - How do I fix warnings about PVXMLSession and OpalVXMLSession not
found compiling the OpenSBC?
4.15 - The configure program for OpenSIPStack and OpenSBC is finding
the wrong version of a library - how do I stop this?
4.16 - How do I stop configure from finding the wrong header files on
Windows?
4.17 - How do fix errors about missing MSVC80.DLL or MSVCR80.DLL files
when debugging using Visual C++ 2005 Express Edition?
4.18 - How do I fix gcc errors about "PAtomicInteger" when compiling
OpenSIPStack?
4.19 - I already have PWLIB and OPAL installed, can I use it to compile
OpenSIPStack instead of the built-in copies?
4.20 - The configure script complains about not finding Expat, but
OpenSIPStack already has expat in the external folder. What's
wrong?
5. Using OpenSBC
5.1 I compiled OpenSBC. Where can I find the binary?
5.2 I can't run OpenSBC. The application exits with an error
message '*** FATAL ERROR *** Attempt to load incorrect version of
oss-application.conf.xml!!!'
53 Where do I configure OpenSBC?
5.4 Where is the configuration data stored?
5.5 I forgot my http admin password, how do I reset it?
6. Using ATLSIP
6.1
- Why won't
ATLSIP display
G.723.1/G.729 in the codec list?
6.2 - Can I use the ITU reference code for G.723.1 and G.729?
6.3 - Where can I get licensed G.723.1 and G.729 codec implementations?
6.4 - Can I use the Microsoft G.723.1 codec in my Windows
program?
6.6 - How do I add my own audio or video codec to ATLSIP?
6.7 - What audio codecs are supported by ATLSIP
6.8 - What video codecs are supported by ATLSIP
6.9 - Why does a call using a compressed audio codec use much more
bandwidth than expected?
6.10 - Why am I getting bad audio quality even though I am using G.711?
6.11 - Why am I getting bad audio when using the G.729 codec?
6.12 - Why are there so many Speex capabilities?
6.13 - Does ATLSIP support wide-band codecs?
6.14
- I am able to compile ATLSIP, but I when I Register the
ActiveX
control in another machine, I get error message
'error:LoadLibrary("c:\atlsip\ATLSIP.dll") failed - This
application has failed to start because the application configuration
is incorrect. Reinstalling the application may fix this problem.'
What's the problem?
1.
General
1.1
- Where can I find the FAQ?
The FAQ page can be found at
http://www.opensipstack.org/faq.html
1.2
- My question is not answered by the FAQ, how can I make a suggestion?
You can mail the Project Coordinator
directly or join the mailing list.
1.3
- Who maintains the FAQ?
This FAQ is maintained by Joegen Baclor
1.4
- Who is the Project Coordinator of OpenSIPStack, and how do I contact him if I
am having problems?
You may e-mail Joegen Baclor at joegen@opensipstack.org.
However, your best bet would be to join the mailing list.
1.5
- The FAQ describes something that sounds like my problem, and it
refers to a document that I don't really understand. I don't have time
for all of this - can I just email someone or contact them via IM and
get them to explain it all to me?
You may try to send the authors an
off-list
message but you must understand that the authors will be using his
personal time and may not respond immediately or at all. We
will
try our best to answer any questions sent directly to us at the latest
possible opportunity. There are past instances that the
authors actually offer real time collaboration via IM. This
depends on how important the matter is to the improvement of the
project.
1.6
- What is OpenSIPStack?
OpenSIPStack is a library implementation
of
the Session Initiation Protocol specified in RFC 3261 written in the
C++ programming language.
1.7
- What is ATLSIP
ATLSIP is a SIP User Agent with audio
capability wrapped as an ActiveX Control. ATLSIP is based on
OpenSIPStack library.
1.8
- What is OpenSBC
OpenSBC is a fully featured
implementation of a Session Border Controller.
OpenSBC can be used for routing, authentication and far end
NAT traversal.
1.9
- What are the development plans for OpenSIPStack?
A road map is available at http://www.opensipstack.org/development.html.
1.10
- What is the license used for OpenSIPStack, and why is it published
using a triple license?
OpenSBC
is published under
the MPL, GPL, LGPL triple license. The default active
license is
MPL. However, because of the inherent incompatibility between
MPL
and GNU licenses, we decided to explicitly publish OpenSBC using GPL
and LGP as alternative licenses. The full text of the license
is
as follows
*
Copyright (c) opensipstack.org.
*
* The contents of this file are subject to the Mozilla Public
License
* Version 1.0 (the "License"); you may not use this file
except in
* compliance with the License. You may obtain a copy of the
License at
* http://www.mozilla.org/MPL/
*
* Software distributed under the License is distributed on an
"AS IS"
* basis, WITHOUT WARRANTY OF ANY KIND, either expressed or
implied. See
* the License for the specific language governing rights and
limitations
* under the License.
*
* The Original Code is OpenSIPStack.
*
* The Initial Developer of the Original Code is
opensipstack.org.
*
* The author of this code is Joegen E. Baclor
*
* Alternatively, the contents of this file may be used under
the terms of
* either the GNU General Public License Version 2 or later
(the "GPL"), or
* the GNU Lesser General Public License Version 2.1 or later
(the "LGPL"),
* in which case the provisions of the GPL or the LGPL are
applicable instead
* of those above. If you wish to allow use of your version of
this file only
* under the terms of either the GPL or the LGPL, and not to
allow others to
* use your version of this file under the terms of the MPL,
indicate your
* decision by deleting the provisions above and replace them
with the notice
* and other provisions required by the GPL or the LGPL. If
you do not delete
* the provisions above, a recipient may use your version of
this file under
* the terms of any one of the MPL, the GPL or the LGPL.
*
* The OpenSIPStack Library includes some GPL/LGPL code
libraries that MAY be
* enabled at compile time using the --enable-gpllibs
configure switch. If
* enabled, the content of this file is published under the
terms of GNU
* General Public License Version 2. For a detailed
list of the available
* GPL code, see $(opensipstack)/gnu/README file.
1.11 - What
license restrictions are placed on changes I make to OpenSIPStack,
ATLSIP and OpenSBC?
MPL is the default
active license for OpenSIPStack and GPL and LGPL are alternative
licenses.
Paragraph 3.2 of the MPL license states:
"Any Modification which You create or to
which You
contribute must be made available in Source Code form under the terms
of this License..."
For the purposes of the MPL, "Modification" is defined as:
"...addition to or deletion from the
substance or
structure of either the Original Code or any previous Modifications.
When Covered Code is released as a series of files, a Modification is:
A. Any addition
to or deletion from the contents of a file containing Original Code or
previous Modifications.
B. Any new file
that contains any part of the Original Code or previous Modifications."
In plain language, this means that any changes you make to any existing
OpenSIPStack source file must be released under the same MPL license.
This same applies to any new file that contains part of any previously
released code.
The MPL places no restrictions on any new files you create that contain
wholly original code. You can choose to release (or not release) these
files under any license you choose. Please note that files
not
covered by the MPL will not be included in the official OpenSIPStack
CVS.
However, if you are using GPL or LGPL code, then restrictions of these
alternative licenses will be imposed.
2. Mailing List
2.1 - How do I subscribe to the mailing
list?
You may directly subscribe to the mailing list using the form provided
below. or you may visit this link:
https://lists.sourceforge.net/lists/listinfo/opensipstack-devel
2.2
- How do I unsubscribe from the mailing list?
You can unsuscribe using this link. https://lists.sourceforge.net/lists/options/opensipstack-devel.
You must enter your email address and password.
Your
password should have been sent to you when you registered for the first
time or you may request mailman to send you a reminder for you password
using the above link as well.
2.3 - How do I make a posting to the
mailing list?
opensipstack-devel@lists.sourceforge.net is the e-mail
address of
the mailing list. You may send e-mails to this address as
soon as
your membership application has been approved.
2.4 - What is the mailing list used for?
The OpenSIPStack mailing list hosts discussions and improvement to the
OpenSIPStack library and its applications. This would include
occasional announcements from the author and sponsors. The list may
also be used to discuss SIP standards in general.
2.5 - What is the mailing list *not*
used for?
The list may not be used to promote a company or commercial products or
to discuss how such product is used or configured without direct
correlation with OpenSIPStack or its applications.
2.6 - There is too much traffic on the
mailing list. Is there a digest?
Yes. Login to https://lists.sourceforge.net/lists/options/opensipstack-devel
and change your settings to receive Digests instead of individual mails.
2.7 - Is there an searchable archive of
the list available?
Yes. You can find the searchable archive at http://sourceforge.net/mailarchive/forum.php?forum_name=opensipstack-devel
2.8 - Are there any rules?
The only rule is to conform with items 2.5 and 2.6 and to respect the
opinions of other members in the list. OpenSIPStack aims to
be a
friendly list and we will not tolerate any inflamatory e-mails.
2.9 - Who enforces the rules?
The project
coordinator
2.10 - How can I ensure someone will
answer my question?
You can't. You can however increase the probability of
getting
answers by providing as much data as needed to describe your problem.
Simply saying "it doesn't work" or "other product works but
yours don't" will most often get ignored. Try to give a short
analysis of the problem and provide others data to work with and how to
reproduce your problem.
2.11 - But I really need an URGENT
answer to my question?
Your personal emergency is not the responsibility of the authors and
other members of the list. Follow 2.10 and hope for the best.
Take note that the URGENT clause in subject lines more often
make people not feeling obliged to answer.
2.12 - Who answers questions on the
list?
Most of the time, the author and main contributors takes care of
answering questions. As the list matures, we are seeing list
members participating in answering questions as well. We
strongly
encourage the community to participate in all discussions.
2.13 - I want to help by answering
questions? How do I do this?
By all means! You may participate in answering any question
posted to the list. Just follow the golden rule stated in
item 2.8
2.14 - Why aren't there separate lists
for users and developers like
other projects?
We simply do not believe in treating user problems as separate to
developer problems. We believe that the project would grow
faster if developers know about user problems. Users may also
be
interested in knowing the real status of the current development
efforts.
2.15 - Can I ask questions about how
to use/debug/understand another
SIP stack?
You may get some advise from the list but unless the other SIP stack
does not have a mailing list of its own, you will get better answers by
mailing the appropriate mailing list directly. We strongly
discourage cross posting.
3. Downloading Codes
3.1 - Where can I download source code
from?
Source code tar balls are available at:
3.2
- Where can I download binaries from?
Latest
binaries are available at:
3.3 - Where can
I get the very latest source code from?
Source tarballs would always be available for each mile stone in the roadmap from the
usual download places.
3.4 - How do I access the CVS
repository?
Instructions can be found at http://www.opensipstack.org/cvs.html
3.5 - Where can I get ZIP versions of
the source archives?
ZIP versions are also available for all sources from the usual download
places.
3.6 - How do I know what version to
download?
We release a specific version of the library for each milestone.
Make sure you use the same version of the OpenSIPStack when
compiling applications from a miles tone release. These files
are usually grouped together in http://www.opensipstack.org/downloads.html
3.7 - Where can I download a particular
version of the code?
We will maintain the last five mile stone releases in http://www.opensipstack.org/downloads.html
Older
releases will only be available from the CVS
3.8 - What are Russel and Descartes.
Why are these names
used?
Each major release are given names from from famous philosophers and is
used to tag mile stone and major releases in CVS.
4. Compiling the Code
4.1 - The code does not compile - what is the problem?
Build instructions can be found here.
There might be times when code for a specific OS the developer is
working on might break other operating systems. Although
rarely happens, it has definitely happened in the past. If
you encounter compilation errors and you think you have followed all
instructions for building OpenSIPStack please get a tail of your
compiler output and report to the list immediately together with the
version of your compiler and the version and type of operating system
you are using.
4.2 - I know the OpenSSL/Foobah library on my system is
broken, but OpenSIPStack uses it anyway. How do I prevent this?
Run
"./configure" for PWLib or OpenH323 with
the appropriate flag to disable the module you want to avoid. Use
"./configure --help" for a list of these flags. Another way is to undefine the enabling macros in ptbuildopts.h.
Example:
#undef P_SSL
#undef P_SSL_AES
#undef P_SSL_USE_CONST
4.3 - How do I cross compile OpenSIPStack for another platform?
Set the following environment variables before running "./configure":
export CXX=<toolchain directory>/g++
export CC=<toolchain directory>/gcc
4.4 - Are there detailed instructions for building OpenSIPStack on
Windows?
Build instructions can be found here.
4.5 - Can I compile OpenSIPStack
using VS.NET 2003, VS.net 2005 and Visual C++ 2005 Express Edition?
Yes to all three. However VS.NET 2003 may lag behind VS.net 2005 and may be mising files.
4.6
- How do I fix the Windows build error "Cannot open include file:
'ptbuildopts.h', 'ossbuildopts': No such file or directory"?
These files are automatically generated by the configure executable or
script. The windows project should automatically call configure
as a pre-build step. If this did not happen, you may run the
configure.exe manually.
4.7 - How do I report a bug in the code?
If you are a member of the mailing list, you may send the bug report to the list.
You may also send a bug reports to the project coordinator
4.9 - How do I submit patches to the code?
4.10 - How do I fix warnings about PVXMLSession and OpalVXMLSession not
found compiling the OpenSBC?
4.11 - The configure program for OpenSIPStack and OpenSBC is finding
the wrong version of a library - how do I stop this?
4.12 - How do I stop configure from finding the wrong header files on
Windows?
4.13 - How do fix errors about missing MSVC80.DLL or MSVCR80.DLL files
when debugging using Visual C++ 2005 Express Edition?
4.14 - How do I fix gcc errors about "PAtomicInteger" when compiling
OpenSIPStack?
4.15 - I already have PWLIB and OPAL installed, can I use it to compile
OpenSIPStack instead of the built-in copies?
4.16
- The configure script complains about not finding Expat, but
OpenSIPStack already has expat in the external folder. What's
wrong?
5. Using OpenSBC
5.1 I compiled OpenSBC. Where can I find the binary?
5.2 I
can't run OpenSBC. The application exits with an error
message '***
FATAL ERROR *** Attempt to load incorrect version of
oss-application.conf.xml!!!'
53 Where do I configure OpenSBC?
5.4 Where is the configuration data stored?
5.5 I forgot my http admin password, how do I reset it?
6. Using ATLSIP
6.1
- Why won't
ATLSIP display
G.723.1/G.729 in the codec list?
6.2 - Can I use the ITU reference code for G.723.1 and G.729?
6.3 - Where can I get licensed G.723.1 and G.729 codec implementations?
6.4 - Can I use the Microsoft G.723.1 codec in my Windows
program?
6.6 - How do I add my own audio or video codec to ATLSIP?
6.7 - What audio codecs are supported by ATLSIP
6.8 - What video codecs are supported by ATLSIP
6.9 - Why does a call using a compressed audio codec use much more
bandwidth than expected?
6.10 - Why am I getting bad audio quality even though I am using G.711?
6.11 - Why am I getting bad audio when using the G.729 codec?
6.12 - Why are there so many Speex capabilities?
6.13 - Does ATLSIP support wide-band codecs?
6.14
- I am able to compile ATLSIP, but I when I Register the
ActiveX
control in another machine, I get error message
'error:LoadLibrary("c:\atlsip\ATLSIP.dll") failed - This
application has failed to start because the application configuration
is incorrect. Reinstalling the application may fix this problem.'
What's the problem?
|
