Difference between revisions of "Set up a new organisation"

From Organic Design wiki
m
m
 
(27 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{procedure
+
<noinclude>{{procedure}}</noinclude>
|description = This process defines the steps required to prepare a new [[wiki organisation]] based system for a client or project. This is really a ''job'' rather than a procedure because it involves many roles and work sessions to complete, but until we have proper workflow in place I suggest we make everything procedures for now.
 
}}
 
 
__NOTOC__
 
__NOTOC__
 +
== Preparation and Administrative ==
 +
If the organisation already exists, then the [[Migrate an existing organisation]] procedure may be more suitable. To begin with the process we need to know a few things. If there is a well-written business plan the information can be taken from there but experience shows that in most cases the organisation is in need of more clarity and structure, thus the process of setting up a new organisational system is equivalent to defining the organisation for the first time. Some questions that need to be clarified are:
 +
 +
=== Work Agreement ===
 +
*What are the clear values that are being worked toward by all parties involved? Is there a [[work agreement]]?
 +
*The work agreement should contain the values (terms and conditions) agreed upon and the scope of the work agreed to, so it is like a quote.
 +
*What are the needs of the client organisation? What are the organisational goals the system needs to help fulfil?
 +
*Who is filling which roles in implementing wiki organisation?
 +
 +
=== Ontology ===
 +
*What is the organisation currently doing, that is, which tasks is it performing and which roles are being filled, what are the departments?
 +
*What is the current state of organisation and what is missing for wiki organisation to be implemented?
 +
 +
=== Financial ===
 +
*The work agreement should be used to get quotes from competing teams to ensure that a decision to commit resource and time is based on a clear understanding of value delivered and the process rules out corruption. In this process it may become clear that the offered solution is not what is sought after by the client, which is better to find out at the beginning
 +
 
== Map existing organisation ==
 
== Map existing organisation ==
*Once requirements are known, compare existing setup with the template  
+
*Once requirements are known, compare existing setup with the template. This done done by filling in an company/system article
*The wiki organisation is prepared in parallel with the existing one to minimise disruption, activity and content is moved across in phases.
+
*The organisational system is prepared in parallel with the existing one to minimise disruption, activity and content is moved across in phases.
 +
 
 +
== Move existing domains ==
 +
*[[Set up a new domain name]]
  
 
== Set up LAN ==
 
== Set up LAN ==
Line 11: Line 28:
 
*Phone solution? VOIP options?
 
*Phone solution? VOIP options?
 
*What is the connection like? Speed, reliability?
 
*What is the connection like? Speed, reliability?
=== Hardware ===
+
 
What kind of hardware is required
+
The general idea for hardware is to get good standard equipment, but be protected against failure by having good procedures in place for handling data restoration or hardware replacement and installation.
*Router
+
*Router: (Lynksys WAG54GP or similar)
*Server box
+
*LAN: Gbit ethernet is practical cost, preferably use optical cable not copper
 +
