r7 - 08 Jul 2008 - 11:48:25 - StephenQYou are here: Wiki >  AppLogic23 Web > RefAppsVPSOsolCid
ALERT! AppLogic 2.3 Beta Documentation The latest production release is AppLogic 3.0.30

VPS64_OSOL - VPS based on OpenSolaris - Implementation Design

Base Class

The base class for the VPS64_OSOL singleton is the OSOL64 server appliance based on OpenSolaris.

Class Volume

The volume configuration for the VPS64_OSOL singleton is determined by the base class image from which it is created. The setup chosen for the 1.0. release is as follows:

  • boot volume: 3 GB, mounted as "/", writeable, instantiable
The boot volume contains the same OpenSolaris installation as the one present on the OSOL appliance.

Packages

VPS64_OSOL includes the same packages as OSOL64.

Contents of the release directory

Exported application image

  • VPS64_OSOL-1.0.1-1.tar.bz2

Application sources

  • VPS64_OSOL-1.0.1-1-src.tar.bz2: tar of all the scripts used to recreate the application

Tests

  • VPS64_OSOL-tst.tar.bz2: VPS64_OSOL test scripts

Re-install Procedure

Here are the steps to create a VPS64_OSOL application from a OSOL64 appliance on an AppLogic grid (ALERT!This requires maintainer access to the grid):

  1. From the AppLogic Editor, create an application named VPS_OSOL_r1, where r1 is the desired revision number.
  2. Insert and branch a OSOL64 appliance. Name the branched class VPS64_OSOL and the instance vps64_osol. Save and exit the application.
  3. Copy and uncompress VPS64_OSOL-1.0.1-1-src.tar.bz2 on the grid controller.
  4. Edit setenv.sh to include the current version information and usable configuration values.
  5. Execute the script mkvpsosol.sh, which performs the following:
    • updates the VPS64_OSOL class descriptor to setup the correct boundary and version information
    • updates the main and package descriptors of the VPS64_OSOL_r1 application
    • starts the application
    • scp's appliance specific files to the running VPS64_OSOL singleton
    • stops the application
    • exports the application
    • tar and zip the VPS64_OSOL_r1 application export
    • NOTE: All operations are logged to mkvpsosol.log. Check the log in case of any failures.
  6. Find the VPS64_OSOL_r1 release tar, VPS64_OSOL_r1-1.0.0-1.tar.bz2, under /vol/_impex.

Theory of Operation

VPS64_OSOL is a virtual private server application that is designed to be deployed as a standalone application.

Configuration

External network setup

VPS64_OSOL has an external interface which allows the appliance to communicate with the outside world. On start, the script /appliance/appliance_netsetup.sh configures the external interface, assigning the primary_ip and secondary_ip (if one is specified). This script also sets the netmask and gateway, as well as setting the DNS servers.

User and passwords

The root password and the user name and password are setup through the /appliance/change_pwd script on the initial boot of VPS64_OSOL and when the /appliance/passwd.stamp file is missing. This script is invoked by the /appliance/appliance.sh script.

In order to update the user, user_pw, or root_pw properties and have those changes take affect, the /appliance/passwd.stamp file must be deleted prior to restarting VPS64_OSOL.

Log Files

VPS64_OSOL does not create any additional logs aside from those ordinarily created by OSOL64.

Important Notes

None

-- StephenQ - 24 Mar 2008

 
Copyright © CA 2005-2011. All Rights Reserved.
%