Prerequisites

1. Take a backup of Jiffy,gus, and Mongo DB.
2. Mongo DB and Postgres DB must be up and running.
3. Ensure SSH connectivity to core machine (preferred method using private key).
4. Connected users must have sudo privilege for root installation
5. Extract the ansible-playbook tar file provided.

   tar -xf jiffy-playbook.tar.gz

   The extracted files include the inventory and variable.yml files in the /tmp/ folder.
6. The Inventory file has to be filled as per the user environment(must have all the details of the machines, authentication methods)
7. Variable file has to be filled as per the user environment(must contain all the parameters, such as, username, configurable values, mountpoint, etc.)

8. Download Artifacts to a new folder under /tmp/{jiffy-install} in core machine.

   wget --user {username} --ask-password downloads.jiffy.ai/4.3.0.0/jiffy-cognitive_upgrade.tar.gz

   wget --user {username} --ask-password downloads.jiffy.ai/4.3.0.0/jiffy-upgrade.tar.gz

   wget --user {username} --ask-password downloads.jiffy.ai/4.3.0.0/jiffy-playbook.tar.gz

Contact support@jiffy.ai for the login credentials.

Upgrade Steps

1. Stop application and functionator container as a jiffyapp-usr and remove images.
2. Update the inventory file. View the sample inventory file here.
3. Provide an IP or a hostname as the connection string.

   The core IP can be localhost, as the playbook is executed from the Core server.

4. SSH credentials must be updated in the inventory file.
   • If authentication is with SSH-User and Password:
   • Uncomment ansible_ssh_pass and update the password.
   • Uncomment ansible_user and update ssh username.
   • Comment ansible_ssh_private_key_file.

   For users with sudo privilege: add ansible_sudo_pass={password}in the inventory file.

   • If authentication is with SSH-User and Private-Key:
   • Uncomment ansible_user and update ssh username.
   • Uncomment ansible_ssh_private_key_file and update the path to private key file.
   • Comment ansible_ssh_pass.
5. Configure the variable.yml file in the /tmp//jiffyinstall/folder as per the corresponding environment.
6. Execute the play book to begin the pre-upgrade and follow instructions on the screen.

Pre-Upgrade

ansible-playbook pre-upgrade/main.yml -i inventory -e @variable.yml

Debug Mode

ansible-playbook pre-upgrade/main.yml -i inventory -e @variable.yml -v

Detailed Debug Mode

ansible-playbook pre-upgrade/main.yml -i inventory -e @variable.yml -vvvv

Upgrade

Execute the following commands as a Root user:

ansible-playbook upgrade/main.yml -i inventory -e @variable.yml

Debug Mode

ansible-playbook upgrade/main.yml -i inventory -e @variable.yml -v

Detailed Debug Mode

ansible-playbook upgrade/main.yml -i inventory -e @variable.yml -vvvv

Execute the below ansible command to bootstrap application:

1. with masterkey prompt:

   ansible-playbook jiffyconfiguration.yml -e @variable.yml

2. without masterkey prompt:

   ansible-playbook jiffyconfiguration.yml -e masterKey=’’ -e @variable.yml

Post Upgrade

Run below commands as a Jiffy application user.

Keep only below files inside $JIFFY_HOME/deploy/jiffy/src/connectors/ and remove other files.

functions_metadata.json
constants.py

Validate anthill, coral, mangrove, Zeus properties for jiffy URL host should be localhost.
Take backup of exiting $FILESERVER_HOME/deploy/conf/ directory and copy new conf directory $FILESERVER_HOME/deploy location and restart fileserver

• cd $FILESERVER_HOME/deploy/bin
• cp -rf conf/ ../
• application install jiffy
• application client jiffy
• application start all

As a root user in Jiffy cognitive server:

1. Validate output, document data folder ownership and update to Jiffy application user.

2. Check docker image creation date.