Upgrade & Downgrade Procedures

How to upgrade servers?

1. Searching customer sitename in the POS portal list. Click their “Full Name” to the page to see the “Upgrade” button.

2. Click “Upgrade” will pop out a page allowing you to choose which version you want to upgrade. Waiting the page loading completed to finish the upgrade. Sometimes the Pi3 or Pi4 is too slow to run the whole upgrade program, Portal will stop loading early before the system completes the upgrade. You need to go to their data center by click Server undering Device Access:

1. Login as root:

1. pi (passcode: pipos) for Pi 3 or Pi4;

1. Run su pi , enter passcode. Now you should undering pi@sitname

2. “sudo bash” login as root@sitname

2. cafe (passcode: jin123) for x86 PC server.

1. Run su cafe, enter passcode. Now you should undering cafe@sitname

2. “sudo bash” login as root@sitname

2. Run “v” to check the current version.

3. run “wm” undering root to track the mysql admin processlist status. When it stops inserting tables to mysql, It means the upgrade process is completed. “Ctrl + c” to exit the processlist page back to root@sitname.

3. To double check the current version, run “v” undering root account.

4. Keep using “Ctrl +d” to log out.

Note: pi3 and pi4 server when doing upgrade, if their current version is before 2023 should take almost an hour to run the upgrade process to Latest/Beta version (2024). 

Who will do the upgrade?

1. Everytime a new version is released to Beta, R&D provides the upgrade list in HQ group chat. The person who does the night shift or early morning shift should help merchants upgrade. Right now Sunshine and Darwin need to take care of the upgrade list.

2. Other Night shift or morning shift support teams should double check support emails, if there is an email received with keywords “upgrade”, from:

1. The person reported the ticket

2. DT

3. [email protected] (sales department)

4. [email protected] (Level 2 support)

5. [email protected] (Level 1 support)

Should list the upgrade information details contain problem issues and solutions.  

When is the better time to upgrade?

1. Monday to Thursday after the merchant was closed, or the morning shift before them open.

2. If the situation is too urgent, you can help them upgrade immediately. Like they cannot take an order or can not use the POS system. 

Which version is better for customers to upgrade?

Latest version:

• Release quarterly

• More stable version

• Usually for the new customer using

Beta version:

• Release once two weeks

• Adventure version

• Unstable use for the new customers

• Fixed problem issues existing in the latest version

• Having some new features released for customers trying to use and give us feedback to make it stable

How to downgrade servers?

1. Searching customer sitename in the POS portal list. Click their “Full Name” to the page to see the “Upgrade” button.

2. Click “Upgrade” will pop out a page allowing you to choose which version you want to upgrade. Waiting the page loading completed to finish the upgrade. Sometimes the Pi3 or Pi4 is too slow to run the whole upgrade program, Portal will stop loading early before the system completes the upgrade. You need to go to their data center by click Server undering Device Access:

1. Login as root:

1. pi (passcode: pipos) for Pi 3 or Pi4;

1. Run su pi , enter passcode. Now you should undering pi@sitname

2. “sudo bash” login as root@sitname

2. cafe (passcode: jin123) for x86 PC server.

1. Run su cafe, enter passcode. Now you should undering cafe@sitname

2. “sudo bash” login as root@sitname

2. Run “v” to check the current version.

3. Run “c” go to the root@nancy25: www$ [ same as run cd /var/www/]

4. Run “l” to check all history versions the server had.

5. Run: “mv html html.bk” [rename the html (which is default name of the current version server always running) to “html.bk”]

6. Run: “mv html20230610 html” [rename the version the merchant want to use to “html”]

7. Run: “systemctl restart apache2” [restart the program apache2 (which is the program to clear the memory re-catch the new version code to save in the memory)]

8. Refresh browser on terminal

1. To double check the current version, run “v” undering root account.

Keep using “Ctrl +d” to log out.

Who will do the downgrade?

Anyone in the support team should know about it and can do it individually.

When is the better time to downgrade?

1. Monday to Thursday after the merchant was closed, or the morning shift before them open.

2. If the situation is too urgent, you can help them upgrade immediately. Like they cannot take an order or can not use the POS system.

Which version is better for customers to downgrade?

You need to check the history versions first:

1. Run “c” go to the root@nancy25: www$

2. Run “cd html20240617” [the files name]

3. Run “l”, it will provide the files inside of it. You can check the most frequently displayed date, which is the date of the version.

Then depending on what’s the problem they would like to resolve, you need to go to the portal →Admin→Version to check all the history recording of bug fixes and features released to make the decision.