Reference Information › CA AppLogic Support Knowledge Base › Overview of Support Knowledge Base › AppLogic Quick Guide

AppLogic Quick Guide

Section 1: Architecture

Architecture

• Applogic can run on a multitude of server configurations because it's designed to run on commodity systems. It's always best to use the same hardware throughout a grid to avoid issues between volume mirroring and cpu flopping. A grid normally consists of 2 or more servers and up to 248 (limitation due to available ports per network switch).
• SANs or other expensive storage systems are not required and direct access to the grid is not supported.

Physical Servers

• Multi-core CPUs, 2+ Disks, XXGB Memory & Gigabit Ethernet

Networks Switches

• 2 Gigabit Switches
• Requirements (Hardware & Software)

  Aldo / BFC

  Controller (Primary & Secondary)

  Links

  http://wiki.3tera.net/bin/view/AppLogic29/ArchitectureOverview

  http://wiki.3tera.net/bin/view/AppLogic29/HardwareConfig

  http://wiki.3tera.net/bin/view/AppLogic29/HwCompatDetails

Section 2: Install & Setup

• Download / rsync release
• Servers Pre-Imaged
• Installing Applogic
• Upgrades, Patches & Hotfixes
• Managing Users
  • Setting Up Grid SSH Access For A New User
  • From grid: user create user@companyemail.com pwd =- sshkey = "paste a public ssh2 key generated from PuttyGen here" - The username must be a valid email address.
    • Local machine using putty: Open notepad - Paste the PuttyGen private key into this new file and save as a .ppk file
    • Open Putty - Select + next to Connection then navigate to Data below - verify Auto-login username is 'root'
    • Select + next to SSH - Make sure Preferred SSH protocol version 2 is selected. Select Auth (2nd category below SSH)
    • Select the browse button on the right and choose the .ppk file in which you just created
    • Select Session (the top category) and enter the grid IP address at port 22, making sure connection type SSH is selected
    • Drop down to the empty text field below "Saved Sessions" and type the name of the grid in which you are connecting to and select the Save button to the right.
    • Select open at the bottom - answer yes to the questions and you will be logged into the grid controller. Type '3t' to access the applications on the grid.
• Local Linux machine: create a .ppk file in ~.ssh by copying PuttyGen private key into the new .ppk file <id_rsa.ppk>

  chmod 600 id_rsa.ppk

  ssh -i id_rsa.ppk root@<grid ip address> - answer yes and you will be logged into the grid controller. Type '3t' to access the applications on the grid.

  Links

  http://wiki.3tera.net/bin/view/AppLogic29/ReleaseNotes-2-9-9

  http://wiki.3tera.net/bin/view/AppLogic29/AldTutorial

Section 3: Web GUI

Dashboard

• Status
• Messages
• Grid Account Info

The Dashboard tab shows a quick and detailed view of the status of the grid. It's separated into three sections: Status, Message & Grid Account Info.

The Status section shows Grid information and resource usage. There is also a Grid Shell button which launches the browser based grid 3t shell (the grid shell will be covered later in this document).

The Messages sections shows a list of the latest alerts or messages.

The Account Info section lists the Public Network information.

Applications Tab

• Tools
• Apps & Templates
• Status, Description & Resource Allocation

The Application tab lists all the applications and templates. It also lists the state, description and resources usage for each one. From here a user can create, edit, start, stop or restart an application as well as a few other functions. Left clicking on an item name will open it in canvas view.

Section 4: Applications

• Tools
• Canvas
• Catalogs
• Boundary
• Configuration
• Volumes
• Components

While in canvas view, the windows displays three main sections: toolbar, catalog pane & canvas.

The toolbar gives you access to all the functions and features.

The catalog pane displays all the components available for use.

The canvas is the slate which holds everything under that given application.

Section 5: Components (Appliances) & Catalogs

• Attributes
• Resources
• Property Values
• Class Branching
• Boundary
• Types (VDS, Assembly, …)

Section 6: Volumes

• Types (instantiation or single)
• Mirroring
• States

Section 7: Grid Shell

Shells

The underlining system of Applogic can be accessed via a command shell. Applogic comes with a built-in 3t shell that can be accessed via the web and terminal. The 3t shell allows the user to access all the commands and objects needed to control the system. Commands can also be passed in from the terminal directly by running the command with "3t" in front of it.

Commands

The syntax for commands within Applogic can be "command args", "command object args" or "object command args". The different syntax formats are allowed depending on where within the 3t shell you're located. To get a list of all the objects and commands type "help" at the prompt.

Basic Commands

If you type '3t' and press 'Enter' it will bring you into the grid and there's no need to precede each command with '3t'

• 3t grid info - lists grid information
• 3t srv list - lists information of servers which are supporting the grid
• 3t app list - lists all running apps
• 3t app list --all - lists all apps within grid
• 3t ca <appname> - change app in which you are working with
• 3t vol list --all <appname> - lists all volumes associated with the particular app. If you do not specify the app then all volumes within grid will be listed.
• 3t app start/stop/restart - will perform requested function on app which you are working within. If on the grid prompt and not within an app you will have to specify app name to perform action.
• 3t log list - lists the app logs which can tell you why it did not start
• 3t help - will return a list of commands and how to use them. (displayed above)

Section 8: Troubleshooting & Support

• Error Logs & Messages
• Volumes (degraded, error & stuck)
• Controller

Section 9: Maintenance

• Servers (Adding & Removing)
• Upgrades (Hard-Drives, Memory & NIC's)
• ...

Additional Information To Include

• Internet access for time syncing
• Resource allocation (cpu, memory, bw & volumes)
• Windows Appliances
• Linux Courses
• Point to Point Networking
• External Interface

AppLogic Bookshelf - reference guides for r3.0 http://doc.3tera.com/AppLogic30/