Virtualization server

A Virtualization server is a customized version of Tomcat that treats each User Sandbox, Staging Sandbox, and workflow instance as a separate Tomcat web application. It understands an "overloaded" hostname format that allows it to map requests to specific sandboxes. These "overloaded" hostnames use wildcard DNS entries to map all request to the same Alfresco Virtualization server.

Configuring the virtual server for preview

The configuration files for the virtual server can be found in the <alfresco home>/virtual-tomcat/conf directory. To enable previews on a development machine, you need to modify the alfrescovirtserver.properties file to utilize the Alfresco wildcard DNS service. The alfresco.virtserv.domain value needs to be updated to replace 127-0-0-1 with the IP of the Alfresco local machine, substituting all "." with dashes:

# Alfresco's free/public wildcard domain service ("EchoDNS")
# returns resource records with a TTL of 1 day. Therefore,
# the run-time overhead is quite minimal. Once the machine
# has done a name lookup, it will cache the result for the
# next 24 hours (or until you reboot).
#
alfresco.virtserver.domain=127-0-0-1.ip.alfrescodemo.net

If the IP of the Alfresco machine is 192.168.1.25, update alfresco.virtserver.domain to alfresco.virtserver.domain=192-168-1-25.ip.alfrescodemo.net.

Alfresco Virtual Server needs to be restarted at this point.

Virtualization URL format

The general format for Alfresco virtual hyperlink is:

http://virtual-hostname.www--sandbox.virtualization-domain:port/request-path

where the virtual-hostname is defined as the DNS name when creating a web project, and the virtualization-domain is the wildcarded domain name entry that maps to the Alfresco Virtualization Server. The default port for a virtualization server is 8180. Given that a web project was created with "test" as the DNS name, (*.virtualserver.unico.com is a DNS entry for Virtualization Server) and is installed on the default port, the following are true:

Virtualization server access to the User Sandbox

The AVM repository and its virtual stores are mapped into the virtual Tomcat working directory:

$VIRTUAL_TOMCAT_HOME/work/Catalina/avm.alfresco.localhost/.

This working directory will contain directories like the following, which are similar to the naming CIFS convention for virtual stores:

TABLE[
$-1$mysite--admin--preview$ROOT/ $-1$silly--admin--preview$ROOT/
$-1$mysite--admin$ROOT/ $-1$silly--admin$ROOT/
$-1$mysite--alice--preview$ROOT/ $-1$silly--alice--preview$ROOT/
$-1$mysite--alice$ROOT/ $-1$silly--alice$ROOT/
$-1$mysite--bob--preview$ROOT/ $-1$silly--preview$ROOT/
$-1$mysite--bob$ROOT/ $-1$silly-$ROOT/
$-1$mysite--preview$ROOT/ host-manager/
$-1$mysite$ROOT/ manager/
$42$mysite$ROOT/]

Virtual server configuration

Configure the virtual server to allow the previewing of content and review some of the content in the CIGNEX web project in the user's sandbox. Once you are satisfied that the preview is working, submit the whole project to staging. After the submission is complete, preview the website in the Staging Sandbox.

  1. Determine the current IP of the Alfresco machine using one of the following:
    • Windows—open CMD prompt and run the ipconfig command
    • Unix(s)—open terminal and run ipconfig -a
  2. Open the virtserver.properties file found in the <alfresco home>/virtual-tomcat/conf directory.
    c:Alfrescovirtual-tomcatconfvirtserver.properties
    
  3. Modify the following line to use the IP found in step one, replacing all "." with "-" :
    alfresco.virtserver.domain=127-0-0-1.ip.alfrescodemo.net
    

    For IP of 192.168.1.100 the line would be:

    alfresco.virtserver.domain=192-168-1-100.ip.alfrescodemo.net
    
  4. Save and exit the file.
  5. Start or restart the Virtual Server.
  6. Test previewing the file in the user's sandbox.

Click on Submit All to send all files to the staging environment. Test preview in the Staging Sandbox. Previewing in the User and Staging Sandboxes should work.

..................Content has been hidden....................

You can't read the all page of ebook, please click here login for view all page.
Reset