Wireless Data Terminal Installation Guide

Reliance Netconnect+ AC2738

Installation Guide for Linux

This Installation Guide is used for Reliance Netconnect+.

ZTE Corporation

http://www.zte.com.cn

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. Its 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: its recommened to install with yast setup package manager. Select software,
ZTE Corporation

http://www.zte.com.cn

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: its 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

Wireless Data Terminal Installation Guide

Fedora: its 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. Installation using command line

Open the terminal program and key in the command:
sudo sh /media/cdrom0/install_linux or sudo sh/media/Reliance/install_linux
or enter to CD directory, execute sudo sh ./install_linux
since it requires super user authority during the installation, it might ask you to input super
user password.

2. Uninstallation using command line

Open the terminal program and key in the command:
sudo unztemtapp

3. Common problems during the installation and uninstallation

Authority/Right problem
This problem occurs as other users(non-admin users) are installing. The installation
cant be completed because there are no enough rights. Please use sudo command to
install (as shown above)

Old version not removed

In the process of script installation, it will pop up cover or not. If
you select yes, it will uninstall the old version and install the new version.
If you select no, it will exit the installation.

Uninstallation failure using command

If you uninstall failure in terminal program using the command sudo unztemtapp,

please key in the following command:

cd /usr/local/bin/ztemtApp
sudo sh ./uninstall
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
ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

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.

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-> Reliance Netconnect+
Execute ztemtapp command through terminal program
a)
b)

After running UI in this way, the following information will display on the terminal,
which will be used to track the problem.
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:

ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

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.
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, ttyUSB1under 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 Cant find device
when running UI.

Why is there no response when clicking ApplicationInternetReliance NetConnect

Solution: Input ztemtapp at the command lineApplications->accessories->terminal;
If the system prompts you with cant find command, the installation isnt successful, you
need install the software again;
If the system prompts you with missing libaudio2 library, you need install the
corresponding library file.

What shall we do if there is a prompt with Cant access the terminal or cant 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 dont 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.

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 cant 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

ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

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 cant 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 Cant find kernel source code, please change the path of
KERNELDIR in Makefile.
e.g.: KERNELDIR=/usr/src/kernels/2.6.27.4-79.fc10.i686)and compile it again.
3. If you didnt find the similar path in the system, follow the method above to install the
kernel development package.
Configuration file path
When Linux setup program is being executed, UI configuration file, will be saved in users
directory.
~/.ztemtapp/ZTEEVDO/
Cant exit due to exception of UI software
In some rare cases,UI process is locked and cant exit, it will occupy USB device file and
driver, it causes the failure of uninstallation, and UI program cant find the device after
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.
What shall we do if there is no sound for UI or the other party cant 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)

ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

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

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 deviceFront Micas shown in the figure above; the systems
Capture device generally corresponds to Front Mic.

ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

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/field%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 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

UI cant run successfully after installation,displaying the following note(Fedoral12

system)

Because selinux configuration can not install Xcomm successfully, solution:

Under /etc/selinux, edit the config file, correct SELLINUX=enforcing to
SELLINUX=disabled, please refer the following command:

Correct and save config file, and then restart PC. UI can work normally. Or, before UI installation
under system Fedora12, check whether SELINUX in config file is disabled or not. If not ,please
correct as the following.

ZTE Corporation

http://www.zte.com.cn

Wireless Data Terminal Installation Guide

Display the following error during UI uninstallation

The driver is working, so you can not delete the driver. In this condition, please restart the system
and then uninstall UI.

ZTE Corporation

http://www.zte.com.cn