RockMongo

    This sections describes how to access your RockMongo installation.

    RockMongo is a MongoDB administration tool, written in PHP5.

    Increasing the security of RockMongo login page.

     
    If you would like, you can add an additional layer of security by enabling Apache's authentication when accessing RockMongo. To do so, open /installdir/apps/rockmongo/conf/httpd-app.conf and uncomment the following lines by removing the # symbol:
     
    For Virtual Appliances and AMIs you can edit the file with "nano":
    $ sudo nano /opt/bitnami/apps/rockmongo/conf/httpd-app.conf
    # AuthType Basic
    # AuthName RockMongo
    # AuthUserFile "install_directory/apache2/users"
    # Require valid-user
    
     
    Now, when accessing RockMongo you will have to log in twice: First, with the username administrator and second, with the username root. Password will be the one you specified at install time or in the case of the Amazon Machine Images and Virtual Appliances, "bitnami". If you would like to change this password, you just have to follow these instructions.

    How to modify the allowed size for uploaded files?

    You can modify the following option in the php.ini file to increase the allowed size for uploads:

    ; Maximum size of POST data that PHP will accept.
    post_max_size = 16M
    
    ...
    
    ; Maximum allowed size for uploaded files.
    upload_max_filesize = 16M
    

    How to modify the execution time?

    This paremeter sets the timeout for Apache to run a script. You can modify the following option in the php.ini file.

    max_execution_time = 120     ; Maximum execution time of each script, in seconds 
    

    How to change the RockMongo password?

    The RockMongo credentials are the same that the MongoDB database. If you want to modify the password, check how to change the MongoDB root password.

    How to enable RockMongo to be accessed remotely?

    For security reasons, this applications will be accessible only when using 127.0.0.1 as the hostname. If you are using a native installer you can access from your own machine but if you are using a Virtual Machine, Amazon cloud image or Windows Azure cloud image, please check the connection steps below.

    Amazon cloud / BitNami Hosting

    By default RockMongo is not accessible from the outside for security reasons. In order to access them, you can create an SSH tunnel to Apache, sending your requests to your webserver from 127.0.0.1 (localhost).

    You should follow these steps to create the tunnel:

    1. Get your SSH private key if you don't have it already. More info

    2. Create the tunnel.

    - If you are in Linux or Mac you can run the following in a Terminal in your local machine (using your Public DNS instead of xyz.bitnamiapp.com):

    $ ssh -N -L 8888:127.0.0.1:80 -i bitnami-hosting.pem bitnami@xyz.bitnamiapp.com
    

    - If you are using Windows, you can use Putty:

    • Follow the steps described here
    • Before opening the connection. Go to Connection -> SSH -> Tunnels, enter the values below and click "Add" button:
      • Source port: "8888"
      • Destination: "localhost:80" 
    • Click Open

    3. While the tunnel is active you can connect to the web application at http://127.0.0.1:8888/rockmongo  in your browser. The default login is:

    • username: root.
    • password: bitnami (for BitNami AMIs), <application password> (for BitNami Cloud Hosting)

    Take a look at this link about how to get your application password for BCH servers

     

    Native Installer

    To test your RockMongo installation, first make sure that your Apache and mongoDB servers are up and running.
     
    To do so, you can use the included "ctlscript.sh" utility. The installdir for Virtual Appliances and AMIs is "/opt/bitnami".
    $ cd your_installdir
    $ ./ctlscript.sh status
    

    If you need to start or stop the servers, you just have to follow the steps described here.

    You can access your RockMongo installation by opening a browser and typing http://127.0.0.1:8080/rockmongo or http://127.0.0.1/rockmongo.

    rockmongo-1.png

    The default root user is root. The password is the same that you set during the installation.

    Virtual Machine

    If you are running the Virtual Appliance in a secure environment, you can enable it by editing the "installdir/apps/rockmongo/conf/httpd-app.conf" file and replace "Allow from 127.0.0.1" with "Allow from all" (if your server is running Apache 2.2) or "Require local" with "Require all granted" (if you server is running Apache 2.4 or later) :

      <Directory "/installdir/apps/rockmongo/htdocs">
      # AuthType Basic
      # AuthName RockMongo
      # AuthUserFile "/installdir/apache2/users"
      # Require valid-user
      <IfVersion < 2.3 >
      Order allow,deny
      Allow from all
      Satisfy all
      </IfVersion>
      <IfVersion >= 2.3>
      Require all granted
      </IfVersion>
      ErrorDocument 403 "For security reasons, this URL is only accesible using localhost (127.0.0.1) as the hostname"
      </Directory>
    

    Then you should restart Apache to load the changes:

    $ cd installdir
    $ ./ctlscript.sh restart apache

    Then you can access at the same URL with "/rockmongo", for example http://YOUR_IP/rockmongo

    For RockMongo the default root user is root. For Virtual Appliances the password is "bitnami".

    Azure cloud

    By default RockMongo is not accessible from the outside for security reasons. In order to access them, you can create an SSH tunnel to Apache, sending your requests to your webserver from 127.0.0.1 (localhost).

    You should follow these steps to create the tunnel:

    1. Create the tunnel.

    - If you are in Linux or Mac you can run the following in a Terminal in your local machine (using your Public DNS instead of xyz.bitnamiapp.com):

    $ ssh -N -L 8888:127.0.0.1:80 your_azure_user@xxx.cloudapp.com
    

    - If you are using Windows, you can use Putty:

    • Follow the steps described here
    • Before opening the connection. Go to Connection -> SSH -> Tunnels, enter the values below and click "Add" button:
      • Source port: "8888"
      • Destination: "localhost:80" 
    • Click Open

    2. While the tunnel is active you can connect to the web application at http://127.0.0.1:8888/rockmongo in your browser. The default login is:

    • username: root.
    • password: bitnami (for BitNami Azure images).

    Tabs end

    Tag page (Edit tags)
    • No tags
    Page statistics
    6139 view(s), 9 edit(s) and 9929 character(s)

    Comments

    You must login to post a comment.

    Attach file

    Attachments