Quick Start Manual

Introduce

This document is for using giip service as user.

Flow

1. Open URL on browser(recommend chrome browser)

• https://giipasp.azurewebsites.net

2. Click Start button

• Register user when you are not have account.

3. Add Project

• Environment > Projects > Add Project
• Add your project. You may manage permission each project to other member.

4. Add Service

• Environment > Services > Add Service
• Service is unit of automation group.
• You man seperate by OS or usage of servers, then use different service code
• It is important for automation on giip, we forced recommend make a service and secret key.

5. Add Secret key

• Environment > Services > Service list
• Secret key is depends on service.
• You can not recover secret key when you do re-generate it. Be careful!
• Secret key is key for giip automation. If you seems to use other peoples, you may block by regenerate it.

6. Add Machine

• Infrastructure > Logical Machine > Add Machine
• You may generate by your machine using giipAgent.
  • Fill sk giipAgent.cnf manually.(you can find on Environment > Services )
  • Fill lssn to 0
  • execute giipAgent, then you can find lssn is changed, and you can see on giip web manager on your logical machine

7. Download giipAgent to your machine

• Connect ssh/rdp to your machine.
• Download giipAgent
  • Linux/UNIX : git clone https://github.com/LowyShin/giipAgentLinux.git
  • Windows : git clone https://github.com/LowyShin/giipAgentWin.git
• Add cron
  • Linux : sudo sh giipcronreg.sh
  • Windows : add system scheduler giipAgent.wsf every 1 min.
    • If you using ahk(Auto Hot Key), add giipAgent.ahk to Startup group.
• You may change agent source when blocked by gateway or kerberos security environment.

8. Add Script

• Automation > Script Repository > Add Script
• Fill forms (Sample is linux)
  • Script Name : test script
  • Script Type : sh
  • Script description : first my automation
  • Script Source : hostname > ~/hostname.giip.txt
• Click Save

9. Apply to your server

• Automation > Script Repository > Script Detail
  • You can see your server's hostname, check it.
• Click Save
• if you does not change, this script is executed every 5min.

10. See result

• You can find file hostname.giip.txt wrote your hostname.

Well done!! Contact us if you have any question anytime.