Rate This Document
Findability
Accuracy
Completeness
Readability

Migrating from Tomcat to TongWeb

  1. Obtain TongWeb and the installation method.
  2. Click the following link to obtain the TongWeb conversion tool, or contact TongTech to obtain the tool.
  3. Decompress the TongWeb tool and conversion tool packages.
  4. Create input and output directories for the conversion.
    1
    mkdir migrate_input; mkdir migrate_output;
    
  5. Copy the following files to be migrated to the input directory. tomcat_home indicates the source Tomcat installation directory.
    cp {tomcat_home}/bin/catalina.sh Absolute_path_to_the_migrate_input_directory
    cp {tomcat_home}/conf/server.xml Absolute_path_to_the_migrate_input_directory
    cp {tomcat_home}/conf/context.xml Absolute_path_to_the_migrate_input_directory
    cp {tomcat_home}/conf/tomcat-users.xml Absolute_path_to_the_migrate_input_directory
    cp {tomcat_home}/conf/catalina.properties Absolute_path_to_the_migrate_input_directory
    cp {tomcat_home}/conf/web.xml Absolute_path_to_the_migrate_input_directory
    cp -r {tomcat_home}/webapps/* Absolute_path_to_the_migrate_input_directory
    cp -r {tomcat_home}/lib/* Absolute_path_to_the_migrate_input_directory
  6. Go to the TongWeb conversion tool package directory and modify the application.properties file.
    1. Open the application.properties file.
      1
      vi application.properties
      
    2. Press i to enter the insert mode and modify the following configuration items.
      root.dir.input=Absolute_path_to_the_migrate_input_directory
      root.dir.output=Absolute_path_to_the_migrate_output_directory
      tongweb.version=TongWeb_version
      tomcat.version=Tomcat_version
    3. Press Esc, type :wq!, and press Enter to save the file and exit.
  7. Start the migration.
    1
    sh migration.sh
    
  8. Place the file generated in the migrate_output directory to the same-level directory under the TongWeb decompression directory. For example:
    cp -r Absolute_path_to_the_migrate_output_directory/conf/* absolute_path_for_TongWeb_installation/conf
  9. Go to the bin directory in the directory where TongWeb is decompressed and run the following command to start the TongWeb service:
    1
    sh startserver.sh
    
  10. Visit http://IP_address:9060/console to go to the TongWeb login page.

    For details about the default user name and password, see Accounts.