Page Comparison

Installation

1. Create and cd to a directory on the server where the application will be unpacked:
   mkdir -p 3yd_v404 && cd 3yd_404

2. Download the archive package from the link provided by the 3YD Technical Support team:
   curl -o 3yd_v4.0.4.tgz “Download Link“
   Note: The link should be surrounded in double quotes ““ as it contains symbols interpreted as special characters by the bash shell

3. Unpack the installation package: tar -zxvf 3yd_v4.0.4.tgz

4. Create a folder where the uploads can be stored called UPLOADS_DIR. (Must be an absolute path like /home/ubuntu/UPLOADS_DIR) that is deploying the application
   mkdir -p $HOME/UPLOADS_DIR

5. Find out the domain under which the app should be publicly reachable (DOMAIN, hostname like app.example.com)
   Note: We suggest exporting the two variables above in your .bashrc by appending the two lines to the end of the file.
   vim ~/.bashrc or nano ~/.bashrc to open and edit the .bashrc file
   Append the code to the end of the file

   Code Block
   export DOMAIN=yourDomainName.xxx export UPLOADS_DIR=/home/ubuntu/UPLOADS_DIR

   Reload your ./bashrc with source ~/.bashrc

6. Run the install script:

   sudo ./install.sh $DOMAIN $UPLOADS_DIR; exec bash -l

7. You can now make changes to the configuration file values.yaml.

8. Apply the changed configuration:

   sudo ./upgrade.sh

9. Check the status of the application:

   kubectl get pods

Upgrade to the next version

1. Unpack the new version of the installation package to a new directory on the machine

2. Run the update script in the new directory:

   sudo ./update.sh

Migration from previous installation method (appconfig)

1. Follow the installation instructions above

2. Copy the files from the uploaded files previous installation to the directory specified as UPLOADS_DIR:

   • 3D files into UPLOADS_DIR/backend-uploads

   • Media files into UPLOADS_DIR/button3d-media

   • Private media files into UPLOADS_DIR/button3d-private-media

3. Make sure that all files have the same read and write permissions and ownership/group membership as the directories they were copied in.