*Server box (Standard server box (make sure it is a stock BIOS and parts etc)
 
*Workstations (1 per office worker)
 
*Workstations (1 per office worker)
*Laptops? (1 per agent in the field)
+
*Laptops (1 per agent in the field)
 
*Sources of good quality hardware
 
*Sources of good quality hardware
 +
*Site hardening available
  
=== Install LAN server ===
+
=== Install Server(s) ===
*Firewall
+
*[[Install a new server]]
*Email (imap)
+
Some places will want to have both a LAN server and a web server, others will be happy serving the wiki directly from the LAN server.
*Backup
+
*Firewall (just linux default utils are fine)
*Shared files and documents (samba?)
+
*Email (IMAP running on internal server, procedures for setting up a new client etc)
 +
*Backup (an automatic LAN server to web server backup exchange over SCP, plus a manual staff procedure on to optical media for larger files and for testing that backups are ok)
 +
*Shared files and documents (samba is best because it's well supported in linux and best not to be purposely difficult to windows users)
 +
*IRC channels (or use freenet until we can set up our own on our servers)
  
=== Install [[workstation]]s ===
+
=== Install Workstations ===
*Ubuntu
+
*[[Install a new workstation]]
*Applications
+
*Firefox
 +
*Thunderbird
 +
*Open Office
 +
*Pidgin
  
== Set up a wikiserver ==
+
== Install New Wiki ==
 +
*Set up a Wiki ([[Install_a_new_wiki]] and see [http://svn.organicdesign.co.nz/filedetails.php?repname=extensions&path=%2FLocalSettings.sample.php LocalSettings.sample.php])
 +
**Ensure the wiki you set up is the same version as the example you are taking the record types from, i.e. use that empty-sql to populate your MySql tables.
 +
**Base your Localsettings on the example RA wiki.
 +
**If the new wiki is not in the same wikia as the example, you will need to install all the extensions exactly as they are in the example.
  
 
== Import articles and templates ==
 
== Import articles and templates ==
 +
There is a script which does this automatically called [http://svn.organicdesign.co.nz/filedetails.php?repname=tools&path=%2Fsync-wikiorg.pl sync-wikiorg.pl], refer to that for the current list of articles that are included in a wiki organisation. The list is the red ''#dpl'' queries in the middle of the program.
  
== Adjust and add forms and templates ==
+
Export/import all the record types [[:Category:Records]] and all the forms in the Form namespace. Then export/import the following categories of templates:
 +
*[[:Category:Organisational templates]]
 +
*[[:Category:Formatting templates]]
 +
*[[:Category:Symbols]]
 +
 
 +
== Transfer data and bots ==
 +
 
 +
== Refine and Extend Structure ==
 +
*You may wish to use [[Special:RecordAdmin]] to make new record types. Do this after you have set up all the standard record types and you have tested them with example records to make sure RA is working.
 +
*Map roles & procedures, resources (especially those which are bookable), knowledge base, best practices etc
 +
*Create specific portals (see [[Wikipedia:Enterprise portal]] for the meaning of portal here)
 +
*Create templates (ones that represent organisational entities) and their forms
  
 
== Train staff in system usage ==
 
== Train staff in system usage ==
 +
 +
== What info we need from the client ==
 +
When a new server is set up for a client we will need them to configure some settings for their domain-name (unless it's a new domain and they want us to take care of registration, in which case we just need to know the domain(s) that require registration). Here's the info needed in the former case.
 +
*Full company name: For invoicing and domain-name registration
 +
*Primary domain name: (eg. abc.com)
 +
*Sub domains: (eg. www, wiki, crm, files)
 +
*Email addresses: (a list of email addresses required for the domain, and whether each is a POP box, or should forward to an existing address)
 +
 +
You will need to ask your domain provider to set up an '''A record''' for each sub-domain pointing to 64.79.219.166
 +
 +
== See also ==
 +
*[[Migrate an existing organisation]]

Latest revision as of 04:35, 31 January 2011

Procedure.svg Set up a new organisation
Organic Design procedure

Preparation and Administrative

If the organisation already exists, then the Migrate an existing organisation procedure may be more suitable. To begin with the process we need to know a few things. If there is a well-written business plan the information can be taken from there but experience shows that in most cases the organisation is in need of more clarity and structure, thus the process of setting up a new organisational system is equivalent to defining the organisation for the first time. Some questions that need to be clarified are:

Work Agreement

  • What are the clear values that are being worked toward by all parties involved? Is there a work agreement?
  • The work agreement should contain the values (terms and conditions) agreed upon and the scope of the work agreed to, so it is like a quote.
  • What are the needs of the client organisation? What are the organisational goals the system needs to help fulfil?
  • Who is filling which roles in implementing wiki organisation?

Ontology

  • What is the organisation currently doing, that is, which tasks is it performing and which roles are being filled, what are the departments?
  • What is the current state of organisation and what is missing for wiki organisation to be implemented?

Financial

  • The work agreement should be used to get quotes from competing teams to ensure that a decision to commit resource and time is based on a clear understanding of value delivered and the process rules out corruption. In this process it may become clear that the offered solution is not what is sought after by the client, which is better to find out at the beginning

Map existing organisation

  • Once requirements are known, compare existing setup with the template. This done done by filling in an company/system article
  • The organisational system is prepared in parallel with the existing one to minimise disruption, activity and content is moved across in phases.

Move existing domains

Set up LAN

  • Internet account
  • Phone solution? VOIP options?
  • What is the connection like? Speed, reliability?

The general idea for hardware is to get good standard equipment, but be protected against failure by having good procedures in place for handling data restoration or hardware replacement and installation.

  • Router: (Lynksys WAG54GP or similar)
  • LAN: Gbit ethernet is practical cost, preferably use optical cable not copper
  • Server box (Standard server box (make sure it is a stock BIOS and parts etc)
  • Workstations (1 per office worker)
  • Laptops (1 per agent in the field)
  • Sources of good quality hardware
  • Site hardening available

Install Server(s)

Some places will want to have both a LAN server and a web server, others will be happy serving the wiki directly from the LAN server.

  • Firewall (just linux default utils are fine)
  • Email (IMAP running on internal server, procedures for setting up a new client etc)
  • Backup (an automatic LAN server to web server backup exchange over SCP, plus a manual staff procedure on to optical media for larger files and for testing that backups are ok)
  • Shared files and documents (samba is best because it's well supported in linux and best not to be purposely difficult to windows users)
  • IRC channels (or use freenet until we can set up our own on our servers)

Install Workstations

Install New Wiki

  • Set up a Wiki (Install_a_new_wiki and see LocalSettings.sample.php)
    • Ensure the wiki you set up is the same version as the example you are taking the record types from, i.e. use that empty-sql to populate your MySql tables.
    • Base your Localsettings on the example RA wiki.
    • If the new wiki is not in the same wikia as the example, you will need to install all the extensions exactly as they are in the example.

Import articles and templates

There is a script which does this automatically called sync-wikiorg.pl, refer to that for the current list of articles that are included in a wiki organisation. The list is the red #dpl queries in the middle of the program.

Export/import all the record types Category:Records and all the forms in the Form namespace. Then export/import the following categories of templates:

Transfer data and bots

Refine and Extend Structure

  • You may wish to use Special:RecordAdmin to make new record types. Do this after you have set up all the standard record types and you have tested them with example records to make sure RA is working.
  • Map roles & procedures, resources (especially those which are bookable), knowledge base, best practices etc
  • Create specific portals (see Wikipedia:Enterprise portal for the meaning of portal here)
  • Create templates (ones that represent organisational entities) and their forms

Train staff in system usage

What info we need from the client

When a new server is set up for a client we will need them to configure some settings for their domain-name (unless it's a new domain and they want us to take care of registration, in which case we just need to know the domain(s) that require registration). Here's the info needed in the former case.

  • Full company name: For invoicing and domain-name registration
  • Primary domain name: (eg. abc.com)
  • Sub domains: (eg. www, wiki, crm, files)
  • Email addresses: (a list of email addresses required for the domain, and whether each is a POP box, or should forward to an existing address)

You will need to ask your domain provider to set up an A record for each sub-domain pointing to 64.79.219.166

See also