Skip to content

Deploy AICCRA

Kenji Tanaka edited this page Sep 26, 2022 · 6 revisions

Deploy AICCRA

To perform the deployment of AICCRA on the Machete server, you must perform the following steps specified in the manual.

Previous tools

Prior to the execution of this manual, it is necessary that you have the data of host, username and password of the server, in the same way it is necessary to have the software called Putty

Server Host, Username and Password

You will find the host, username and password data in the deployment server.txt file which is hosted on the #dev-marlo-aiccra slack channel. You will find it pinned to the channel and you can access it by go into the #dev-marlo-aiccra channel (1) and then clicking on Pinned (2) button, where the list of pinned files will be displayed. Finally, you just must click on the file (3).

image

The data you will need is as follows (the rest of the file you can ignore): • prod host • prod user • prod pass Note: Have this information handy because it will be requested several times throughout the process.

Download Putty software

In case you don't have the putty software, you can download it from the following link: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

You can select option 1 to download the installer, or just download the executable by selecting option 2

image

Configurate connection in Putty

You should open putty, you will see the following window

image

To create a new connection in putty, you must enter the host (host prod) in the indicated field (1) and press the open button (2) to establish the connection. Note: Optionally you can save this connection by clicking on the save button after having:

  • The field (1) filled with the host information
  • The saved Sessions field filled with a custom name for your connection.

image

Send reset message in the AICCRA system to users

Users should be informed that the system will be rebooted (except in the case where the system is not available). To carry out this process you must go to AICCRA, login in and go the System Admin section, located in the upper right part of the screen.

image

Then you must select the Notifications option in the menu on the left side.

image

You must copy the content of Message #1 and paste it in the indicated text field (system reset message) (1). Finally, press the Send Message button (2) to send the message.

image

Deploy AICCRA in server

Click the “Open” button and then a command line window will appear. If this is the first time connecting to the server, a different window asking to trust the server will show up. Hit “Yes”.

Untitled

Enter the provided credentials and now you will be on the server.

In Putty when you enter the server (pressing the open button in the previous putty step), the following window will appear where you must enter the password (host pass).

Note: To enter the password you must copy the text from file (in the normal way) and paste it only pressing right click in this screen.

image

After entering the password, the following window appears

image

To perform AICCRA deployment, you need to run the following command: sudo bash home/marlo_admin/AICCRA/scripts/deploy_aiccra.sh To run the command, you must type it and press the enter key.

Note: you may be able to find this command in the history of the last executed commands (so you don't have to type it), to access the history, just press the up key on your keyboard until you find the command.

After pressing enter you will only have to wait approximately 6 minutes, and the AICCRA deployment will have been carried out if there is no previous error in the code or server.

image

See the tomcat log

Additionally, you can see the tomcat log obtained by the following command: sudo tail -F /opt/tomcat-aiccra/logs/catalina.out Note: To stop seeing the tomcat log, simultaneously press the control + c keys

In case you are asked for a password to see the tomcat log, enter the password (host pass). To enter the password, you must copy it from the text file (in the normal way) and to paste it you just have to right click in this screen. image