Archive Trac instance rodeo

Instance Rodeo

Legacy Trac archive page imported from instance_rodeo. Source: https://genapp.rocks/wiki/wiki/instance_rodeo. Review age, links, and examples before treating as current.

SGCI Rodeo Instructions

PRELIMINARY COPY OF ATOMSPHERE INSTRUCTIONS... NEEDS EDITING/TESTING

A prepared instance for GenApp is available for TACC/Rodeo's through an arrangement with SGCI through their hosting service.

Prerequisites

You must first request hosting services from SGCI by filling out this form.

Once you have successfully applied and been granted SGCI hosting time you can get access to SGCI's hosting system and get started.

A nice overview of Rodeo usage is here

For a step-by-step walkthrough, see [https:SGCIHostingWithGenapp.pdf]

Rodeo Image

• GenApp Ubuntu Xenial

Setting up

1. Login with your credentials

• $ {{{ssh rodeo@ip-address-associated-to-instance}}}
  • ip-address-associated-to-instance is the ip address you have associated it to the instance.

1. Update the operating system

• $ {{{sudo apt-get update && sudo apt-get dist-upgrade}}}
• if instructed, reboot the system and go back to step 1.

1. If you wish to use another user besides 'rodeo', add the user to the genapp group:

• $ {{{sudo usermod -a -G genapp user}}}
  • replace user with the proper user name

1. Logout and login again
2. update to the latest version of GenApp

• $ {{{svn update /src/genapp}}}

1. Set the configuration for your instance

• $ {{{$GENAPP/sbin/setconfig.pl -f -pj}}}
  • The created {{{$GENAPP/etc/config.json}}} can also be manually edited
  • $ {{{$GENAPP/sbin/setconfig -h}}} will list options available for advanced usage

1. Reconfigure your system

• $ {{{$GENAPP/sbin/reconfig}}}
• The VM instance should now be ready to use.
• You should next follow post install steps outlined here.
  • note that the postfix mail server is already setup and running, but you will need to add proper values to each application's appconfig.json manually if you wish to use the "admin" and "feedback" systems.
  • e.g. add or edit this block in appconfig.json, replacing the key values appropriately:

    "mail"     : {
	"admin"    : "<redacted-email>"
	,"feedback" : "<redacted-email>"
	,"from"     : "the.host.name"
    }

• in a future update, we will work to simplify the email setup

Security

• Secure your public facing website!