Wireless Data Terminal Installation Guide

Reliance Netconnect+ AC2737

Installation Guide for Linux

This Installation Guide is used for Reliance Netconnect+.

V 1.0

ZTE Corporation http://www.zte.com.cn

Downloaded from www.Manualslib.com manuals search engine

 Wireless Data Terminal Installation Guide

Installation procedure and method for UI

software

1. Description of installation procedure

The UI software setup package under Linux (Ubuntu, openSUSE, Fedora,…) system contains the
driver of USB data card and offers different driver source codes according to different Linux
kernel versions. They are put under the setup path: /usr/local/bin/ztemtApp/zteusbserial, and saved
in different sub-folders.

The setup package will automatically compile the corresponding driver version and load the driver
(insmod ztemt.ko) during the installation.
Therefore, you need to install gcc compiler and kernel development package (kernel-devel) in
advance.
Ubuntu9.04 system is an exception because the USB driver module already exists in the system
kernel. The setup package will omit the step of compiling the driver after confirming that the
system version is Ubuntu9.04; instead, it would modify the system pilot configuration (menu.lst)
in order to support different ZTE USB data cards.
Note: You need insert USB data card when installing UI software under Ubuntu9.04 system,
otherwise you will be unable to install the drivers for the USB modem

Prerequisite conditions for installing UI software

