HeapMS-Installation-Process

• HeapMS website: http://120.126.17.186
  First, open the terminal in your Ubuntu environment. Then, execute all the following commands and operations:

Installing the environment

1. Update

   sudo apt-get update  

2. Remove the existing Docker environment.

   sudo apt-get remove docker docker-engine docker.io   

3. Install a new Docker environment.

   sudo apt install docker.io   

4. Run the Docker environment.

   sudo service docker start    

   At this point, you will be able to execute Docker commands.
5. Find the absolute file path of the "pc4_heapms.tar" or "heapms_new.tar" file stored on your computer.
   Download pc4_heapms.tar (file size: ~60GB) link:
   (https://onedrive.live.com/?authkey=%21AO8kOvVhBSEuxZc&id=7309231C4353D1C0%21447583&cid=7309231C4353D1C0&parId=root&parQt=sharedby&o=OneUp)

   realpath pc4_heapms.tar

   Download heapms_new.tar (with four colors, file size: ~33.23GB) link:
   https://onedrive.live.com/?authkey=%21AG8MPsmwIyBenxU&id=7309231C4353D1C0%21502588&cid=7309231C4353D1C0&parId=root&parQt=sharedby&o=OneUp

   realpath heapms_new.tar
   

   
6. Create a Docker image through the "pc4_heapms.tar" file.

   docker load < /home/ccllab/Downloads/pc4_heapms.tar    

   After executing the command, the result will be as follows:
7. To check if the "pc4_heapms.tar" has been successfully created as a Docker image, you can use the following command:

   docker images   

   
8. To create a container named "node1," use the following command. If the container creation is successful, you will see the following output:

   sudo docker run -t -i --name node1 pc4_heapms:latest /bin/bash   

   
9. To check if the container "node1" has the /docker_mount path, you can use the following command:

ll  

11. To check if the container "node1" has the /docker_mount path, you can use the following command:

cd /docker_mount  

ll  

Upload files

11. Next, use the 'cd' command to navigate to the directory /docker_mount/web/upload in order to prepare for uploading the data you want to execute.

cd /web/upload 

12. To upload a file, you need to use the following commands in your local terminal:

sudo scp -P 22034 /home/brojack/Desktop/heapms_dataset/OSCC-1_time_intensity.tsv ccllab@120.126.17.213:/home/ccllab/Downloads 

/home/brojack/Desktop/heapms_dataset/OSCC-1_time_intensity.tsv : Path of the file to be uploaded (local machine): ccllab@120.126.17.213:/home/ccllab/Downloads : Location where the file should be uploaded (remote machine):
#Because I'm using a remote Ubuntu virtual machine, the IP address "120.126.17.213" represents the IP address of the virtual machine, and "22034" represents the port number of the virtual machine's IP.
The following image shows the execution result:
Afterward, you will be able to see the uploaded file in the '/Downloads' directory.
13. After uploading all the files you want to execute, you need to move these files into the container "node1" that was created initially.
14. Now, open a new terminal and connect to the previously created container "node1".

sudo -s

docker attach node1 

15. Create a directory under /docker_mount/web/upload/ to store the files for execution. OSCC-1 : Folder name，You can name the folder whatever you like.

mkdir OSCC-1 

ll

16. Move the data that needs to be executed from /Downloads to /docker_mount/web/upload/OSCC-1, which is the newly created folder named "OSCC-1".

docker cp /home/ccllab/Downloads/OSCC-1_human.csv node1:/docker_mount/web/upload/OSCC-1/

/Downlaods:

/OSCC-1:

After uploading all the files, the /OSCC-1 directory will contain the uploaded data, and you can proceed with running the program.
17. Before executing the program, you need to rename the three files in /OSCC-1 to the following names:

mv OSCC-1_human.csv human.csv

mv OSCC-1_skyline.csv skyline.csv

mv OSCC-1_time_intensity.tsv time_intensity.tsv

After renaming, the file names in /OSCC-1 will appear as shown in the following image:
#If the names of those three files are not modified, it will not be able to execute the program.

Start executing the program.

18. Go back to the location /docker_mount/web/, and you will find the programs for execution inside.

cd /docker_mount/web/

ll

19. Execute the program "exe.py".

python3 exe.py upload OSCC-1

exe.py : This program will automatically execute programs 1 to 13. upload OSCC-1: The files to be executed will be stored here. #If you want to execute each program one by one and see the output results, replace "exe.py" with the specific program you want to execute, as follows:

python3 1_rmTQN_format_trans.py upload OSCC-1

Path: /upload/OSCC-1, as shown in the following image:
20. If it is displayed in a format similar to the image below, it means that the execution was successful.