Install BTR
1.WINDOWS:
1) unpack BTR-free.zip to a temp directory d:\temp
2) cd d:\temp\win
3) run d:\temp\win\install.exe
install.exe
4) assign BTR directory , BTR directory can not be root directory.
d:\BTR
5) try to start
cd d:\BTR
bd.exe
LINUX:
1) unpack BTR-free.zip to a temp directory .( here is /home/user/temp )
2) cd /home/user/temp/linux
3) run /home/user/temp/linux/install.exe
chmod ugo+x install.exe
./install.exe
4) assign BTR directory.
/home/user/BTR
5) try to start
cd /home/user/BTR
./bd.exe
Enterprise version installation( Client )
BTR client installation just like the free version installation.
1.WINDOWS:
1) unpack BTR.zip to a temp directory d:\temp
2) cd d:\temp\win\client
3) run d:\temp\win\client\install.exe
install.exe
4) assign already exist BTR directory , BTR directory can not be root directory.
d:\BTR
LINUX:
1) unpack BTR.zip to a temp directory .( here is /home/user/temp )
2) cd /home/user/temp/linux/client
3) run /home/user/temp/linux/client/install.exe
chmod ugo+x install.exe
./install.exe
4) assign already exist BTR directory.
/home/user/BTR
5) if you debug java, run the following as root right:
/home/user/BTR/jshell/java_setup.sh ( root )
Enterprise version authentication
The installation of server needs serial key , install key , active key. The server must set the assigned hostname.
1.serial key and hostname
When customer buy enterprise version BTR, customer will get the serial key and the assigned hostname from btrue software co.,ltd.
Bye the way , the server hostname can be named by customer.
2. install key
When customer install the server of BTR, install.exe will generate the install key. The install-key is saved in ../BTR/setup/install.ini.
3. active key
When customer complete the server installation. install.ini must fill in active key before bdee.exe can run correctly.
When customer email the install.ini file to btrue software technology co.,ltd. Then active key is returned quickly.
Enterprise version installation( Server)
1.WIN:
1) check the pc name , the pc name must be the same with the assigned hostname.
2) unpack BTR.zip to a temp directory d:\temp
3) cd d:\temp\win\server
4) run d:\temp\win\server\install.exe
install.exe
5) assign already exist BTR server directory , BTR directory can not be root directory.
d:\BTRs
6) input serial key , for example:
1879113254256275
7) installation finished . Generated file d:\BTRs\setup\install.ini .
8) email the install.ini file to btrue software co.,ltd .
9) get the new install.ini file from btrue company which included active key .
the active key like:
3C34FE452AA566E23315D9823A9ABFAD2AA566E2BA76AE82
10) replace the old file d:\BTRs\setup\install.ini with new install.ini
A example:
[user_name]
CHINA
[serial_no]
1879187754640679
[install_key]
BB75587F1C4EE5026F494961F5AD7A7CA494094BC3220A4B386BC325386BC3253467E8435409AC505D05A0491C10A9001C4A9A0CFC7AF8574A1EC0F34C315951EF5B4A51EF5B5551EF5B5551EF5BA302
[active_key]
06F1CDC18BA356910A3729B845265CC18BA356914E16DFB8
2.LINUX:
1) check the host name , the host name must be the same with the assigned hostname.
hostname ( input "hostname" command to check the hostname )
/etc/rc.d/rc.sysinit modify the hostname
if [ -z "$HOSTNAME" -o "$HOSTNAME" = "(none)" ];then
HOSTNAME=localhost
fi
HOSTNAME=yourhostname
2) unpack BTR.zip to a temp directory /home/user/temp
3) cd /home/user/temp
4) run /home/user/temp/install.exe
chmod ugo+x install.exe
./install.exe
5) assign already exist BTR server directory .
/home/user/BTRs
6) input serial key , for example:
1879113254256275
7) installation finished . Generated /home/user/BTRs/setup/install.ini file.
8) Email the install.ini file to btrue software co.,ltd .
9) get the new install.ini file from btrue company which included active key.
the active key like:
3C34FE452AA566E23315D9823A9ABFAD2AA566E2BA76AE82
10) replace the old file d:\BTRs\setup\install.ini with new install.ini
A example:
[user_name]
CHINA
[serial_no]
1879187754640679
[install_key]
BB75587F1C4EE5026F494961F5AD7A7CA494094BC3220A4B386BC325386BC3253467E8435409AC505D05A0491C10A9001C4A9A0CFC7AF8574A1EC0F34C315951EF5B4A51EF5B5551EF5B5551EF5BA302
[active_key]
3C34FE452AA566E23315D9823A9ABFAD2AA566E2BA76AE82
1. WINDOWS
1) Open ms-prompt to start server first
cd d:\BTRs
bdee.exe
2) Open ms-prompt to start client No#1
cd d:\BTR
bd.exe
3) Use the others pc to start client No#1 , ... No#n
cd d:\BTR
bd.exe
2. LINUX
1) Open terminal to start server first
cd /home/user/BTRs
./bdee.exe
2) Use terminal to start client No#1
cd /home/user/BTR
./bd.exe
3) Use the others linux pc to start linux client No#1 , ... No#n
cd /home/user/BTR
./bd.exe
Only enterprise version have server.
1. WINDOWS
In ms-prompt for bdee.exe:
bdee> shutdown
2. LINUX
In terminal for bdee.exe:
bdee> shutdown
Only enterprise version have server. Uninstall the server must run install /uninstall to remove it and generate UNINSTALL-KEY . If you want to re-install the bdee.exe. You must send install.ini file which include UNINSTALL-KEY to btrue commany , then you can get another active-key again.
WINDOWS:
install.exe /uninstall
LINUX:
./install.exe /uninstall
1. If you have already installed bd.exe , use install.exe /uninsall to remove it . ( only bd.exe need java setup , bdee.exe need not any more )
2. JDK and Java web
You must install JDK or J2EE first, assign the JAVA_HOME , CLASSPATH ..., If you want debug servlet or EJB , you must install tomcat , weblogical , websphere or others java web.
3. SELinux config
root user modify:
/etc/selinux/config
SELINUX=permissive
Because BTR debugger will insert librarys into /usr/lib/ path , it needs setenfore 0
4. install bd.exe
./install.exe
5. java setup shell
Run BTR install.exe, install.exe will generate java_setup shell. BTR will add library to java home , but add these libs need root user privilege.
In Windows, BTR install.exe may not set java environment , so java setup is ...\jshell\java_setup.bat :
copy ...\jni\jni.jar "%JAVA_HOME%\jre\lib\ext\jni.jar"
In linux, java setup is jshell/java_setup.sh , it need root user to run .../BTR/jshell/java_setup.sh:
cp .../jni/jni.jar $JAVA_HOME/jre/lib/ext/jni.jar"
cp .../lib/libbdl.so /usr/lib/libbdl.so
For example in linux, user's operation like:
cd /home/usr/BTR/jshell
su
./java_setup.sh
6. Modify CLASSPATH environment variable
In Windows, modify CLASSPATH in environment:
CLASSPATH = ... ; %JAVA_HOMW%\jre\lib\ext\jni.jar
In Linux, modify CLASSPATH in environment:
export CLASSPATH = ... : $JAVA_HOMW\jre\lib\ext\jni.jar
After the steps show as above, reboot linux then you can build java project and debug them now.
7. SELinux config restore
root user modify:
/etc/selinux/config
SELINUX=old value( =enforcing )
1) bdee.exe
Q: I have already install bdee.exe, but bdee.exe don't run?
A: Please check setup\install.ini , check [active_key] which get from btrue company and fill in here.
2) bdee.exe
Q: I have already set install.ini for bdee.exe, but bdee.exe don't run?
A: Please check host name , hostname must set correctly.
3) java
Q: I have already install BTR, but I can't debug java project ?
A: Please check if jshell\java_setup.sh have already runned by root privilege.
4) java
Q: I have already install BTR, but I can't debug java project ?
A: Please check if javac.exe version is the same as the java.exe version.
5) java
Q: I have already install BTR, but I can't debug java project ?
A: Please check if /etc/selinux/config( SELINUX=permissive ) is set correctly.
6) large project
Q: I use BTR debug my project, sometimes the code log have no [file][no] location , why?
A: Because the project is large and you use free BTR version. Enterprise version have no this problem..
7) build failed
Q: I use BTR build my project , but it failed , why?
A: First , you must rebuild all your project without BTR debugger. Then you use BTR debugger build it.