NE-ONE: Applying a Patch Kit

by Calnex

Applying an NE-ONE Patch Kit

 

Where you see <username> and <password> use the credentials you have set.

If you do not know these please contact support.

 

1) Use scp, sftp (or filezilla or similar) to transfer the file to the NE-ONE, once you have copied the file into the secure environment. The example below shows scp, assuming that the patch kit you received is called ne-one-patch-202204082031

scp -p ne-one-patch-202204082031 <username>@<your ne-one ip address>:

(you'll be prompted for the password for the <username> username as usual - the default is <username>)

 

The file is now in the home folder of the <username> user /home/<username>

 

2) log in to the console of your NE-ONE :

a) $ ssh <username>@<your ne-one ip address>

<username>@<your -ne-one ip address>'s password:

You get the menu:

b) leave the menu with E <enter>

 

c) You may already have a patches folder under /ippe, check with:

<username>@NE-ONE:~$ ls -l /ippe

total 40

drwxr-xr-x 8 root root 4096 Apr 6 13:15 config

drwxr-xr-x 2 root root 4096 Apr 8 17:44 db

drwxr-xr-x 3 root root 4096 Apr 28 2021 debug_patches

drwxr-xr-x 7 root root 4096 Apr 10 19:01 filesystem

drwxr-xr-x 2 root root 4096 Feb 16 14:02 host_bin

drwxr-xr-x 9 root root 4096 Apr 27 2021 jail

drwxr-xr-x 3 root root 12288 Apr 10 19:01 logs

drwxr-xr-x 4 root root 4096 Apr 10 18:58 patches

 

You should see the patches folder in the list, as above.

 

If it is not there, create a ./patches under /ippe on your NE-ONE

<username>@NE-ONE:~$ sudo mkdir -p /ippe/patches

 

d) copy the ne-one-patch-202204082031 file to that folder

<username>@NE-ONE:~$ sudo cp -p ne-one-patch-202204082031 /ippe/patches

 

e) go the the patches folder:

<username>@NE-ONE:~$ cd /ippe/patches/

 

f) expand the ne-one-patch-202204082031 tarball into this folder:

<username>@NE-ONE:/ippe/patches$ sudo tar -xvzf ne-one-patch-202204082031

./bin/ipperte

./ext/Default

./ext/Expression

./ext/Generate

./ext/Labs

./ext/Service

./ext/Soft_Port

 

g) check that all the files are present:

 

<username>@NE-ONE:/ippe/patches$ ls -lR

.:

total 21368

drwxr-xr-x 2 root root 4096 Apr 10 20:02 bin

drwxr-xr-x 2 root root 4096 Apr 10 20:02 ext

-rw-rw-r-- 1 <username> <username> 21872461 Apr 10 18:49 ne-one-patch-202204082031

 

./bin:

total 57844

-r-sr-sr-t 1 root root 59229632 Apr 8 21:31 ipperte

 

./ext:

total 4632

-rwxrwxr-x 1 <username> <username> 1050496 Apr 8 17:00 Default

-rwxrwxr-x 1 <username> <username> 581704 Apr 8 17:00 Expression

-rwxrwxr-x 1 <username> <username> 342136 Apr 8 17:00 Generate

-rwxrwxr-x 1 <username> <username> 1461408 Apr 8 17:00 Labs

-rwxrwxr-x 1 <username> <username> 307448 Apr 8 17:00 Service

-rwxrwxr-x 1 <username> <username> 985192 Apr 8 17:00 Soft_Port

 

NOTE: The dates and times may vary a little due to timezone and clock differences, the sizes should be the same as above

 

h) make sure ipperte has the correct protections:

<username>@NE-ONE:~$ sudo chmod 555 /ippe/patches/bin/ipperte

 

i) and check the protections:

 

<username>@NE-ONE:/ippe/patches$ ls -l /ippe/patches/bin

total 57844

-r-xr-xr-x 1 root root 59229632 Apr 8 21:31 ipperte

<username>@NE-ONE:~$

 

j) enter the docker environment:

<username>@NE-ONE:~$ sudo docker exec -it ippe bash

 

k) enter the command to restart the ippe engine

root@NE-ONE:/# kill -1 1

 

l) check that the patching has taken place by looking at the ippe.log file for patching messages:

root@NE-ONE:/# grep -Eia 'ippe version|patching' /ippe/logs/ippe.log

2024-05-17 17:02:25.379402: PATCHING /ippe/ext/Labs
2024-05-17 17:02:25.384021: PATCHING /ippe/ext/Soft_Port
2024-05-17 17:02:25.386660: PATCHING /ippe/ext/Expression
2024-05-17 17:02:25.388602: PATCHING /ippe/ext/Generate
2024-05-17 17:02:25.390209: PATCHING /ippe/ext/Service
2024-05-17 17:02:25.391422: PATCHING /ippe/ext/Default
2024-05-17 17:02:25.394197: PATCHING restarting to patch ipperte (2024.05.000000 202405171503)
2024-05-17 17:02:25.394206: PATCHING Restarting with command: [/ippe/patches/bin/ipperte -z -d]
2024-05-17 17:02:25.450164: PATCHING /ippe/bin/ipperte from /ippe/patches/bin/ipperte
2024-05-17 17:02:25.769547: PATCHING Restarting with command: [/ippe/bin/ipperte -x -d]
2024-05-17 17:02:25.782195: PATCHING All patches have been applied
2024-05-17 17:02:25.782745: IPPE Version: 2024.05.000000

 

In the above output we’re looking for the PATCHING statements immediately above the last IPPE Version: - these should correspond to the files supplied.