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