Applications

    URL

    Once the server is running, all its properties are available in the BitNami Cloud Hosting console. Go to the Manage Server section.

    If you want to access your applications directly, click the proper url in the Applications row. In the example above you should choose either "WordPress 3.2.1-2" or "Redmine 1.2.1-2" link. The Application popup will be shown with all the details about specific application credentials, a link to our Wiki and the url to the application itself ("Go to Application" button).

    It is also possible to go to the BitNami default page (shown below) available at your server domain name. It is bch-demo.bitnamiapp.com in our example.

    Click "Access my applications". All your installed applications are listed here. Please note that this page is empty and refreshing every couple of seconds while server is in the building state.

     

     

    Configuring the URL for the application

    New Server Configuration

    When launching a new machine in the BitNami Cloud Hosting console, apart from the main server Domain Name, you are able to configure the domain name and the URL type for each installed application. This feature is available at the moment with the limited set of applications: Discourse, Drupal, Joomla!, Magento, OpenERP, SugarCRM, WordPress and  WordPress MultiSite.

    In our example, we will install applications shown at the screenshot below:

    bch-vhost-0-1.png

    You are able to configure each application Domain Name / URL at the very first step of the new machine definition process. Open the Application configuration popup by clicking the Application icon in the Apps section. The example WordPress Properties window is presented below at the attached screenshot.

    bch-vhost-1-1.png

     

    You have two options to configure your application domain name.

    • Prefix (for instance /drupal) It is a default deployment strategy.
    • Subdomain (for instance drupal.demo-server.bitnamiapp.com) Choosing this option, your applicaton will be configured as the Apache web server Virtual Host. This is a default deployment configuration for applications like WordPress Multisite, Discourse or OpenERP (you are not allowed to use Prefix in this case)

    Note: Once you configure your application with the subdomain, it is not possible to change it back to the Prefix setup later in the automated manner.

    bch-vhost-2-1.png

    You are able to install several instances of the same application in the machine. It is currenty possible only for BitNami WordPress stack. In the WordPress Properties popup, there is an additional field Nickname which makes it easy to set the prefix to any value you want. If you do not change the application nicknames, the system will automaticaly generate unique values: wordpress, wordpress1, wordpress2, etc.

     

    Already Running Machine 

    Once your machine is running, you are still able to change the application domain name / url configuration. There is the Applications tab In the server Manage section. All applications and their current domain names are listed there.
     
    You can also check the application nickname in square brackets, for instance [wordpress1]. The Application Nickname is an unique  identifier. For example wordpress1 instance is located in the /opt/bitnami/apps/wordpress1 directory on your machine. 
     
    There is a pencil icon next each supported application which opens a popup with the Application Custom Domain properties. If you did not choose the Subdomain configuration at the time of launching your machine, you can do it now here.

    bch-vhost-3-1.png

     

    In BitNami Cloud Hosting, every server has only one wildcard domain assigned. In our example,  demo-server.bitnamiapp.com and all subdomains *.demo-server.bitnamiapp.com point to our machine IP address. Thanks to that, it is possible to change our application domain to me.blogs.demo-server.bitnamiapp.com as shown below.

    bch-vhost-4.png

    You may also change the application domain to any custom domain of your choice, for instance me.example.com. Please note that in this case you need to be an owner of the domain and configure it properly. Learn more about how to configure your Domain Name.

    bch-vhost-5.png

    The last thing you need to be aware of is that if you change the main server domain name, in our example from demo-server.bitnamiapp.com to demo-server-123.bitnamiapp.com, then all application domains with Prefix setup and those with default Subdomain will be updated as shown below. The example domain me.blogs.demo-server.bitnamiapp.com will not change and will not work properly because demo-server.bitnamiapp.com does not point to our machine anymore.

    bch-vhost-6-1.png

    Login and password

    All your choosen applications on each server share the same login and password. The image below shows the part of the server setup interface. You can choose your own username and password when configuring a server by clicking on the 'Application Options' button.

    bitnami-set-password.png

     

    The new dialog will pop up. You can set your applications login and password here. If you don't configure a username and password, a random password will be generated for you and the login will be 'user'.

    Once the server is started, to view the password, go to the Servers section in the left menu, then select the server for which you want the password and click on the 'manage' button that appears. You will see that there is a 'show' link next to the word 'Application Credentials'. Click on that to view the password. Please use both Application Login and Application Password to sign in to you aplications. Note: if you decide to set your own application password, it will not be available here.

    bitnami-cloud-hosting-default-password.png

    The default login and password for BitNami applications

    • login: user
    • password:  The one specified under Application Options or if none is, one will be automatically generated for you and will be available under the server manage screen.

    The applications listed below do not follow the default login/password policy. You can also click the application name in the server details  in the BitNami Cloud Hosting console to get the specific application credentials.

    JasperServer

    • login: jasperadmin
    • password: jasperadmin

    Liferay

    • login: username @liferay.com  Where username will be the one specified under Application Options or 'user' if none is.
    • password:  The one specified under Application Options or if none is, one will be automatically generated for you and will be available under the server manage screen. 

    ThinkUp and Spree

    • login: The email specified under 'Application Options' or your BitNami Cloud Hosting account email if none is.

    • password:  The one specified under 'Application Options' or if none is, one will be automatically generated for you and will be available under the server manage screen.

    eZ Publish and Plone

    • login: admin
    • password:  The one specified under Application Options or if none is, one will be automatically generated for you and will be available under the server manage screen.

    Where are my apps installed?

    BitNami Stack components (Apache, MySQL, PHP, Ruby ... ) are installed in /opt/bitnami directory.  You can find your web application files in the /opt/bitnami/apps location.

    You can also take a look at our Base Stack page. We keep here the detailed changelog of the BitNami Cloud Hosting base images together with BitNami base stack components list.

    Adding a new application to an existing server

    It is not currently possible to add another application to already created server via the BitNami Cloud Hosting console. However, you can add another application manually to a running server using the BitNami Modules. You can follow the steps below:

    • First, check if the BitNami Module installer is available in the stack page. Go to http://bitnami.com/stack/ruby/modules, select the application of your choice. Copy the download link for Linux 64-bit or 32-bit BitNami Module depending on the server architecture you are using. For example, if you want to add SugarCRM, you can go to the page http://bitnami.com/stack/ruby/modules#sugarcrm and copy Linux 64-bit URL:
    http://downloads.bitnami.com/files/stacks/sugarcrm/6.5.2-0/bitnami-sugarcrm-6.5.2-0-module-linux-x64-installer.run
    

    NOTE: If you can't find a "BitNami Module" available at bitnami.com for the application you want to include, contact us at http://helpdesk.bitnami.com.

    • Connect to your server via SSH. Learn more about how to connect
    • Download the module you want to install with "wget" and the URL you got from bitnami website:
    bitnami@domU-...:~$ wget http://downloads.bitnami.com/files/stacks/sugarcrm/6.5.2-0/bitnami-sugarcrm-6.5.2-0-module-linux-x64-installer.run
    --2011-02-21 10:22:36--  http://downloads.bitnami.com/files/stacks/sugarcrm/6.5.2-0/bitnami-sugarcrm-6.5.2-0-module-linux-x64-installer.run
    Resolving downloads.bitnami.com... 216.235.167.23
    Connecting to downloads.bitnami.com|216.235.167.23|:80... connected.
    HTTP request sent, awaiting response... 200 OK
    Length: 12105939 (12M) [application/octet-stream]
    Saving to: `bitnami-sugarcrm-6.5.2-0-module-linux-x64-installer.run'
    
    100%[==========================================================================>] 12,105,939  3.82M/s   in 3.0s    
    
    2011-02-21 10:22:40 (3.82 MB/s) - `bitnami-sugarcrm-6.5.2-0-module-linux-x64-installer.run' saved [12105939/12105939]
    
    • Make the application binary executable.
    bitnami@domU-...:~$ chmod a+x bitnami-sugarcrm-6.5.2-0-module-linux-x64-installer.run
    
    • Start the module installer with "sudo" in the folder /opt/bitnami: ( the MySQL password is the "Application Password" by default: more info )
    bitnami@domU-...:~$ sudo ./bitnami-sugarcrm-6.5.2-0-module-linux-x64-installer.run
    ----------------------------------------------------------------------------
    Welcome to the BitNami SugarCRM Module Setup Wizard.
    ----------------------------------------------------------------------------
    Installation folder
    
    Please choose a folder that contains an installation of BitNami LAMPStack.
    
    Select a folder []: /opt/bitnami
    
    ----------------------------------------------------------------------------
    Create Admin account
    Please enter the existing MySQL password for BitNami LAMPStack
    
    Password :
    
    ----------------------------------------------------------------------------
    Setup is now ready to begin installing BitNami SugarCRM Module on your computer.
    
    Do you want to continue? [Y/n]:
    
    ----------------------------------------------------------------------------
    Please wait while Setup installs BitNami SugarCRM Module on your computer.
    
     Installing
     0% ______________ 50% ______________ 100%
     #########################################
    
    ----------------------------------------------------------------------------
    Setup has finished installing BitNami SugarCRM Module on your computer.
    
    Launch BitNami SugarCRM Module [Y/n]: y
    
    • Your new appllication should be already available.

    NOTE: Please note that in most cases you can't install the same application module more than once (i.e Drupal or Joomla!). You will need to install and configure the application manually in this case. Please check the section about adding several instances of the same application.

    Remove an application from an existing server

    If you want to disable one of the applications you can remove or comment out the related 'Include' line in /opt/bitnami/apache2/conf/httpd.conf file and restart the Apache:

    # Include "/opt/bitnami/apps/sugarcrm/conf/sugarcrm.conf"
    
    $ sudo /opt/bitnami/ctlscript.sh restart apache
    

    Alternatevely, you can use the unistaller in the application directory to delete all application files and settings.

    $ sudo /opt/bitnami/apps/sugarcrm/uninstall
    

    Adding several instances of the same application

    It is currently possible to add several instances of WordPress (more applications will be supported in the future) directly from the BitNami Cloud Hosting console. 

    New server

    If you are creating a new server, you can just add more than one wordpress to the list of applications and configure the name and location for each of them. The application files will be installed in /opt/bitnami/apps/<wordpress_name>/ and, each will be located in its prefix http://example.bitnamiapp.com/<wordpress_name>/ by default.

    bch-vhost-1-2.png

    Already running server

    If your server is already running you can still install the new wordpress module following the steps to install new modules in an already running server adding the option --wordpress_instance_name when you run the module installer to configure the wordpress installation name: 

    ​sudo ./bitnami-wordpress-3.6.1-0-module-linux-x64-installer.run --wordpress_instance_name mywordpress

    Once the module is installed the application will be accessible in the prefix URL based on the instance name that you used: (i.e http://example.bitnamiapp.com/mywordpress) .If you want the new wordpress to be served from a subdomain or your own custom domain (like http://example.com/), you can run the following command: 

    sudo /opt/bitnami/apps/mywordpress/bnconfig --appdomain example.com

    Comments

    You must login to post a comment.