Skip navigation.


Log in with NCSU WRAP
View all authentication options

How to Create Linux Images

How to create a VCL Linux image environment.

  1. Select Make a Reservation from the main VCL site.
     
  2. Select Manage Images
     
  3. Select "Create / Update an Image" -> submit
     
  4. From the pull-down menu, select the base image you would like to start with
     
  5. select the Now button
     
  6. click Create Imaging Reservation
     
  7. If the image you have choosen is preloaded wait time will be less than a minute, else you may wait 10-15 minutes while the remote node is being loaded.
     
  8. click the "Connect" button when it appears. Information on how to connect will be displayed
     
  9. Use sudo bash to get a root shell.

  10. You'll have a set amount of time, usually 12 hours, to complete any changes to the image before the reservation expires and the node is wiped clean. 

Tips & Tricks: 

When processing an image for creation, the vcl system cleans or modifies out several locations to make the image suitable for VCL to reload and other users. 

  • /home (unless /home is a network drive)
  • /etc/rc.local
  • /etc/udev/rules.d/70-persistent-net.rules
  • /etc/ssh/sshd_config

The exclude the files from being modified. Add the full file path to an exclude file /root/.vclcontrol/vcl_exclude_list

VCL Post load and reserve scripts

VCL post scripts allow for customization after a node is loaded or reserved. If these scripts exists in the default location they will be excuted at their designated times. These scripts are often used for cluster on demand or handlling custom tasks that are local to the node.

The scripts are:

  1. vcl_post_load
    • File location /etc/init.d/vcl_post_load
    • Created by the image owner
    • Executed after the node is loaded
    • Ideal for editing configuration files and starting services
  2. vcl_post_reserve
    • File location /etc/init.d/vcl_post_reserve
    • Created by the image owner/creator.
    • Executed when user hits the "Connect" button
    • Ideal for making custom changes based on user names.

Save the Image

When you're done configuring the remote computer and are ready to save the image:
 

  1. Log off of the remote VCL computer
     
  2. From your own machine, return to the Current Reservations page on the VCL website
     
  3. Select More Options...->End Reservation & Create Image
     
  4. Select Creating New Image and then click Submit
     
  5. Enter an image name.  Something simple related to the applications you installed is fine. The image name is displayed when a user makes a reservation and can be changed later if needed.
     
  6. The settings under Advanced Options can be left at the defaults 
     
  7. Confirm the image properties are correct
     
  8. Click Submit 

After about 20-25 minutes, you will receive an email saying your image ready for testing when the image creation process is done (occasionally, if there is a lot of software installed in the image or if the system is extremely busy, this can take as long as 90 minutes).

Grant access to use the image

Once you have tested that the image works correctly, access to use the image will need to be granted to other users. If you have the appropriate access, you can follow the instructions on granting access to new images. If you don't have access to everything mentioned there, you will need to contact your IT support to have it done.