Installing DSC

Before using DSC, install it on the Linux or Windows server. DSC supports 64-bit Linux. Refer Table 2 to learn more about compatible OSs.

Prerequisites

  • In Linux, do not install or execute DSC as a root user. To execute the install.sh script, you must have the permission to create folders.
  • The size of the target folder must be at least four times that of the SQL files in the input folder.

    For example, if the size of the SQL files in the input folder is 100 KB, the target folder must have at least the space of 400 KB to process the SQL files.

    • To query for the available disk space of the target folder in Linux, run the following command:
      df -P Folder path
    • To query for the size of the input file in Linux, run the following command in the directory storing the file:
      ls -l
  • JRE 1.8 or later and Perl have been installed. For details about the hardware and software requirements, see System Requirements.
    To check the installed Java version and set the Java path, perform the following steps:
    1. Check whether the Java version meets requirements.
      java -version
    2. Ensure that the Java path is correctly set.
      • Linux
        1. Check whether the Java path is correctly set.
          echo $JAVA_HOME
        2. If no information is returned, add the following two lines to the .bashrc file of the current user, save the modification, and exit.
          Assume that the Java installation path is /home/user/Java/jdk1.8.0_141.
          export JAVA_HOME=/home/user/Java/jdk1.8.0_141
          export PATH=$JAVA_HOME/bin:$PATH
        3. Activate Java environment variables.
          source ~/.bashrc
      • Windows
        1. Right-click My Computer and choose Properties from the shortcut menu. The System window is displayed.
        2. Click Advanced System Settings. The System Properties dialog box is displayed.
        3. On the Advanced tab page, click Environment Variables. The Environment Variables dialog box is displayed.
        4. Select Path in the System variables area. Click Edit and check the Java installation path.

          If the Java installation path does not exist or is incorrect, append it in Path.

          Assume that the Java installation path is C:\Program Files\Java\jdk1.8.0_141\bin and the environment variable in Path is c:\windows\system32;. Set Path to c:\windows\system32;C:\Program Files\Java\jdk1.8.0_141\bin;.

Procedure

DSC is an installation-free tool. You can use it after downloading and decompressing the software package.

The following procedure describes how to obtain the package. Decompress the package DSC.zip, you will obtain the files shown in Table 1.

In Windows:

  1. Download the software package and package verification file.

    • DSC.zip: software package
    • DSC.zip.sha256.txt: verification of software package

  2. Decompress the DSC.zip package.

    DSC folder is generated.

    You can decompress the DSC.zip in any folder based on preferences.

  3. Go to the DSC directory.
  4. Find and check the files in the DSC directory.

Table 1 describes the obtained folders and files.

In Linux:

  1. Extract files from DSC.zip.

    sh install.sh

  2. Go to the DSC directory.

    cd DSC

  3. Check the files in the DSC directory.

    ls 
    config   lib   scripts   bin  input output runDSC.sh  runDSC.bat

Table 1 describes the obtained folders and files.

Table 1 DSC directory

Folder or File

Description

DSC

bin

All dsc-related jars (executable) are available.

config

Configuration files of DSC.

input

Input folder

lib

Library files required for the normal running of DSC.

output

Output folder

scripts

Customized configuration scripts for Oracle schema conversion, which can be executed to implement corresponding functions.

runDSC.sh

To run the application in Linux operating system.

runDSC.bat

To run the application in Windows operating system.

changelog

To notify the current modifications.

Install.sh

To set the file permissions for DSC.

readme

To read the instructions before installation and configuration.

If you do not need DSC, you can uninstall it by deleting the DSC folder.