Contents

0.  Access the system
1.  Create a new server
2.  Add a client to a server
3.  List all servers
4.  List all clients for a server
5.  Download the install script for a server or a client
6.  Install files on a server/client
7.  Install files on the same server
8.  Remove a client from a server
9.  Remove a server



0.  Access the system

    Using your web browser, go to the web address:
    
        http://localhost/openvpn     (for non-ssl)
        https://localhost/openvpn    (for ssl)
    
    replace the localhost with the appropriate dns address.


1.  Add a new server

    Click the ADD NEW button to add a new server
    
    Fill in all the fields.  Most are self-explanatory:
    
    Tun/Tap:    There are 4 choices here.  If you select a static Tun or Tap
                then the generated installation scripts will look at the system
                and assign a unique number to the tap interface.  This open
                carries over to the client systems
                
    DNS Address:This is the external address of the server.  It can be either
                an IP address or a full DNS name
                
    When done, click the GENERATE button.  If you specified 2048 bits, this can
    take a long time, be patient.


2.  Add a client to a server

    Click on the server name in the left column
    
    There will be three buttons at the bottom.  Click the button 
    labeled "New Location"
    
    Enter the location/client name.
    
    Verify that the server DNS is correct.  The default will be the 
    value entered on the server screen
    
    Verify that the port is correct.  Again, the default will be the value
    entered on the server screen.
    
    Click the "GENERATE" button


3.  List all servers

    All servers will be listed in the left column.  If a server has clients,
    there will be an arrow to the left of the server, otherwise there will be
    a dash.


4.  List all clients for a server

    Click the arrow to the left of the server name.  The clients will be listed
    underneath the server


5.  Download the install script for a server or a client

    Click on the server or client you want to download.  All available files
    will be displayed in the right side.  There will be two groups of files,
    the top part will be the full package which includes the install scripts.
    There will be a version for Linux, and a version for Windows. Click the icon
    to the left of the version you want, and download the file.


6.  Install files on a server/client

    a. Linux
        Move the file into a temporary directory.
        Make the file executable (chmod +x openvpn-???.sh)
        Run the file.  This will unpack two files, an "install.sh" and "openvpn.uu"
        Now run the install script.
        Delete all the files in the temp directory.
    
    b. Windows
        Copy the zip file to the Windows system
        Make sure that OpenVPN is installed on the Windows system
        Unzip the file into the OpenVPN config directory

    
7.  Install files on the same server

    This requires that the user that Apache is running as has sudo root permission
    to execute the following file (assuming that the scripts are installed
    in /home/openvpn):
    
        /home/openvpn/scripts/install-local.sh
        
    Click on the server you want to install locally
    
    Click the button labeled "Install on this system"


8.  Remove a client from a server

    Click the arrow to the left of the server to expand the list of clients
    
    Click the client to remove
    
    Click the "REMOVE" button
    
    This does NOT remove the client from the physical server, it merely deletes
    the client information from the management system.  In order to actually
    delete the files on the client system, you will need to delete the conf
    file and the subdirectory containing the security files.


9.  Remove a server

    Click the server to remove
    
    Click the "REMOVE" button.  This will remove the server and all clients 
    for that server

    This does NOT remove the server or clients from the physical machines,
    it merely deletes the server and client information from the management 
    system

    In order to actually delete the files on the server system, you will need
    to delete the conf file and the subdirectory containing the security files.
