Install BTR

go back

Free version installation

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

 

Start enterprise version:

 

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

 

Shutdown BTR server:

   Only enterprise version have server.

1. WINDOWS

   In ms-prompt for bdee.exe:

   bdee> shutdown

2. LINUX

   In terminal for bdee.exe:

   bdee> shutdown

 

Uninstall BTR server:

    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

 

 

 

Java setup:

      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 )

Question & Answer

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.