Since the installation of Linux system package is rather complicated, you need to have certain
experience of using Linux system to complete the installation. It’s recommended to select the
corresponding package upon the system installation, which is the simplest method.
(The installation methods may vary among different types of Linux system. Here we take
openSUSE for example）
gcc compiler and kernel-devel should be installed in the system because the driver needs to be
compiled during the installation. If gcc compiler and kernel-devel are not yet installed, install
them from their respective Linux system installation CD.
¾ Install gcc
Recommended method: when installing Linux system, select gcc relevant package at
“Development Tools”.
Or install it again from CD after the system is installed.
openSUSE: it’s recommened to install with yast setup package manager. Select software,

ZTE Corporation http://www.zte.com.cn

Downloaded from www.Manualslib.com manuals search engine

 Wireless Data Terminal Installation Guide

search the setup package from CD and then select Install.

Take gcc package installed under openSUSE11.1 system for example. The relevant packages
installed are listed as below (for reference only):
gcc-4.3-34.168
gcc-c++-4.3-34.168
gcc-info-4.3-34.168
gcc43-4.3.3_20081022-9.5
gcc43-info-4.3.3_20081022-9.5
gcc43-gij-4.3.3_20081022-9.2
gcc43-c++-4.3.3_20081022-9.5
libgcc43-4.3.3_20081022-9.5
gcc-gij-4.3-34.168

Ubuntu: Require PC to connect to the network, and then use apt-get install command to
install.
e.g.: sudo apt-get install gcc
Feora: use yum command to install. e.g., yum install gcc.

¾ Install kernel-devel
Select the corresponding package when installing Linux system. The detailed name and
version might vary according to different Linux system versions.
Or add the corresponding setup package from CD after the system is installed.
openSUSE: it’s recommended to install with yast setup package manager.
Take openSUSE11.1 system for example. The kernel packages installed are listed as below
(for reference only):
kernel-source-2.6.27.7-9.1
linux-kernel-headers-2.6.27-2.28
kernel-pae-base-2.6.27.7-9.1
kernel-pae-2.6.27.7-9.1
kernel-syms-2.6.27.7-9.1
kernel-pae-extra-2.6.27.7-9.1

ZTE Corporation http://www.zte.com.cn

Downloaded from www.Manualslib.com manuals search engine

 Wireless Data Terminal Installation Guide

Fedora: it’s recommended to use yum manager to install. e.g., yum install kernel-devel
(Require PC to connect the network）
Ubuntu: Require PC to connect the network, and then use apt-get install to install.
e.g.,: sudo apt-get install kernel-devel

2. Get started – Installation

After the installation of gcc compiler and kernel-devel, you could start installing cross-platform UI
software. Supposed CDROM will automatically mount at the patch: /media/cdrom0 after USB
modem is inserted.
1. Double-click the corresponding Linux version to install
Open the directory of CDROM loading point/media/cdrom0, and double click the corresponding
Linux version setup package.
There are three Linux setup packages contained in CD:
¾ CrossPlatformUI-V1.0.21-i386-ubuntu.deb
This is DEB format setup package used for Ubuntu system
¾ CrossPlatformUI-V1.0.16-i586.opensuse.rpm
openSUSE system setup package
¾ CrossPlatformUI-V1.0.16-i586.fedora.rpm
Fedora system setup package
2. Installation using command line (Terminal)
Open the terminal program and key in the command:
sudo rpm –ivh /media/cdrom0/ CrossPlatformUI-V1.0.16-i586.opensuse.rpm #openSUSE
sudo rpm –ivh /media/cdrom0/ CrossPlatformUI-V1.0.16-i586.fedora.rpm #Fedora
sudo dpkg –i /media/cdrom0/ CrossPlatformUI-V1.0.21-i386.ubuntu.deb #Ubuntu
Because it requires super user authority during the installation, it might ask you to input super
user password.

3. Uninstallation using command line (Terminal)

Open the terminal program and key in the command:
sudo rpm –e CrossPlatformUI ( #Fedora/openSUSE case sensitive)
sudo dpkg –r CrossPlatformUI ( #Ubuntu )
sudo dpkg –P CrossPlatformUI （ #Ubuntu ）

4. Common problems during the installation

¾ Authority/Right problem
This problem occurs as other users(non-admin users) are installing. The installation
can’t be completed because there are no enough rights. Please use “sudo” command to
install (as shown above)
¾ Old version not removed
The old version must be removed before installation, otherwise the installation will fail.

ZTE Corporation http://www.zte.com.cn

Downloaded from www.Manualslib.com manuals search engine

 Wireless Data Terminal Installation Guide

Uninstall method:
sudo rpm –e CrossPlatformUI ( #Fedora/openSUSE case sensitive)
or: sudo dpkg –r CrossPlatformUI ( #Ubuntu )
or: sudo dpkg –P CrossPlatformUI （ #Ubuntu ）

¾ Conflict among setup packages

If there is any conflict between the setup package and other software (generally, this
won’t happen), you could perform compulsory installation (not recommended).
Method:
sudo dpkg –i --force-all CrossPlatformUI-V1.0.21-i386.ubuntu.deb
This method is currently applicable for the problem occurred under Ubuntu9.04 system.

Required shared library to run UI software

After installing Linux version UI software, you need to install the required shared library to run UI
software.
¾ ALSA library. Generally, ALSA audio shared library has been installed into your new
Linux version by default.
If your system can play sound, it means ALSA library has been successfully installed;
If not, your system version might be too old to support ALSA library or you need to use
the corresponding setup package manager to reinstall. For detailed steps, refer to the
installation method of kernel-devel above.
Take openSUSE11.1 system for example. The relevant ALSA library installed are
listed as below: (for reference only)
alsa-oss-1.0.17-1.37
alsa-utils-1.0.18-6.4
alsa-devel-1.0.18-8.7
alsa-plugins-pulse-1.0.18-6.12
alsa-1.0.18-8.7
alsa-plugins-1.0.18-6.12
¾ Libaudio2
libaudio2 is another library used by UI to play the sound. The installation of this setup
package is simple. You could download the relevant deb or rpm to install.
Recommended website:
http://rpm.pbone.net/index.php3/stat/4/idpl/12245031/com/libaudio2-1.9.2-0.pm.1.i586.
rpm.html
http://packages.ubuntu.com/hardy/libaudio2

or you could get the relevant compression package of library files, containing
libaudio.so, libaudio.so.2, libaudio.so.2.4, etc., directly unzip to /lib directory and run
ldconfig command.

ZTE Corporation http://www.zte.com.cn

Downloaded from www.Manualslib.com manuals search engine

 Wireless Data Terminal Installation Guide

3. Get Started to Run UI

After all above installations, you can run UI software.

Insert the usb modem into USB port, wait for the driver to recognize USB modem, and then run
UI program.
z Two methods to run UI software:
１．Click the shortcut menu: Menu ->Connection->ZTEMTUI
２．Execute ztemtapp command through terminal program

a) After running UI in this way, the following information will display on the terminal,
which will be used to track the problem.
b) If the shared library required by UI are not completely installed, you will see the system
prompt of missing libaudio2 library after executing ztemtapp command.
See the figure below:

4. Common Problems and Troubleshooting

z Has UI software been installed or no?

If UI software has been installed, the program would be located at the following path:
/usr/local/bin/ztemtApp. Execute the program through ztemtapp command.
You can use the command line to inquire the name of the package where the files are saved.
The name will be used when you want to remove UI software. For example, if you want to
inquire which package ztemtapp file is installed, you can run:
rpm –qf /bin/ztemtapp
or
dpkg –S ztemtapp
If dialer is already installed, the following information will return:
“CrossPlatformUI-V1.x.x-*”, and the package name is CrossPlatformUI.
z Can USB device be used or not
If the driver is installed successfully, you could inquire that ztemt.ko module has been loaded
into the system through lsmod | grep ztemt command. At this point, you will find the device
files such as ttyUSB0, ttyUSB1…under the directory: /dev/ after inserting the data card (1~ 2
seconds). ttyUSB0 corresponds to modem port.
If the installation fails, you will not find /dev/ttyUSB0. You are prompted with “Can’t find device”
when running UI.

ZTE Corporation http://www.zte.com.cn

Downloaded from www.Manualslib.com manuals search engine

 Wireless Data Terminal Installation Guide

z Why is there no response when clicking ApplicationÆInternetÆReliance NetConnect？

Solution: Input “ztemtapp” at the command line（Applications->accessories->terminal）;
If the system prompts you with “can’t find command”, the installation isn’t successful, you
need install the software again;
If the system prompts you with “missing libaudio2” library, you need install the
corresponding library file.

z What shall we do if there is a prompt with “Can’t access the terminal or can’t find the
device” after clicking Reliance NetConnect？
Solution: use the command “ls /dev/ttyU*” to check whether /dev/ttyUSB0, /dev/ttyUSB1,
/dev/ttyUSB2 and /dev/ttyUSB3 exist. If they don’t exist, device drivers are not loaded
properly. You could manually compile and load the driver which is placed at
/usr/local/bin/ztemtApp/, or seek for technical support.

z What shall we do if there is a prompt with “insmod ztemt.ko failure” during the
installation?
There are two reasons:
1. This usually happens as you remove UI and install again. You need reboot to load
normally because the driver module is not well compatible with the system.
2. It also happens under Ubuntu9.04 version system because the USB driver already exists
in the system and the ztemt.ko driver file provided by UI can’t be loaded again.
However, we have built-in the automatic judgment and handling over Ubuntu9.04 in the
setup package; if such an error occurs to your system unexpectedly, use the following
method to manually pass two parameters to the kernel, and make the kernel support ZTE
USB modem.
Method: under the system startup interface, move the highlight to ubuntu9.04, press “e”
key to edit, select the item you want to start, add space after the word splash, input
“usbserial.vendor=0x19d2 usbserial.product=0xfff1”, press “Enter” to confirm and
press “b” to start.
(Use “lsusb” command to view PID and VID values.)

z Manually compile the driver

1. In some special cases, the setup package can’t automatically compile the driver, so you
need change the configurations yourself and manually compile the driver.
Method: enter the directory: /usr/local/bin/ztemtApp/zteusbserial, and find the corresponding
kernel version of current system.
For example: if the operating system is 2.6.27 kernel, please use the driver in 2.6.27 folder; if
the operating system is the version below 2.6.27, use the driver in below2.6.27 folder. Enter
the directory, execute make command. If the compiling is successful, ztemt.ko driver will be
generated in current directory.
Execute insmod ztemt.ko to load and copy the ztemt.ko under zteusbserial directory.

2. If it prompts with “Can’t find kernel source code”, please change the path of
KERNELDIR in Makefile.

ZTE Corporation http://www.zte.com.cn

Downloaded from www.Manualslib.com manuals search engine

 Wireless Data Terminal Installation Guide

（e.g.: KERNELDIR=/usr/src/kernels/2.6.27.4-79.fc10.i686)，and compile it again.

3. If you didn’t find the similar path in the system, follow the method above to install the
kernel development package.
z Configuration file path
When Linux setup program is being executed, UI configuration file, will be saved in user’s
directory.
~/.ztemtapp/ZTEEVDO/
z Can’t exit due to exception of UI software
In some rare cases, UI process is locked and can’t exit, it will occupy USB device file and
driver; it causes the failure of uninstallation, and UI program prompts with “Still can’t find
the device” after the device is plug out and plug in again.
In this case you could use killall -9 App to end UI process and let the system release all used
resources.
Plug in/out the device to normally run UI software.

z What shall we do if the uninstall fails and the software package can’t be installed again?
The common/other users use “sudo dpkg -i --forece-all setup package name” to perform
compulsory installation, and this will cover some remaining information and has no influence
upon the system. Root users don’t need sudo. Please note that there are two “-” before force and
there is no space between “force” and “-all”.

z What shall we do if there is no sound for UI or the other party can’t hear the sound?
1. In order to normally use ALSA sound frame, UI software provides the selection of
corresponding audio device.
ＵI default settings are select default device. The conflict among these three devices might
cause one device unable to make the sound due to different system configurations. Therefore
you need select the proper settings. Generally, the following selection method is
recommended
(the detailed operations might vary according to different Linux system versions and
hardware configurations)

During the use of UI, if Capture device can’t be used by default, please manually select one (generally
select the last one, namely, the second device). See the figure below:

ZTE Corporation http://www.zte.com.cn

Downloaded from www.Manualslib.com manuals search engine

 Wireless Data Terminal Installation Guide

2. Besides, you need to configure the sound controller in advance to make sure the system
recorder could normally record the sound from Microphone.
Refer to the figure below for configuration method:

Capture device is namely input device（Front Mic）as shown in the figure above; the system’s
Capture device generally corresponds to Front Mic.

z How to download libaudio?

fedora libaudio download url:

http://rpm.pbone.net/index.php3/stat/3/srodzaj/1/search/libaudio.so.2

opensuse libaudio download url:

http://rpm.pbone.net/index.php3/stat/3/limit/3/srodzaj/1/dl/40/search/libaudio.so.2/field%5B%5D/1/fiel
d%5B%5D/2

ubuntu libaudio download url:

http://packages.ubuntu.com/en/lucid/libaudio2

z how to solve the problem with modem-manager?

For Linux 2.6.31 kernel such as Fedora12, the prompt like “Cannot access serial port.Make sure you

ZTE Corporation http://www.zte.com.cn

Downloaded from www.Manualslib.com manuals search engine

 Wireless Data Terminal Installation Guide

have appropriate permission.” after installation might appear because this port is occupied by
modem-manager program. Simply remove modem-manager or change the name after backup, and then
restart the computer to solve this problem.

z Why doesn't the system automatically load CD-ROM and can't install the driver and UI
software after the data card is inserted?
It's unnecessary to install ZTE driver and UI software since the new version of usb_modeswitch
tool integrates the driver of data card. You can directly connect to the Internet through the system's
dialer. If you need install ZTE UI software, please open /etc/usb_modeswitch.conf, change the
value of DisableSwitching to 1, save the settings, and then insert the data card again. By doing so,
the system can automatically load CD-ROM.

z How can you make the data card not switch to Modem when you insert the data card
again?
1. Turn on the terminal.
2. Use “sudo vim /etc/usb_modeswitch.conf” to open the file.
3. Press “a” to enter the edit-mode, then move the cursor to DisableSwitching=0 and change the value
to 1.
4. Press “ESC” to quit the edit-mode, then press “:”, input “wq” and click the “Enter” Key.
5. Now the file is saved. You can use “cat /etc/usb_modeswitch.conf” to check whether it is modified
successfully.
6. Insert our data card again. The data card should not be switched to modem.

ZTE Corporation http://www.zte.com.cn

Downloaded from www.Manualslib.com manuals search engine