List of RightScripts
Table of contents
No headers
APP OpenVPN install and client configuration
This script will install OpenVPN and set up the client certificate by using OpenVPN easy-rsa. It will then send the Certificate Signing Request to the CA server via a secure channel. It has the basic client configuration setup by using tun device. Users should set up their own firewall, if they need it.
AMZN Bundle Tools Update
This updates the bundle tools on the instance to the latest Amazon version.
APP FaceBook Footprints bootstrap configure
It initializes the FaceBook Demo ready to be used after a fresh installation.
APP Mephisto bootstrap configure
It initializes the mephisto ready to be used after a fresh installation.
APP Mono 1.2.4 Install
Installs and configures Mono version 1.2.4, a .NET runtime for UNIX.
APP OpenVPN install and client configuration
This script will install OpenVPN and set up the client certificate by using OpenVPN easy-rsa. It will then send the Certificate Signing Request to the CA server via a secure channel. It has the basic client configuration setup by using tun device. Users should set up their own firewall, if they need it.
APP OpenVPN install and server configuration
This script will install OpenVPN and set up the Certificate Authority certificate and server certificate by using OpenVPN easy-rsa (user can provide their own CA certificate). It has the basic server configuration setup by using tun device. Users should set up their own firewall, if they need it.
AV FreeImage 3.9.3 & ImageScience install
Installs FreeImage and also RubyInline gem so we can compile ImageScience. Attachments come from doing: wget http://prdownloads.sourceforge.net/freeimage/FreeImage393.zip?download; unzip FreeImage393.zip; cd FreeImage; make
AV shntool install
This is an install of the shntool rpm from the Dag Repo(dag.wieers.com). This package requires sox,flac and shorten.
DB MySQL 5.0.44 upgrade
Upgrades MySQL to version 5.0.44 using RightScale's own repository. NOTE: This version is still in testing mode, so it's not fully supported. Use at your own risk.
DB MySQL gem install
Installs the C-native, fast mysql gem.
DB MySQL s3 continuous mysqldump backups
Install a cron job to perform a nightly backup of a db (DB_SCHEMA_NAME), using mysqldump, and save it to S3. If bucket and prefix input variables are not set (or set to ignore) no cron will be created.
DB MySQL s3 mysqldump backup
Backup a particular DB/schema to S3, using mysqldump.
DB MySQL s3 mysqldump import
It downloads a mysqldump file from S3 and imports it into the local server (on database DB_SCHEMA_NAME). If the schema already exists, nothing will be changed in the DB (i.e., no import). If the DB_MYSQLDUMP_PREFIX and DB_MYSQLDUMP_BUCKET are not set (input variable marked as ignored), nothing will be done.
DB MySQL server install
It installs MySQL and configures it with one of the predefined templates based on the value of $DB_SERVER_FOOTPRINT. Currently 2 main option types exist: dedicated (where the mysql config allocates all existing resources of the machine)...or shared (where the mysql is configured to use less resources so that it can be run concurrently with other apps like apache and rails for example). Different types of dedicated or shared might appear later. The name of the input variable must match the name of an attachment, without the extension.
DB Rightscale tools install
Installs rightscale DB tools into /opt/rightscale/db. This version adds fragmented files and parallel backups. Many new improvements in alerts, backup cleanup, slave rotations, directory filenames.
DB application privileges set
Sets up passwords and privileges for monitoring and manipulating the DB remotely (within EC2) (application).
DB backup
Backs up the binary DB contents to S3. The resulting backup will 'file' will consist of several fixed chunk size S3 files (at this moment 100M each). The filename will contain a '/' so that all the files corresponding to a backup can be seen as a directory with year,month,day (instead of many individual files). This facilitates the human browsing of backups.
DB backups removal
WARNING: this script is not compatible with DB tools lower than v7 (<0.14.0)! It sets up the nightly database backup removal in the cron. The backup removal script will keep 7 daily backups, (user specified) a number of weekly backups, and (user specified) a number of monthly backups. The weekly backup will be every Sunday and the monthly backup will be the first Sunday of the month. Any backup that falls off the time range will be removed.
CAUTION: please be careful while specifying the backup prefix; if you have two sets of backups with the same prefix in the same bucket, they will all be removed, according to removal rule.
DB continuous backups
This script will perform continuous binary backups of master or slave DBs. Master DB instances will be detected based on the MASTERDB_DNSNAME matching the instance primary IP. For master DBs, the backup will be done nightly and uncompressed with filename ending with +%Y%m%d%H%M%S. For the slave DB, the backup will be done every 10 minutes, compressed, with filename ending with the minute of the hour (always overwritting from previous hours) This Rightscript requires the rightscale dbtools installed, and the identity key installed.
DB create binary (init)
Create binary backup from mysql dump (currently support .tar, .tar.gz, .gz, .tgz, and .zip); It supports multiple dump file in an archive file, as long as the file path in the archive is correct and the associated schema name is in order. The restoration from dump uses the basic operation without any addition option; if users would like to add some options to handle their particular dump, users may want to customize this script to do.
DB freeze binary backups
It comments out the lines in the crontab that launches the continuous backups.
DB master restore
WARNING: not compatible with RightScale DB tools earlier than 0.13.0! Restores the latest backup from S3, configures the DB to be a master, and makes the master DB DNS entry point to itself. (*** NOTE: for now, this command should only be applied to a cold-boot master server. ***)
DB privileges re-set
Sets up (or re-sets) passwords and privileges for monitoring and manipulating the DB remotely (within EC2). Usually executed after loading a DB. WARNING: it will enable all privileges for this user/password.
DB privileges set
Sets up (or re-sets) passwords and privileges for monitoring and manipulating the DB remotely (within EC2). Usually executed after loading a DB. WARNING: it will enable all privileges for this user/password.
DB promote to master
Launch on a slave instance to convert it to the new master. The slave instance must already be connected to the current master...otherwise we'll just assume that the current master is dead and will change this (slave) DB to accept writes and log binary changes (i.e., become a master). The master DNS entry will be changed to point to this instance.
DB slave init at boot
Boot-time version of slave initialization. Can be enabled/disabled by setting the SLAVE_INIT_AT_BOOT = true/false. Setting the value to $ignore is equivalent to true. When enabled, it performs the same actions as its counterpart in the operational scripts list: it converts a running DB instance to be slave of an existing Master DB. It will snapshot and pull the necessary files of the running master. It will set the slave dns entry to point to the instance's IP.
DB unfreeze binary backups
It re-enables the binary backup scripts in the crontab so they continue to be executed periodically.
DNS Rightscale tools install
Installs rightscale DNS tools into /opt/rightscale/dns.
DNS dnsmadeeasy id register
Registers an IP of the current instance to dns madeeasy. ADDR_TYPE input defines if the public or the local ip should be used for it.
DNS master DB register
It registers the IP of the instance with the dns name for the master DB. It requires RightScale DB tools installed.
LB HA proxy install
Installs haproxy and stunnel (specially patched) binaries. Also sets up one default configuration based on the passed template name and application values (app name, and binding address/port).
LB RightScale tools install
Installs RightScale premium LB tools.
LB apache for balancer configure
It configures Apache to act as a reverse proxy for a balancer_module and to include any existing vhost definitions that are found in /etc/httpd/rightscale.d/
LB apache reverse proxy configure
It configures Apache to act as a reverse proxy and to include any existing vhost definitions that are found in /etc/httpd/rightscale.d/
LB app to HA proxy connect
Contacts and configures the predefined load balancer instance to start forwarding traffic to all existing app port configured in all Load Balancer instances associated with LB_HOSTNAME.
LB app to HA proxy disconnect
Contacts and configures the predefined load balancer instance to stop forwarding traffic to all existing mongrels (mongrel_cluster) configured in all Load Balancer instances associated with LB_HOSTNAME.
LB app to local HA proxy connect
Contacts and configures the local HA proxy to start forwarding traffic to the same instance. This is used such that freshly booted applications are automatically connected to their local HA proxy.
LB mod_jk to HA proxy connect
Contacts and configures the predefined load balancer instance to start forwarding traffic to all existing tomcats (i.e., jk_module with AJP protocol) configured in all Load Balancer instances associated with LB_HOSTNAME. TCP Checks to the ajp port (configurable with TOMCAT_AJP_PORT) will be enabled.
LB mongrels to HA proxy connect
Contacts and configures the predefined load balancer instance to start forwarding traffic to all existing mongrels (mongrel_cluster) configured in all Load Balancer instances associated with LB_HOSTNAME. Checks to the mongrels will be enabled if the OPT_HEALTH_CHECK_URI variable is set.
LB mongrels to HA proxy disconnect
Contacts and configures the predefined load balancer instance to stop forwarding traffic to all existing mongrels (mongrel_cluster) configured in all Load Balancer instances associated with LB_HOSTNAME.
LB mongrels to local HA proxy connect
Contacts and connects the mongrels of the instance to the HA proxy running on its own instance. This script is typically run at the end of the boot sequence for front-end instances, so that they come up already with the local mongrels connected (i.e., serving at least the local mongrels). Checks to the mongrels will be enabled if the OPT_HEALTH_CHECK_URI variable is set.
MISC ssh priv key install
It copies a private key file (from the variable/credential) into the ~root/.ssh/id_rsa
NFS Additional Sync
PERF httperf install
Install the httperf load generating application for load-testing HTTP servers.
PERF httperf launch
Launch an httperf test geared towards auto-scaling. The test runs for $PERF_TEST_DURATION minutes executing repetitive requests of $PERF_PERIOD minutes that oscillates the request rates between $PERF_MIN_RATE to $PERF_MAX_RATE using a sinusoidal wave.
PHP DB Connection Configure
RB custom gems install
Requires RB RubyGems 1.0.1 + quickinstall v1. Installs an (optional) list of gems as specified by the (space separated) input variable. You can specify a version number and pass extra args to gem. Example: \"rake-0.7.3 rails-1.2.3 mongrel\
RB merb 0.3.7 install
Install Mongrel + ERb, Ezra's lightweight web serving framework. Also installs prereqs such as mongrel, fastthread, json, and hpricot. Mongrel_upload_progress is also installed.
RB mongrel health-check handler configure
RB mongrel_cluster (re)start
Starts the mongrel_cluster service or re-starts it if it's already running.
RB rails 2.x mongrel install & config
Installs rails 2.x series, mongrel_cluster and fastthread gems. Then builds the configuration for the mongrel_cluster and sets the init.d scripts for it. Requires rubygems > 1.0.1 + quickinstall.
RB rails capistrano setup
Installs capistrano and initializes the directory structure of the application for a Capistrano-based deployment setup.
RB rails database configure
Configures/re-configures the variables in config/database.yml based on the user/password and database parameters passed as variables.
RB rails mongrel install & config
Installs rails and mongrel_cluster and fastthread gems. Then it builds the configuration for the mongrel_cluster and sets the init.d scripts for it.
RB rails s3 code update & db config
Updates the rails sources from an s3 tarball. Skips the update/retrieval of code if the bucket and package are not set. The code update will be done a la capistrano. It will redo the directory links, it will configure the database.yml and will finally switch the \"current\" dir to point to the new release dir. Username can be left unset for anonymous checkout. Can be used as an operational script to perform upgrades at the touch of a button.
RB rails svn code update & db config
It checks out the rails sources from an svn repository, a la capistrano. It will redo the directory links, it will configure the database.yml and will finally switch the \"current\" dir to point to the new release dir. Username can be left unset for anonymous checkout. Can be used as an operational script to perform upgrades at the touch of a button.
RB rubygems 1.0.1 + quickinstall
Patches rubygems version 1.0.1 with a 'quickinstall' option. This option enables specific version selection and installation of multiple gems in one command. Now RubyGems has a new command you can use like this: \"gem quickinstall mongrel-1.0 fastthread-1.0 daemons-1.0.9\". V2 introduces retry on 500 error for S3 support.
RG RightGrid gem install.2.0
Installs RightGrid gem v1.2.0 . This version is compatible with SQS Generation 2 only! If you still need to run from Generation 1 SQS queues, use RightGrid 1.1.5 instead.
RG rightworker start
Starts the RightGrid daemon (called rightworker). Can use as a boot or operational script.
RG rightworker stop
Stops the RightGrid daemon (called rightworker).
RG user files & rightworker start
Download the rightworker.yml file for the svn repository, sets the running directory and starts the rightworker daemon. The scripts assumes that both the user's worker code and the rightworker.yml file live in the SVN same path ($SNV_URL).
S3 Rightscale tools install
Installs rightscale S3 tools into /opt/rightscale/s3. It contains scripts for incremental rsync'ing to S3.
SYS Monitoring MySQL add
Add monitoring of mysql to collectd. The MONDB_ variables are used to access a local mysql to gather stats about the database. Often user=root, password=-empty-, and name=mysql works fine.
SYS Monitoring install
Installs and configures monitoring data collection for RightScale. Uses collectd 4.1.1 (http://collectd.org/) The MONDB_ variables are to access a local mysql process to gather stats about the database. The MON_PROCESSES can be a (space separated) list of processes to monitor, such as \"httpd mysqld\".
SYS RAILS_ENV into system profile
It sets the configured value for RAILS_ENV in the system profile, so that any shell use it by default. Useful, for example to login and perform a manual migration.
SYS Remote Logging Fix /dev/null
Modifies /etc/syslog-ng/syslog-ng.conf to use /dev/null.syslog-ng instead of /dev/null
SYS Syslog Remote Logging Client
This delta-set is for configuring syslog-ng to do remote logging. $SYSLOG_SERVER - Server to send logs to.
SYS Timezone set
Sets the timezone of the instance to the one specified in the OPT_TZINFO input var. The format of the input variable follows the typical naming of time zone, of three of more letters. For example, \"UTC\", \"EST\", \"GMT\", \"America/Los_Angeles\",\"US/Eastern\" .... See tzset for more details. If no OPT_TZINFO specified, the zone will be set to UTC.
SYS lvm on /mnt
WARNING: this script is not compatible with DB tools lower than v7 (<0.14.0)! Converts the available disks to lvm's logical volumes. The size of volumes can be manually specified by the user (The max size of a small sinstance is 139GB, large instance is 789, and xlarge instance is 1629). For small images, it installs a newer version of patched kernel module. WARNING: This DELETES the contents of /mnt!!!
SYS memcached server install
Installs and configures memcached server.
TomCat PHP s3 code checkout
Updates the php sources from an S3 tarball and/or war file. Skips the update/retrieval of code if the bucket and package are not set. (This RightScript is depreciated. Please use \"APP s3 code checkout\" v3 or above.)
TomCat5 Demo (JSP & MySQL)
This little demo configures TomCats to be able running a simple JSP, which connects to MySQL, in the application directory. (It will backup the original configuration files to *.bak.(date))
WEB Apache & TomCat (re)start
Will start or re-start Apache and Tomcat.
WEB PHP install
Installs PHP and enables it. Also will install additional php modules. WARNING: it will be disabled by the Apache config script (> v4) -- restricted/binded to a vhost only.
WEB TomCat Connector (Mod_JK) install
Installs TomCat Connector (Mod_JK)-1.2.26 and configures it. WARNING: it requires LB RightScale tools install v9 or greater.
WEB TomCat5 configure
Bug fixed: 1. Repackaging tomcat5.5.23-0jpp.3.0.2.el5 *.jar files to fix invalid index error and 2. Fix the bug that is caused by the nameing-factory-dbcp... and configures TomCat5 server.xml.
WEB TomCat5 install
It installs TomCat5 by using Jpackage (centos edition). It also installs Java 6u4 manually, because xml-commons-apis, which is required by Jpackage TomCat5, will remove jdk before it is installed. In addition, it also installs tomcat5 admin, webapps, and mysql-connector-java (jdbc). WARNING: this script is not compatible to RightImage <2.0
WEB TomCat5 install
It installs TomCat5 by using Jpackage version. It also installs Java-sun.1.6.0.4 for working around xml-commons-apis obsolete and requirement of TomCat5 (JPackage). In addition, it installs tomcat5 admin, webapps, and mysql-connector-java (jdbc). The packages are downloaded from RightScale repo; in case, the new version of Jpackage doesn't work.
WEB apache (re)start
Will start or re-start apache.
WEB apache FE + APP vhost
It sets up the necessary vhost for a front end machine that also runs the application on another vhost. Specifically, it sets port 80 vhost that forwards to HA proxy and it sets up a second vhost for the application. PHP can be enabled in the application.
WEB apache base install
Installs the apache package with the mpm model specified by the input variable. PHP is disabled by default. It also moves www and log dirs to /mnt. Enables client keepalives. Configures the server threads for high traffic.
WEB apache http-only rails vhost
It sets up a simple http vhost (i.e., no ssl), using the default document root of \"rails_root\"/public, and logging to the typical system-wide dirs \"/var/log/httpd\". The default maintenance page lives inside the system directory so it can be retained even while switching 'current' directories 'a la capistrano.'
WEB apache http-only vhost
It sets up a simple http vhost (i.e., no ssl), using the default document root \"/home/lamp/...\", and logging to the typical system-wide dirs \"/var/log/httpd\"
WEB apache mod_balancer simple vhost config
Sets up a simple http vhost (i.e., no ssl) for $WEBSITE_DNS site, forwarding to a preconfigured/existing mod_balancer identified by \"$APPLICATION\"_cluster. Supports displaying a maintenance page if it exists (/maintenence.html).
WEB apache vhost non-rails configure
Configures a virtual host for a non-rails site.
WEB app s3 code checkout
Updates the php sources from an S3 tarball. Skips the update/retrieval of code if the bucket and package are not set.
WEB app svn code checkout
Updates the php sources from an svn repository.
WEB rails maintenance start
Creates a maintenance page that will be presented to all clients (instead of processing the requests). This page should we removed (with maintenance stop) as soon as the application has been fixed/reconfigured...etc.
WEB rails maintenance stop
Deletes a maintenance page so that normal processing of requests can take place again.
WEB tomcat5 (re)start
Will start or restart tomcat5.
Web apache enable server-status
It enables server status pages for a given IP/dns list of domains.
- Tag page
-
- What links here
You are correct. This is a premium RightScript. We will try and update the documentation so that it clearly shows which RightScripts are Premium/Public. Thanks for you comment!
-Dean